org.apache.tomcat.util.digester

Class Rule

public abstract class Rule extends Object

Concrete implementations of this class implement actions to be taken when a corresponding nested pattern of XML elements has been matched.
Field Summary
protected Digesterdigester
The Digester with which this Rule is associated.
protected StringnamespaceURI
The namespace URI for which this Rule is relevant, if any.
Constructor Summary
Rule(Digester digester)
Constructor sets the associated Digester.
Rule()

Base constructor.

Method Summary
voidbegin(Attributes attributes)
This method is called when the beginning of a matching XML element is encountered.
voidbegin(String namespace, String name, Attributes attributes)
This method is called when the beginning of a matching XML element is encountered.
voidbody(String text)
This method is called when the body of a matching XML element is encountered.
voidbody(String namespace, String name, String text)
This method is called when the body of a matching XML element is encountered.
voidend()
This method is called when the end of a matching XML element is encountered.
voidend(String namespace, String name)
This method is called when the end of a matching XML element is encountered.
voidfinish()
This method is called after all parsing methods have been called, to allow Rules to remove temporary data.
DigestergetDigester()
Return the Digester with which this Rule is associated.
StringgetNamespaceURI()
Return the namespace URI for which this Rule is relevant, if any.
voidsetDigester(Digester digester)
Set the Digester with which this Rule is associated.
voidsetNamespaceURI(String namespaceURI)
Set the namespace URI for which this Rule is relevant, if any.

Field Detail

digester

protected Digester digester
The Digester with which this Rule is associated.

namespaceURI

protected String namespaceURI
The namespace URI for which this Rule is relevant, if any.

Constructor Detail

Rule

public Rule(Digester digester)

Deprecated: The digester instance is now set in the Digester method. Use Rule instead.

Constructor sets the associated Digester.

Parameters: digester The digester with which this rule is associated

Rule

public Rule()

Base constructor. Now the digester will be set when the rule is added.

Method Detail

begin

public void begin(Attributes attributes)

Deprecated: Use the begin method with namespace and name parameters instead.

This method is called when the beginning of a matching XML element is encountered.

Parameters: attributes The attribute list of this element

begin

public void begin(String namespace, String name, Attributes attributes)
This method is called when the beginning of a matching XML element is encountered. The default implementation delegates to the deprecated method begin without the namespace and name parameters, to retain backwards compatibility.

Parameters: namespace the namespace URI of the matching element, or an empty string if the parser is not namespace aware or the element has no namespace name the local name if the parser is namespace aware, or just the element name otherwise attributes The attribute list of this element

Since: Digester 1.4

body

public void body(String text)

Deprecated: Use the body method with namespace and name parameters instead.

This method is called when the body of a matching XML element is encountered. If the element has no body, this method is not called at all.

Parameters: text The text of the body of this element

body

public void body(String namespace, String name, String text)
This method is called when the body of a matching XML element is encountered. If the element has no body, this method is not called at all. The default implementation delegates to the deprecated method body without the namespace and name parameters, to retain backwards compatibility.

Parameters: namespace the namespace URI of the matching element, or an empty string if the parser is not namespace aware or the element has no namespace name the local name if the parser is namespace aware, or just the element name otherwise text The text of the body of this element

Since: Digester 1.4

end

public void end()

Deprecated: Use the end method with namespace and name parameters instead.

This method is called when the end of a matching XML element is encountered.

end

public void end(String namespace, String name)
This method is called when the end of a matching XML element is encountered. The default implementation delegates to the deprecated method end without the namespace and name parameters, to retain backwards compatibility.

Parameters: namespace the namespace URI of the matching element, or an empty string if the parser is not namespace aware or the element has no namespace name the local name if the parser is namespace aware, or just the element name otherwise

Since: Digester 1.4

finish

public void finish()
This method is called after all parsing methods have been called, to allow Rules to remove temporary data.

getDigester

public Digester getDigester()
Return the Digester with which this Rule is associated.

getNamespaceURI

public String getNamespaceURI()
Return the namespace URI for which this Rule is relevant, if any.

setDigester

public void setDigester(Digester digester)
Set the Digester with which this Rule is associated.

setNamespaceURI

public void setNamespaceURI(String namespaceURI)
Set the namespace URI for which this Rule is relevant, if any.

Parameters: namespaceURI Namespace URI for which this Rule is relevant, or null to match independent of namespace.

Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.