⇒ Index (Frames) |  ⇒ Index (No Frames) |  ⇒ Package |  ⇒ Package Tree |  ⇒ Full Tree 
org.apache.commons.collections.bag

Class TypedBag

java.lang.Object
|
+--org.apache.commons.collections.bag.TypedBag


public class TypedBag
extends java.lang.Object

Decorates another Bag 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
Authors:
Stephen Colebourne
Matthew Hawthorne

Constructor Summary

TypedBag()

Restrictive constructor.

Method Summary

static Bag

decorate(Bag bag, Class type)

Factory method to create a typed bag.

Constructor Details

TypedBag

protected TypedBag()

Restrictive constructor.

Method Details

decorate

public static Bag decorate(Bag bag, Class type)

Factory method to create a typed 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
Throws:
- if bag or type is null
- if the bag contains invalid elements