jdk8-mips64-public/corba: src/share/classes/org/omg/CORBA/LocalObject.java@a12ea7c7b497 (annotated)

src/share/classes/org/omg/CORBA/LocalObject.java@a12ea7c7b497 (annotated)

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

Tue, 28 Jul 2009 12:12:36 -0700

author: xdono
date: Tue, 28 Jul 2009 12:12:36 -0700
changeset 98: a12ea7c7b497
parent 1: 55540e827aef
child 158: 91006f157c46
permissions: -rw-r--r--

6862919: Update copyright year
Summary: Update copyright for files that have been modified in 2009, up to 07/09
Reviewed-by: tbell, ohair

 /*
  * Copyright 2000-2001 Sun Microsystems, Inc.  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.  Sun designates this
  * particular file as subject to the "Classpath" exception as provided
  * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  * CA 95054 USA or visit www.sun.com if you need additional information or
  * have any questions.
  */
 package org.omg.CORBA;
 import org.omg.CORBA.portable.*;
 /**
  * <P>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
  * in the <tt>org.omg.CORBA.Object</tt> interface.
  * <P>Local interfaces are implemented by using CORBA::LocalObject
  *  to provide implementations of <code>Object</code> pseudo
  *  operations and any other ORB-specific support mechanisms that are
  *  appropriate for such objects.  Object implementation techniques are
  *  inherently language-mapping specific.  Therefore, the
  *  <code>LocalObject</code> type is not defined in IDL, but is specified
  *  in each language mapping.
  *  <P>Methods that do not apply to local objects throw
  *  an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with the message,
  *  "This is a locally contrained object."  Attempting to use a
  *  <TT>LocalObject</TT> to create a DII request results in NO_IMPLEMENT
  *  system exception.  Attempting to marshal or stringify a
  *  <TT>LocalObject</TT> results in a MARSHAL system exception.  Narrowing
  *  and widening references to <TT>LocalObjects</TT> must work as for regular
  *  object references.
  *  <P><code>LocalObject</code> is to be used as the base class of locally
  *  constrained objects, such as those in the PortableServer module.
  *  The specification here is based on the CORBA Components
  *  Volume I - orbos/99-07-01<P>
  * @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.";
     /**
      * Constructs a default <code>LocalObject</code> instance.
      */
     public LocalObject() {}
     /**
      * <P>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. <P>
      *
      * @param that the object reference with which to check for equivalence
      * @return <code>true</code> if this object reference is known to be
      *         equivalent to the given object reference.
      *         Note that <code>false</code> indicates only that the two
      *         object references are distinct, not necessarily that
      *         they reference distinct objects.
      */
     public boolean _is_equivalent(org.omg.CORBA.Object that) {
         return equals(that) ;
     }
     /**
      * Always returns <code>false</code>.
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      *
      * @return <code>false</code>
      */
     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
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @param maximum an <code>int</code> identifying maximum value of
      *                  the hashcode
      * @return this instance's hashcode
      */
     public int _hash(int maximum) {
         return hashCode() ;
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * 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
      * <code>org.omg.CORBA.Object</code> method.<P>
      *
      * @param repository_id a <code>String</code>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @return a duplicate of this <code>LocalObject</code> instance.
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      *
      * @param operation a <code>String</code> giving the name of an operation
      *        to be performed by the request that is returned
      * @return a <code>Request</code> object with the given operation
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      *
      * @param ctx          a <code>Context</code> object containing
      *                     a list of properties
      * @param operation    the <code>String</code> representing the name of the
      *                     method to be invoked
      * @param arg_list     an <code>NVList</code> containing the actual arguments
      *                     to the method being invoked
      * @param result       a <code>NamedValue</code> object to serve as a
      *                     container for the method's return value
      * @return a new <code>Request</code> object initialized with the given
      * 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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      *
      * @param ctx          a <code>Context</code> object containing
      *                     a list of properties
      * @param operation    the name of the method to be invoked
      * @param arg_list     an <code>NVList</code> containing the actual arguments
      *                     to the method being invoked
      * @param result       a <code>NamedValue</code> object to serve as a
      *                     container for the method's return value
      * @param exceptions   an <code>ExceptionList</code> object containing a
      *                     list of possible exceptions the method can throw
      * @param contexts     a <code>ContextList</code> object containing a list of
      *                     context strings that need to be resolved and sent
      *                     with the
      *                     <code>Request</code> instance
      * @return the new <code>Request</code> object initialized with the given
      * 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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * 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
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @return the ORB instance that created the Delegate contained in this
      * <code>ObjectImpl</code>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * 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
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @param policy_type  an <code>int</code>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * 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
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * 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
      * <code>org.omg.CORBA.Object</code> method.
      *
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * Returns <code>true</code> for this <code>LocalObject</code> instance.<P>
      * @return <code>true</code> always
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @param operation a <code>String</code> indicating which operation
      *                  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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @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.
      */
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.
      * <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).<P>
      * @param operation the name of the operation being requested
      * @param responseExpected <code>true</code> if a response is expected,
      *                         <code>false</code> if it is a one-way call
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.
      * <P>Called to invoke an operation. The stub provides an
      * <code>OutputStream</code> that was previously returned by a
      * <code>_request()</code>
      * call. <code>_invoke</code> returns an <code>InputStream</code> which
      * contains the
      * marshaled reply. If an exception occurs, <code>_invoke</code> may throw an
      * <code>ApplicationException</code> object which contains an
      * <code>InputStream</code> from
      * which the user exception state may be unmarshaled.<P>
      * @param output the <code>OutputStream</code> to invoke
      * @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,
      * <code>_invoke</code> may throw an
      * <code>ApplicationException</code> object which contains
      * an <code>InputStream</code> from
      * which the user exception state may be unmarshaled.
      * @throws RemarshalException If an exception occurs,
      * <code>_invoke</code> may throw an
      * <code>ApplicationException</code> object which contains
      * an <code>InputStream</code> from
      * 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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * the message "This is a locally constrained object."
      * This method is the default implementation of the
      * <code>org.omg.CORBA.Object</code> method.
      * <P>May optionally be called by a stub to release a
      * reply stream back to the ORB when the unmarshaling has
      * completed. The stub passes the <code>InputStream</code> returned by
      * <code>_invoke()</code> or
      * <code>ApplicationException.getInputStream()</code>.
      * A null
      * value may also be passed to <code>_releaseReply</code>, in which case the
      * method is a no-op.<P>
      * @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);
     }
     /**
      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with
      * 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
      * <code>org.omg.CORBA.Object</code> method.<P>
      * @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 validate_connection() {
         throw new org.omg.CORBA.NO_IMPLEMENT(reason);
     }
 }

Mercurial > jdk8-mips64-public > corba / annotate

src/share/classes/org/omg/CORBA/LocalObject.java@a12ea7c7b497 (annotated)

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