| java.lang.Object | |
| ↳ | org.apache.commons.collections.collection.TypedCollection |
Class Overview
Decorates a Collection to validate that elements added are of a specific type.
The validation of additions is performed via an instanceof test against
a specified Class. If an object cannot be added to the
collection, an IllegalArgumentException is thrown.
Summary
| Protected Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Restrictive constructor.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Factory method to create a typed collection.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Protected Constructors
protected TypedCollection ()
Restrictive constructor.
Public Methods
public static Collection decorate (Collection coll, Class type)
Factory method to create a typed collection.
If there are any elements already in the collection being decorated, they are validated.
Parameters
| coll | the collection to decorate, must not be null |
|---|---|
| type | the type to allow into the collection, must not be null |
Returns
- a new typed collection
Throws
| IllegalArgumentException | if collection or type is null |
|---|---|
| IllegalArgumentException | if the collection contains invalid elements |