com.opensymphony.xwork.util
Class InstantiatingNullHandler
java.lang.Object
com.opensymphony.xwork.util.InstantiatingNullHandler
- All Implemented Interfaces:
- ognl.NullHandler
public class InstantiatingNullHandler
- extends java.lang.Object
- implements ognl.NullHandler
Provided that the key CREATE_NULL_OBJECTS
is in the action context with a value of true (this key is set
only during the execution of the ParametersInterceptor
), OGNL expressions
that have caused a NullPointerException will be temporarily stopped for evaluation while the system automatically
tries to solve the null references by automatically creating the object.
The following rules are used when handling null references:
- If the property is declared exactly as a
Collection
or List
, then an ArrayList shall be
returned and assigned to the null references.
- If the property is declared as a
Map
, then a HashMap will be returned and assigned to the null
references.
- If the null property is a simple bean with a no-arg constructor, it will simply be created using the
ObjectFactory.buildBean(java.lang.Class, java.util.Map)
method.
For example, if a form element has a text field named person.name and the expression person evaluates
to null, then this class will be invoked. Because the person expression evaluates to a Person class, a
new Person is created and assigned to the null reference. Finally, the name is set on that object and the overall
effect is that the system automatically created a Person object for you, set it by calling setPerson() and then
finally called getPerson().setName() as you would typically expect.
Method Summary |
java.lang.Object |
nullMethodResult(java.util.Map context,
java.lang.Object target,
java.lang.String methodName,
java.lang.Object[] args)
|
java.lang.Object |
nullPropertyValue(java.util.Map context,
java.lang.Object target,
java.lang.Object property)
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
CREATE_NULL_OBJECTS
public static final java.lang.String CREATE_NULL_OBJECTS
- See Also:
- Constant Field Values
InstantiatingNullHandler
public InstantiatingNullHandler()
nullMethodResult
public java.lang.Object nullMethodResult(java.util.Map context,
java.lang.Object target,
java.lang.String methodName,
java.lang.Object[] args)
- Specified by:
nullMethodResult
in interface ognl.NullHandler
nullPropertyValue
public java.lang.Object nullPropertyValue(java.util.Map context,
java.lang.Object target,
java.lang.Object property)
- Specified by:
nullPropertyValue
in interface ognl.NullHandler