Class TypedCollection
java.lang.Object
org.apache.commons.collections.collection.TypedCollection
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.
- Since:
- Commons Collections 3.0
- Version:
- $Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $
- Author:
- Stephen Colebourne, Matthew Hawthorne
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic Collection
decorate
(Collection coll, Class type) Factory method to create a typed collection.
-
Constructor Details
-
TypedCollection
protected TypedCollection()Restrictive constructor.
-
-
Method Details
-
decorate
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 nulltype
- the type to allow into the collection, must not be null- Returns:
- a new typed collection
- Throws:
IllegalArgumentException
- if collection or type is nullIllegalArgumentException
- if the collection contains invalid elements
-