org.apache.catalina.core

Class NamingContextListener

Implemented Interfaces:
ContainerListener, LifecycleListener, PropertyChangeListener

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

Helper class used to initialize and populate the JNDI context associated with each context and server.

Version:
$Revision: 1.6.2.1 $ $Date: 2004/10/29 14:01:20 $

Author:
Remy Maucherat

Field Summary

protected javax.naming.Context
compCtx
Comp context.
protected Object
container
Associated container.
protected int
debug
Debugging level.
protected javax.naming.Context
envCtx
Env context.
protected boolean
initialized
Initialized flag.
protected String
name
Name of the associated naming context.
protected NamingContext
namingContext
Associated JNDI context.
protected NamingResources
namingResources
Associated naming resources.
protected static StringManager
sm
The string manager for this package.

Constructor Summary

NamingContextListener()
Create a new naming context listener.

Method Summary

void
addEjb(ContextEjb ejb)
Set the specified EJBs in the naming context.
void
addEnvironment(ContextEnvironment env)
Set the specified environment entries in the naming context.
void
addLocalEjb(ContextLocalEjb localEjb)
Set the specified local EJBs in the naming context.
void
addResource(ContextResource resource)
Set the specified resources in the naming context.
void
addResourceEnvRef(String name, String type)
Set the specified resources in the naming context.
void
addResourceLink(ContextResourceLink resourceLink)
Set the specified resource link in the naming context.
void
containerEvent(ContainerEvent event)
Acknowledge the occurrence of the specified event.
int
getDebug()
Return the "debug" property.
String
getName()
Return the "name" property.
NamingContext
getNamingContext()
Return the associated naming context.
void
lifecycleEvent(LifecycleEvent event)
Acknowledge the occurrence of the specified event.
protected void
log(String message)
Log the specified message to our current Logger (if any).
protected void
log(String message, Throwable throwable)
Log the specified message and exception to our current Logger (if any).
protected String
logName()
Return the abbreviated name of this container for logging messsages
void
propertyChange(PropertyChangeEvent event)
Process property change events.
void
removeEjb(String name)
Set the specified EJBs in the naming context.
void
removeEnvironment(String name)
Set the specified environment entries in the naming context.
void
removeLocalEjb(String name)
Set the specified local EJBs in the naming context.
void
removeResource(String name)
Set the specified resources in the naming context.
void
removeResourceEnvRef(String name)
Set the specified resources in the naming context.
void
removeResourceLink(String name)
Set the specified resources in the naming context.
void
setDebug(int debug)
Set the "debug" property.
void
setName(String name)
Set the "name" property.

Field Details

compCtx

protected javax.naming.Context compCtx
Comp context.


container

protected Object container
Associated container.


debug

protected int debug
Debugging level.


envCtx

protected javax.naming.Context envCtx
Env context.


initialized

protected boolean initialized
Initialized flag.


name

protected String name
Name of the associated naming context.


namingContext

protected NamingContext namingContext
Associated JNDI context.


namingResources

protected NamingResources namingResources
Associated naming resources.


sm

protected static StringManager sm
The string manager for this package.

Constructor Details

NamingContextListener

public NamingContextListener()
Create a new naming context listener.

Method Details

addEjb

public void addEjb(ContextEjb ejb)
Set the specified EJBs in the naming context.


addEnvironment

public void addEnvironment(ContextEnvironment env)
Set the specified environment entries in the naming context.


addLocalEjb

public void addLocalEjb(ContextLocalEjb localEjb)
Set the specified local EJBs in the naming context.


addResource

public void addResource(ContextResource resource)
Set the specified resources in the naming context.


addResourceEnvRef

public void addResourceEnvRef(String name,
                              String type)
Set the specified resources in the naming context.


addResourceLink

public void addResourceLink(ContextResourceLink resourceLink)
Set the specified resource link in the naming context.


containerEvent

public void containerEvent(ContainerEvent event)
Acknowledge the occurrence of the specified event. Note: Will never be called when the listener is associated to a Server, since it is not a Container.
Specified by:
containerEvent in interface ContainerListener

Parameters:
event - ContainerEvent that has occurred


getDebug

public int getDebug()
Return the "debug" property.


getName

public String getName()
Return the "name" property.


getNamingContext

public NamingContext getNamingContext()
Return the associated naming context.


lifecycleEvent

public void lifecycleEvent(LifecycleEvent event)
Acknowledge the occurrence of the specified event.
Specified by:
lifecycleEvent in interface LifecycleListener

Parameters:
event - LifecycleEvent that has occurred


log

protected void log(String message)
Log the specified message to our current Logger (if any).

Parameters:
message - Message to be logged


log

protected void log(String message,
                   Throwable throwable)
Log the specified message and exception to our current Logger (if any).

Parameters:
message - Message to be logged
throwable - Related exception


logName

protected String logName()
Return the abbreviated name of this container for logging messsages


propertyChange

public void propertyChange(PropertyChangeEvent event)
Process property change events. Currently, only listens to such events on the NamingResources instance for the global naming resources.

Parameters:
event - The property change event that has occurred


removeEjb

public void removeEjb(String name)
Set the specified EJBs in the naming context.


removeEnvironment

public void removeEnvironment(String name)
Set the specified environment entries in the naming context.


removeLocalEjb

public void removeLocalEjb(String name)
Set the specified local EJBs in the naming context.


removeResource

public void removeResource(String name)
Set the specified resources in the naming context.


removeResourceEnvRef

public void removeResourceEnvRef(String name)
Set the specified resources in the naming context.


removeResourceLink

public void removeResourceLink(String name)
Set the specified resources in the naming context.


setDebug

public void setDebug(int debug)
Set the "debug" property.

Parameters:
debug - The new debug level


setName

public void setName(String name)
Set the "name" property.

Parameters:
name - The new name


Copyright B) 2000-2003 Apache Software Foundation. All Rights Reserved.