org.apache.commons.collections.collection

Class TypedCollection

public class TypedCollection extends Object

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: 155406 $ $Date: 2005-02-26 12:55:26 +0000 (Sat, 26 Feb 2005) $

Author: Stephen Colebourne Matthew Hawthorne

Constructor Summary
protected TypedCollection()
Restrictive constructor.
Method Summary
static Collectiondecorate(Collection coll, Class type)
Factory method to create a typed collection.

Constructor Detail

TypedCollection

protected TypedCollection()
Restrictive constructor.

Method Detail

decorate

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

Copyright © 2001-2008 Apache Software Foundation. All Rights Reserved.