org.apache.commons.collections.bag

Class TypedSortedBag

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

Author: Stephen Colebourne Matthew Hawthorne

Constructor Summary
protected TypedSortedBag()
Restrictive constructor.
Method Summary
static SortedBagdecorate(SortedBag bag, Class type)
Factory method to create a typed sorted bag.

Constructor Detail

TypedSortedBag

protected TypedSortedBag()
Restrictive constructor.

Method Detail

decorate

public static SortedBag decorate(SortedBag bag, Class 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-2008 Apache Software Foundation. All Rights Reserved.