1. /*

  2.  * @(#)Referenceable.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;

  12. 

  13. /**

  14.   * This interface is implemented by an object that can provide a

  15.   * Reference to itself.

  16.   *<p>

  17.   * A Reference represents a way of recording address information about

  18.   * objects which themselves are not directly bound to the naming system.

  19.   * Such objects can implement the Referenceable interface as a way

  20.   * for programs that use that object to determine what its Reference is.

  21.   * For example, when binding a object, if an object implements the

  22.   * Referenceable interface, getReference() can be invoked on the object to

  23.   * get its Reference to use for binding.

  24.   *

  25.   * @author Rosanna Lee

  26.   * @author Scott Seligman

  27.   * @author R. Vasudevan

  28.   * @version 1.4 00/02/02

  29.   *

  30.   * @see Context#bind

  31.   * @see javax.naming.spi.NamingManager#getObjectInstance

  32.   * @see Reference

  33.   * @since 1.3

  34.   */

  35. public interface Referenceable {

  36.     /**

  37.       * Retrieves the Reference of this object.

  38.       *

  39.       * @return The non-null Reference of this object.

  40.       * @exception NamingException If a naming exception was encountered

  41.       *		while retrieving the reference.

  42.       */

  43.     Reference getReference() throws NamingException;

  44. }