src/share/classes/org/omg/CORBA/LocalObject.java

changeset 1
55540e827aef
child 158
91006f157c46
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/src/share/classes/org/omg/CORBA/LocalObject.java	Sat Dec 01 00:00:00 2007 +0000
     1.3 @@ -0,0 +1,500 @@
     1.4 +/*
     1.5 + * Copyright 2000-2001 Sun Microsystems, Inc.  All Rights Reserved.
     1.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     1.7 + *
     1.8 + * This code is free software; you can redistribute it and/or modify it
     1.9 + * under the terms of the GNU General Public License version 2 only, as
    1.10 + * published by the Free Software Foundation.  Sun designates this
    1.11 + * particular file as subject to the "Classpath" exception as provided
    1.12 + * by Sun in the LICENSE file that accompanied this code.
    1.13 + *
    1.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
    1.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    1.16 + * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    1.17 + * version 2 for more details (a copy is included in the LICENSE file that
    1.18 + * accompanied this code).
    1.19 + *
    1.20 + * You should have received a copy of the GNU General Public License version
    1.21 + * 2 along with this work; if not, write to the Free Software Foundation,
    1.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    1.23 + *
    1.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    1.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
    1.26 + * have any questions.
    1.27 + */
    1.28 +
    1.29 +package org.omg.CORBA;
    1.30 +import org.omg.CORBA.portable.*;
    1.31 +
    1.32 +
    1.33 +/**
    1.34 + * <P>Used as a base class for implementation of a local IDL interface in the
    1.35 + * Java language mapping.  It is a class which implements all the operations
    1.36 + * in the <tt>org.omg.CORBA.Object</tt> interface.
    1.37 + * <P>Local interfaces are implemented by using CORBA::LocalObject
    1.38 + *  to provide implementations of <code>Object</code> pseudo
    1.39 + *  operations and any other ORB-specific support mechanisms that are
    1.40 + *  appropriate for such objects.  Object implementation techniques are
    1.41 + *  inherently language-mapping specific.  Therefore, the
    1.42 + *  <code>LocalObject</code> type is not defined in IDL, but is specified
    1.43 + *  in each language mapping.
    1.44 + *  <P>Methods that do not apply to local objects throw
    1.45 + *  an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with the message,
    1.46 + *  "This is a locally contrained object."  Attempting to use a
    1.47 + *  <TT>LocalObject</TT> to create a DII request results in NO_IMPLEMENT
    1.48 + *  system exception.  Attempting to marshal or stringify a
    1.49 + *  <TT>LocalObject</TT> results in a MARSHAL system exception.  Narrowing
    1.50 + *  and widening references to <TT>LocalObjects</TT> must work as for regular
    1.51 + *  object references.
    1.52 + *  <P><code>LocalObject</code> is to be used as the base class of locally
    1.53 + *  constrained objects, such as those in the PortableServer module.
    1.54 + *  The specification here is based on the CORBA Components
    1.55 + *  Volume I - orbos/99-07-01<P>
    1.56 + * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
    1.57 +     *      comments for unimplemented features</a>
    1.58 + */
    1.59 +
    1.60 +public class LocalObject implements org.omg.CORBA.Object
    1.61 +{
    1.62 +    private static String reason = "This is a locally constrained object.";
    1.63 +
    1.64 +    /**
    1.65 +     * Constructs a default <code>LocalObject</code> instance.
    1.66 +     */
    1.67 +    public LocalObject() {}
    1.68 +
    1.69 +    /**
    1.70 +     * <P>Determines whether the two object references are equivalent,
    1.71 +     * so far as the ORB can easily determine. Two object references are equivalent
    1.72 +     * if they are identical. Two distinct object references which in fact refer to
    1.73 +     * the same object are also equivalent. However, ORBs are not required
    1.74 +     * to attempt determination of whether two distinct object references
    1.75 +     * refer to the same object, since such determination could be impractically
    1.76 +     * expensive.
    1.77 +     * <P>Default implementation of the org.omg.CORBA.Object method. <P>
    1.78 +     *
    1.79 +     * @param that the object reference with which to check for equivalence
    1.80 +     * @return <code>true</code> if this object reference is known to be
    1.81 +     *         equivalent to the given object reference.
    1.82 +     *         Note that <code>false</code> indicates only that the two
    1.83 +     *         object references are distinct, not necessarily that
    1.84 +     *         they reference distinct objects.
    1.85 +     */
    1.86 +    public boolean _is_equivalent(org.omg.CORBA.Object that) {
    1.87 +        return equals(that) ;
    1.88 +    }
    1.89 +
    1.90 +    /**
    1.91 +     * Always returns <code>false</code>.
    1.92 +     * This method is the default implementation of the
    1.93 +     * <code>org.omg.CORBA.Object</code> method.<P>
    1.94 +     *
    1.95 +     * @return <code>false</code>
    1.96 +     */
    1.97 +    public boolean _non_existent() {
    1.98 +        return false;
    1.99 +    }
   1.100 +
   1.101 +    /**
   1.102 +     * Returns a hash value that is consistent for the
   1.103 +     * lifetime of the object, using the given number as the maximum.
   1.104 +     * This method is the default implementation of the
   1.105 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.106 +     * @param maximum an <code>int</code> identifying maximum value of
   1.107 +     *                  the hashcode
   1.108 +     * @return this instance's hashcode
   1.109 +     */
   1.110 +    public int _hash(int maximum) {
   1.111 +        return hashCode() ;
   1.112 +    }
   1.113 +
   1.114 +    /**
   1.115 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.116 +     * the message "This is a locally constrained object."  This method
   1.117 +     * does not apply to local objects and is therefore not implemented.
   1.118 +     * This method is the default implementation of the
   1.119 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.120 +     *
   1.121 +     * @param repository_id a <code>String</code>
   1.122 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.123 +     *      and this method does not apply to local objects
   1.124 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.125 +     *      and this method does not apply to local objects
   1.126 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.127 +     *      comments for unimplemented features</a>
   1.128 +     */
   1.129 +    public boolean _is_a(String repository_id) {
   1.130 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.131 +    }
   1.132 +
   1.133 +    /**
   1.134 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.135 +     * the message "This is a locally constrained object."
   1.136 +     * This method is the default implementation of the
   1.137 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.138 +     * @return a duplicate of this <code>LocalObject</code> instance.
   1.139 +     * @exception NO_IMPLEMENT
   1.140 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.141 +     *      comments for unimplemented features</a>
   1.142 +     */
   1.143 +    public org.omg.CORBA.Object _duplicate() {
   1.144 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.145 +    }
   1.146 +
   1.147 +    /**
   1.148 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.149 +     * the message "This is a locally constrained object."
   1.150 +     * This method is the default implementation of the
   1.151 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.152 +     * @exception NO_IMPLEMENT
   1.153 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.154 +     *      comments for unimplemented features</a>
   1.155 +     */
   1.156 +    public void _release() {
   1.157 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.158 +    }
   1.159 +
   1.160 +    /**
   1.161 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.162 +     * the message "This is a locally constrained object."
   1.163 +     * This method is the default implementation of the
   1.164 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.165 +     *
   1.166 +     * @param operation a <code>String</code> giving the name of an operation
   1.167 +     *        to be performed by the request that is returned
   1.168 +     * @return a <code>Request</code> object with the given operation
   1.169 +     * @exception NO_IMPLEMENT
   1.170 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.171 +     *      comments for unimplemented features</a>
   1.172 +     */
   1.173 +    public Request _request(String operation) {
   1.174 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.175 +    }
   1.176 +
   1.177 +    /**
   1.178 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.179 +     * the message "This is a locally constrained object."
   1.180 +     * This method is the default implementation of the
   1.181 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.182 +     *
   1.183 +     * @param ctx          a <code>Context</code> object containing
   1.184 +     *                     a list of properties
   1.185 +     * @param operation    the <code>String</code> representing the name of the
   1.186 +     *                     method to be invoked
   1.187 +     * @param arg_list     an <code>NVList</code> containing the actual arguments
   1.188 +     *                     to the method being invoked
   1.189 +     * @param result       a <code>NamedValue</code> object to serve as a
   1.190 +     *                     container for the method's return value
   1.191 +     * @return a new <code>Request</code> object initialized with the given
   1.192 +     * arguments
   1.193 +     * @exception NO_IMPLEMENT
   1.194 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.195 +     *      comments for unimplemented features</a>
   1.196 +     */
   1.197 +    public Request _create_request(Context ctx,
   1.198 +                                   String operation,
   1.199 +                                   NVList arg_list,
   1.200 +                                   NamedValue result) {
   1.201 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.202 +    }
   1.203 +
   1.204 +    /**
   1.205 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.206 +     * the message "This is a locally constrained object."
   1.207 +     * This method is the default implementation of the
   1.208 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.209 +     *
   1.210 +     * @param ctx          a <code>Context</code> object containing
   1.211 +     *                     a list of properties
   1.212 +     * @param operation    the name of the method to be invoked
   1.213 +     * @param arg_list     an <code>NVList</code> containing the actual arguments
   1.214 +     *                     to the method being invoked
   1.215 +     * @param result       a <code>NamedValue</code> object to serve as a
   1.216 +     *                     container for the method's return value
   1.217 +     * @param exceptions   an <code>ExceptionList</code> object containing a
   1.218 +     *                     list of possible exceptions the method can throw
   1.219 +     * @param contexts     a <code>ContextList</code> object containing a list of
   1.220 +     *                     context strings that need to be resolved and sent
   1.221 +     *                     with the
   1.222 +     *                     <code>Request</code> instance
   1.223 +     * @return the new <code>Request</code> object initialized with the given
   1.224 +     * arguments
   1.225 +     * @exception NO_IMPLEMENT
   1.226 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.227 +     *      comments for unimplemented features</a>
   1.228 +     */
   1.229 +    public Request _create_request(Context ctx,
   1.230 +                                   String operation,
   1.231 +                                   NVList arg_list,
   1.232 +                                   NamedValue result,
   1.233 +                                   ExceptionList exceptions,
   1.234 +                                   ContextList contexts) {
   1.235 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.236 +    }
   1.237 +
   1.238 +    /**
   1.239 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.240 +     * the message "This is a locally constrained object." This method
   1.241 +     * does not apply to local objects and is therefore not implemented.
   1.242 +     * This method is the default implementation of the
   1.243 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.244 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.245 +     *      and this method does not apply to local objects
   1.246 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.247 +     *      and this method does not apply to local objects
   1.248 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.249 +     *      comments for unimplemented features</a>
   1.250 +     */
   1.251 +    public org.omg.CORBA.Object _get_interface()
   1.252 +    {
   1.253 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.254 +    }
   1.255 +
   1.256 +    /**
   1.257 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.258 +     * the message "This is a locally constrained object."
   1.259 +     * This method is the default implementation of the
   1.260 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.261 +     * @exception NO_IMPLEMENT
   1.262 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.263 +     *      comments for unimplemented features</a>
   1.264 +     */
   1.265 +    public org.omg.CORBA.Object _get_interface_def()
   1.266 +    {
   1.267 +        // First try to call the delegate implementation class's
   1.268 +        // "Object get_interface_def(..)" method (will work for JDK1.2
   1.269 +        // ORBs).
   1.270 +        // Else call the delegate implementation class's
   1.271 +        // "InterfaceDef get_interface(..)" method using reflection
   1.272 +        // (will work for pre-JDK1.2 ORBs).
   1.273 +
   1.274 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.275 +    }
   1.276 +
   1.277 +    /**
   1.278 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.279 +     * the message "This is a locally constrained object."
   1.280 +     * This method is the default implementation of the
   1.281 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.282 +     * @return the ORB instance that created the Delegate contained in this
   1.283 +     * <code>ObjectImpl</code>
   1.284 +     * @exception NO_IMPLEMENT
   1.285 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.286 +     *      comments for unimplemented features</a>
   1.287 +     */
   1.288 +    public org.omg.CORBA.ORB _orb() {
   1.289 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.290 +    }
   1.291 +
   1.292 +    /**
   1.293 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.294 +     * the message "This is a locally constrained object." This method
   1.295 +     * does not apply to local objects and is therefore not implemented.
   1.296 +     * This method is the default implementation of the
   1.297 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.298 +     * @param policy_type  an <code>int</code>
   1.299 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.300 +     *      and this method does not apply to local objects
   1.301 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.302 +     *      and this method does not apply to local objects
   1.303 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.304 +     *      comments for unimplemented features</a>
   1.305 +     */
   1.306 +    public org.omg.CORBA.Policy _get_policy(int policy_type) {
   1.307 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.308 +    }
   1.309 +
   1.310 +
   1.311 +    /**
   1.312 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.313 +     * the message "This is a locally constrained object." This method
   1.314 +     * does not apply to local objects and is therefore not implemented.
   1.315 +     * This method is the default implementation of the
   1.316 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.317 +     * @exception NO_IMPLEMENT
   1.318 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.319 +     *      comments for unimplemented features</a>
   1.320 +     */
   1.321 +    public org.omg.CORBA.DomainManager[] _get_domain_managers() {
   1.322 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.323 +    }
   1.324 +
   1.325 +    /**
   1.326 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.327 +     * the message "This is a locally constrained object." This method
   1.328 +     * does not apply to local objects and is therefore not implemented.
   1.329 +     * This method is the default implementation of the
   1.330 +     * <code>org.omg.CORBA.Object</code> method.
   1.331 +     *
   1.332 +     * @param policies an array
   1.333 +     * @param set_add a flag
   1.334 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.335 +     *      and this method does not apply to local objects
   1.336 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.337 +     *      and this method does not apply to local objects
   1.338 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.339 +     *      comments for unimplemented features</a>
   1.340 +     */
   1.341 +    public org.omg.CORBA.Object
   1.342 +        _set_policy_override(org.omg.CORBA.Policy[] policies,
   1.343 +                             org.omg.CORBA.SetOverrideType set_add) {
   1.344 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.345 +    }
   1.346 +
   1.347 +
   1.348 +    /**
   1.349 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.350 +     * the message "This is a locally constrained object."
   1.351 +     * This method is the default implementation of the
   1.352 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.353 +     * Returns <code>true</code> for this <code>LocalObject</code> instance.<P>
   1.354 +     * @return <code>true</code> always
   1.355 +     * @exception NO_IMPLEMENT
   1.356 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.357 +     *      comments for unimplemented features</a>
   1.358 +     */
   1.359 +    public boolean _is_local() {
   1.360 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.361 +    }
   1.362 +
   1.363 +    /**
   1.364 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.365 +     * the message "This is a locally constrained object."
   1.366 +     * This method is the default implementation of the
   1.367 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.368 +     * @param operation a <code>String</code> indicating which operation
   1.369 +     *                  to preinvoke
   1.370 +     * @param expectedType the class of the type of operation mentioned above
   1.371 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.372 +     *      and this method does not apply to local objects
   1.373 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.374 +     *      and this method does not apply to local object
   1.375 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.376 +     *      comments for unimplemented features</a>
   1.377 +     */
   1.378 +    public ServantObject _servant_preinvoke(String operation,
   1.379 +                                            Class expectedType) {
   1.380 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.381 +    }
   1.382 +
   1.383 +    /**
   1.384 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.385 +     * the message "This is a locally constrained object."
   1.386 +     * This method is the default implementation of the
   1.387 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.388 +     * @param servant the servant object on which to post-invoke
   1.389 +     * @exception NO_IMPLEMENT
   1.390 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.391 +     *      comments for unimplemented features</a>
   1.392 +     */
   1.393 +    public void _servant_postinvoke(ServantObject servant) {
   1.394 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.395 +    }
   1.396 +
   1.397 +    /*
   1.398 +     * The following methods were added by orbos/98-04-03: Java to IDL
   1.399 +     * Mapping. These are used by RMI over IIOP.
   1.400 +     */
   1.401 +
   1.402 +    /**
   1.403 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.404 +     * the message "This is a locally constrained object."
   1.405 +     * This method is the default implementation of the
   1.406 +     * <code>org.omg.CORBA.Object</code> method.
   1.407 +     * <P>Called by a stub to obtain an OutputStream for
   1.408 +     * marshaling arguments. The stub must supply the operation name,
   1.409 +     * and indicate if a response is expected (i.e is this a oneway
   1.410 +     * call).<P>
   1.411 +     * @param operation the name of the operation being requested
   1.412 +     * @param responseExpected <code>true</code> if a response is expected,
   1.413 +     *                         <code>false</code> if it is a one-way call
   1.414 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.415 +     *      and this method does not apply to local objects
   1.416 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.417 +     *      and this method does not apply to local objects
   1.418 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.419 +     *      comments for unimplemented features</a>
   1.420 +     */
   1.421 +    public OutputStream _request(String operation,
   1.422 +                                 boolean responseExpected) {
   1.423 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.424 +    }
   1.425 +
   1.426 +    /**
   1.427 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.428 +     * the message "This is a locally constrained object."
   1.429 +     * This method is the default implementation of the
   1.430 +     * <code>org.omg.CORBA.Object</code> method.
   1.431 +     * <P>Called to invoke an operation. The stub provides an
   1.432 +     * <code>OutputStream</code> that was previously returned by a
   1.433 +     * <code>_request()</code>
   1.434 +     * call. <code>_invoke</code> returns an <code>InputStream</code> which
   1.435 +     * contains the
   1.436 +     * marshaled reply. If an exception occurs, <code>_invoke</code> may throw an
   1.437 +     * <code>ApplicationException</code> object which contains an
   1.438 +     * <code>InputStream</code> from
   1.439 +     * which the user exception state may be unmarshaled.<P>
   1.440 +     * @param output the <code>OutputStream</code> to invoke
   1.441 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.442 +     *      and this method does not apply to local objects
   1.443 +     * @throws ApplicationException If an exception occurs,
   1.444 +     * <code>_invoke</code> may throw an
   1.445 +     * <code>ApplicationException</code> object which contains
   1.446 +     * an <code>InputStream</code> from
   1.447 +     * which the user exception state may be unmarshaled.
   1.448 +     * @throws RemarshalException If an exception occurs,
   1.449 +     * <code>_invoke</code> may throw an
   1.450 +     * <code>ApplicationException</code> object which contains
   1.451 +     * an <code>InputStream</code> from
   1.452 +     * which the user exception state may be unmarshaled.
   1.453 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.454 +     *      and this method does not apply to local objects
   1.455 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.456 +     *      comments for unimplemented features</a>
   1.457 +     */
   1.458 +    public InputStream _invoke(OutputStream output)
   1.459 +        throws ApplicationException, RemarshalException
   1.460 +    {
   1.461 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.462 +    }
   1.463 +
   1.464 +    /**
   1.465 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.466 +     * the message "This is a locally constrained object."
   1.467 +     * This method is the default implementation of the
   1.468 +     * <code>org.omg.CORBA.Object</code> method.
   1.469 +     * <P>May optionally be called by a stub to release a
   1.470 +     * reply stream back to the ORB when the unmarshaling has
   1.471 +     * completed. The stub passes the <code>InputStream</code> returned by
   1.472 +     * <code>_invoke()</code> or
   1.473 +     * <code>ApplicationException.getInputStream()</code>.
   1.474 +     * A null
   1.475 +     * value may also be passed to <code>_releaseReply</code>, in which case the
   1.476 +     * method is a no-op.<P>
   1.477 +     * @param input the reply stream back to the ORB or null
   1.478 +     * @exception NO_IMPLEMENT
   1.479 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.480 +     *      comments for unimplemented features</a>
   1.481 +     */
   1.482 +    public void _releaseReply(InputStream input) {
   1.483 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.484 +    }
   1.485 +
   1.486 +    /**
   1.487 +     * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
   1.488 +     * the message "This is a locally constrained object." This method
   1.489 +     * does not apply to local objects and is therefore not implemented.
   1.490 +     * This method is the default implementation of the
   1.491 +     * <code>org.omg.CORBA.Object</code> method.<P>
   1.492 +     * @return NO_IMPLEMENT because this is a locally constrained object
   1.493 +     *      and this method does not apply to local objects
   1.494 +     * @exception NO_IMPLEMENT because this is a locally constrained object
   1.495 +     *      and this method does not apply to local objects
   1.496 +     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
   1.497 +     *      comments for unimplemented features</a>
   1.498 +     */
   1.499 +
   1.500 +    public boolean validate_connection() {
   1.501 +        throw new org.omg.CORBA.NO_IMPLEMENT(reason);
   1.502 +    }
   1.503 +}

mercurial