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]>