1. /*

  2.  * @(#)NamingContext.java	1.6 01/11/29

  3.  *

  4.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. /*

  8.  * File: ./org/omg/CosNaming/NamingContext.java

  9.  * From: nameservice.idl

  10.  * Date: Tue Aug 11 03:12:09 1998

  11.  *   By: idltojava Java IDL 1.2 Aug 11 1998 02:00:18

  12.  */

  13. 

  14. package org.omg.CosNaming;

  15. /**

  16. * A naming context is an object that contains a set of name bindings in 

  17. * which each name is unique. Different names can be bound to an object 

  18. * in the same or different contexts at the same time. <p>

  19. ** See <a href=" http://www.omg.org/corba/sectrans.htm#nam">CORBA COS 

  20. * Naming Specification.</a>

  21.  */public interface NamingContext

  22.     extends org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity {

  23.     /**

  24.     * Creates a binding of a name and an object in the naming context.

  25. * Naming contexts that are bound using bind do not participate in name

  26. * resolution when compound names are passed to be resolved. 

  27. ** @param n Name of the object <p>

  28. ** @param obj The Object to bind with the given name<p>

  29. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  30. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  31. * given up for some reason. The client, however, may be able to 

  32. * continue the operation at the returned naming context.<p>

  33. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  34. ** @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 

  35. * bound to the specified name.<p>

  36.      */

  37.     void bind(org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj)

  38.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound;

  39.     /**

  40.     * Names an object that is a naming context. Naming contexts that

  41. * are bound using bind_context() participate in name resolution 

  42. * when compound names are passed to be resolved.

  43. ** @param n Name of the object <p>

  44. ** @param nc NamingContect object to bind with the given name <p>

  45. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  46. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  47. * given up for some reason. The client, however, may be able to 

  48. * continue the operation at the returned naming context.<p>

  49. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  50. ** @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 

  51. * bound to the specified name.<p>

  52.      */

  53.     void bind_context(org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc)

  54.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound;

  55.     /**

  56.     * Creates a binding of a name and an object in the naming context

  57. * even if the name is already bound in the context. Naming contexts 

  58. * that are bound using rebind do not participate in name resolution 

  59. * when compound names are passed to be resolved.

  60. ** @param  n Name of the object <p>

  61. ** @parm obj The Object to rebind with the given name <p>

  62. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  63. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  64. * given up for some reason. The client, however, may be able to 

  65. * continue the operation at the returned naming context.<p>

  66. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  67.      */

  68.     void rebind(org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj)

  69.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  70.     /**

  71.     * Creates a binding of a name and a naming context in the naming

  72. * context even if the name is already bound in the context. Naming 

  73. * contexts that are bound using rebind_context() participate in name 

  74. * resolution when compound names are passed to be resolved.

  75. ** @param n Name of the object <p>

  76. ** @param nc NamingContect object to rebind with the given name <p>

  77. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  78. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  79. * given up for some reason. The client, however, may be able to 

  80. * continue the operation at the returned naming context.<p>

  81. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  82.      */

  83.     void rebind_context(org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc)

  84.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  85.     /**

  86.     * The resolve operation is the process of retrieving an object

  87. * bound to a name in a given context. The given name must exactly 

  88. * match the bound name. The naming service does not return the type 

  89. * of the object. Clients are responsible for "narrowing" the object 

  90. * to the appropriate type. That is, clients typically cast the returned 

  91. * object from Object to a more specialized interface.

  92. ** @param n Name of the object <p>

  93. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  94. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  95. * given up for some reason. The client, however, may be able to 

  96. * continue the operation at the returned naming context.<p>

  97. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  98.      */

  99.     org.omg.CORBA.Object resolve(org.omg.CosNaming.NameComponent[] n)

  100.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  101.     /**

  102.     * The unbind operation removes a name binding from a context.

  103. ** @param n Name of the object <p>

  104. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  105. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  106. * given up for some reason. The client, however, may be able to 

  107. * continue the operation at the returned naming context.<p>

  108. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  109.      */

  110.     void unbind(org.omg.CosNaming.NameComponent[] n)

  111.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  112.     /**

  113.     * The list operation allows a client to iterate through a set of

  114. * bindings in a naming context. <p>

  115. ** The list operation returns at most the requested number of

  116. * bindings in BindingList bl. 

  117. * <ul>

  118. * <li>If the naming context contains additional 

  119. * bindings, the list operation returns a BindingIterator with the 

  120. * additional bindings. 

  121. * <li>If the naming context does not contain additional 

  122. * bindings, the binding iterator is a nil object reference.

  123. * </ul>

  124. ** @param how_many the maximum number of bindings to return <p>

  125. ** @param bl the returned list of bindings <p>

  126. ** @param bi the returned binding iterator <p>

  127.      */

  128.     void list(int how_many, org.omg.CosNaming.BindingListHolder bl, org.omg.CosNaming.BindingIteratorHolder bi)

  129. ;

  130.     /**

  131.     * This operation returns a naming context implemented by the same

  132. * naming server as the context on which the operation was invoked. 

  133. * The new context is not bound to any name.

  134.      */

  135.     org.omg.CosNaming.NamingContext new_context()

  136. ;

  137.     /**

  138.     * This operation creates a new context and binds it to the name

  139. * supplied as an argument. The newly-created context is implemented 

  140. * by the same naming server as the context in which it was bound (that 

  141. * is, the naming server that implements the context denoted by the 

  142. * name argument excluding the last component).

  143. ** @param n Name of the object <p>

  144. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>

  145. ** @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 

  146. * bound to the specified name.<p>

  147. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has

  148. * given up for some reason. The client, however, may be able to 

  149. * continue the operation at the returned naming context.<p>

  150. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>

  151.      */

  152.     org.omg.CosNaming.NamingContext bind_new_context(org.omg.CosNaming.NameComponent[] n)

  153.         throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.AlreadyBound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  154.     /**

  155.     * The destroy operation deletes a naming context. If the naming 

  156. * context contains bindings, the NotEmpty exception is raised.

  157. ** @exception org.omg.CosNaming.NamingContextPackage.NotEmpty Indicates that the Naming Context contains bindings.

  158.      */

  159.     void destroy()

  160.         throws org.omg.CosNaming.NamingContextPackage.NotEmpty;

  161. }