| java.lang.Object | |
| ↳ | org.apache.commons.collections.bag.TypedBag |
Class Overview
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.
Summary
| Protected Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Restrictive constructor.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Factory method to create a typed bag.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Protected Constructors
protected TypedBag ()
Restrictive constructor.
Public Methods
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 |
Returns
- a new typed Bag
Throws
| IllegalArgumentException | if bag or type is null |
|---|---|
| IllegalArgumentException | if the bag contains invalid elements |