NamingContextListener (Apache Tomcat 9.0.111 API Documentation)
Description: declaration: package: org.apache.catalina.core, class: NamingContextListener

# Class NamingContextListener

java.lang.Object
org.apache.catalina.core.NamingContextListener

All Implemented Interfaces:
  `PropertyChangeListener, EventListener, ContainerListener, LifecycleListener`

public class NamingContextListener extends Object implements LifecycleListener, ContainerListener, PropertyChangeListener
Helper class used to initialize and populate the JNDI context associated with each context and server.

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `protected Context`
  `compCtx`
  Comp context.
  `protected Object`
  `container`
  Associated container.
  `protected 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 NamingResourcesImpl`
  `namingResources`
  Associated naming resources.
  `protected HashMap<String, ObjectName>`
  `objectNames`
  Objectnames Map.
  `protected static final StringManager`
  `sm`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `NamingContextListener()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `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`
  `addMessageDestinationRef(MessageDestinationRef mdr)`
  Set the specified message destination refs in the naming context.
  `void`
  `addResource(ContextResource resource)`
  Set the specified resources in the naming context.
  `void`
  `addResourceEnvRef(ContextResourceEnvRef resourceEnvRef)`
  Set the specified resources in the naming context.
  `void`
  `addResourceLink(ContextResourceLink resourceLink)`
  Set the specified resource link in the naming context.
  `void`
  `addService(ContextService service)`
  Set the specified web service in the naming context.
  `void`
  `containerEvent(ContainerEvent event)`
  Deprecated.
  The `ContainerListener` interface and implementing methods will be removed from this class for Tomcat 10 onwards.
  `protected ObjectName`
  `createObjectName(ContextResource resource)`
  Create an `ObjectName` for this `ContextResource` object.
  `Context`
  `getEnvContext()`
  `boolean`
  `getExceptionOnFailedWrite()`
  `String`
  `getName()`
  `void`
  `lifecycleEvent(LifecycleEvent event)`
  Acknowledge the occurrence of the specified event.
  `void`
  `propertyChange(PropertyChangeEvent event)`
  `void`
  `removeEjb(String name)`
  Remove the specified EJB from the naming context.
  `void`
  `removeEnvironment(String name)`
  Remove the specified environment entry from the naming context.
  `void`
  `removeLocalEjb(String name)`
  Remove the specified local EJB from the naming context.
  `void`
  `removeMessageDestinationRef(String name)`
  Remove the specified message destination ref from the naming context.
  `void`
  `removeResource(String name)`
  Remove the specified resource from the naming context.
  `void`
  `removeResourceEnvRef(String name)`
  Remove the specified resource environment reference from the naming context.
  `void`
  `removeResourceLink(String name)`
  Remove the specified resource link from the naming context.
  `void`
  `removeService(String name)`
  Remove the specified web service from the naming context.
  `void`
  `setExceptionOnFailedWrite(boolean exceptionOnFailedWrite)`
  Controls whether or not an attempt to modify the JNDI context will trigger an exception or if the request will be ignored.
  `void`
  `setName(String name)`
  Set the "name" property.

  ### Methods inherited from class Object

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

- ## Field Details

  - ### sm

    protected static final StringManager sm

  - ### name

    protected String name
    Name of the associated naming context.

  - ### container

    protected Object container
    Associated container.

  - ### initialized

    protected boolean initialized
    Initialized flag.

  - ### namingResources

    protected NamingResourcesImpl namingResources
    Associated naming resources.

  - ### namingContext

    protected NamingContext namingContext
    Associated JNDI context.

  - ### compCtx

    protected Context compCtx
    Comp context.

  - ### envCtx

    protected Context envCtx
    Env context.

  - ### objectNames

    protected HashMap<String, ObjectName> objectNames
    Objectnames Map.

- ## Constructor Details

  - ### NamingContextListener

    public NamingContextListener()

- ## Method Details

  - ### getExceptionOnFailedWrite

    public boolean getExceptionOnFailedWrite()
    Returns:
      whether or not an attempt to modify the JNDI context will trigger an exception or if the request will be ignored.

  - ### setExceptionOnFailedWrite

    public void setExceptionOnFailedWrite(boolean exceptionOnFailedWrite)
    Controls whether or not an attempt to modify the JNDI context will trigger an exception or if the request will be ignored.
    Parameters:
      `exceptionOnFailedWrite` - The new value

  - ### getName

    public String getName()
    Returns:
      the "name" property.

  - ### setName

    public void setName(String name)
    Set the "name" property.
    Parameters:
      `name` - The new name

  - ### getEnvContext

    public Context getEnvContext()
    Returns:
      the naming environment context.

  - ### lifecycleEvent

    public void lifecycleEvent(LifecycleEvent event)
    Description copied from interface: `LifecycleListener`
    Acknowledge the occurrence of the specified event.
    Specified by:
      `lifecycleEvent` in interface `LifecycleListener`
    Parameters:
      `event` - LifecycleEvent that has occurred

  - ### containerEvent

    @Deprecated public void containerEvent(ContainerEvent event)
    Deprecated.
    The `ContainerListener` interface and implementing methods will be removed from this class for Tomcat 10 onwards.
    NO-OP.
    Specified by:
      `containerEvent` in interface `ContainerListener`
    Parameters:
      `event` - ContainerEvent that has occurred

  - ### propertyChange

    public void propertyChange(PropertyChangeEvent event)
    Specified by:
      `propertyChange` in interface `PropertyChangeListener`

  - ### createObjectName

    protected ObjectName createObjectName(ContextResource resource) throws MalformedObjectNameException
    Create an `ObjectName` for this `ContextResource` object.
    Parameters:
      `resource` - The resource
    Returns:
      ObjectName The object name
    Throws:
      `MalformedObjectNameException` - if a name cannot be created

  - ### addEjb

    public void addEjb(ContextEjb ejb)
    Set the specified EJBs in the naming context.
    Parameters:
      `ejb` - the EJB descriptor

  - ### addEnvironment

    public void addEnvironment(ContextEnvironment env)
    Set the specified environment entries in the naming context.
    Parameters:
      `env` - the environment entry

  - ### addLocalEjb

    public void addLocalEjb(ContextLocalEjb localEjb)
    Set the specified local EJBs in the naming context.
    Parameters:
      `localEjb` - the local EJB descriptor (unused)

  - ### addMessageDestinationRef

    public void addMessageDestinationRef(MessageDestinationRef mdr)
    Set the specified message destination refs in the naming context.
    Parameters:
      `mdr` - the message destination ref descriptor (unused)

  - ### addService

    public void addService(ContextService service)
    Set the specified web service in the naming context.
    Parameters:
      `service` - the web service descriptor

  - ### addResource

    public void addResource(ContextResource resource)
    Set the specified resources in the naming context.
    Parameters:
      `resource` - the resource descriptor

  - ### addResourceEnvRef

    public void addResourceEnvRef(ContextResourceEnvRef resourceEnvRef)
    Set the specified resources in the naming context.
    Parameters:
      `resourceEnvRef` - the resource reference

  - ### addResourceLink

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

  - ### removeEjb

    public void removeEjb(String name)
    Remove the specified EJB from the naming context.
    Parameters:
      `name` - the name of the EJB which should be removed

  - ### removeEnvironment

    public void removeEnvironment(String name)
    Remove the specified environment entry from the naming context.
    Parameters:
      `name` - the name of the environment entry which should be removed

  - ### removeLocalEjb

    public void removeLocalEjb(String name)
    Remove the specified local EJB from the naming context.
    Parameters:
      `name` - the name of the EJB which should be removed

  - ### removeMessageDestinationRef

    public void removeMessageDestinationRef(String name)
    Remove the specified message destination ref from the naming context.
    Parameters:
      `name` - the name of the message destination ref which should be removed

  - ### removeService

    public void removeService(String name)
    Remove the specified web service from the naming context.
    Parameters:
      `name` - the name of the web service which should be removed

  - ### removeResource

    public void removeResource(String name)
    Remove the specified resource from the naming context.
    Parameters:
      `name` - the name of the resource which should be removed

  - ### removeResourceEnvRef

    public void removeResourceEnvRef(String name)
    Remove the specified resource environment reference from the naming context.
    Parameters:
      `name` - the name of the resource environment reference which should be removed

  - ### removeResourceLink

    public void removeResourceLink(String name)
    Remove the specified resource link from the naming context.
    Parameters:
      `name` - the name of the resource link which should be removed