com.sun.corba.se.impl.protocol

Class CorbaClientDelegateImpl

java.lang.Object

org.omg.CORBA.portable.Delegate

org.omg.CORBA_2_3.portable.Delegate

com.sun.corba.se.spi.protocol.CorbaClientDelegate

com.sun.corba.se.impl.protocol.CorbaClientDelegateImpl

All Implemented Interfaces:

ClientDelegate

public class CorbaClientDelegateImpl
extends CorbaClientDelegate

Author:

Harold Carr

Constructor Summary

Constructors

Constructor and Description
CorbaClientDelegateImpl(ORB orb, CorbaContactInfoList contactInfoList)

Method Summary

Modifier and Type	Method and Description
Request	create_request(Object obj, Context ctx, String operation, NVList arg_list, NamedValue result) Creates a Request instance for use in the Dynamic Invocation Interface.
Request	create_request(Object obj, Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist) Creates a Request instance for use in the Dynamic Invocation Interface.
Object	duplicate(Object obj) Returns a duplicate of the object reference provided.
boolean	equals(Object self, Object other) This method overrides the org.omg.CORBA.portable.Delegate.equals method, and does the equality check based on IOR equality.
String	get_codebase(Object self) Returns the codebase for object reference provided.
Object	get_interface_def(Object obj) Return an InterfaceDef for the object reference provided.
Broker	getBroker() The Broker associated with an invocation.
ContactInfoList	getContactInfoList() Get the ContactInfoList which represents they encoding/protocol/transport combinations that may be used to contact the service.
int	hash(Object obj, int maximum) Returns an ORB-internal identifier (hashcode) for this object reference.
int	hashCode()
int	hashCode(Object obj) Provides the implementation to override the hashCode() method of the delegating CORBA object.
InputStream	invoke(Object self, OutputStream output) invoke is called by a stub to invoke an operation.
boolean	is_a(Object obj, String dest) Checks if the object reference is an instance of the given interface.
boolean	is_equivalent(Object obj, Object ref) Determines if the two object references are equivalent.
boolean	is_local(Object self) Returns true if this object is implemented by a local servant.
boolean	non_existent(Object obj) Determines whether the server object for the object reference has been destroyed.
ORB	orb(Object obj) Provides a reference to the orb associated with its parameter.
void	release(Object obj) Releases resources associated with the object reference provided.
void	releaseReply(Object self, InputStream input) releaseReply may optionally be called by a stub to release a reply stream back to the ORB when the unmarshaling has completed.
Request	request(Object obj, String operation) Creates a Request instance for use in the Dynamic Invocation Interface.
OutputStream	request(Object self, String operation, boolean responseExpected) request is called by a stub to obtain an OutputStream for marshaling arguments.
void	servant_postinvoke(Object self, ServantObject servant) servant_postinvoke() is invoked by the local stub after the operation has been invoked on the local servant.
ServantObject	servant_preinvoke(Object self, String operation, Class expectedType) Returns a Java reference to the servant which should be used for this request.
String	toString(Object self) Provides the implementation to override the toString() method of the delegating CORBA object.

Methods inherited from class org.omg.CORBA.portable.Delegate

get_domain_managers, get_policy, set_policy_override

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CorbaClientDelegateImpl

public CorbaClientDelegateImpl(ORB orb,
                               CorbaContactInfoList contactInfoList)

Method Detail

getBroker

public Broker getBroker()

Description copied from interface: ClientDelegate

The Broker associated with an invocation.

Returns:

Broker

getContactInfoList

public ContactInfoList getContactInfoList()

Description copied from interface: ClientDelegate

Get the ContactInfoList which represents they encoding/protocol/transport combinations that may be used to contact the service.

Returns:

ContactInfoList

request

public OutputStream request(Object self,
                            String operation,
                            boolean responseExpected)

Description copied from class: Delegate

request is 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).

Overrides:

request in class Delegate

Parameters:

self - The object reference which delegated to this delegate.

operation - a string containing the operation name. The operation name corresponds to the operation name as it would be encoded in a GIOP request.

responseExpected - false if the operation is a one way operation, and true otherwise.

Returns:

OutputStream the OutputStream into which request arguments can be marshaled.

