public class SetNextRule extends AbstractMethodRule
Rule implementation that calls a method on the (top-1) (parent) object, passing the top object (child) as an argument. It is commonly used to establish parent-child relationships.
This rule now supports more flexible method matching by default. It is possible that this may break (some) code
written against release 1.1.1 or earlier. See AbstractMethodRule.isExactMatch()
for more details.
Note that while CallMethodRule uses commons-beanutils' data-conversion functionality (ConvertUtils class) to convert parameter values into the appropriate type for the parameter to the called method, this rule does not. Needing to use ConvertUtils functionality when building parent-child relationships is expected to be very rare; however if you do need this then instead of using this rule, create a CallMethodRule specifying targetOffset of 1 in the constructor.
fireOnBegin, methodName, paramType, paramTypeName, useExactMatch
Constructor and Description |
---|
SetNextRule(String methodName)
Construct a "set next" rule with the specified method name.
|
SetNextRule(String methodName,
Class<?> paramType)
Construct a "set next" rule with the specified method name.
|
SetNextRule(String methodName,
String paramType)
Construct a "set next" rule with the specified method name.
|
Modifier and Type | Method and Description |
---|---|
protected Object |
getChild()
Returns the argument object of method has to be invoked.
|
protected Object |
getParent()
Returns the target object of method has to be invoked.
|
begin, end, isExactMatch, isFireOnBegin, setExactMatch, setFireOnBegin, toString
body, finish, getDigester, getNamespaceURI, setDigester, setNamespaceURI
public SetNextRule(String methodName)
methodName
- Method name of the parent method to callpublic SetNextRule(String methodName, String paramType)
methodName
- Method name of the parent method to callparamType
- Java class name of the parent method's argument (if you wish to use a primitive type,
specify the corresonding Java wrapper class instead, such as java.lang.Boolean
for a boolean
parameter)public SetNextRule(String methodName, Class<?> paramType)
methodName
- Method name of the parent method to callparamType
- Java class of the parent method's argument (if you wish to use a primitive type, specify the
corresonding Java wrapper class instead, such as java.lang.Boolean
for a
boolean
parameter)protected Object getChild()
getChild
in class AbstractMethodRule
protected Object getParent()
getParent
in class AbstractMethodRule
Copyright © 2001-2013 The Apache Software Foundation. All Rights Reserved.