Package org.apache.commons.beanutils
Class BeanPropertyValueChangeClosure
java.lang.Object
org.apache.commons.beanutils.BeanPropertyValueChangeClosure
- All Implemented Interfaces:
org.apache.commons.collections.Closure
public class BeanPropertyValueChangeClosure
extends Object
implements org.apache.commons.collections.Closure
Closure
that sets a property.
An implementation of org.apache.commons.collections.Closure
that updates
a specified property on the object provided with a specified value.
The BeanPropertyValueChangeClosure
constructor takes two parameters which determine
what property will be updated and with what value.
-
public BeanPropertyValueChangeClosure( String propertyName, Object propertyValue )
-
Will create a
Closure
that will update an object by setting the property specified bypropertyName
to the value specified bypropertyValue
.
org.apache.commons.beanutils.PropertyUtils
. If any object in the property path
specified by propertyName
is null
then the outcome is based on the
value of the ignoreNull
attribute.
A typical usage might look like:
// create the closure
BeanPropertyValueChangeClosure closure =
new BeanPropertyValueChangeClosure( "activeEmployee", Boolean.TRUE );
// update the Collection
CollectionUtils.forAllDo( peopleCollection, closure );
This would take a Collection
of person objects and update the
activeEmployee
property of each object in the Collection
to
true
. Assuming...
-
The top level object in the
peopleCollection
is an object which represents a person. -
The person object has a
setActiveEmployee( boolean )
method which updates the value for the object'sactiveEmployee
property.
- Version:
- $Id$
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate boolean
Determines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not.private final org.apache.commons.logging.Log
For logging.private String
The name of the property which will be updated when thisClosure
executes.private Object
The value that the property specified bypropertyName
will be updated to when thisClosure
executes. -
Constructor Summary
ConstructorsConstructorDescriptionBeanPropertyValueChangeClosure
(String propertyName, Object propertyValue) Constructor which takes the name of the property to be changed, the new value to set the property to, and assumesignoreNull
to befalse
.BeanPropertyValueChangeClosure
(String propertyName, Object propertyValue, boolean ignoreNull) Constructor which takes the name of the property to be changed, the new value to set the property to and a boolean which determines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Updates the target object provided using the property update criteria provided when thisBeanPropertyValueChangeClosure
was constructed.Returns the name of the property which will be updated when thisClosure
executes.Returns the value that the property specified bypropertyName
will be updated to when thisClosure
executes.boolean
Returns the flag that determines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not.
-
Field Details
-
log
private final org.apache.commons.logging.Log logFor logging. -
propertyName
The name of the property which will be updated when thisClosure
executes. -
propertyValue
The value that the property specified bypropertyName
will be updated to when thisClosure
executes. -
ignoreNull
private boolean ignoreNullDetermines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not. If set totrue
then if any objects in the property path leading up to the target property evaluate tonull
then theIllegalArgumentException
throw byPropertyUtils
will be logged but not rethrown. If set tofalse
then if any objects in the property path leading up to the target property evaluate tonull
then theIllegalArgumentException
throw byPropertyUtils
will be logged and rethrown.
-
-
Constructor Details
-
BeanPropertyValueChangeClosure
Constructor which takes the name of the property to be changed, the new value to set the property to, and assumesignoreNull
to befalse
.- Parameters:
propertyName
- The name of the property that will be updated with the value specified bypropertyValue
.propertyValue
- The value thatpropertyName
will be set to on the target object.- Throws:
IllegalArgumentException
- If the propertyName provided is null or empty.
-
BeanPropertyValueChangeClosure
public BeanPropertyValueChangeClosure(String propertyName, Object propertyValue, boolean ignoreNull) Constructor which takes the name of the property to be changed, the new value to set the property to and a boolean which determines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not.- Parameters:
propertyName
- The name of the property that will be updated with the value specified bypropertyValue
.propertyValue
- The value thatpropertyName
will be set to on the target object.ignoreNull
- Determines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not.- Throws:
IllegalArgumentException
- If the propertyName provided is null or empty.
-
-
Method Details
-
execute
Updates the target object provided using the property update criteria provided when thisBeanPropertyValueChangeClosure
was constructed. If any object in the property path leading up to the target property isnull
then the outcome will be based on the value of theignoreNull
attribute. By default,ignoreNull
isfalse
and would result in anIllegalArgumentException
if an object in the property path leading up to the target property isnull
.- Specified by:
execute
in interfaceorg.apache.commons.collections.Closure
- Parameters:
object
- The object to be updated.- 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 isnull
andignoreNull
is set tofalse
.
-
getPropertyName
Returns the name of the property which will be updated when thisClosure
executes.- Returns:
- The name of the property which will be updated when this
Closure
executes.
-
getPropertyValue
Returns the value that the property specified bypropertyName
will be updated to when thisClosure
executes.- Returns:
- The value that the property specified by
propertyName
will be updated to when thisClosure
executes.
-
isIgnoreNull
public boolean isIgnoreNull()Returns the flag that determines whethernull
objects in the property path will genenerate anIllegalArgumentException
or not. If set totrue
then if any objects in the property path leading up to the target property evaluate tonull
then theIllegalArgumentException
throw byPropertyUtils
will be logged but not rethrown. If set tofalse
then if any objects in the property path leading up to the target property evaluate tonull
then theIllegalArgumentException
throw byPropertyUtils
will be logged and rethrown.- Returns:
- The flag that determines whether
null
objects in the property path will genenerate anIllegalArgumentException
or not.
-