org.codehaus.plexus.collections
Interface ActiveCollection

All Known Subinterfaces:

ActiveList, ActiveMap, ActiveSet

All Known Implementing Classes:

AbstractActiveList, AbstractActiveMap, AbstractActiveSet, DefaultActiveList, DefaultActiveMap, DefaultActiveSet

public interface ActiveCollection

Represents a collection-style view of a PlexusContainer instance, which retrieves a fresh batch of component elements for each method call. This interface DOES NOT implement Collection, since it is used as a common parent for active List, Set, and Map implementations.
NOTE: All active collections are immutable, and will throw an UnsupportedOperationException if a mutator method is called.

Author:

jdcasey

Method Summary

boolean	checkedIsEmpty() Same semantics as Collection.isEmpty() or Map.isEmpty(), except this method will throw a ComponentLookupException if one or more of the elements collected here fails during lookup.
int	checkedSize() Same semantics as Collection.size() or Map.size(), except this method will throw a ComponentLookupException if one or more of the elements collected here fails during lookup.
java.lang.String	getRole() Retrive the role, or type of component, which is collected in the current instance.
boolean	isEmpty() Same semantics as Collection.isEmpty() or Map.isEmpty().
int	size() Same semantics as Collection.size() or Map.size().

Method Detail

getRole

java.lang.String getRole()

Retrive the role, or type of component, which is collected in the current instance. The current collection will only "contain" elements that specify this role in their component definitions.

isEmpty

boolean isEmpty()

Same semantics as Collection.isEmpty() or Map.isEmpty().

checkedIsEmpty

boolean checkedIsEmpty()
                       throws org.codehaus.plexus.component.repository.exception.ComponentLookupException

Same semantics as Collection.isEmpty() or Map.isEmpty(), except this method will throw a ComponentLookupException if one or more of the elements collected here fails during lookup.

Throws:

org.codehaus.plexus.component.repository.exception.ComponentLookupException

size

int size()

Same semantics as Collection.size() or Map.size().

checkedSize

int checkedSize()
                throws org.codehaus.plexus.component.repository.exception.ComponentLookupException

Same semantics as Collection.size() or Map.size(), except this method will throw a ComponentLookupException if one or more of the elements collected here fails during lookup.

Throws:

org.codehaus.plexus.component.repository.exception.ComponentLookupException