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. 

  11. package org.omg.CosNaming;

  12. 

  13. /**

  14. * org/omg/CosNaming/NamingContextOperations.java

  15. * Generated by the IDL-to-Java compiler (portable), version "3.0"

  16. * from nameservice.idl

  17. * Wednesday, January 26, 2000 3:34:53 PM PST

  18. */

  19. 

  20. public interface NamingContextOperations 

  21. {

  22.     /**

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

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

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

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

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

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

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

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

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

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

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

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

  35.      */

  36.   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;

  37.     /**

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

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

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

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

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

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

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

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

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

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

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

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

  50.      */

  51.   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;

  52.     /**

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

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

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

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

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

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

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

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

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

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

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

  64.      */

  65.   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;

  66.     /**

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

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

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

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

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

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

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

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

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

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

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

  78.      */

  79.   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;

  80.     /**

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

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

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

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

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

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

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

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

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

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

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

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

  93.      */

  94.   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;

  95.     /**

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

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

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

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

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

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

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

  103.      */

  104.   void unbind (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  105.     /**

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

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

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

  109.      * bindings in BindingList bl. 

  110.      * <ul>

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

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

  113.      * additional bindings. 

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

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

  116.      * </ul>

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

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

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

  120.      */

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

  122.     /**

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

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

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

  126.      */

  127.   org.omg.CosNaming.NamingContext new_context ();

  128.     /**

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

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

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

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

  133.      * name argument excluding the last component).

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

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

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

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

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

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

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

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

  142.      */

  143.   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;

  144.     /**

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

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

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

  148.      */

  149.   void destroy () throws org.omg.CosNaming.NamingContextPackage.NotEmpty;

  150. } // interface NamingContextOperations