public class PredicateUtils extends Object
PredicateUtils
provides reference implementations and utilities
for the Predicate functor interface. The supplied predicates are:
Constructor and Description |
---|
PredicateUtils()
This class is not normally instantiated.
|
Modifier and Type | Method and Description |
---|---|
static Predicate |
allPredicate(Collection predicates)
Create a new Predicate that returns true only if all of the specified
predicates are true.
|
static Predicate |
allPredicate(Predicate[] predicates)
Create a new Predicate that returns true only if all of the specified
predicates are true.
|
static Predicate |
andPredicate(Predicate predicate1,
Predicate predicate2)
Create a new Predicate that returns true only if both of the specified
predicates are true.
|
static Predicate |
anyPredicate(Collection predicates)
Create a new Predicate that returns true if any of the specified
predicates are true.
|
static Predicate |
anyPredicate(Predicate[] predicates)
Create a new Predicate that returns true if any of the specified
predicates are true.
|
static Predicate |
asPredicate(Transformer transformer)
Create a new Predicate that wraps a Transformer.
|
static Predicate |
eitherPredicate(Predicate predicate1,
Predicate predicate2)
Create a new Predicate that returns true if one, but not both, of the
specified predicates are true.
|
static Predicate |
equalPredicate(Object value)
Creates a Predicate that checks if the input object is equal to the
specified object using equals().
|
static Predicate |
exceptionPredicate()
Gets a Predicate that always throws an exception.
|
static Predicate |
falsePredicate()
Gets a Predicate that always returns false.
|
static Predicate |
identityPredicate(Object value)
Creates a Predicate that checks if the input object is equal to the
specified object by identity.
|
static Predicate |
instanceofPredicate(Class type)
Creates a Predicate that checks if the object passed in is of
a particular type, using instanceof.
|
static Predicate |
invokerPredicate(String methodName)
Creates a Predicate that invokes a method on the input object.
|
static Predicate |
invokerPredicate(String methodName,
Class[] paramTypes,
Object[] args)
Creates a Predicate that invokes a method on the input object.
|
static Predicate |
neitherPredicate(Predicate predicate1,
Predicate predicate2)
Create a new Predicate that returns true if neither of the specified
predicates are true.
|
static Predicate |
nonePredicate(Collection predicates)
Create a new Predicate that returns true if none of the specified
predicates are true.
|
static Predicate |
nonePredicate(Predicate[] predicates)
Create a new Predicate that returns true if none of the specified
predicates are true.
|
static Predicate |
notNullPredicate()
Gets a Predicate that checks if the input object passed in is not null.
|
static Predicate |
notPredicate(Predicate predicate)
Create a new Predicate that returns true if the specified predicate
returns false and vice versa.
|
static Predicate |
nullIsExceptionPredicate(Predicate predicate)
Gets a Predicate that throws an exception if the input object is null,
otherwise it calls the specified Predicate.
|
static Predicate |
nullIsFalsePredicate(Predicate predicate)
Gets a Predicate that returns false if the input object is null, otherwise
it calls the specified Predicate.
|
static Predicate |
nullIsTruePredicate(Predicate predicate)
Gets a Predicate that returns true if the input object is null, otherwise
it calls the specified Predicate.
|
static Predicate |
nullPredicate()
Gets a Predicate that checks if the input object passed in is null.
|
static Predicate |
onePredicate(Collection predicates)
Create a new Predicate that returns true if only one of the specified
predicates are true.
|
static Predicate |
onePredicate(Predicate[] predicates)
Create a new Predicate that returns true if only one of the specified
predicates are true.
|
static Predicate |
orPredicate(Predicate predicate1,
Predicate predicate2)
Create a new Predicate that returns true if either of the specified
predicates are true.
|
static Predicate |
transformedPredicate(Transformer transformer,
Predicate predicate)
Creates a predicate that transforms the input object before passing it
to the predicate.
|
static Predicate |
truePredicate()
Gets a Predicate that always returns true.
|
static Predicate |
uniquePredicate()
Creates a Predicate that returns true the first time an object is
encountered, and false if the same object is received
again.
|
public static Predicate exceptionPredicate()
ExceptionPredicate
public static Predicate truePredicate()
TruePredicate
public static Predicate falsePredicate()
FalsePredicate
public static Predicate nullPredicate()
NullPredicate
public static Predicate notNullPredicate()
NotNullPredicate
public static Predicate equalPredicate(Object value)
value
- the value to compare againstEqualPredicate
public static Predicate identityPredicate(Object value)
value
- the value to compare againstIdentityPredicate
public static Predicate instanceofPredicate(Class type)
null
input
object will return false
.type
- the type to check for, may not be nullIllegalArgumentException
- if the class is nullInstanceofPredicate
public static Predicate uniquePredicate()
null
input object
is accepted and will return true the first time, and false subsequently
as well.UniquePredicate
public static Predicate invokerPredicate(String methodName)
For example, PredicateUtils.invokerPredicate("isEmpty");
will call the isEmpty
method on the input object to
determine the predicate result.
methodName
- the method name to call on the input object, may not be nullIllegalArgumentException
- if the methodName is null.InvokerTransformer
,
TransformerPredicate
public static Predicate invokerPredicate(String methodName, Class[] paramTypes, Object[] args)
For example, PredicateUtils.invokerPredicate("isEmpty");
will call the isEmpty
method on the input object to
determine the predicate result.
methodName
- the method name to call on the input object, may not be nullparamTypes
- the parameter typesargs
- the argumentsIllegalArgumentException
- if the method name is nullIllegalArgumentException
- if the paramTypes and args don't matchInvokerTransformer
,
TransformerPredicate
public static Predicate andPredicate(Predicate predicate1, Predicate predicate2)
predicate1
- the first predicate, may not be nullpredicate2
- the second predicate, may not be nulland
predicateIllegalArgumentException
- if either predicate is nullAndPredicate
public static Predicate allPredicate(Predicate[] predicates)
predicates
- an array of predicates to check, may not be nullall
predicateIllegalArgumentException
- if the predicates array is nullIllegalArgumentException
- if any predicate in the array is nullAllPredicate
public static Predicate allPredicate(Collection predicates)
predicates
- a collection of predicates to check, may not be nullall
predicateIllegalArgumentException
- if the predicates collection is nullIllegalArgumentException
- if any predicate in the collection is nullAllPredicate
public static Predicate orPredicate(Predicate predicate1, Predicate predicate2)
predicate1
- the first predicate, may not be nullpredicate2
- the second predicate, may not be nullor
predicateIllegalArgumentException
- if either predicate is nullOrPredicate
public static Predicate anyPredicate(Predicate[] predicates)
predicates
- an array of predicates to check, may not be nullany
predicateIllegalArgumentException
- if the predicates array is nullIllegalArgumentException
- if any predicate in the array is nullAnyPredicate
public static Predicate anyPredicate(Collection predicates)
predicates
- a collection of predicates to check, may not be nullany
predicateIllegalArgumentException
- if the predicates collection is nullIllegalArgumentException
- if any predicate in the collection is nullAnyPredicate
public static Predicate eitherPredicate(Predicate predicate1, Predicate predicate2)
predicate1
- the first predicate, may not be nullpredicate2
- the second predicate, may not be nulleither
predicateIllegalArgumentException
- if either predicate is nullOnePredicate
public static Predicate onePredicate(Predicate[] predicates)
predicates
- an array of predicates to check, may not be nullone
predicateIllegalArgumentException
- if the predicates array is nullIllegalArgumentException
- if any predicate in the array is nullOnePredicate
public static Predicate onePredicate(Collection predicates)
predicates
- a collection of predicates to check, may not be nullone
predicateIllegalArgumentException
- if the predicates collection is nullIllegalArgumentException
- if any predicate in the collection is nullOnePredicate
public static Predicate neitherPredicate(Predicate predicate1, Predicate predicate2)
predicate1
- the first predicate, may not be nullpredicate2
- the second predicate, may not be nullneither
predicateIllegalArgumentException
- if either predicate is nullNonePredicate
public static Predicate nonePredicate(Predicate[] predicates)
predicates
- an array of predicates to check, may not be nullnone
predicateIllegalArgumentException
- if the predicates array is nullIllegalArgumentException
- if any predicate in the array is nullNonePredicate
public static Predicate nonePredicate(Collection predicates)
predicates
- a collection of predicates to check, may not be nullnone
predicateIllegalArgumentException
- if the predicates collection is nullIllegalArgumentException
- if any predicate in the collection is nullNonePredicate
public static Predicate notPredicate(Predicate predicate)
predicate
- the predicate to notnot
predicateIllegalArgumentException
- if the predicate is nullNotPredicate
public static Predicate asPredicate(Transformer transformer)
transformer
- the transformer to wrap, may not be nullIllegalArgumentException
- if the transformer is nullTransformerPredicate
public static Predicate nullIsExceptionPredicate(Predicate predicate)
predicate
- the predicate to wrap, may not be nullIllegalArgumentException
- if the predicate is null.NullIsExceptionPredicate
public static Predicate nullIsFalsePredicate(Predicate predicate)
predicate
- the predicate to wrap, may not be nullIllegalArgumentException
- if the predicate is null.NullIsFalsePredicate
public static Predicate nullIsTruePredicate(Predicate predicate)
predicate
- the predicate to wrap, may not be nullIllegalArgumentException
- if the predicate is null.NullIsTruePredicate
public static Predicate transformedPredicate(Transformer transformer, Predicate predicate)
transformer
- the transformer to call firstpredicate
- the predicate to call with the result of the transformIllegalArgumentException
- if the transformer or the predicate is nullTransformedPredicate
Copyright © 2001–2015 The Apache Software Foundation. All rights reserved.