org.apache.catalina.startup
Class LifecycleListenerRule

java.lang.Object
  org.apache.tomcat.util.digester.Rule
      org.apache.catalina.startup.LifecycleListenerRule

public class LifecycleListenerRule
extends Rule

Rule that creates a new LifecycleListener and associates it with the top object on the stack which must implement Container. The implementation class to be used is determined by:

1. Does the top element on the stack specify an implementation class using the attribute specified when this rule was created?
2. Does the parent Container of the Container on the top of the stack specify an implementation class using the attribute specified when this rule was created?
3. Use the default implementation class specified when this rule was created.

Field Summary

Fields inherited from class org.apache.tomcat.util.digester.Rule

digester, namespaceURI

Constructor Summary

LifecycleListenerRule(String listenerClass, String attributeName)
Construct a new instance of this Rule.

Method Summary

void	begin(String namespace, String name, Attributes attributes) Handle the beginning of an XML element.

Methods inherited from class org.apache.tomcat.util.digester.Rule

begin, body, body, end, end, finish, getDigester, getNamespaceURI, setDigester, setNamespaceURI

Methods inherited from class java.lang.Object

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

Constructor Detail

LifecycleListenerRule

public LifecycleListenerRule(String listenerClass,
                             String attributeName)

Construct a new instance of this Rule.

Parameters:

listenerClass - Default name of the LifecycleListener implementation class to be created

attributeName - Name of the attribute that optionally includes an override name of the LifecycleListener class

Method Detail

begin

public void begin(String namespace,
                  String name,
                  Attributes attributes)
           throws Exception

Handle the beginning of an XML element.

Overrides:

begin in class Rule

Parameters:

attributes - The attributes of this element

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

Throws:

Exception - if a processing error occurs