org.apache.commons.collections15.bag
Class TypedSortedBag<E>

java.lang.Object
  extended by org.apache.commons.collections15.bag.TypedSortedBag<E>

public class TypedSortedBag<E>
extends Object

Decorates another SortedBag 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: 1.1 $ $Date: 2005/10/11 17:05:19 $
Author:
Stephen Colebourne, Matt Hall, John Watkinson, Matthew Hawthorne

Constructor Summary
protected TypedSortedBag()
          Restrictive constructor.
 
Method Summary
static
<E> SortedBag<E>
decorate(SortedBag<E> bag, Class<E> type)
          Factory method to create a typed sorted bag.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TypedSortedBag

protected TypedSortedBag()
Restrictive constructor.

Method Detail

decorate

public static <E> SortedBag<E> decorate(SortedBag<E> bag,
                                        Class<E> type)
Factory method to create a typed sorted bag.

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

Parameters:
bag - the bag to decorate, must not be null
type - the type to allow into the bag, must not be null
Returns:
a new transformed SortedBag
Throws:
IllegalArgumentException - if bag or type is null
IllegalArgumentException - if the bag contains invalid elements


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