org.apache.catalina.mbeans
Class ServerLifecycleListener

java.lang.Object
  org.apache.catalina.mbeans.ServerLifecycleListener

All Implemented Interfaces:

java.beans.PropertyChangeListener, java.util.EventListener, ContainerListener, LifecycleListener

public class ServerLifecycleListener
extends java.lang.Object
implements ContainerListener, LifecycleListener, java.beans.PropertyChangeListener

Implementation of LifecycleListener that instantiates the set of MBeans associated with the components of a running instance of Catalina.

Author:

Craig R. McClanahan, Amy Roh

descriptors

protected java.lang.String descriptors

Semicolon separated list of paths containing MBean desciptor resources.

ServerLifecycleListener

public ServerLifecycleListener()

getDescriptors

public java.lang.String getDescriptors()

setDescriptors

public void setDescriptors(java.lang.String descriptors)

containerEvent

public void containerEvent(ContainerEvent event)

Handle a ContainerEvent from one of the Containers we are interested in.

Specified by:

containerEvent in interface ContainerListener

Parameters:

event - The event that has occurred

lifecycleEvent

public void lifecycleEvent(LifecycleEvent event)

Primary entry point for startup and shutdown events.

Specified by:

lifecycleEvent in interface LifecycleListener

Parameters:

event - The event that has occurred

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent event)

Handle a PropertyChangeEvent from one of the Containers we are interested in.

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

Parameters:

event - The event that has occurred

createMBeans

protected void createMBeans()

Create the MBeans that correspond to every existing node of our tree.

createMBeans

protected void createMBeans(Connector connector)
                     throws java.lang.Exception

Create the MBeans for the specified Connector and its nested components.

Parameters:

connector - Connector for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(Context context)
                     throws java.lang.Exception

Create the MBeans for the specified Context and its nested components.

Parameters:

context - Context for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(ContextEnvironment environment)
                     throws java.lang.Exception

Create the MBeans for the specified ContextEnvironment entry.

Parameters:

environment - ContextEnvironment for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(ContextResource resource)
                     throws java.lang.Exception

Create the MBeans for the specified ContextResource entry.

Parameters:

resource - ContextResource for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(ContextResourceLink resourceLink)
                     throws java.lang.Exception

Create the MBeans for the specified ContextResourceLink entry.

Parameters:

resourceLink - ContextResourceLink for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(Engine engine)
                     throws java.lang.Exception

Create the MBeans for the specified Engine and its nested components.

Parameters:

engine - Engine for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(Host host)
                     throws java.lang.Exception

Create the MBeans for the specified Host and its nested components.

Parameters:

host - Host for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(MBeanFactory factory)
                     throws java.lang.Exception

Create the MBeans for MBeanFactory.

Parameters:

factory - MBeanFactory for which to create MBean

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(NamingResources resources)
                     throws java.lang.Exception

Create the MBeans for the specified NamingResources and its nested components.

Parameters:

resources - NamingResources for which to create MBeans

Throws:

java.lang.Exception

createMBeans

protected void createMBeans(Server server)
                     throws java.lang.Exception

Create the MBeans for the specified Server and its nested components.

Parameters:

server - Server for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

createMBeans

protected void createMBeans(Service service)
                     throws java.lang.Exception

Create the MBeans for the specified Service and its nested components.

Parameters:

service - Service for which to create MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean creation

destroyMBeans

protected void destroyMBeans(Connector connector,
                             Service service)
                      throws java.lang.Exception

Deregister the MBeans for the specified Connector and its nested components.

Parameters:

connector - Connector for which to deregister MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(Context context)
                      throws java.lang.Exception

Deregister the MBeans for the specified Context and its nested components.

Parameters:

context - Context for which to deregister MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(ContextEnvironment environment)
                      throws java.lang.Exception

Deregister the MBeans for the specified ContextEnvironment entry.

Parameters:

environment - ContextEnvironment for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(ContextResource resource)
                      throws java.lang.Exception

Deregister the MBeans for the specified ContextResource entry.

Parameters:

resource - ContextResource for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(ContextResourceLink resourceLink)
                      throws java.lang.Exception

Deregister the MBeans for the specified ContextResourceLink entry.

Parameters:

resourceLink - ContextResourceLink for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(Engine engine)
                      throws java.lang.Exception

Deregister the MBeans for the specified Engine and its nested components.

Parameters:

engine - Engine for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(Host host)
                      throws java.lang.Exception

Deregister the MBeans for the specified Host and its nested components.

Parameters:

host - Host for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(NamingResources resources)
                      throws java.lang.Exception

Deregister the MBeans for the specified NamingResources and its nested components.

Parameters:

resources - NamingResources for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(Server server)
                      throws java.lang.Exception

Deregister the MBeans for the specified Server and its related components.

Parameters:

server - Server for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

destroyMBeans

protected void destroyMBeans(Service service)
                      throws java.lang.Exception

Deregister the MBeans for the specified Service and its nested components.

Parameters:

service - Service for which to destroy MBeans

Throws:

java.lang.Exception - if an exception is thrown during MBean destruction

processContainerAddChild

protected void processContainerAddChild(Container parent,
                                        Container child)

Process the addition of a new child Container to a parent Container.

Parameters:

parent - Parent container

child - Child container

processContainerPropertyChange

protected void processContainerPropertyChange(Container container,
                                              java.lang.String propertyName,
                                              java.lang.Object oldValue,
                                              java.lang.Object newValue)
                                       throws java.lang.Exception

Process a property change event on a Container.

Parameters:

container - The container on which this event occurred

propertyName - The name of the property that changed

oldValue - The previous value (may be null)

newValue - The new value (may be null)

Throws:

java.lang.Exception - if an exception is thrown

processContainerRemoveChild

protected void processContainerRemoveChild(Container parent,
                                           Container child)

Process the removal of a child Container from a parent Container.

Parameters:

parent - Parent container

child - Child container

processNamingResourcesPropertyChange

protected void processNamingResourcesPropertyChange(NamingResources resources,
                                                    java.lang.String propertyName,
                                                    java.lang.Object oldValue,
                                                    java.lang.Object newValue)
                                             throws java.lang.Exception

Process a property change event on a NamingResources.

Parameters:

resources - The global naming resources on which this event occurred

propertyName - The name of the property that changed

oldValue - The previous value (may be null)

newValue - The new value (may be null)

Throws:

java.lang.Exception - if an exception is thrown

processServerPropertyChange

protected void processServerPropertyChange(Server server,
                                           java.lang.String propertyName,
                                           java.lang.Object oldValue,
                                           java.lang.Object newValue)
                                    throws java.lang.Exception

Process a property change event on a Server.

Parameters:

server - The server on which this event occurred

propertyName - The name of the property that changed

oldValue - The previous value (may be null)

newValue - The new value (may be null)

Throws:

java.lang.Exception - if an exception is thrown

processServicePropertyChange

protected void processServicePropertyChange(Service service,
                                            java.lang.String propertyName,
                                            java.lang.Object oldValue,
                                            java.lang.Object newValue)
                                     throws java.lang.Exception

Process a property change event on a Service.

Parameters:

service - The service on which this event occurred

propertyName - The name of the property that changed

oldValue - The previous value (may be null)

newValue - The new value (may be null)

Throws:

java.lang.Exception - if an exception is thrown