NamingContextOperations


1   package org.omg.CosNaming;
2   
3   
4   /**
5   * org/omg/CosNaming/NamingContextOperations.java .
6   * Generated by the IDL-to-Java compiler (portable), version "3.2"
7   * from ../../../../src/share/classes/org/omg/CosNaming/nameservice.idl
8   * Saturday, February 9, 2008 9:40:10 AM GMT
9   */
10  
11  
12  /** 
13   * A naming context is an object that contains a set of name bindings in 
14   * which each name is unique. Different names can be bound to an object 
15   * in the same or different contexts at the same time. <p>
16   * 
17   * See <a HREF="http://www.omg.org/technology/documents/formal/naming_service.htm">
18   * CORBA COS 
19   * Naming Specification.</a>
20   */
21  public interface NamingContextOperations 
22  {
23  
24    /**
25   * Creates a binding of a name and an object in the naming context.
26   * Naming contexts that are bound using bind do not participate in name
27   * resolution when compound names are passed to be resolved. 
28   * 
29   * @param n Name of the object <p>
30   * 
31   * @param obj The Object to bind with the given name<p>
32   * 
33   * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates
34   * the name does not identify a binding.<p>
35   * 
36   * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed 
37   * Indicates that the implementation has given up for some reason.
38   * The client, however, may be able to continue the operation
39   * at the returned naming context.<p>
40   * 
41   * @exception org.omg.CosNaming.NamingContextPackage.InvalidName 
42   * Indicates that the name is invalid. <p>
43   *
44   * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound 
45   * Indicates an object is already bound to the specified name.<p> 
46   */
47    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  ;
48  
49    /**
50   * Names an object that is a naming context. Naming contexts that
51   * are bound using bind_context() participate in name resolution 
52   * when compound names are passed to be resolved.
53   * 
54   * @param n Name of the object <p>
55   * 
56   * @param nc NamingContect object to bind with the given name <p>
57   * 
58   * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
59   * 
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   * 
64   * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
65   *
66   * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 
67   * bound to the specified name.<p>
68   */
69    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  ;
70  
71    /**
72   * Creates a binding of a name and an object in the naming context
73   * even if the name is already bound in the context. Naming contexts 
74   * that are bound using rebind do not participate in name resolution 
75   * when compound names are passed to be resolved.
76   * 
77   * @param  n Name of the object <p>
78   * 
79   * @parm obj The Object to rebind with the given name <p>
80   * 
81   * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
82   * 
83   * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
84   * given up for some reason. The client, however, may be able to 
85   * continue the operation at the returned naming context.<p>
86   * 
87   * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
88   */
89    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  ;
90  
91    /** 
92   * Creates a binding of a name and a naming context in the naming
93   * context even if the name is already bound in the context. Naming 
94   * contexts that are bound using rebind_context() participate in name 
95   * resolution when compound names are passed to be resolved.
96   * 
97   * @param n Name of the object <p>
98   * 
99   * @param nc NamingContect object to rebind with the given name <p>
100  * 
101  * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
102  * 
103  * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
104  * given up for some reason. The client, however, may be able to 
105  * continue the operation at the returned naming context.<p>
106  * 
107  * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
108  */
109   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  ;
110 
111   /** 
112  * The resolve operation is the process of retrieving an object
113  * bound to a name in a given context. The given name must exactly 
114  * match the bound name. The naming service does not return the type 
115  * of the object. Clients are responsible for "narrowing" the object 
116  * to the appropriate type. That is, clients typically cast the returned 
117  * object from Object to a more specialized interface.
118  * 
119  * @param n Name of the object <p>
120  * 
121  * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
122  * 
123  * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
124  * given up for some reason. The client, however, may be able to 
125  * continue the operation at the returned naming context.<p>
126  * 
127  * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
128  */
129   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  ;
130 
131   /** 
132  * The unbind operation removes a name binding from a context.
133  * 
134  * @param n Name of the object <p>
135  * 
136  * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
137  * 
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  * 
142  * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
143  */
144   void unbind (org.omg.CosNaming.NameComponent  [] n) throws org.omg.CosNaming.NamingContextPackage.NotFound  , org.omg.CosNaming.NamingContextPackage.CannotProceed  , org.omg.CosNaming.NamingContextPackage.InvalidName  ;
145 
146   /**
147  * The list operation allows a client to iterate through a set of
148  * bindings in a naming context. <p>
149  * 
150  * The list operation returns at most the requested number of
151  * bindings in BindingList bl. 
152  * <ul>
153  * <li>If the naming context contains additional 
154  * bindings, the list operation returns a BindingIterator with the 
155  * additional bindings. 
156  * <li>If the naming context does not contain additional 
157  * bindings, the binding iterator is a nil object reference.
158  * </ul>
159  * 
160  * @param how_many the maximum number of bindings to return <p>
161  * 
162  * @param bl the returned list of bindings <p>
163  * 
164  * @param bi the returned binding iterator <p>
165  */
166   void list (int how_many, org.omg.CosNaming.BindingListHolder   bl, org.omg.CosNaming.BindingIteratorHolder   bi);
167 
168   /**
169  * This operation returns a naming context implemented by the same
170  * naming server as the context on which the operation was invoked. 
171  * The new context is not bound to any name.
172  */
173   org.omg.CosNaming.NamingContext   new_context ();
174 
175   /**
176  * This operation creates a new context and binds it to the name
177  * supplied as an argument. The newly-created context is implemented 
178  * by the same naming server as the context in which it was bound (that 
179  * is, the naming server that implements the context denoted by the 
180  * name argument excluding the last component).
181  * 
182  * @param n Name of the object <p>
183  * 
184  * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
185  * 
186  * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 
187  * bound to the specified name.<p>
188  * 
189  * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
190  * given up for some reason. The client, however, may be able to 
191  * continue the operation at the returned naming context.<p>
192  * 
193  * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
194  */
195   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  ;
196 
197   /** 
198  * The destroy operation deletes a naming context. If the naming 
199  * context contains bindings, the NotEmpty exception is raised.
200  * 
201  * @exception org.omg.CosNaming.NamingContextPackage.NotEmpty Indicates that the Naming Context contains bindings.
202  */
203   void destroy () throws org.omg.CosNaming.NamingContextPackage.NotEmpty  ;
204 } // interface NamingContextOperations
205
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags