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.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`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