ICpPackCollection.java

/*******************************************************************************
* Copyright (c) 2015 ARM Ltd. and others
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* ARM Ltd and ARM Germany GmbH - Initial API and implementation
*******************************************************************************/

package com.arm.cmsis.pack.data;


import java.util.Collection;
import java.util.Set;

/**
 * Interface to collection of pack families
 * @see ICpPackFamily
 */
public interface ICpPackCollection extends ICpPackGroup {

	/**
	 * Returns pack collection of the latest packs  
	 * @return collection of the latest packs 
	 */
	Collection<ICpPack> getLatestPacks();

	/**
	 * Returns set of latest packs IDs   
	 * @return set of latest pack IDs 
	 */
	Set<String> getLatestPackIDs();
	
	/**
	 * Returns pack collection of filtered packs according to supplied filter  
	 * @return collection of filtered packs, if filter is null, the entire collection is returned 
	 */
	Collection<ICpPack> getFilteredPacks(ICpPackFilter packFilter);
	
	/**
	 * Returns pack collection of the packFamilyId
	 * @return collection of packs that belong to this packFamilyId, or null if no such packFamilyId exists 
	 */
	Collection<ICpPack> getPacksByPackFamilyId(String packFamilyId);
}