org.apache.commons.collections.list
Class TypedList

java.lang.Object
  org.apache.commons.collections.list.TypedList

public class TypedList
extends java.lang.Object

Decorates another List 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 13:33:15 +0100 (Thu, 10 Apr 2008) $

Author:

Stephen Colebourne, Matthew Hawthorne

Constructor Summary

protected

TypedList() Restrictive constructor.

Method Summary

static java.util.List

decorate(java.util.List list, java.lang.Class type) Factory method to create a typed list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TypedList

protected TypedList()

Restrictive constructor.

Method Detail

decorate

public static java.util.List decorate(java.util.List list,
                                      java.lang.Class type)

Factory method to create a typed list.

If there are any elements already in the list being decorated, they are validated.

Parameters:

list - the list to decorate, must not be null

type - the type to allow into the collection, must not be null

Throws:

java.lang.IllegalArgumentException - if list or type is null

java.lang.IllegalArgumentException - if the list contains invalid elements