See Also:

portable package comments for unimplemented features

invoke

public InputStream invoke(Object self,
                          OutputStream output)
                   throws ApplicationException,
                          RemarshalException

Description copied from class: Delegate

invoke is called by a stub to invoke an operation. The stub provides an OutputStream that was previously returned by a request() call. invoke returns an InputStream which contains the marshaled reply. If an exception occurs, invoke may throw an ApplicationException object which contains an InputStream from which the user exception state may be unmarshaled.

Overrides:

invoke in class Delegate

Parameters:

self - The object reference which delegated to this delegate.

output - the OutputStream which contains marshaled arguments

Returns:

input the InputStream from which reply parameters can be unmarshaled.

Throws:

ApplicationException - thrown when implementation throws (upon invocation) an exception defined as part of its remote method definition.

RemarshalException - thrown when remarshalling fails.

See Also:

portable package comments for unimplemented features

releaseReply

public void releaseReply(Object self,
                         InputStream input)

Description copied from class: Delegate

releaseReply 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 InputStream returned by invoke() or ApplicationException.getInputStream(). A null value may also be passed to releaseReply, in which case the method is a noop.

Overrides:

releaseReply in class Delegate

Parameters:

self - The object reference which delegated to this delegate.

input - the InputStream returned from invoke().

See Also:

portable package comments for unimplemented features

get_interface_def

public Object get_interface_def(Object obj)

Description copied from class: Delegate

Return an InterfaceDef for the object reference provided.

Specified by:

get_interface_def in class Delegate

Parameters:

obj - The object reference whose InterfaceDef needs to be returned

Returns:

the InterfaceDef

is_a

public boolean is_a(Object obj,
                    String dest)

Description copied from class: Delegate

Checks if the object reference is an instance of the given interface.

Specified by:

is_a in class Delegate

Parameters:

obj - The object reference to be checked.

dest - The repository identifier of the interface to check against.

Returns:

true if the object reference supports the interface

non_existent

public boolean non_existent(Object obj)

Description copied from class: Delegate

Determines whether the server object for the object reference has been destroyed.

Specified by:

non_existent in class Delegate

Parameters:

obj - The object reference which delegated to this delegate.

Returns:

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

duplicate

public Object duplicate(Object obj)

Description copied from class: Delegate

Returns a duplicate of the object reference provided.

Specified by:

duplicate in class Delegate

Parameters:

obj - The object reference whose duplicate needs to be returned

Returns:

the duplicate object reference

release

public void release(Object obj)

Description copied from class: Delegate

Releases resources associated with the object reference provided.

Specified by:

release in class Delegate

Parameters:

obj - The object reference whose resources need to be released

is_equivalent

public boolean is_equivalent(Object obj,
                             Object ref)

Description copied from class: Delegate

Determines if the two object references are equivalent.

Specified by:

is_equivalent in class Delegate

Parameters:

obj - The object reference which delegated to this delegate.

ref - The object reference to check equivalence against.

Returns:

true if the objects are CORBA-equivalent.

equals

public boolean equals(Object self,
                      Object other)

This method overrides the org.omg.CORBA.portable.Delegate.equals method, and does the equality check based on IOR equality.

Overrides:

equals in class Delegate

Parameters:

self - the object reference that delegated to this delegate

other - the Object with which to compare

Returns:

true if obj equals self; false otherwise

hashCode

public int hashCode(Object obj)

Description copied from class: Delegate

Provides the implementation to override the hashCode() method of the delegating CORBA object.

Overrides:

hashCode in class Delegate

Parameters:

obj - the object reference that delegated to this delegate

Returns:

an int that represents the hashcode for the object reference that delegated to this Delegate object

hash

public int hash(Object obj,
                int maximum)

Description copied from class: Delegate

Returns an ORB-internal identifier (hashcode) for this object reference.

Specified by:

hash in class Delegate

Parameters:

obj - The object reference which delegated to this delegate.

maximum - specifies an upper bound on the hash value returned by the ORB.

Returns:

ORB-internal hash identifier for object reference

request

public Request request(Object obj,
                       String operation)

Description copied from class: Delegate

Creates a Request instance for use in the Dynamic Invocation Interface.

