56 |
* @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org) |
* @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org) |
57 |
*/ |
*/ |
58 |
public interface NamingContext |
public interface NamingContext |
59 |
extends org.omg.CORBA.Object, IDLEntity |
extends NamingContextOperations, org.omg.CORBA.Object, IDLEntity |
60 |
{ |
{ |
61 |
/** |
/** |
62 |
* Gives the object a name, valid in this context. |
* Gives the object a name, valid in this context. |
66 |
* |
* |
67 |
* @throws AlreadyBound if the object is already named in this context. |
* @throws AlreadyBound if the object is already named in this context. |
68 |
* @throws InvalidName if the name has zero length or otherwise invalid. |
* @throws InvalidName if the name has zero length or otherwise invalid. |
69 |
|
* |
70 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
71 |
*/ |
*/ |
72 |
void bind(NameComponent[] a_name, org.omg.CORBA.Object an_object) |
void bind(NameComponent[] a_name, org.omg.CORBA.Object an_object) |
73 |
throws NotFound, CannotProceed, InvalidName, AlreadyBound; |
throws NotFound, CannotProceed, InvalidName, AlreadyBound; |
80 |
* |
* |
81 |
* @throws AlreadyBound if the child context is already named in |
* @throws AlreadyBound if the child context is already named in |
82 |
* the current context. |
* the current context. |
83 |
|
* |
84 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
85 |
*/ |
*/ |
86 |
void bind_context(NameComponent[] a_name, NamingContext a_context) |
void bind_context(NameComponent[] a_name, NamingContext a_context) |
87 |
throws NotFound, CannotProceed, InvalidName, AlreadyBound; |
throws NotFound, CannotProceed, InvalidName, AlreadyBound; |
96 |
* |
* |
97 |
* @throws AlreadyBound if the name is already in use. |
* @throws AlreadyBound if the name is already in use. |
98 |
* @throws InvalidName if the name has zero length or otherwise invalid. |
* @throws InvalidName if the name has zero length or otherwise invalid. |
99 |
|
* |
100 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
101 |
*/ |
*/ |
102 |
NamingContext bind_new_context(NameComponent[] a_name) |
NamingContext bind_new_context(NameComponent[] a_name) |
103 |
throws NotFound, AlreadyBound, CannotProceed, |
throws NotFound, AlreadyBound, CannotProceed, |
106 |
/** |
/** |
107 |
* Destroy this context (must be empty). |
* Destroy this context (must be empty). |
108 |
* @throws NotEmpty if the context being destroyed is not empty. |
* @throws NotEmpty if the context being destroyed is not empty. |
109 |
|
* |
110 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
111 |
*/ |
*/ |
112 |
void destroy() |
void destroy() |
113 |
throws NotEmpty; |
throws NotEmpty; |
123 |
* @param a_list the holder, where the returned bindigs are stored. |
* @param a_list the holder, where the returned bindigs are stored. |
124 |
* @param an_iter the iterator that can be used to access the remaining |
* @param an_iter the iterator that can be used to access the remaining |
125 |
* bindings. |
* bindings. |
126 |
|
* |
127 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
128 |
*/ |
*/ |
129 |
void list(int amount, BindingListHolder a_list, BindingIteratorHolder an_iter); |
void list(int amount, BindingListHolder a_list, BindingIteratorHolder an_iter); |
130 |
|
|
131 |
/** |
/** |
132 |
* Creates a new naming context, not bound to any name. |
* Creates a new naming context, not bound to any name. |
133 |
|
* |
134 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
135 |
*/ |
*/ |
136 |
NamingContext new_context(); |
NamingContext new_context(); |
137 |
|
|
144 |
* @param an_object the object, being named. |
* @param an_object the object, being named. |
145 |
* |
* |
146 |
* @throws InvalidName if the name has zero length or otherwise invalid. |
* @throws InvalidName if the name has zero length or otherwise invalid. |
147 |
|
* |
148 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
149 |
*/ |
*/ |
150 |
void rebind(NameComponent[] a_name, org.omg.CORBA.Object an_object) |
void rebind(NameComponent[] a_name, org.omg.CORBA.Object an_object) |
151 |
throws NotFound, CannotProceed, InvalidName; |
throws NotFound, CannotProceed, InvalidName; |
159 |
* @param a_context the child context being named. |
* @param a_context the child context being named. |
160 |
* |
* |
161 |
* @throws InvalidName if the name has zero length or otherwise invalid. |
* @throws InvalidName if the name has zero length or otherwise invalid. |
162 |
|
* |
163 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
164 |
*/ |
*/ |
165 |
void rebind_context(NameComponent[] a_name, NamingContext a_context) |
void rebind_context(NameComponent[] a_name, NamingContext a_context) |
166 |
throws NotFound, CannotProceed, InvalidName; |
throws NotFound, CannotProceed, InvalidName; |
177 |
* |
* |
178 |
* @throws NotFound |
* @throws NotFound |
179 |
* @throws InvalidName if the name has zero length or otherwise invalid. |
* @throws InvalidName if the name has zero length or otherwise invalid. |
180 |
|
* |
181 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
182 |
*/ |
*/ |
183 |
org.omg.CORBA.Object resolve(NameComponent[] a_name) |
org.omg.CORBA.Object resolve(NameComponent[] a_name) |
184 |
throws NotFound, CannotProceed, InvalidName; |
throws NotFound, CannotProceed, InvalidName; |
189 |
* @param a_name a name to remove. |
* @param a_name a name to remove. |
190 |
* |
* |
191 |
* @throws InvalidName if the name has zero length or otherwise invalid. |
* @throws InvalidName if the name has zero length or otherwise invalid. |
192 |
|
* |
193 |
|
* @specnote since 1.3 this method has moved into NamingContextOperations. |
194 |
*/ |
*/ |
195 |
void unbind(NameComponent[] a_name) |
void unbind(NameComponent[] a_name) |
196 |
throws NotFound, CannotProceed, InvalidName; |
throws NotFound, CannotProceed, InvalidName; |
197 |
} |
} |