summaryrefslogtreecommitdiff
path: root/base/src/main/java/bjc/utils/components/IComponentRepository.java
blob: 6ee51f3abfb3cf88bfccda602e1462852a42aa38 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package bjc.utils.components;

import bjc.utils.funcdata.IList;
import bjc.utils.funcdata.IMap;

/**
 * A collection of implementations of a particular type of
 * {@link IDescribedComponent}
 *
 * @author ben
 *
 * @param <ComponentType>
 *                The type of components contained in this repository
 */
public interface IComponentRepository<ComponentType extends IDescribedComponent> {
	/**
	 * Get all of the components this repository knows about
	 *
	 * @return A map from component name to component, containing all of the
	 *         components in the repositories
	 */
	public IMap<String, ComponentType> getAll();

	/**
	 * Get a component with a specific name
	 *
	 * @param name
	 *                The name of the component to retrieve
	 * @return The named component, or null if no component with that name
	 *         exists
	 */
	public ComponentType getByName(String name);

	/**
	 * Get a list of all the registered components
	 *
	 * @return A list of all the registered components
	 */
	public default IList<ComponentType> getList() {
		return getAll().valueList();
	}

	/**
	 * Get the source from which these components came
	 *
	 * @return The source from which these components came
	 */
	public String getSource();
}