You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
535 lines
21 KiB
535 lines
21 KiB
/*
|
|
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
package org.omg.CORBA.portable;
|
|
|
|
import org.omg.CORBA.Request;
|
|
import org.omg.CORBA.NamedValue;
|
|
import org.omg.CORBA.NVList;
|
|
import org.omg.CORBA.ExceptionList;
|
|
import org.omg.CORBA.ContextList;
|
|
import org.omg.CORBA.Context;
|
|
import org.omg.CORBA.TypeCode;
|
|
import org.omg.CORBA.BAD_OPERATION;
|
|
import org.omg.CORBA.SystemException;
|
|
|
|
|
|
/**
|
|
* The common base class for all stub classes; provides default implementations
|
|
* of the <code>org.omg.CORBA.Object</code> methods. All method implementations are
|
|
* forwarded to a <code>Delegate</code> object stored in the <code>ObjectImpl</code>
|
|
* instance. <code>ObjectImpl</code> allows for portable stubs because the
|
|
* <code>Delegate</code> can be implemented by a different vendor-specific ORB.
|
|
*/
|
|
|
|
abstract public class ObjectImpl implements org.omg.CORBA.Object
|
|
{
|
|
|
|
/**
|
|
* The field that stores the <code>Delegate</code> instance for
|
|
* this <code>ObjectImpl</code> object. This <code>Delegate</code>
|
|
* instance can be implemented by a vendor-specific ORB. Stub classes,
|
|
* which are derived from this <code>ObjectImpl</code> class, can be
|
|
* portable because they delegate all of the methods called on them to this
|
|
* <code>Delegate</code> object.
|
|
*/
|
|
private transient Delegate __delegate;
|
|
|
|
|
|
/**
|
|
* Retrieves the reference to the vendor-specific <code>Delegate</code>
|
|
* object to which this <code>ObjectImpl</code> object delegates all
|
|
* methods invoked on it.
|
|
*
|
|
* @return the Delegate contained in this ObjectImpl instance
|
|
* @throws BAD_OPERATION if the delegate has not been set
|
|
* @see #_set_delegate
|
|
*/
|
|
public Delegate _get_delegate() {
|
|
if (__delegate == null)
|
|
throw new BAD_OPERATION("The delegate has not been set!");
|
|
return __delegate;
|
|
}
|
|
|
|
|
|
/**
|
|
* Sets the Delegate for this <code>ObjectImpl</code> instance to the given
|
|
* <code>Delegate</code> object. All method invocations on this
|
|
* <code>ObjectImpl</code> object will be forwarded to this delegate.
|
|
*
|
|
* @param delegate the <code>Delegate</code> instance to which
|
|
* all method calls on this <code>ObjectImpl</code> object
|
|
* will be delegated; may be implemented by a third-party ORB
|
|
* @see #_get_delegate
|
|
*/
|
|
public void _set_delegate(Delegate delegate) {
|
|
__delegate = delegate;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a string array containing the repository identifiers
|
|
* supported by this <code>ObjectImpl</code> object. For example,
|
|
* for a stub, this method returns information about all the
|
|
* interfaces supported by the stub.
|
|
*
|
|
* @return the array of all repository identifiers supported by this
|
|
* <code>ObjectImpl</code> instance
|
|
*/
|
|
public abstract String[] _ids();
|
|
|
|
|
|
/**
|
|
* Returns a duplicate of this <code>ObjectImpl</code> object.
|
|
*
|
|
* @return an <code>orb.omg.CORBA.Object</code> object that is
|
|
* a duplicate of this object
|
|
*/
|
|
public org.omg.CORBA.Object _duplicate() {
|
|
return _get_delegate().duplicate(this);
|
|
}
|
|
|
|
/**
|
|
* Releases the resources associated with this <code>ObjectImpl</code> object.
|
|
*/
|
|
public void _release() {
|
|
_get_delegate().release(this);
|
|
}
|
|
|
|
/**
|
|
* Checks whether the object identified by the given repository
|
|
* identifier is an <code>ObjectImpl</code> object.
|
|
*
|
|
* @param repository_id a <code>String</code> object with the repository
|
|
* identifier to check
|
|
* @return <code>true</code> if the object identified by the given
|
|
* repository id is an instance of <code>ObjectImpl</code>;
|
|
* <code>false</code> otherwise
|
|
*/
|
|
public boolean _is_a(String repository_id) {
|
|
return _get_delegate().is_a(this, repository_id);
|
|
}
|
|
|
|
/**
|
|
* Checks whether the the given <code>ObjectImpl</code> object is
|
|
* equivalent to this <code>ObjectImpl</code> object.
|
|
*
|
|
* @param that an instance of <code>ObjectImpl</code> to compare with
|
|
* this <code>ObjectImpl</code> object
|
|
* @return <code>true</code> if the given object is equivalent
|
|
* to this <code>ObjectImpl</code> object;
|
|
* <code>false</code> otherwise
|
|
*/
|
|
public boolean _is_equivalent(org.omg.CORBA.Object that) {
|
|
return _get_delegate().is_equivalent(this, that);
|
|
}
|
|
|
|
/**
|
|
* Checks whether the server object for this <code>ObjectImpl</code>
|
|
* object has been destroyed.
|
|
*
|
|
* @return <code>true</code> if the ORB knows authoritatively that the
|
|
* server object does not exist; <code>false</code> otherwise
|
|
*/
|
|
public boolean _non_existent() {
|
|
return _get_delegate().non_existent(this);
|
|
}
|
|
|
|
/**
|
|
* Retrieves the hash code that serves as an ORB-internal identifier for
|
|
* this <code>ObjectImpl</code> object.
|
|
*
|
|
* @param maximum an <code>int</code> indicating the upper bound on the hash
|
|
* value returned by the ORB
|
|
* @return an <code>int</code> representing the hash code for this
|
|
* <code>ObjectImpl</code> object
|
|
*/
|
|
public int _hash(int maximum) {
|
|
return _get_delegate().hash(this, maximum);
|
|
}
|
|
|
|
/**
|
|
* Creates a <code>Request</code> object containing the given method
|
|
* that can be used with the Dynamic Invocation Interface.
|
|
*
|
|
* @param operation the method to be invoked by the new <code>Request</code>
|
|
* object
|
|
* @return a new <code>Request</code> object initialized with the
|
|
* given method
|
|
*/
|
|
public Request _request(String operation) {
|
|
return _get_delegate().request(this, operation);
|
|
}
|
|
|
|
/**
|
|
* Creates a <code>Request</code> object that contains the given context,
|
|
* method, argument list, and container for the result.
|
|
*
|
|
* @param ctx the Context for the request
|
|
* @param operation the method that the new <code>Request</code>
|
|
* object will invoke
|
|
* @param arg_list the arguments for the method; an <code>NVList</code>
|
|
* in which each argument is a <code>NamedValue</code> object
|
|
* @param result a <code>NamedValue</code> object to be used for
|
|
* returning the result of executing the request's method
|
|
* @return a new <code>Request</code> object initialized with the
|
|
* given context, method, argument list, and container for the
|
|
* return value
|
|
*/
|
|
public Request _create_request(Context ctx,
|
|
String operation,
|
|
NVList arg_list,
|
|
NamedValue result) {
|
|
return _get_delegate().create_request(this,
|
|
ctx,
|
|
operation,
|
|
arg_list,
|
|
result);
|
|
}
|
|
|
|
/**
|
|
* Creates a <code>Request</code> object that contains the given context,
|
|
* method, argument list, container for the result, exceptions, and
|
|
* list of property names to be used in resolving the context strings.
|
|
* This <code>Request</code> object is for use in the Dynamic
|
|
* Invocation Interface.
|
|
*
|
|
* @param ctx the <code>Context</code> object that contains the
|
|
* context strings that must be resolved before they are
|
|
* sent along with the request
|
|
* @param operation the method that the new <code>Request</code>
|
|
* object will invoke
|
|
* @param arg_list the arguments for the method; an <code>NVList</code>
|
|
* in which each argument is a <code>NamedValue</code> object
|
|
* @param result a <code>NamedValue</code> object to be used for
|
|
* returning the result of executing the request's method
|
|
* @param exceptions a list of the exceptions that the given method
|
|
* throws
|
|
* @param contexts a list of the properties that are needed to
|
|
* resolve the contexts in <i>ctx</i>; the strings in
|
|
* <i>contexts</i> are used as arguments to the method
|
|
* <code>Context.get_values</code>,
|
|
* which returns the value associated with the given property
|
|
* @return a new <code>Request</code> object initialized with the
|
|
* given context strings to resolve, method, argument list,
|
|
* container for the result, exceptions, and list of property
|
|
* names to be used in resolving the context strings
|
|
*/
|
|
public Request _create_request(Context ctx,
|
|
String operation,
|
|
NVList arg_list,
|
|
NamedValue result,
|
|
ExceptionList exceptions,
|
|
ContextList contexts) {
|
|
return _get_delegate().create_request(this,
|
|
ctx,
|
|
operation,
|
|
arg_list,
|
|
result,
|
|
exceptions,
|
|
contexts);
|
|
}
|
|
|
|
/**
|
|
* Retrieves the interface definition for this <code>ObjectImpl</code>
|
|
* object.
|
|
*
|
|
* @return the <code>org.omg.CORBA.Object</code> instance that is the
|
|
* interface definition for this <code>ObjectImpl</code> object
|
|
*/
|
|
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).
|
|
|
|
org.omg.CORBA.portable.Delegate delegate = _get_delegate();
|
|
try {
|
|
// If the ORB's delegate class does not implement
|
|
// "Object get_interface_def(..)", this will call
|
|
// get_interface_def(..) on portable.Delegate.
|
|
return delegate.get_interface_def(this);
|
|
}
|
|
catch( org.omg.CORBA.NO_IMPLEMENT ex ) {
|
|
// Call "InterfaceDef get_interface(..)" method using reflection.
|
|
try {
|
|
Class[] argc = { org.omg.CORBA.Object.class };
|
|
java.lang.reflect.Method meth =
|
|
delegate.getClass().getMethod("get_interface", argc);
|
|
Object[] argx = { this };
|
|
return (org.omg.CORBA.Object)meth.invoke(delegate, argx);
|
|
}
|
|
catch( java.lang.reflect.InvocationTargetException exs ) {
|
|
Throwable t = exs.getTargetException();
|
|
if (t instanceof Error) {
|
|
throw (Error) t;
|
|
}
|
|
else if (t instanceof RuntimeException) {
|
|
throw (RuntimeException) t;
|
|
}
|
|
else {
|
|
throw new org.omg.CORBA.NO_IMPLEMENT();
|
|
}
|
|
} catch( RuntimeException rex ) {
|
|
throw rex;
|
|
} catch( Exception exr ) {
|
|
throw new org.omg.CORBA.NO_IMPLEMENT();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns a reference to the ORB associated with this object and
|
|
* its delegate. This is the <code>ORB</code> object that created
|
|
* the delegate.
|
|
*
|
|
* @return the <code>ORB</code> instance that created the
|
|
* <code>Delegate</code> object contained in this
|
|
* <code>ObjectImpl</code> object
|
|
*/
|
|
public org.omg.CORBA.ORB _orb() {
|
|
return _get_delegate().orb(this);
|
|
}
|
|
|
|
|
|
/**
|
|
* Retrieves the <code>Policy</code> object for this
|
|
* <code>ObjectImpl</code> object that has the given
|
|
* policy type.
|
|
*
|
|
* @param policy_type an int indicating the policy type
|
|
* @return the <code>Policy</code> object that is the specified policy type
|
|
* and that applies to this <code>ObjectImpl</code> object
|
|
* @see org.omg.CORBA.PolicyOperations#policy_type
|
|
*/
|
|
public org.omg.CORBA.Policy _get_policy(int policy_type) {
|
|
return _get_delegate().get_policy(this, policy_type);
|
|
}
|
|
|
|
/**
|
|
* Retrieves a list of the domain managers for this
|
|
* <code>ObjectImpl</code> object.
|
|
*
|
|
* @return an array containing the <code>DomainManager</code>
|
|
* objects for this instance of <code>ObjectImpl</code>
|
|
*/
|
|
public org.omg.CORBA.DomainManager[] _get_domain_managers() {
|
|
return _get_delegate().get_domain_managers(this);
|
|
}
|
|
|
|
/**
|
|
* Sets this <code>ObjectImpl</code> object's override type for
|
|
* the given policies to the given instance of
|
|
* <code>SetOverrideType</code>.
|
|
*
|
|
* @param policies an array of <code>Policy</code> objects with the
|
|
* policies that will replace the current policies or be
|
|
* added to the current policies
|
|
* @param set_add either <code>SetOverrideType.SET_OVERRIDE</code>,
|
|
* indicating that the given policies will replace any existing
|
|
* ones, or <code>SetOverrideType.ADD_OVERRIDE</code>, indicating
|
|
* that the given policies should be added to any existing ones
|
|
* @return an <code>Object</code> with the given policies replacing or
|
|
* added to its previous policies
|
|
*/
|
|
public org.omg.CORBA.Object
|
|
_set_policy_override(org.omg.CORBA.Policy[] policies,
|
|
org.omg.CORBA.SetOverrideType set_add) {
|
|
return _get_delegate().set_policy_override(this, policies,
|
|
set_add);
|
|
}
|
|
|
|
/**
|
|
* Checks whether this <code>ObjectImpl</code> object is implemented
|
|
* by a local servant. If so, local invocation API's may be used.
|
|
*
|
|
* @return <code>true</code> if this object is implemented by a local
|
|
* servant; <code>false</code> otherwise
|
|
*/
|
|
public boolean _is_local() {
|
|
return _get_delegate().is_local(this);
|
|
}
|
|
|
|
/**
|
|
* Returns a Java reference to the local servant that should be used for sending
|
|
* a request for the method specified. If this <code>ObjectImpl</code>
|
|
* object is a local stub, it will invoke the <code>_servant_preinvoke</code>
|
|
* method before sending a request in order to obtain the
|
|
* <code>ServantObject</code> instance to use.
|
|
* <P>
|
|
* If a <code>ServantObject</code> object is returned, its <code>servant</code>
|
|
* field has been set to an object of the expected type (Note: the object may
|
|
* or may not be the actual servant instance). The local stub may cast
|
|
* the servant field to the expected type, and then invoke the operation
|
|
* directly. The <code>ServantRequest</code> object is valid for only one
|
|
* invocation and cannot be used for more than one invocation.
|
|
*
|
|
* @param operation a <code>String</code> containing the name of the method
|
|
* to be invoked. This name should correspond to the method name as
|
|
* it would be encoded in a GIOP request.
|
|
*
|
|
* @param expectedType a <code>Class</code> object representing the
|
|
* expected type of the servant that is returned. This expected
|
|
* type is the <code>Class</code> object associated with the
|
|
* operations class for the stub's interface. For example, a
|
|
* stub for an interface <code>Foo</code> would pass the
|
|
* <code>Class</code> object for the <code>FooOperations</code>
|
|
* interface.
|
|
*
|
|
* @return (1) a <code>ServantObject</code> object, which may or may
|
|
* not be the actual servant instance, or (2) <code>null</code> if
|
|
* (a) the servant is not local or (b) the servant has ceased to
|
|
* be local due to a ForwardRequest from a POA ServantManager
|
|
* @throws org.omg.CORBA.BAD_PARAM if the servant is not the expected type
|
|
*/
|
|
public ServantObject _servant_preinvoke(String operation,
|
|
Class expectedType) {
|
|
return _get_delegate().servant_preinvoke(this, operation,
|
|
expectedType);
|
|
}
|
|
|
|
/**
|
|
* Is called by the local stub after it has invoked an operation
|
|
* on the local servant that was previously retrieved from a
|
|
* call to the method <code>_servant_preinvoke</code>.
|
|
* The <code>_servant_postinvoke</code> method must be called
|
|
* if the <code>_servant_preinvoke</code>
|
|
* method returned a non-null value, even if an exception was thrown
|
|
* by the method invoked by the servant. For this reason, the call
|
|
* to the method <code>_servant_postinvoke</code> should be placed
|
|
* in a Java <code>finally</code> clause.
|
|
*
|
|
* @param servant the instance of the <code>ServantObject</code>
|
|
* returned by the <code>_servant_preinvoke</code> method
|
|
*/
|
|
public void _servant_postinvoke(ServantObject servant) {
|
|
_get_delegate().servant_postinvoke(this, servant);
|
|
}
|
|
|
|
/*
|
|
* The following methods were added by orbos/98-04-03: Java to IDL
|
|
* Mapping. These are used by RMI over IIOP.
|
|
*/
|
|
|
|
/**
|
|
* Returns an <code>OutputStream</code> object to use for marshalling
|
|
* the arguments of the given method. This method is called by a stub,
|
|
* which must indicate if a response is expected, that is, whether or not
|
|
* the call is oneway.
|
|
*
|
|
* @param operation a String giving the name of the method.
|
|
* @param responseExpected a boolean -- <code>true</code> if the
|
|
* request is not one way, that is, a response is expected
|
|
* @return an <code>OutputStream</code> object for dispatching the request
|
|
*/
|
|
public OutputStream _request(String operation,
|
|
boolean responseExpected) {
|
|
return _get_delegate().request(this, operation, responseExpected);
|
|
}
|
|
|
|
/**
|
|
* Invokes an operation and returns an <code>InputStream</code>
|
|
* object for reading the response. The stub provides the
|
|
* <code>OutputStream</code> object that was previously returned by a
|
|
* call to the <code>_request</code> method. The method specified
|
|
* as an argument to <code>_request</code> when it was
|
|
* called previously is the method that this method invokes.
|
|
* <P>
|
|
* If an exception occurs, the <code>_invoke</code> method may throw an
|
|
* <code>ApplicationException</code> object that contains an InputStream from
|
|
* which the user exception state may be unmarshalled.
|
|
*
|
|
* @param output an OutputStream object for dispatching the request
|
|
* @return an <code>InputStream</code> object containing the marshalled
|
|
* response to the method invoked
|
|
* @throws ApplicationException if the invocation
|
|
* meets application-defined exception
|
|
* @throws RemarshalException if the invocation leads
|
|
* to a remarshalling error
|
|
* @see #_request
|
|
*/
|
|
public InputStream _invoke(OutputStream output)
|
|
throws ApplicationException, RemarshalException {
|
|
return _get_delegate().invoke(this, output);
|
|
}
|
|
|
|
/**
|
|
* Releases the given
|
|
* reply stream back to the ORB when unmarshalling has
|
|
* completed after a call to the method <code>_invoke</code>.
|
|
* Calling this method is optional for the stub.
|
|
*
|
|
* @param input the <code>InputStream</code> object that was returned
|
|
* by the <code>_invoke</code> method or the
|
|
* <code>ApplicationException.getInputStream</code> method;
|
|
* may be <code>null</code>, in which case this method does
|
|
* nothing
|
|
* @see #_invoke
|
|
*/
|
|
public void _releaseReply(InputStream input) {
|
|
_get_delegate().releaseReply(this, input);
|
|
}
|
|
|
|
/**
|
|
* Returns a <code>String</code> object that represents this
|
|
* <code>ObjectImpl</code> object.
|
|
*
|
|
* @return the <code>String</code> representation of this object
|
|
*/
|
|
public String toString() {
|
|
if ( __delegate != null )
|
|
return __delegate.toString(this);
|
|
else
|
|
return getClass().getName() + ": no delegate set";
|
|
}
|
|
|
|
/**
|
|
* Returns the hash code for this <code>ObjectImpl</code> object.
|
|
*
|
|
* @return the hash code for this object
|
|
*/
|
|
public int hashCode() {
|
|
if ( __delegate != null )
|
|
return __delegate.hashCode(this);
|
|
else
|
|
return super.hashCode();
|
|
}
|
|
|
|
/**
|
|
* Compares this <code>ObjectImpl</code> object with the given one
|
|
* for equality.
|
|
*
|
|
*@param obj the object with which to compare this object
|
|
*@return <code>true</code> if the two objects are equal;
|
|
* <code>false</code> otherwise
|
|
*/
|
|
public boolean equals(java.lang.Object obj) {
|
|
if ( __delegate != null )
|
|
return __delegate.equals(this, obj);
|
|
else
|
|
return (this==obj);
|
|
}
|
|
}
|