Class TypedBag


  • @Deprecated(since="2021-04-30")
    public class TypedBag
    extends java.lang.Object
    Deprecated.
    Commons Collections 3 is in maintenance mode. Commons Collections 4 should be used instead.
    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
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static Bag decorate​(Bag bag, java.lang.Class type)
      Deprecated.
      Factory method to create a typed bag.
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • decorate

        public static Bag decorate​(Bag bag,
                                   java.lang.Class type)
        Deprecated.
        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:
        java.lang.IllegalArgumentException - if bag or type is null
        java.lang.IllegalArgumentException - if the bag contains invalid elements