NullIsExceptionPredicate (Commons Collections 3.2.2 API)

java.lang.Object
- org.apache.commons.collections.functors.NullIsExceptionPredicate

All Implemented Interfaces:

Serializable, PredicateDecorator, Predicate
```
public final class NullIsExceptionPredicate
extends Object
implements Predicate, PredicateDecorator, Serializable
```
Predicate implementation that throws an exception if the input is null.

Since:

Commons Collections 3.0

Version:

$Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $

Author:

Stephen Colebourne

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor Description

NullIsExceptionPredicate(Predicate predicate)
Constructor that performs no validation.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`boolean`	`evaluate(Object object)`	Evaluates the predicate returning the result of the decorated predicate once a null check is performed.
`static Predicate`	`getInstance(Predicate predicate)`	Factory to create the null exception predicate.
`Predicate[]`	`getPredicates()`	Gets the predicate being decorated.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - NullIsExceptionPredicate
```
public NullIsExceptionPredicate(Predicate predicate)
```
    Constructor that performs no validation. Use getInstance if you want that.
    
    Parameters:
    
    predicate - the predicate to call after the null check
- Method Detail
  - getInstance
```
public static Predicate getInstance(Predicate predicate)
```
    Factory to create the null exception predicate.
    
    Parameters:
    
    predicate - the predicate to decorate, not null
    
    Returns:
    
    the predicate
    
    Throws:
    
    IllegalArgumentException - if the predicate is null
  - evaluate
```
public boolean evaluate(Object object)
```
    Evaluates the predicate returning the result of the decorated predicate once a null check is performed.
    
    Specified by:
    
    evaluate in interface Predicate
    
    Parameters:
    
    object - the input object
    
    Returns:
    
    true if decorated predicate returns true
    
    Throws:
    
    FunctorException - if input is null
  - getPredicates
```
public Predicate[] getPredicates()
```
    Gets the predicate being decorated.
    
    Specified by:
    
    getPredicates in interface PredicateDecorator
    
    Returns:
    
    the predicate as the only element in an array
    
    Since:
    
    Commons Collections 3.1