Java™ Platform
Standard Ed. 6

javax.naming.event
Interface NamespaceChangeListener

All Superinterfaces:
EventListener, NamingListener

public interface NamespaceChangeListener
extends 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.

Since:
1.3
See Also:
NamingEvent, ObjectChangeListener, EventContext, EventDirContext

Method Summary
 void objectAdded(NamingEvent evt)
          Called when an object has been added.
 void objectRemoved(NamingEvent evt)
          Called when an object has been removed.
 void objectRenamed(NamingEvent evt)
          Called when an object has been renamed.
 
Methods inherited from interface javax.naming.event.NamingListener
namingExceptionThrown
 

Method Detail

objectAdded

void objectAdded(NamingEvent evt)
Called when an object has been added.

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

Parameters:
evt - The nonnull event.
See Also:
NamingEvent.OBJECT_ADDED

objectRemoved

void objectRemoved(NamingEvent evt)
Called when an object has been removed.

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

Parameters:
evt - The nonnull event.
See Also:
NamingEvent.OBJECT_REMOVED

objectRenamed

void objectRenamed(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.

Parameters:
evt - The nonnull event.
See Also:
NamingEvent.OBJECT_RENAMED

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.