org.apache.commons.digester.plugins

Class RuleLoader

java.lang.Object

org.apache.commons.digester.plugins.RuleLoader

Direct Known Subclasses:

LoaderFromClass, LoaderFromStream, LoaderSetProperties

public abstract class RuleLoader
extends java.lang.Object

Interface for classes which can dynamically load custom plugin rules associated with a user's plugin class.

Each plugin declaration has an associated RuleLoader instance, and that instance's addRules method is invoked each time the input xml specifies that an instance of that plugged-in class is to be created.

This is an abstract class rather than an interface in order to make it possible to enhance this class in future without breaking binary compatibility; it is possible to add methods to an abstract class, but not to an interface.

Since:

1.6

Constructor Summary

Constructors

Constructor and Description
RuleLoader()

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	addRules(Digester d, java.lang.String path) Configures the digester with custom rules for some plugged-in class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RuleLoader

public RuleLoader()

Method Detail

addRules

public abstract void addRules(Digester d,
            java.lang.String path)
                       throws PluginException

Configures the digester with custom rules for some plugged-in class.

This method is invoked when the start of an xml tag is encountered which maps to a PluginCreateRule. Any rules added here are removed from the digester when the end of that xml tag is encountered.

Throws:

PluginException