public SetRootRule(String methodName) 
{
        this(methodName, null);
}

Construct a "set root" rule with the specified method name. The method's argument type is assumed to be the class of the child object.

Parameters:

methodName - Method name of the parent method to call

 public SetRootRule(Digester digester,
    String methodName) 
{
        this(methodName);
}

Construct a "set root" rule with the specified method name. The method's argument type is assumed to be the class of the child object.

Parameters:

digester - The associated Digester

methodName - Method name of the parent method to call

 public SetRootRule(String methodName,
    String paramType) 
{
        this.methodName = methodName;
        this.paramType = paramType;
}

Construct a "set root" rule with the specified method name.

Parameters:

methodName - Method name of the parent method to call

paramType - 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)

 public SetRootRule(Digester digester,
    String methodName,
    String paramType) 
{
        this(methodName, paramType);
}

Construct a "set root" rule with the specified method name.

Parameters:

digester - The associated Digester

methodName - Method name of the parent method to call

paramType - 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)

 public  void end() throws Exception 
{
        // Identify the objects to be used
        Object child = digester.peek(0);
        Object parent = digester.root;
        if (digester.log.isDebugEnabled()) {
            if (parent == null) {
                digester.log.debug("[SetRootRule]{" + digester.match +
                        "} Call [NULL ROOT]." +
                        methodName + "(" + child + ")");
            } else {
                digester.log.debug("[SetRootRule]{" + digester.match +
                        "} Call " + parent.getClass().getName() + "." +
                        methodName + "(" + child + ")");
            }
        }
        // Call the specified method
        Class paramTypes[] = new Class[1];
        if (paramType != null) {
            paramTypes[0] =
                    digester.getClassLoader().loadClass(paramType);
        } else {
            paramTypes[0] = child.getClass();
        }
        if (useExactMatch) {
            MethodUtils.invokeExactMethod(parent, methodName,
                new Object[]{ child }, paramTypes);
        } else {
            MethodUtils.invokeMethod(parent, methodName,
                new Object[]{ child }, paramTypes);
        }
}

Process the end of this element.

 public boolean isExactMatch() 
{
    // --------------------------------------------------------- Public Methods
        return useExactMatch;
}

Is exact matching being used.

This rule uses org.apache.commons.beanutils.MethodUtils to introspect the relevent objects so that the right method can be called. Originally, MethodUtils.invokeExactMethod was used. This matches methods very strictly and so may not find a matching method when one exists. This is still the behaviour when exact matching is enabled.

When exact matching is disabled, MethodUtils.invokeMethod is used. This method finds more methods but is less precise when there are several methods with correct signatures. So, if you want to choose an exact signature you might need to enable this property.

The default setting is to disable exact matches.

 public  void setExactMatch(boolean useExactMatch) 
{
        this.useExactMatch = useExactMatch;
}

Set whether exact matching is enabled.

See #isExactMatch() .

 public String toString() 
{
        StringBuffer sb = new StringBuffer("SetRootRule[");
        sb.append("methodName=");
        sb.append(methodName);
        sb.append(", paramType=");
        sb.append(paramType);
        sb.append("]");
        return (sb.toString());
}

Render a printable version of this Rule.