The <Listener> (o.a.c.LifecycleListener) can be imbedded in various containers.
It is mentioned in the engine.xml, host.xml, context.xml and defaultcontext.xml,
and is actually used in the current conf/server.xml, but there is not a page
about it. This one is a bit sketchy but at least provides some coverage.

Ian
<?xml version="1.0"?>
<!DOCTYPE document [
  <!ENTITY project SYSTEM "project.xml">
]>
<document>

  &project;

  <properties>
    <author email="[EMAIL PROTECTED]">Ian F. Darwin</author>
    <title>The Listener Component</title>
  </properties>

<body>


<section name="Introduction">

  <p>A <strong>Listener</strong> element represents a "life cycle listener"
  for use within a container; it will be notified of lifecycle events,
  and may be used for management or other purposes.</p>

</section>


<section name="Attributes">

  <subsection name="Common Attributes">

  <p>All implementations of <strong>Listener</strong>
  support the following attributes:</p>

  <attributes>
    <attribute name="className" required="true">
      <p>Java class name of the implementation to use.  This class must
      implement the <code>org.apache.catalina.LifeCycleListener</code> 
      interface.</p>
    </attribute>
    <attribute name="debug" required="false">
      <p>The level of debugging output. The value zero means none;
      postitive numbers increase the verbosity.</p>
    </attribute>
  </attributes>

  </subsection>

  <subsection name="Standard Implementation">

  <p>The standard implementation of <strong>LifeCycleListener</strong> is
  provided by two MBean classes:
  <strong>org.apache.catalina.mbeans.ServerLifecycleListener</strong>
  and
  <strong>org.apache.catalina.mbeans.GlobalResourcesLifecycleListener</strong>.
  These support the following additional attributes (in addition to the
  common attributes listed above):</p>

  <attributes/>

  </subsection>

</section>


<section name="Nested Components">

  <p>None.</p>

</section>


<section name="Special Features">

  <p>There are no special features associated with a <strong>Listener</strong>.
  </p>

</section>


</body>

</document>
--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to