| java.lang.Object org.omg.CORBA.portable.ObjectImpl
All known Subclasses: org.omg.CORBA_2_3.portable.ObjectImpl, org.omg.CORBA.DynamicImplementation, org.omg.CORBA._PolicyStub, org.omg.CORBA._IDLTypeStub,
ObjectImpl | abstract public class ObjectImpl implements org.omg.CORBA.Object(Code) | | The common base class for all stub classes; provides default implementations
of the org.omg.CORBA.Object methods. All method implementations are
forwarded to a Delegate object stored in the ObjectImpl
instance. ObjectImpl allows for portable stubs because the
Delegate can be implemented by a different vendor-specific ORB.
|
Method Summary | |
public Request | _create_request(Context ctx, String operation, NVList arg_list, NamedValue result) Creates a Request object that contains the given context,
method, argument list, and container for the result. | public Request | _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts) Creates a Request 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. | public org.omg.CORBA.Object | _duplicate() Returns a duplicate of this ObjectImpl object. | public Delegate | _get_delegate() Retrieves the reference to the vendor-specific Delegate
object to which this ObjectImpl object delegates all
methods invoked on it. | public org.omg.CORBA.DomainManager[] | _get_domain_managers() Retrieves a list of the domain managers for this
ObjectImpl object. | public org.omg.CORBA.Object | _get_interface_def() Retrieves the interface definition for this ObjectImpl
object. | public org.omg.CORBA.Policy | _get_policy(int policy_type) Retrieves the Policy object for this
ObjectImpl object that has the given
policy type. | public int | _hash(int maximum) Retrieves the hash code that serves as an ORB-internal identifier for
this ObjectImpl object. | abstract public String[] | _ids() Retrieves a string array containing the repository identifiers
supported by this ObjectImpl object. | public InputStream | _invoke(OutputStream output) Invokes an operation and returns an InputStream
object for reading the response. | public boolean | _is_a(String repository_id) Checks whether the object identified by the given repository
identifier is an ObjectImpl object. | public boolean | _is_equivalent(org.omg.CORBA.Object that) Checks whether the the given ObjectImpl object is
equivalent to this ObjectImpl object. | public boolean | _is_local() Checks whether this ObjectImpl object is implemented
by a local servant. | public boolean | _non_existent() Checks whether the server object for this ObjectImpl
object has been destroyed. | public org.omg.CORBA.ORB | _orb() Returns a reference to the ORB associated with this object and
its delegate. | public void | _release() Releases the resources associated with this ObjectImpl object. | public void | _releaseReply(InputStream input) Releases the given
reply stream back to the ORB when unmarshalling has
completed after a call to the method _invoke . | public Request | _request(String operation) Creates a Request object containing the given method
that can be used with the Dynamic Invocation Interface. | public OutputStream | _request(String operation, boolean responseExpected) Returns an OutputStream object to use for marshalling
the arguments of the given method. | public void | _servant_postinvoke(ServantObject servant) 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 _servant_preinvoke .
The _servant_postinvoke method must be called
if the _servant_preinvoke
method returned a non-null value, even if an exception was thrown
by the method invoked by the servant. | public ServantObject | _servant_preinvoke(String operation, Class expectedType) Returns a Java reference to the local servant that should be used for sending
a request for the method specified. | public void | _set_delegate(Delegate delegate) Sets the Delegate for this ObjectImpl instance to the given
Delegate object. | public org.omg.CORBA.Object | _set_policy_override(org.omg.CORBA.Policy[] policies, org.omg.CORBA.SetOverrideType set_add) Sets this ObjectImpl object's override type for
the given policies to the given instance of
SetOverrideType . | public boolean | equals(java.lang.Object obj) Compares this ObjectImpl object with the given one
for equality. | public int | hashCode() Returns the hash code for this ObjectImpl object. | public String | toString() Returns a String object that represents this
ObjectImpl object. |
_create_request | public Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result)(Code) | | Creates a Request object that contains the given context,
method, argument list, and container for the result.
Parameters: ctx - the Context for the request Parameters: operation - the method that the new Request object will invoke Parameters: arg_list - the arguments for the method; an NVList in which each argument is a NamedValue object Parameters: result - a NamedValue object to be used for returning the result of executing the request's method a new Request object initialized with thegiven context, method, argument list, and container for thereturn value |
_create_request | public Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts)(Code) | | Creates a Request 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 Request object is for use in the Dynamic
Invocation Interface.
Parameters: ctx - the Context object that contains thecontext strings that must be resolved before they are sent along with the request Parameters: operation - the method that the new Request object will invoke Parameters: arg_list - the arguments for the method; an NVList in which each argument is a NamedValue object Parameters: result - a NamedValue object to be used for returning the result of executing the request's method Parameters: exceptions - a list of the exceptions that the given methodthrows Parameters: contexts - a list of the properties that are needed toresolve the contexts in ctx; the strings in contexts are used as arguments to the methodContext.get_values ,which returns the value associated with the given property a new Request object initialized with thegiven context strings to resolve, method, argument list,container for the result, exceptions, and list of propertynames to be used in resolving the context strings |
_duplicate | public org.omg.CORBA.Object _duplicate()(Code) | | Returns a duplicate of this ObjectImpl object.
an orb.omg.CORBA.Object object that isa duplicate of this object |
_get_delegate | public Delegate _get_delegate()(Code) | | Retrieves the reference to the vendor-specific Delegate
object to which this ObjectImpl object delegates all
methods invoked on it.
the Delegate contained in this ObjectImpl instance throws: BAD_OPERATION - if the delegate has not been set See Also: ObjectImpl._set_delegate |
_get_domain_managers | public org.omg.CORBA.DomainManager[] _get_domain_managers()(Code) | | Retrieves a list of the domain managers for this
ObjectImpl object.
an array containing the DomainManager objects for this instance of ObjectImpl |
_get_interface_def | public org.omg.CORBA.Object _get_interface_def()(Code) | | Retrieves the interface definition for this ObjectImpl
object.
the org.omg.CORBA.Object instance that is theinterface definition for this ObjectImpl object |
_get_policy | public org.omg.CORBA.Policy _get_policy(int policy_type)(Code) | | Retrieves the Policy object for this
ObjectImpl object that has the given
policy type.
Parameters: policy_type - an int indicating the policy type the Policy object that is the specified policy typeand that applies to this ObjectImpl object See Also: org.omg.CORBA.PolicyOperations.policy_type |
_hash | public int _hash(int maximum)(Code) | | Retrieves the hash code that serves as an ORB-internal identifier for
this ObjectImpl object.
Parameters: maximum - an int indicating the upper bound on the hash value returned by the ORB an int representing the hash code for thisObjectImpl object |
_ids | abstract public String[] _ids()(Code) | | Retrieves a string array containing the repository identifiers
supported by this ObjectImpl object. For example,
for a stub, this method returns information about all the
interfaces supported by the stub.
the array of all repository identifiers supported by thisObjectImpl instance |
_invoke | public InputStream _invoke(OutputStream output) throws ApplicationException, RemarshalException(Code) | | Invokes an operation and returns an InputStream
object for reading the response. The stub provides the
OutputStream object that was previously returned by a
call to the _request method. The method specified
as an argument to _request when it was
called previously is the method that this method invokes.
If an exception occurs, the _invoke method may throw an
ApplicationException object that contains an InputStream from
which the user exception state may be unmarshalled.
Parameters: output - an OutputStream object for dispatching the request an InputStream object containing the marshalledresponse to the method invoked throws: ApplicationException - if the invocation meets application-defined exception throws: RemarshalException - if the invocation leadsto a remarshalling error See Also: ObjectImpl._request |
_is_a | public boolean _is_a(String repository_id)(Code) | | Checks whether the object identified by the given repository
identifier is an ObjectImpl object.
Parameters: repository_id - a String object with the repositoryidentifier to check true if the object identified by the givenrepository id is an instance of ObjectImpl ;false otherwise |
_is_equivalent | public boolean _is_equivalent(org.omg.CORBA.Object that)(Code) | | Checks whether the the given ObjectImpl object is
equivalent to this ObjectImpl object.
Parameters: that - an instance of ObjectImpl to compare withthis ObjectImpl object true if the given object is equivalentto this ObjectImpl object;false otherwise |
_is_local | public boolean _is_local()(Code) | | Checks whether this ObjectImpl object is implemented
by a local servant. If so, local invocation API's may be used.
true if this object is implemented by a localservant; false otherwise |
_non_existent | public boolean _non_existent()(Code) | | Checks whether the server object for this ObjectImpl
object has been destroyed.
true if the ORB knows authoritatively that theserver object does not exist; false otherwise |
_orb | public org.omg.CORBA.ORB _orb()(Code) | | Returns a reference to the ORB associated with this object and
its delegate. This is the ORB object that created
the delegate.
the ORB instance that created the Delegate object contained in thisObjectImpl object |
_release | public void _release()(Code) | | Releases the resources associated with this ObjectImpl object.
|
_releaseReply | public void _releaseReply(InputStream input)(Code) | | Releases the given
reply stream back to the ORB when unmarshalling has
completed after a call to the method _invoke .
Calling this method is optional for the stub.
Parameters: input - the InputStream object that was returnedby the _invoke method or the ApplicationException.getInputStream method;may be null , in which case this method doesnothing See Also: ObjectImpl._invoke |
_request | public Request _request(String operation)(Code) | | Creates a Request object containing the given method
that can be used with the Dynamic Invocation Interface.
Parameters: operation - the method to be invoked by the new Request object a new Request object initialized with thegiven method |
_request | public OutputStream _request(String operation, boolean responseExpected)(Code) | | Returns an OutputStream 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.
Parameters: operation - a String giving the name of the method. Parameters: responseExpected - a boolean -- true if the request is not one way, that is, a response is expected an OutputStream object for dispatching the request |
_servant_postinvoke | public void _servant_postinvoke(ServantObject servant)(Code) | | 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 _servant_preinvoke .
The _servant_postinvoke method must be called
if the _servant_preinvoke
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 _servant_postinvoke should be placed
in a Java finally clause.
Parameters: servant - the instance of the ServantObject returned by the _servant_preinvoke method |
_servant_preinvoke | public ServantObject _servant_preinvoke(String operation, Class expectedType)(Code) | | Returns a Java reference to the local servant that should be used for sending
a request for the method specified. If this ObjectImpl
object is a local stub, it will invoke the _servant_preinvoke
method before sending a request in order to obtain the
ServantObject instance to use.
If a ServantObject object is returned, its servant
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 ServantRequest object is valid for only one
invocation and cannot be used for more than one invocation.
Parameters: operation - a String containing the name of the methodto be invoked. This name should correspond to the method name asit would be encoded in a GIOP request. Parameters: expectedType - a Class object representing theexpected type of the servant that is returned. This expected type is the Class object associated with theoperations class for the stub's interface. For example, a stub for an interface Foo would pass the Class object for the FooOperations interface. (1) a ServantObject object, which may or maynot be the actual servant instance, or (2) null if(a) the servant is not local or (b) the servant has ceased tobe local due to a ForwardRequest from a POA ServantManager throws: org.omg.CORBA.BAD_PARAM - if the servant is not the expected type |
_set_delegate | public void _set_delegate(Delegate delegate)(Code) | | Sets the Delegate for this ObjectImpl instance to the given
Delegate object. All method invocations on this
ObjectImpl object will be forwarded to this delegate.
Parameters: delegate - the Delegate instance to whichall method calls on this ObjectImpl objectwill be delegated; may be implemented by a third-party ORB See Also: ObjectImpl._get_delegate |
_set_policy_override | public org.omg.CORBA.Object _set_policy_override(org.omg.CORBA.Policy[] policies, org.omg.CORBA.SetOverrideType set_add)(Code) | | Sets this ObjectImpl object's override type for
the given policies to the given instance of
SetOverrideType .
Parameters: policies - an array of Policy objects with thepolicies that will replace the current policies or beadded to the current policies Parameters: set_add - either SetOverrideType.SET_OVERRIDE , indicating that the given policies will replace any existing ones, or SetOverrideType.ADD_OVERRIDE , indicatingthat the given policies should be added to any existing ones an Object with the given policies replacing oradded to its previous policies |
equals | public boolean equals(java.lang.Object obj)(Code) | | Compares this ObjectImpl object with the given one
for equality.
Parameters: obj - the object with which to compare this object true if the two objects are equal;false otherwise |
hashCode | public int hashCode()(Code) | | Returns the hash code for this ObjectImpl object.
the hash code for this object |
toString | public String toString()(Code) | | Returns a String object that represents this
ObjectImpl object.
the String representation of this object |
|
|