FileDocCategorySizeDatePackage
NamespaceChangeListener.javaAPI DocJava SE 5 API2394Fri Aug 26 14:57:40 BST 2005javax.naming.event

NamespaceChangeListener

public interface NamespaceChangeListener implements NamingListener
Specifies the methods that a listener interested in namespace changes must implement. Specifically, the listener is interested in NamingEvents with event types of OBJECT_ADDED, OBJECT_RENAMED, or OBJECT_REMOVED.

Such a listener must:

  1. Implement this interface and its methods.
  2. Implement NamingListener.namingExceptionThrown() so that it will be notified of exceptions thrown while attempting to collect information about the events.
  3. Register with the source using the source's addNamingListener() method.
A listener that wants to be notified of OBJECT_CHANGED event types should also implement the ObjectChangeListener interface.
author
Rosanna Lee
author
Scott Seligman
version
1.7 03/12/19
see
NamingEvent
see
ObjectChangeListener
see
EventContext
see
EventDirContext
since
1.3

Fields Summary
Constructors Summary
Methods Summary
public voidobjectAdded(javax.naming.event.NamingEvent evt)
Called when an object has been added.

The binding of the newly added object can be obtained using evt.getNewBinding().

param
evt The nonnull event.
see
NamingEvent#OBJECT_ADDED

public voidobjectRemoved(javax.naming.event.NamingEvent evt)
Called when an object has been removed.

The binding of the newly removed object can be obtained using evt.getOldBinding().

param
evt The nonnull event.
see
NamingEvent#OBJECT_REMOVED

public voidobjectRenamed(javax.naming.event.NamingEvent evt)
Called when an object has been renamed.

The binding of the renamed object can be obtained using evt.getNewBinding(). Its old binding (before the rename) can be obtained using evt.getOldBinding(). One of these may be null if the old/new binding was outside the scope in which the listener has registered interest.

param
evt The nonnull event.
see
NamingEvent#OBJECT_RENAMED