Specified by:

request in class Delegate

Parameters:

obj - The object reference which delegated to this delegate.

operation - The name of the operation to be invoked using the Request instance.

Returns:

the created Request instance

create_request

public Request create_request(Object obj,
                              Context ctx,
                              String operation,
                              NVList arg_list,
                              NamedValue result)

Description copied from class: Delegate

Creates a Request instance for use in the Dynamic Invocation Interface.

Specified by:

create_request in class Delegate

Parameters:

obj - The object reference which delegated to this delegate.

ctx - The context to be used.

operation - The name of the operation to be invoked.

arg_list - The arguments to the operation in the form of an NVList.

result - A container for the result as a NamedValue.

Returns:

The created Request object.

create_request

public Request create_request(Object obj,
                              Context ctx,
                              String operation,
                              NVList arg_list,
                              NamedValue result,
                              ExceptionList exclist,
                              ContextList ctxlist)

Description copied from class: Delegate

Creates a Request instance for use in the Dynamic Invocation Interface.

Specified by:

create_request in class Delegate

Parameters:

obj - The object reference which delegated to this delegate.

ctx - The context to be used.

operation - The name of the operation to be invoked.

arg_list - The arguments to the operation in the form of an NVList.

result - A container for the result as a NamedValue.

exclist - A list of possible exceptions the operation can throw.

ctxlist - A list of context strings that need to be resolved and sent with the Request.

Returns:

The created Request object.

orb

public ORB orb(Object obj)

Description copied from class: Delegate

Provides a reference to the orb associated with its parameter.

Overrides:

orb in class Delegate

Parameters:

obj - the object reference which delegated to this delegate.

Returns:

the associated orb.

See Also:

portable package comments for unimplemented features

is_local

public boolean is_local(Object self)

Returns true if this object is implemented by a local servant. REVISIT: locatedIOR should be replaced with a method call that returns the current IOR for this request (e.g. ContactInfoChooser).

Overrides:

is_local in class Delegate

Parameters:

self - The object reference which delegated to this delegate.

Returns:

true only if the servant incarnating this object is located in this ORB.

servant_preinvoke

public ServantObject servant_preinvoke(Object self,
                                       String operation,
                                       Class expectedType)

Description copied from class: Delegate

Returns a Java reference to the servant which should be used for this request. servant_preinvoke() is invoked by a local stub. If a ServantObject object is returned, then 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.

Overrides:

servant_preinvoke in class Delegate

Parameters:

self - The object reference which delegated to this delegate.

operation - a string containing the operation name. The operation name corresponds to the operation name as it would be encoded in a GIOP request.

expectedType - a Class object representing the expected type of the servant. The expected type is the Class object associated with the operations class of the stub's interface (e.g. A stub for an interface Foo, would pass the Class object for the FooOperations interface).

Returns:

a ServantObject object. The method may return a null value if it does not wish to support this optimization (e.g. due to security, transactions, etc). The method must return null if the servant is not of the expected type.

servant_postinvoke

public void servant_postinvoke(Object self,
                               ServantObject servant)

Description copied from class: Delegate

servant_postinvoke() is invoked by the local stub after the operation has been invoked on the local servant. This method must be called if servant_preinvoke() returned a non-null value, even if an exception was thrown by the servant's method. For this reason, the call to servant_postinvoke() should be placed in a Java finally clause.

Overrides:

servant_postinvoke in class Delegate

Parameters:

self - The object reference which delegated to this delegate.

servant - the instance of the ServantObject returned from the servant_preinvoke() method.

get_codebase

public String get_codebase(Object self)

Description copied from class: Delegate

Returns the codebase for object reference provided.

Overrides:

get_codebase in class Delegate

Parameters:

self - the object reference whose codebase needs to be returned.

Returns:

the codebase as a space delimited list of url strings or null if none.

toString

public String toString(Object self)

Description copied from class: Delegate

Provides the implementation to override the toString() method of the delegating CORBA object.

Overrides:

toString in class Delegate

Parameters:

self - the object reference that delegated to this delegate

Returns:

a String object that represents the object reference that delegated to this Delegate object

hashCode

public int hashCode()

Overrides:

hashCode in class Object