Class BeanPropertyValueEqualsPredicate<T,V> 
- Type Parameters:
- T- The type of the input to the predicate.
- V- The property value type.
- All Implemented Interfaces:
- Predicate<T>
 Predicate that evaluates a property value against a specified value.
 
 An implementation of Predicate that evaluates a property value on the object provided against a specified value and returns
 true if equal; false otherwise. The BeanPropertyValueEqualsPredicate constructor takes two parameters which determine what property
 will be evaluated on the target object and what its expected value should be.
 
-  public BeanPropertyValueEqualsPredicate( String propertyName, Object propertyValue )
- Will create a Predicatethat will evaluate the target object and returntrue</code> if the property specified by <code>propertyNamehas a value which is equal to the value specified bypropertyValue. Or returnfalseotherwise.
 Note: Property names can be a simple, nested, indexed, or mapped property as defined by
 org.apache.commons.beanutils2.PropertyUtils.  If any object in the property path
 specified by propertyName</code> is <code>null then the outcome is based on the
 value of the ignoreNull attribute.
 
A typical usage might look like:
 // create the closure
 BeanPropertyValueEqualsPredicate predicate =
    new BeanPropertyValueEqualsPredicate( "activeEmployee", Boolean.FALSE );
 // filter the Collection
 CollectionUtils.filter( peopleCollection, predicate );
 
 This would take a Collection of person objects and filter out any people whose
 activeEmployee</code> property is <code>false. Assuming...
 
- 
       The top level object in the peopleCollectionis an object which represents a person.
- 
       The person object has a getActiveEmployee()method which returns the boolean value for the object'sactiveEmployeeproperty.
Another typical usage might look like:
 // create the closure
 BeanPropertyValueEqualsPredicate predicate =
    new BeanPropertyValueEqualsPredicate( "personId", "456-12-1234" );
 // search the Collection
 CollectionUtils.find( peopleCollection, predicate );
 
 This would search a Collection of person objects and return the first object whose
 personId</code> property value equals <code>456-12-1234. Assuming...
 
- The top level object in the peopleCollectionis an object which represents a person.
- The person object has a getPersonId()method which returns the value for the object'spersonIdproperty.
- See Also:
- 
Constructor SummaryConstructorsConstructorDescriptionBeanPropertyValueEqualsPredicate(String propertyName, V propertyValue) Constructor which takes the name of the property, its expected value to be used in evaluation, and assumesignoreNull</code> to be <code>false.BeanPropertyValueEqualsPredicate(String propertyName, V propertyValue, boolean ignoreNull) Constructor which takes the name of the property, its expected value to be used in evaluation, and a boolean which determines whethernullobjects in the property path will generate anIllegalArgumentExceptionor not.
- 
Method SummaryModifier and TypeMethodDescriptionprotected booleanevaluateValue(V expected, Object actual) Utility method which evaluates whether the actual property value equals the expected property value.Returns the name of the property which will be evaluated when thisPredicateis executed.Returns the value that the property specified bypropertyNamewill be compared to when thisPredicateexecutes.booleanReturns the flag which determines whethernullobjects in the property path will generate anIllegalArgumentException</code> or not. If set to <code>truethen if any objects in the property path evaluate tonullthen theIllegalArgumentException</code> throw by <code>PropertyUtilswill be logged but not re-thrown andfalse</code> will be returned. If set to <code>falsethen if any objects in the property path evaluate tonullthen theIllegalArgumentException</code> throw by <code>PropertyUtilswill be logged and re-thrown.booleanEvaluates the object provided against the criteria specified when thisBeanPropertyValueEqualsPredicatewas constructed.
- 
Constructor Details- 
BeanPropertyValueEqualsPredicateConstructor which takes the name of the property, its expected value to be used in evaluation, and assumesignoreNull</code> to be <code>false.- Parameters:
- propertyName- The name of the property that will be evaluated against the expected value.
- propertyValue- The value to use in object evaluation.
- Throws:
- IllegalArgumentException- If the property name provided is null or empty.
 
- 
BeanPropertyValueEqualsPredicateConstructor which takes the name of the property, its expected value to be used in evaluation, and a boolean which determines whethernullobjects in the property path will generate anIllegalArgumentExceptionor not.- Parameters:
- propertyName- The name of the property that will be evaluated against the expected value.
- propertyValue- The value to use in object evaluation.
- ignoreNull- Determines whether- nullobjects in the property path will generate an- IllegalArgumentExceptionor not.
- Throws:
- IllegalArgumentException- If the property name provided is null or empty.
 
 
- 
- 
Method Details- 
evaluateValueUtility method which evaluates whether the actual property value equals the expected property value.- Parameters:
- expected- The expected value.
- actual- The actual value.
- Returns:
- True if they are equal; false otherwise.
 
- 
getPropertyNameReturns the name of the property which will be evaluated when thisPredicateis executed.- Returns:
- The name of the property which will be evaluated when this Predicateis executed.
 
- 
getPropertyValueReturns the value that the property specified bypropertyNamewill be compared to when thisPredicateexecutes.- Returns:
- The value that the property specified by propertyNamewill be compared to when thisPredicateexecutes.
 
- 
isIgnoreNullReturns the flag which determines whethernullobjects in the property path will generate anIllegalArgumentException</code> or not. If set to <code>truethen if any objects in the property path evaluate tonullthen theIllegalArgumentException</code> throw by <code>PropertyUtilswill be logged but not re-thrown andfalse</code> will be returned. If set to <code>falsethen if any objects in the property path evaluate tonullthen theIllegalArgumentException</code> throw by <code>PropertyUtilswill be logged and re-thrown.- Returns:
- The flag which determines whether nullobjects in the property path will generate anIllegalArgumentExceptionor not.
 
- 
testEvaluates the object provided against the criteria specified when thisBeanPropertyValueEqualsPredicatewas constructed. Equality is based on either reference or logical equality as defined by the property object's equals method. If any object in the property path leading up to the target property isnullthen the outcome will be based on the value of theignoreNullattribute. By default,ignoreNull</code> is <code>falseand would result in anIllegalArgumentExceptionif an object in the property path leading up to the target property isnull. @param object The object to be evaluated. @return True if the object provided meets all the criteria for thisPredicate; false otherwise.- Specified by:
- testin interface- Predicate<T>
- Throws:
- IllegalArgumentException- If an IllegalAccessException, InvocationTargetException, or NoSuchMethodException is thrown when trying to access the property specified on the object provided. Or if an object in the property path provided is- nulland- ignoreNull</code> is set to <code>false.
 
 
-