1. /*

  2.  * @(#)ObjectChangeListener.java	1.4 00/02/02

  3.  *

  4.  * Copyright 1999, 2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package javax.naming.event;

  12. 

  13. /**

  14.   * Specifies the method that a listener of a <tt>NamingEvent</tt>

  15.   * with event type of <tt>OBJECT_CHANGED</tt> must implement.

  16.   *<p>

  17.   * An <tt>OBJECT_CHANGED</tt> event type is fired when (the contents of)

  18.   * an object has changed. This might mean that its attributes have been modified,

  19.   * added, or removed, and/or that the object itself has been replaced.

  20.   * How the object has changed can be determined by examining the

  21.   * <tt>NamingEvent</tt>'s old and new bindings.

  22.   *<p>

  23.   * A listener interested in <tt>OBJECT_CHANGED</tt> event types must:

  24.   *<ol>

  25.   *

  26.   *<li>Implement this interface and its method (<tt>objectChanged()</tt>)

  27.   *<li>Implement <tt>NamingListener.namingExceptionThrown()</tt> so that

  28.   * it will be notified of exceptions thrown while attempting to

  29.   * collect information about the events.

  30.   *<li>Register with the source using the source's <tt>addNamingListener()</tt>

  31.   *    method.

  32.   *</ol>

  33.   * A listener that wants to be notified of namespace change events

  34.   * should also implement the <tt>NamespaceChangeListener</tt>

  35.   * interface.

  36.   * 

  37.   * @author Rosanna Lee

  38.   * @author Scott Seligman

  39.   * @version 1.4 00/02/02

  40.   * 

  41.   * @see NamingEvent

  42.   * @see NamespaceChangeListener

  43.   * @see EventContext

  44.   * @see EventDirContext

  45.   * @since 1.3

  46.   */

  47. public interface ObjectChangeListener extends NamingListener {

  48. 

  49.     /**

  50.      * Called when an object has been changed.

  51.      *<p>

  52.      * The binding of the changed object can be obtained using

  53.      * <tt>evt.getNewBinding()</tt>. Its old binding (before the change)

  54.      * can be obtained using <tt>evt.getOldBinding()</tt>.

  55.      * @param evt The nonnull naming event.

  56.      * @see NamingEvent#OBJECT_CHANGED

  57.      */

  58.     void objectChanged(NamingEvent evt);

  59. }