org.omg.CORBA.portable
Class ObjectImpl

java.lang.Object   
  org.omg.CORBA.portable.ObjectImpl

All Implemented Interfaces:

Object

Direct Known Subclasses:

_BindingIteratorStub , _DynAnyFactoryStub , _DynAnyStub , _DynArrayStub , _DynEnumStub , _DynFixedStub , _DynSequenceStub , _DynStructStub , _DynUnionStub , _DynValueStub , _IDLTypeStub , _NamingContextExtStub , _NamingContextStub , _PolicyStub , _ServantActivatorStub , _ServantLocatorStub , DynamicImplementation , ObjectImpl

public abstract class ObjectImpl
extends Object   
implements Object   

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.

Constructor Summary

ObjectImpl ()

Method Summary

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.
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.
Object	_duplicate () Returns a duplicate of this ObjectImpl object.
Delegate	_get_delegate () Retrieves the reference to the vendor-specific Delegate object to which this ObjectImpl object delegates all methods invoked on it.
DomainManager []	_get_domain_managers () Retrieves a list of the domain managers for this ObjectImpl object.
Object	_get_interface_def () Retrieves the interface definition for this ObjectImpl object.
Policy	_get_policy (int policy_type) Retrieves the Policy object for this ObjectImpl object that has the given policy type.
int	_hash (int maximum) Retrieves the hash code that serves as an ORB-internal identifier for this ObjectImpl object.
abstract String []	_ids () Retrieves a string array containing the repository identifiers supported by this ObjectImpl object.
InputStream	_invoke (OutputStream output) Invokes an operation and returns an InputStream object for reading the response.
boolean	_is_a (String repository_id) Checks whether the object identified by the given repository identifier is an ObjectImpl object.
boolean	_is_equivalent (Object that) Checks whether the the given ObjectImpl object is equivalent to this ObjectImpl object.
boolean	_is_local () Checks whether this ObjectImpl object is implemented by a local servant.
boolean	_non_existent () Checks whether the server object for this ObjectImpl object has been destroyed.
ORB	_orb () Returns a reference to the ORB associated with this object and its delegate.
void	_release () Releases the resources associated with this ObjectImpl object.
void	_releaseReply (InputStream input) Releases the given reply stream back to the ORB when unmarshalling has completed after a call to the method _invoke.
Request	_request (String operation) Creates a Request object containing the given method that can be used with the Dynamic Invocation Interface.
OutputStream	_request (String operation, boolean responseExpected) Returns an OutputStream object to use for marshalling the arguments of the given method.
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.
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.
void	_set_delegate (Delegate delegate) Sets the Delegate for this ObjectImpl instance to the given Delegate object.
Object	_set_policy_override (Policy [] policies, SetOverrideType set_add) Sets this ObjectImpl object's override type for the given policies to the given instance of SetOverrideType.
boolean	equals (Object obj) Compares this ObjectImpl object with the given one for equality.
int	hashCode () Returns the hash code for this ObjectImpl object.
String	toString () Returns a String object that represents this ObjectImpl object.

Methods inherited from class java.lang.Object

clone , finalize , getClass , notify , notifyAll , wait , wait , wait

Constructor Detail

ObjectImpl

public ObjectImpl()

Method Detail

_get_delegate

public Delegate    _get_delegate()

Retrieves the reference to the vendor-specific Delegate object to which this ObjectImpl object delegates all methods invoked on it.

Returns:

the Delegate contained in this ObjectImpl instance

Throws:

BAD_OPERATION - if the delegate has not been set

See Also:

_set_delegate(org.omg.CORBA.portable.Delegate)

_set_delegate

public void _set_delegate(Delegate    delegate)

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 which all method calls on this ObjectImpl object will be delegated; may be implemented by a third-party ORB

See Also:

_get_delegate()

_ids

public abstract String   [] _ids()

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.

Returns:

the array of all repository identifiers supported by this ObjectImpl instance

_duplicate

public Object    _duplicate()

Returns a duplicate of this ObjectImpl object.

Specified by:

_duplicate in interface Object

Returns:

an orb.omg.CORBA.Object object that is a duplicate of this object

_release

public void _release()

Releases the resources associated with this ObjectImpl object.

Specified by:

_release in interface Object

_is_a

public boolean _is_a(String    repository_id)

Checks whether the object identified by the given repository identifier is an ObjectImpl object.

Specified by:

_is_a in interface Object

Parameters:

repository_id - a String object with the repository identifier to check

Returns:

true if the object identified by the given repository id is an instance of ObjectImpl; false otherwise

_is_equivalent

public boolean _is_equivalent(Object    that)

Checks whether the the given ObjectImpl object is equivalent to this ObjectImpl object.

Specified by:

_is_equivalent in interface Object

Parameters:

that - an instance of ObjectImpl to compare with this ObjectImpl object

Returns:

true if the given object is equivalent to this ObjectImpl object; false otherwise

_non_existent

public boolean _non_existent()

Checks whether the server object for this ObjectImpl object has been destroyed.

Specified by:

_non_existent in interface Object

Returns:

true if the ORB knows authoritatively that the server object does not exist; false otherwise

_hash

public int _hash(int maximum)

Retrieves the hash code that serves as an ORB-internal identifier for this ObjectImpl object.

Specified by:

_hash in interface Object

Parameters:

maximum - an int indicating the upper bound on the hash value returned by the ORB

Returns:

an int representing the hash code for this ObjectImpl object

_request

public Request    _request(String    operation)

Creates a Request object containing the given method that can be used with the Dynamic Invocation Interface.

Specified by:

_request in interface Object

Parameters:

operation - the method to be invoked by the new Request object

Returns:

a new Request object initialized with the given method

_create_request

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.

Specified by:

_create_request in interface Object

Parameters:

ctx - the Context for the request

operation - the method that the new Request object will invoke

arg_list - the arguments for the method; an NVList in which each argument is a NamedValue object

result - a NamedValue object to be used for returning the result of executing the request's method

Returns:

a new Request object initialized with the given context, method, argument list, and container for the return value

See Also:

Request , NVList , NamedValue

_create_request

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. This Request object is for use in the Dynamic Invocation Interface.

Specified by:

_create_request in interface Object

Parameters:

ctx - the Context object that contains the context strings that must be resolved before they are sent along with the request

operation - the method that the new Request object will invoke

arg_list - the arguments for the method; an NVList in which each argument is a NamedValue object

result - a NamedValue object to be used for returning the result of executing the request's method

exceptions - a list of the exceptions that the given method throws

contexts - a list of the properties that are needed to resolve the contexts in ctx; the strings in contexts are used as arguments to the method Context.get_values, which returns the value associated with the given property

Returns:

a new Request 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

See Also:

Request , NVList , NamedValue