Class NonePredicate

  • All Implemented Interfaces:
    Serializable, PredicateDecorator, Predicate

    public final class NonePredicate
    extends Object
    implements Predicate, PredicateDecorator, Serializable
    Predicate implementation that returns true if none of the predicates return true. If the array of predicates is empty, then this predicate returns true.

    NOTE: In versions prior to 3.2 an array size of zero or one threw an exception.

    Since:
    Commons Collections 3.0
    Version:
    $Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $
    Author:
    Stephen Colebourne, Matt Benson
    See Also:
    Serialized Form
    • Constructor Detail

      • NonePredicate

        public NonePredicate​(Predicate[] predicates)
        Constructor that performs no validation. Use getInstance if you want that.
        Parameters:
        predicates - the predicates to check, not cloned, not null
    • Method Detail

      • getInstance

        public static Predicate getInstance​(Predicate[] predicates)
        Factory to create the predicate.

        If the array is size zero, the predicate always returns true.

        Parameters:
        predicates - the predicates to check, cloned, not null
        Returns:
        the any predicate
        Throws:
        IllegalArgumentException - if the predicates array is null
        IllegalArgumentException - if any predicate in the array is null
      • getInstance

        public static Predicate getInstance​(Collection predicates)
        Factory to create the predicate.

        If the collection is size zero, the predicate always returns true.

        Parameters:
        predicates - the predicates to check, cloned, not null
        Returns:
        the one predicate
        Throws:
        IllegalArgumentException - if the predicates array is null
        IllegalArgumentException - if any predicate in the array is null
      • evaluate

        public boolean evaluate​(Object object)
        Evaluates the predicate returning false if any stored predicate returns false.
        Specified by:
        evaluate in interface Predicate
        Parameters:
        object - the input object
        Returns:
        true if none of decorated predicates return true
      • getPredicates

        public Predicate[] getPredicates()
        Gets the predicates, do not modify the array.
        Specified by:
        getPredicates in interface PredicateDecorator
        Returns:
        the predicates
        Since:
        Commons Collections 3.1