28 |
28 |
29 |
29 |
30 /** |
30 /** |
31 * Used as a base class for implementation of a local IDL interface in the |
31 * Used as a base class for implementation of a local IDL interface in the |
32 * Java language mapping. It is a class which implements all the operations |
32 * Java language mapping. It is a class which implements all the operations |
33 * in the <tt>org.omg.CORBA.Object</tt> interface. |
33 * in the {@code org.omg.CORBA.Object} interface. |
34 * <P>Local interfaces are implemented by using CORBA::LocalObject |
34 * <P>Local interfaces are implemented by using CORBA::LocalObject |
35 * to provide implementations of <code>Object</code> pseudo |
35 * to provide implementations of {@code Object} pseudo |
36 * operations and any other ORB-specific support mechanisms that are |
36 * operations and any other ORB-specific support mechanisms that are |
37 * appropriate for such objects. Object implementation techniques are |
37 * appropriate for such objects. Object implementation techniques are |
38 * inherently language-mapping specific. Therefore, the |
38 * inherently language-mapping specific. Therefore, the |
39 * <code>LocalObject</code> type is not defined in IDL, but is specified |
39 * {@code LocalObject} type is not defined in IDL, but is specified |
40 * in each language mapping. |
40 * in each language mapping. |
41 * <P>Methods that do not apply to local objects throw |
41 * <P>Methods that do not apply to local objects throw |
42 * an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with the message, |
42 * an {@code org.omg.CORBA.NO_IMPLEMENT} exception with the message, |
43 * "This is a locally contrained object." Attempting to use a |
43 * "This is a locally contrained object." Attempting to use a |
44 * <TT>LocalObject</TT> to create a DII request results in NO_IMPLEMENT |
44 * {@code LocalObject} to create a DII request results in NO_IMPLEMENT |
45 * system exception. Attempting to marshal or stringify a |
45 * system exception. Attempting to marshal or stringify a |
46 * <TT>LocalObject</TT> results in a MARSHAL system exception. Narrowing |
46 * {@code LocalObject} results in a MARSHAL system exception. Narrowing |
47 * and widening references to <TT>LocalObjects</TT> must work as for regular |
47 * and widening references to {@code LocalObjects} must work as for regular |
48 * object references. |
48 * object references. |
49 * <P><code>LocalObject</code> is to be used as the base class of locally |
49 * <P>{@code LocalObject} is to be used as the base class of locally |
50 * constrained objects, such as those in the PortableServer module. |
50 * constrained objects, such as those in the PortableServer module. |
51 * The specification here is based on the CORBA Components |
51 * The specification here is based on the CORBA Components |
52 * Volume I - orbos/99-07-01 |
52 * Volume I - orbos/99-07-01 |
53 * |
53 * |
54 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
54 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
55 * comments for unimplemented features</a> |
55 * comments for unimplemented features</a> |
56 */ |
56 */ |
57 |
57 |
58 public class LocalObject implements org.omg.CORBA.Object |
58 public class LocalObject implements org.omg.CORBA.Object |
59 { |
59 { |
60 private static String reason = "This is a locally constrained object."; |
60 private static String reason = "This is a locally constrained object."; |
61 |
61 |
62 /** |
62 /** |
63 * Constructs a default <code>LocalObject</code> instance. |
63 * Constructs a default {@code LocalObject} instance. |
64 */ |
64 */ |
65 public LocalObject() {} |
65 public LocalObject() {} |
66 |
66 |
67 /** |
67 /** |
68 * Determines whether the two object references are equivalent, |
68 * Determines whether the two object references are equivalent, |
73 * refer to the same object, since such determination could be impractically |
73 * refer to the same object, since such determination could be impractically |
74 * expensive. |
74 * expensive. |
75 * <P>Default implementation of the org.omg.CORBA.Object method. |
75 * <P>Default implementation of the org.omg.CORBA.Object method. |
76 * |
76 * |
77 * @param that the object reference with which to check for equivalence |
77 * @param that the object reference with which to check for equivalence |
78 * @return <code>true</code> if this object reference is known to be |
78 * @return {@code true} if this object reference is known to be |
79 * equivalent to the given object reference. |
79 * equivalent to the given object reference. |
80 * Note that <code>false</code> indicates only that the two |
80 * Note that {@code false} indicates only that the two |
81 * object references are distinct, not necessarily that |
81 * object references are distinct, not necessarily that |
82 * they reference distinct objects. |
82 * they reference distinct objects. |
83 */ |
83 */ |
84 public boolean _is_equivalent(org.omg.CORBA.Object that) { |
84 public boolean _is_equivalent(org.omg.CORBA.Object that) { |
85 return equals(that) ; |
85 return equals(that) ; |
86 } |
86 } |
87 |
87 |
88 /** |
88 /** |
89 * Always returns <code>false</code>. |
89 * Always returns {@code false}. |
90 * This method is the default implementation of the |
90 * This method is the default implementation of the |
91 * <code>org.omg.CORBA.Object</code> method. |
91 * {@code org.omg.CORBA.Object} method. |
92 * |
92 * |
93 * @return <code>false</code> |
93 * @return {@code false} |
94 */ |
94 */ |
95 public boolean _non_existent() { |
95 public boolean _non_existent() { |
96 return false; |
96 return false; |
97 } |
97 } |
98 |
98 |
99 /** |
99 /** |
100 * Returns a hash value that is consistent for the |
100 * Returns a hash value that is consistent for the |
101 * lifetime of the object, using the given number as the maximum. |
101 * lifetime of the object, using the given number as the maximum. |
102 * This method is the default implementation of the |
102 * This method is the default implementation of the |
103 * <code>org.omg.CORBA.Object</code> method. |
103 * {@code org.omg.CORBA.Object} method. |
104 * |
104 * |
105 * @param maximum an <code>int</code> identifying maximum value of |
105 * @param maximum an {@code int} identifying maximum value of |
106 * the hashcode |
106 * the hashcode |
107 * @return this instance's hashcode |
107 * @return this instance's hashcode |
108 */ |
108 */ |
109 public int _hash(int maximum) { |
109 public int _hash(int maximum) { |
110 return hashCode() ; |
110 return hashCode() ; |
111 } |
111 } |
112 |
112 |
113 /** |
113 /** |
114 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
114 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
115 * the message "This is a locally constrained object." This method |
115 * the message "This is a locally constrained object." This method |
116 * does not apply to local objects and is therefore not implemented. |
116 * does not apply to local objects and is therefore not implemented. |
117 * This method is the default implementation of the |
117 * This method is the default implementation of the |
118 * <code>org.omg.CORBA.Object</code> method. |
118 * {@code org.omg.CORBA.Object} method. |
119 * |
119 * |
120 * @param repository_id a <code>String</code> |
120 * @param repository_id a {@code String} |
121 * @return NO_IMPLEMENT because this is a locally constrained object |
121 * @return NO_IMPLEMENT because this is a locally constrained object |
122 * and this method does not apply to local objects |
122 * and this method does not apply to local objects |
123 * @exception NO_IMPLEMENT because this is a locally constrained object |
123 * @exception NO_IMPLEMENT because this is a locally constrained object |
124 * and this method does not apply to local objects |
124 * and this method does not apply to local objects |
125 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
125 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
128 public boolean _is_a(String repository_id) { |
128 public boolean _is_a(String repository_id) { |
129 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
129 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
130 } |
130 } |
131 |
131 |
132 /** |
132 /** |
133 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
133 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
134 * the message "This is a locally constrained object." |
134 * the message "This is a locally constrained object." |
135 * This method is the default implementation of the |
135 * This method is the default implementation of the |
136 * <code>org.omg.CORBA.Object</code> method. |
136 * {@code org.omg.CORBA.Object} method. |
137 * |
137 * |
138 * @return a duplicate of this <code>LocalObject</code> instance. |
138 * @return a duplicate of this {@code LocalObject} instance. |
139 * @exception NO_IMPLEMENT |
139 * @exception NO_IMPLEMENT |
140 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
140 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
141 * comments for unimplemented features</a> |
141 * comments for unimplemented features</a> |
142 */ |
142 */ |
143 public org.omg.CORBA.Object _duplicate() { |
143 public org.omg.CORBA.Object _duplicate() { |
144 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
144 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
145 } |
145 } |
146 |
146 |
147 /** |
147 /** |
148 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
148 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
149 * the message "This is a locally constrained object." |
149 * the message "This is a locally constrained object." |
150 * This method is the default implementation of the |
150 * This method is the default implementation of the |
151 * <code>org.omg.CORBA.Object</code> method. |
151 * {@code org.omg.CORBA.Object} method. |
152 * |
152 * |
153 * @exception NO_IMPLEMENT |
153 * @exception NO_IMPLEMENT |
154 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
154 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
155 * comments for unimplemented features</a> |
155 * comments for unimplemented features</a> |
156 */ |
156 */ |
157 public void _release() { |
157 public void _release() { |
158 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
158 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
159 } |
159 } |
160 |
160 |
161 /** |
161 /** |
162 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
162 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
163 * the message "This is a locally constrained object." |
163 * the message "This is a locally constrained object." |
164 * This method is the default implementation of the |
164 * This method is the default implementation of the |
165 * <code>org.omg.CORBA.Object</code> method. |
165 * {@code org.omg.CORBA.Object} method. |
166 * |
166 * |
167 * @param operation a <code>String</code> giving the name of an operation |
167 * @param operation a {@code String} giving the name of an operation |
168 * to be performed by the request that is returned |
168 * to be performed by the request that is returned |
169 * @return a <code>Request</code> object with the given operation |
169 * @return a {@code Request} object with the given operation |
170 * @exception NO_IMPLEMENT |
170 * @exception NO_IMPLEMENT |
171 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
171 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
172 * comments for unimplemented features</a> |
172 * comments for unimplemented features</a> |
173 */ |
173 */ |
174 public Request _request(String operation) { |
174 public Request _request(String operation) { |
175 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
175 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
176 } |
176 } |
177 |
177 |
178 /** |
178 /** |
179 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
179 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
180 * the message "This is a locally constrained object." |
180 * the message "This is a locally constrained object." |
181 * This method is the default implementation of the |
181 * This method is the default implementation of the |
182 * <code>org.omg.CORBA.Object</code> method. |
182 * {@code org.omg.CORBA.Object} method. |
183 * |
183 * |
184 * @param ctx a <code>Context</code> object containing |
184 * @param ctx a {@code Context} object containing |
185 * a list of properties |
185 * a list of properties |
186 * @param operation the <code>String</code> representing the name of the |
186 * @param operation the {@code String} representing the name of the |
187 * method to be invoked |
187 * method to be invoked |
188 * @param arg_list an <code>NVList</code> containing the actual arguments |
188 * @param arg_list an {@code NVList} containing the actual arguments |
189 * to the method being invoked |
189 * to the method being invoked |
190 * @param result a <code>NamedValue</code> object to serve as a |
190 * @param result a {@code NamedValue} object to serve as a |
191 * container for the method's return value |
191 * container for the method's return value |
192 * @return a new <code>Request</code> object initialized with the given |
192 * @return a new {@code Request} object initialized with the given |
193 * arguments |
193 * arguments |
194 * @exception NO_IMPLEMENT |
194 * @exception NO_IMPLEMENT |
195 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
195 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
196 * comments for unimplemented features</a> |
196 * comments for unimplemented features</a> |
197 */ |
197 */ |
201 NamedValue result) { |
201 NamedValue result) { |
202 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
202 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
203 } |
203 } |
204 |
204 |
205 /** |
205 /** |
206 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
206 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
207 * the message "This is a locally constrained object." |
207 * the message "This is a locally constrained object." |
208 * This method is the default implementation of the |
208 * This method is the default implementation of the |
209 * <code>org.omg.CORBA.Object</code> method. |
209 * {@code org.omg.CORBA.Object} method. |
210 * |
210 * |
211 * @param ctx a <code>Context</code> object containing |
211 * @param ctx a {@code Context} object containing |
212 * a list of properties |
212 * a list of properties |
213 * @param operation the name of the method to be invoked |
213 * @param operation the name of the method to be invoked |
214 * @param arg_list an <code>NVList</code> containing the actual arguments |
214 * @param arg_list an {@code NVList} containing the actual arguments |
215 * to the method being invoked |
215 * to the method being invoked |
216 * @param result a <code>NamedValue</code> object to serve as a |
216 * @param result a {@code NamedValue} object to serve as a |
217 * container for the method's return value |
217 * container for the method's return value |
218 * @param exceptions an <code>ExceptionList</code> object containing a |
218 * @param exceptions an {@code ExceptionList} object containing a |
219 * list of possible exceptions the method can throw |
219 * list of possible exceptions the method can throw |
220 * @param contexts a <code>ContextList</code> object containing a list of |
220 * @param contexts a {@code ContextList} object containing a list of |
221 * context strings that need to be resolved and sent |
221 * context strings that need to be resolved and sent |
222 * with the |
222 * with the |
223 * <code>Request</code> instance |
223 * {@code Request} instance |
224 * @return the new <code>Request</code> object initialized with the given |
224 * @return the new {@code Request} object initialized with the given |
225 * arguments |
225 * arguments |
226 * @exception NO_IMPLEMENT |
226 * @exception NO_IMPLEMENT |
227 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
227 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
228 * comments for unimplemented features</a> |
228 * comments for unimplemented features</a> |
229 */ |
229 */ |
235 ContextList contexts) { |
235 ContextList contexts) { |
236 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
236 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
237 } |
237 } |
238 |
238 |
239 /** |
239 /** |
240 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
240 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
241 * the message "This is a locally constrained object." This method |
241 * the message "This is a locally constrained object." This method |
242 * does not apply to local objects and is therefore not implemented. |
242 * does not apply to local objects and is therefore not implemented. |
243 * This method is the default implementation of the |
243 * This method is the default implementation of the |
244 * <code>org.omg.CORBA.Object</code> method. |
244 * {@code org.omg.CORBA.Object} method. |
245 * |
245 * |
246 * @return NO_IMPLEMENT because this is a locally constrained object |
246 * @return NO_IMPLEMENT because this is a locally constrained object |
247 * and this method does not apply to local objects |
247 * and this method does not apply to local objects |
248 * @exception NO_IMPLEMENT because this is a locally constrained object |
248 * @exception NO_IMPLEMENT because this is a locally constrained object |
249 * and this method does not apply to local objects |
249 * and this method does not apply to local objects |
276 |
276 |
277 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
277 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
278 } |
278 } |
279 |
279 |
280 /** |
280 /** |
281 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
281 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
282 * the message "This is a locally constrained object." |
282 * the message "This is a locally constrained object." |
283 * This method is the default implementation of the |
283 * This method is the default implementation of the |
284 * <code>org.omg.CORBA.Object</code> method. |
284 * {@code org.omg.CORBA.Object} method. |
285 * @return the ORB instance that created the Delegate contained in this |
285 * @return the ORB instance that created the Delegate contained in this |
286 * <code>ObjectImpl</code> |
286 * {@code ObjectImpl} |
287 * @exception NO_IMPLEMENT |
287 * @exception NO_IMPLEMENT |
288 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
288 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
289 * comments for unimplemented features</a> |
289 * comments for unimplemented features</a> |
290 */ |
290 */ |
291 public org.omg.CORBA.ORB _orb() { |
291 public org.omg.CORBA.ORB _orb() { |
292 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
292 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
293 } |
293 } |
294 |
294 |
295 /** |
295 /** |
296 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
296 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
297 * the message "This is a locally constrained object." This method |
297 * the message "This is a locally constrained object." This method |
298 * does not apply to local objects and is therefore not implemented. |
298 * does not apply to local objects and is therefore not implemented. |
299 * This method is the default implementation of the |
299 * This method is the default implementation of the |
300 * <code>org.omg.CORBA.Object</code> method. |
300 * {@code org.omg.CORBA.Object} method. |
301 * |
301 * |
302 * @param policy_type an <code>int</code> |
302 * @param policy_type an {@code int} |
303 * @return NO_IMPLEMENT because this is a locally constrained object |
303 * @return NO_IMPLEMENT because this is a locally constrained object |
304 * and this method does not apply to local objects |
304 * and this method does not apply to local objects |
305 * @exception NO_IMPLEMENT because this is a locally constrained object |
305 * @exception NO_IMPLEMENT because this is a locally constrained object |
306 * and this method does not apply to local objects |
306 * and this method does not apply to local objects |
307 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
307 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
311 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
311 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
312 } |
312 } |
313 |
313 |
314 |
314 |
315 /** |
315 /** |
316 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
316 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
317 * the message "This is a locally constrained object." This method |
317 * the message "This is a locally constrained object." This method |
318 * does not apply to local objects and is therefore not implemented. |
318 * does not apply to local objects and is therefore not implemented. |
319 * This method is the default implementation of the |
319 * This method is the default implementation of the |
320 * <code>org.omg.CORBA.Object</code> method. |
320 * {@code org.omg.CORBA.Object} method. |
321 * |
321 * |
322 * @exception NO_IMPLEMENT |
322 * @exception NO_IMPLEMENT |
323 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
323 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
324 * comments for unimplemented features</a> |
324 * comments for unimplemented features</a> |
325 */ |
325 */ |
326 public org.omg.CORBA.DomainManager[] _get_domain_managers() { |
326 public org.omg.CORBA.DomainManager[] _get_domain_managers() { |
327 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
327 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
328 } |
328 } |
329 |
329 |
330 /** |
330 /** |
331 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
331 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
332 * the message "This is a locally constrained object." This method |
332 * the message "This is a locally constrained object." This method |
333 * does not apply to local objects and is therefore not implemented. |
333 * does not apply to local objects and is therefore not implemented. |
334 * This method is the default implementation of the |
334 * This method is the default implementation of the |
335 * <code>org.omg.CORBA.Object</code> method. |
335 * {@code org.omg.CORBA.Object} method. |
336 * |
336 * |
337 * @param policies an array |
337 * @param policies an array |
338 * @param set_add a flag |
338 * @param set_add a flag |
339 * @return NO_IMPLEMENT because this is a locally constrained object |
339 * @return NO_IMPLEMENT because this is a locally constrained object |
340 * and this method does not apply to local objects |
340 * and this method does not apply to local objects |
349 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
349 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
350 } |
350 } |
351 |
351 |
352 |
352 |
353 /** |
353 /** |
354 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
354 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
355 * the message "This is a locally constrained object." |
355 * the message "This is a locally constrained object." |
356 * This method is the default implementation of the |
356 * This method is the default implementation of the |
357 * <code>org.omg.CORBA.Object</code> method.<P> |
357 * {@code org.omg.CORBA.Object} method.<P> |
358 * Returns <code>true</code> for this <code>LocalObject</code> instance. |
358 * Returns {@code true} for this {@code LocalObject} instance. |
359 * |
359 * |
360 * @return <code>true</code> always |
360 * @return {@code true} always |
361 * @exception NO_IMPLEMENT |
361 * @exception NO_IMPLEMENT |
362 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
362 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
363 * comments for unimplemented features</a> |
363 * comments for unimplemented features</a> |
364 */ |
364 */ |
365 public boolean _is_local() { |
365 public boolean _is_local() { |
366 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
366 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
367 } |
367 } |
368 |
368 |
369 /** |
369 /** |
370 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
370 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
371 * the message "This is a locally constrained object." |
371 * the message "This is a locally constrained object." |
372 * This method is the default implementation of the |
372 * This method is the default implementation of the |
373 * <code>org.omg.CORBA.Object</code> method. |
373 * {@code org.omg.CORBA.Object} method. |
374 * |
374 * |
375 * @param operation a <code>String</code> indicating which operation |
375 * @param operation a {@code String} indicating which operation |
376 * to preinvoke |
376 * to preinvoke |
377 * @param expectedType the class of the type of operation mentioned above |
377 * @param expectedType the class of the type of operation mentioned above |
378 * @return NO_IMPLEMENT because this is a locally constrained object |
378 * @return NO_IMPLEMENT because this is a locally constrained object |
379 * and this method does not apply to local objects |
379 * and this method does not apply to local objects |
380 * @exception NO_IMPLEMENT because this is a locally constrained object |
380 * @exception NO_IMPLEMENT because this is a locally constrained object |
386 Class expectedType) { |
386 Class expectedType) { |
387 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
387 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
388 } |
388 } |
389 |
389 |
390 /** |
390 /** |
391 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
391 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
392 * the message "This is a locally constrained object." |
392 * the message "This is a locally constrained object." |
393 * This method is the default implementation of the |
393 * This method is the default implementation of the |
394 * <code>org.omg.CORBA.Object</code> method. |
394 * {@code org.omg.CORBA.Object} method. |
395 * |
395 * |
396 * @param servant the servant object on which to post-invoke |
396 * @param servant the servant object on which to post-invoke |
397 * @exception NO_IMPLEMENT |
397 * @exception NO_IMPLEMENT |
398 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
398 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
399 * comments for unimplemented features</a> |
399 * comments for unimplemented features</a> |
406 * The following methods were added by orbos/98-04-03: Java to IDL |
406 * The following methods were added by orbos/98-04-03: Java to IDL |
407 * Mapping. These are used by RMI over IIOP. |
407 * Mapping. These are used by RMI over IIOP. |
408 */ |
408 */ |
409 |
409 |
410 /** |
410 /** |
411 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
411 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
412 * the message "This is a locally constrained object." |
412 * the message "This is a locally constrained object." |
413 * This method is the default implementation of the |
413 * This method is the default implementation of the |
414 * <code>org.omg.CORBA.Object</code> method. |
414 * {@code org.omg.CORBA.Object} method. |
415 * <P>Called by a stub to obtain an OutputStream for |
415 * <P>Called by a stub to obtain an OutputStream for |
416 * marshaling arguments. The stub must supply the operation name, |
416 * marshaling arguments. The stub must supply the operation name, |
417 * and indicate if a response is expected (i.e is this a oneway call). |
417 * and indicate if a response is expected (i.e is this a oneway call). |
418 * |
418 * |
419 * @param operation the name of the operation being requested |
419 * @param operation the name of the operation being requested |
420 * @param responseExpected <code>true</code> if a response is expected, |
420 * @param responseExpected {@code true} if a response is expected, |
421 * <code>false</code> if it is a one-way call |
421 * {@code false} if it is a one-way call |
422 * @return NO_IMPLEMENT because this is a locally constrained object |
422 * @return NO_IMPLEMENT because this is a locally constrained object |
423 * and this method does not apply to local objects |
423 * and this method does not apply to local objects |
424 * @exception NO_IMPLEMENT because this is a locally constrained object |
424 * @exception NO_IMPLEMENT because this is a locally constrained object |
425 * and this method does not apply to local objects |
425 * and this method does not apply to local objects |
426 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
426 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
430 boolean responseExpected) { |
430 boolean responseExpected) { |
431 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
431 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
432 } |
432 } |
433 |
433 |
434 /** |
434 /** |
435 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
435 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
436 * the message "This is a locally constrained object." |
436 * the message "This is a locally constrained object." |
437 * This method is the default implementation of the |
437 * This method is the default implementation of the |
438 * <code>org.omg.CORBA.Object</code> method. |
438 * {@code org.omg.CORBA.Object} method. |
439 * <P>Called to invoke an operation. The stub provides an |
439 * <P>Called to invoke an operation. The stub provides an |
440 * <code>OutputStream</code> that was previously returned by a |
440 * {@code OutputStream} that was previously returned by a |
441 * <code>_request()</code> |
441 * {@code _request()} |
442 * call. <code>_invoke</code> returns an <code>InputStream</code> which |
442 * call. {@code _invoke} returns an {@code InputStream} which |
443 * contains the |
443 * contains the |
444 * marshaled reply. If an exception occurs, <code>_invoke</code> may throw an |
444 * marshaled reply. If an exception occurs, {@code _invoke} may throw an |
445 * <code>ApplicationException</code> object which contains an |
445 * {@code ApplicationException} object which contains an |
446 * <code>InputStream</code> from |
446 * {@code InputStream} from |
447 * which the user exception state may be unmarshaled. |
447 * which the user exception state may be unmarshaled. |
448 * |
448 * |
449 * @param output the <code>OutputStream</code> to invoke |
449 * @param output the {@code OutputStream} to invoke |
450 * @return NO_IMPLEMENT because this is a locally constrained object |
450 * @return NO_IMPLEMENT because this is a locally constrained object |
451 * and this method does not apply to local objects |
451 * and this method does not apply to local objects |
452 * @throws ApplicationException If an exception occurs, |
452 * @throws ApplicationException If an exception occurs, |
453 * <code>_invoke</code> may throw an |
453 * {@code _invoke} may throw an |
454 * <code>ApplicationException</code> object which contains |
454 * {@code ApplicationException} object which contains |
455 * an <code>InputStream</code> from |
455 * an {@code InputStream} from |
456 * which the user exception state may be unmarshaled. |
456 * which the user exception state may be unmarshaled. |
457 * @throws RemarshalException If an exception occurs, |
457 * @throws RemarshalException If an exception occurs, |
458 * <code>_invoke</code> may throw an |
458 * {@code _invoke} may throw an |
459 * <code>ApplicationException</code> object which contains |
459 * {@code ApplicationException} object which contains |
460 * an <code>InputStream</code> from |
460 * an {@code InputStream} from |
461 * which the user exception state may be unmarshaled. |
461 * which the user exception state may be unmarshaled. |
462 * @exception NO_IMPLEMENT because this is a locally constrained object |
462 * @exception NO_IMPLEMENT because this is a locally constrained object |
463 * and this method does not apply to local objects |
463 * and this method does not apply to local objects |
464 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
464 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
465 * comments for unimplemented features</a> |
465 * comments for unimplemented features</a> |
469 { |
469 { |
470 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
470 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
471 } |
471 } |
472 |
472 |
473 /** |
473 /** |
474 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
474 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
475 * the message "This is a locally constrained object." |
475 * the message "This is a locally constrained object." |
476 * This method is the default implementation of the |
476 * This method is the default implementation of the |
477 * <code>org.omg.CORBA.Object</code> method. |
477 * {@code org.omg.CORBA.Object} method. |
478 * <P>May optionally be called by a stub to release a |
478 * <P>May optionally be called by a stub to release a |
479 * reply stream back to the ORB when the unmarshaling has |
479 * reply stream back to the ORB when the unmarshaling has |
480 * completed. The stub passes the <code>InputStream</code> returned by |
480 * completed. The stub passes the {@code InputStream} returned by |
481 * <code>_invoke()</code> or |
481 * {@code _invoke()} or |
482 * <code>ApplicationException.getInputStream()</code>. |
482 * {@code ApplicationException.getInputStream()}. |
483 * A null |
483 * A null |
484 * value may also be passed to <code>_releaseReply</code>, in which case the |
484 * value may also be passed to {@code _releaseReply}, in which case the |
485 * method is a no-op. |
485 * method is a no-op. |
486 * |
486 * |
487 * @param input the reply stream back to the ORB or null |
487 * @param input the reply stream back to the ORB or null |
488 * @exception NO_IMPLEMENT |
488 * @exception NO_IMPLEMENT |
489 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
489 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package |
492 public void _releaseReply(InputStream input) { |
492 public void _releaseReply(InputStream input) { |
493 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
493 throw new org.omg.CORBA.NO_IMPLEMENT(reason); |
494 } |
494 } |
495 |
495 |
496 /** |
496 /** |
497 * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with |
497 * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with |
498 * the message "This is a locally constrained object." This method |
498 * the message "This is a locally constrained object." This method |
499 * does not apply to local objects and is therefore not implemented. |
499 * does not apply to local objects and is therefore not implemented. |
500 * This method is the default implementation of the |
500 * This method is the default implementation of the |
501 * <code>org.omg.CORBA.Object</code> method. |
501 * {@code org.omg.CORBA.Object} method. |
502 * |
502 * |
503 * @return NO_IMPLEMENT because this is a locally constrained object |
503 * @return NO_IMPLEMENT because this is a locally constrained object |
504 * and this method does not apply to local objects |
504 * and this method does not apply to local objects |
505 * @exception NO_IMPLEMENT because this is a locally constrained object |
505 * @exception NO_IMPLEMENT because this is a locally constrained object |
506 * and this method does not apply to local objects |
506 * and this method does not apply to local objects |