1. /*
  2. * @(#)NamingContextOperations.java 1.1 00/01/26
  3. *
  4. * Copyright 1997-1999 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. package org.omg.CosNaming;
  11. /**
  12. * org/omg/CosNaming/NamingContextOperations.java
  13. * Generated by the IDL-to-Java compiler (portable), version "3.0"
  14. * from nameservice.idl
  15. * Wednesday, January 26, 2000 3:34:53 PM PST
  16. */
  17. public interface NamingContextOperations
  18. {
  19. /**
  20. * Creates a binding of a name and an object in the naming context.
  21. * Naming contexts that are bound using bind do not participate in name
  22. * resolution when compound names are passed to be resolved.
  23. ** @param n Name of the object <p>
  24. ** @param obj The Object to bind with the given name<p>
  25. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  26. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  27. * given up for some reason. The client, however, may be able to
  28. * continue the operation at the returned naming context.<p>
  29. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  30. ** @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
  31. * bound to the specified name.<p>
  32. */
  33. void bind (org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound;
  34. /**
  35. * Names an object that is a naming context. Naming contexts that
  36. * are bound using bind_context() participate in name resolution
  37. * when compound names are passed to be resolved.
  38. ** @param n Name of the object <p>
  39. ** @param nc NamingContect object to bind with the given name <p>
  40. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  41. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  42. * given up for some reason. The client, however, may be able to
  43. * continue the operation at the returned naming context.<p>
  44. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  45. ** @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
  46. * bound to the specified name.<p>
  47. */
  48. void bind_context (org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound;
  49. /**
  50. * Creates a binding of a name and an object in the naming context
  51. * even if the name is already bound in the context. Naming contexts
  52. * that are bound using rebind do not participate in name resolution
  53. * when compound names are passed to be resolved.
  54. ** @param n Name of the object <p>
  55. ** @parm obj The Object to rebind with the given name <p>
  56. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  57. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  58. * given up for some reason. The client, however, may be able to
  59. * continue the operation at the returned naming context.<p>
  60. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  61. */
  62. void rebind (org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
  63. /**
  64. * Creates a binding of a name and a naming context in the naming
  65. * context even if the name is already bound in the context. Naming
  66. * contexts that are bound using rebind_context() participate in name
  67. * resolution when compound names are passed to be resolved.
  68. ** @param n Name of the object <p>
  69. ** @param nc NamingContect object to rebind with the given name <p>
  70. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  71. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  72. * given up for some reason. The client, however, may be able to
  73. * continue the operation at the returned naming context.<p>
  74. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  75. */
  76. void rebind_context (org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
  77. /**
  78. * The resolve operation is the process of retrieving an object
  79. * bound to a name in a given context. The given name must exactly
  80. * match the bound name. The naming service does not return the type
  81. * of the object. Clients are responsible for "narrowing" the object
  82. * to the appropriate type. That is, clients typically cast the returned
  83. * object from Object to a more specialized interface.
  84. ** @param n Name of the object <p>
  85. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  86. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  87. * given up for some reason. The client, however, may be able to
  88. * continue the operation at the returned naming context.<p>
  89. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  90. */
  91. org.omg.CORBA.Object resolve (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
  92. /**
  93. * The unbind operation removes a name binding from a context.
  94. ** @param n Name of the object <p>
  95. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  96. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  97. * given up for some reason. The client, however, may be able to
  98. * continue the operation at the returned naming context.<p>
  99. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  100. */
  101. void unbind (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
  102. /**
  103. * The list operation allows a client to iterate through a set of
  104. * bindings in a naming context. <p>
  105. ** The list operation returns at most the requested number of
  106. * bindings in BindingList bl.
  107. * <ul>
  108. * <li>If the naming context contains additional
  109. * bindings, the list operation returns a BindingIterator with the
  110. * additional bindings.
  111. * <li>If the naming context does not contain additional
  112. * bindings, the binding iterator is a nil object reference.
  113. * </ul>
  114. ** @param how_many the maximum number of bindings to return <p>
  115. ** @param bl the returned list of bindings <p>
  116. ** @param bi the returned binding iterator <p>
  117. */
  118. void list (int how_many, org.omg.CosNaming.BindingListHolder bl, org.omg.CosNaming.BindingIteratorHolder bi);
  119. /**
  120. * This operation returns a naming context implemented by the same
  121. * naming server as the context on which the operation was invoked.
  122. * The new context is not bound to any name.
  123. */
  124. org.omg.CosNaming.NamingContext new_context ();
  125. /**
  126. * This operation creates a new context and binds it to the name
  127. * supplied as an argument. The newly-created context is implemented
  128. * by the same naming server as the context in which it was bound (that
  129. * is, the naming server that implements the context denoted by the
  130. * name argument excluding the last component).
  131. ** @param n Name of the object <p>
  132. ** @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
  133. ** @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
  134. * bound to the specified name.<p>
  135. ** @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
  136. * given up for some reason. The client, however, may be able to
  137. * continue the operation at the returned naming context.<p>
  138. ** @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
  139. */
  140. org.omg.CosNaming.NamingContext bind_new_context (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.AlreadyBound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
  141. /**
  142. * The destroy operation deletes a naming context. If the naming
  143. * context contains bindings, the NotEmpty exception is raised.
  144. ** @exception org.omg.CosNaming.NamingContextPackage.NotEmpty Indicates that the Naming Context contains bindings.
  145. */
  146. void destroy () throws org.omg.CosNaming.NamingContextPackage.NotEmpty;
  147. } // interface NamingContextOperations