/*

 * Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

package org.omg.CORBA;

import org.omg.CORBA.portable.*;

/**

 * Used as a base class for implementation of a local IDL interface in the

 * Java language mapping.  It is a class which implements all the operations

 * <P>Local interfaces are implemented by using CORBA::LocalObject

 *

 * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

 *      comments for unimplemented features</a>

 */

public class LocalObject implements org.omg.CORBA.Object

{

    private static String reason = "This is a locally constrained object.";

    /**

     */

    public LocalObject() {}

    /**

     * Determines whether the two object references are equivalent,

     * so far as the ORB can easily determine. Two object references are equivalent

     * if they are identical. Two distinct object references which in fact refer to

     * the same object are also equivalent. However, ORBs are not required

     * to attempt determination of whether two distinct object references

     * refer to the same object, since such determination could be impractically

     * expensive.

     * <P>Default implementation of the org.omg.CORBA.Object method.

     *

     * @param that the object reference with which to check for equivalence

     *         equivalent to the given object reference.

     *         object references are distinct, not necessarily that

     *         they reference distinct objects.

     */

    public boolean _is_equivalent(org.omg.CORBA.Object that) {

        return equals(that) ;

    }

    /**

     * This method is the default implementation of the

     *

     */

    public boolean _non_existent() {

        return false;

    }

    /**

     * Returns a hash value that is consistent for the

     * lifetime of the object, using the given number as the maximum.

     * This method is the default implementation of the

     *

     *                the hashcode

     * @return this instance's hashcode

     */

    public int _hash(int maximum) {

        return hashCode() ;

    }

    /**

     * the message "This is a locally constrained object."  This method

     * does not apply to local objects and is therefore not implemented.

     * This method is the default implementation of the

     *

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public boolean _is_a(String repository_id) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.Object _duplicate() {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public void _release() {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     *        to be performed by the request that is returned

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public Request _request(String operation) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     *                     a list of properties

     *                     method to be invoked

     *                     to the method being invoked

     *                     container for the method's return value

     * arguments

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public Request _create_request(Context ctx,

                                   String operation,

                                   NVList arg_list,

                                   NamedValue result) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     *                     a list of properties

     * @param operation    the name of the method to be invoked

     *                     to the method being invoked

     *                     container for the method's return value

     *                     list of possible exceptions the method can throw

     *                     context strings that need to be resolved and sent

     *                     with the

     * arguments

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public Request _create_request(Context ctx,

                                   String operation,

                                   NVList arg_list,

                                   NamedValue result,

                                   ExceptionList exceptions,

                                   ContextList contexts) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object." This method

     * does not apply to local objects and is therefore not implemented.

     * This method is the default implementation of the

     *

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.Object _get_interface()

    {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.Object _get_interface_def()

    {

        // First try to call the delegate implementation class's

        // "Object get_interface_def(..)" method (will work for JDK1.2

        // ORBs).

        // Else call the delegate implementation class's

        // "InterfaceDef get_interface(..)" method using reflection

        // (will work for pre-JDK1.2 ORBs).

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     * @return the ORB instance that created the Delegate contained in this

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.ORB _orb() {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object." This method

     * does not apply to local objects and is therefore not implemented.

     * This method is the default implementation of the

     *

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.Policy _get_policy(int policy_type) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object." This method

     * does not apply to local objects and is therefore not implemented.

     * This method is the default implementation of the

     *

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.DomainManager[] _get_domain_managers() {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object." This method

     * does not apply to local objects and is therefore not implemented.

     * This method is the default implementation of the

     *

     * @param policies an array

     * @param set_add a flag

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public org.omg.CORBA.Object

        _set_policy_override(org.omg.CORBA.Policy[] policies,

                             org.omg.CORBA.SetOverrideType set_add) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public boolean _is_local() {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     *                  to preinvoke

     * @param expectedType the class of the type of operation mentioned above

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local object

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public ServantObject _servant_preinvoke(String operation,

                                            Class expectedType) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     *

     * @param servant the servant object on which to post-invoke

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public void _servant_postinvoke(ServantObject servant) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /*

     * The following methods were added by orbos/98-04-03: Java to IDL

     * Mapping. These are used by RMI over IIOP.

     */

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     * <P>Called by a stub to obtain an OutputStream for

     * marshaling arguments. The stub must supply the operation name,

     * and indicate if a response is expected (i.e is this a oneway call).

     *

     * @param operation the name of the operation being requested

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public OutputStream _request(String operation,

                                 boolean responseExpected) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     * <P>Called to invoke an operation. The stub provides an

     * contains the

     * which the user exception state may be unmarshaled.

     *

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @throws ApplicationException If an exception occurs,

     * which the user exception state may be unmarshaled.

     * @throws RemarshalException If an exception occurs,

     * which the user exception state may be unmarshaled.

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public InputStream _invoke(OutputStream output)

        throws ApplicationException, RemarshalException

    {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object."

     * This method is the default implementation of the

     * <P>May optionally be called by a stub to release a

     * reply stream back to the ORB when the unmarshaling has

     * A null

     * method is a no-op.

     *

     * @param input the reply stream back to the ORB or null

     * @exception NO_IMPLEMENT

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>

     */

    public void _releaseReply(InputStream input) {

        throw new org.omg.CORBA.NO_IMPLEMENT(reason);

    }

    /**

     * the message "This is a locally constrained object." This method

     * does not apply to local objects and is therefore not implemented.

     * This method is the default implementation of the

     *

     * @return NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @exception NO_IMPLEMENT because this is a locally constrained object

     *      and this method does not apply to local objects

     * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package

     *      comments for unimplemented features</a>