Java Platform 1.2
Beta 4

Class org.omg.CORBA.portable.Delegate

java.lang.Object
  |
  +--org.omg.CORBA.portable.Delegate

public abstract class Delegate
extends Object
The Delegate abstract class specifies a portable API for ORB-vendor-specific implementation of the org.omg.CORBA.Object methods. Each stub (proxy) contains a delegate object, to which all org.omg.CORBA.Object methods are forwarded. This allows a stub generated by one vendor's ORB to work with the delegate from another vendor's ORB.

See Also:
Object

Method Summary
 InputStream _invoke(OutputStream output)
          _invoke is called to invoke an operation.
 void _releaseReply(InputStream input)
          _releaseReply may optionally be called by a stub to release a reply stream back to the ORB when the unmarshaling has completed.
 OutputStream _request(String operation, boolean responseExpected)
          _request is called by a stub to obtain an OutputStream for marshaling arguments.
abstract  Request create_request(Object obj, Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist)
          Create a Request instance for use in the Dynamic Invocation Interface.
abstract  Request create_request(Object obj, Context ctx, String operation, NVList arg_list, NamedValue result)
          Create a Request instance for use in the Dynamic Invocation Interface.
abstract  Object duplicate(Object obj)
          Return a duplicate of the object reference provided.
 DomainManager[] get_domain_managers(Object self)
           
abstract  ImplementationDef get_implementation(Object obj)
          Return an ImplementationDef for the object reference provided.
abstract  InterfaceDef get_interface(Object obj)
          Return an InterfaceDef for the object reference provided.
 Policy get_policy(Object self, int policy_type)
           
abstract  int hash(Object obj, int max)
          Returns an ORB-internal identifier (hashcode) for this object reference.
abstract  boolean is_a(Object obj, String repository_id)
          Check if the object reference is an instance of the given interface.
abstract  boolean is_equivalent(Object obj, Object other)
          Determines if the two object references are equivalent.
 boolean is_local(Object self)
           
abstract  boolean non_existent(Object obj)
          Determines whether the server object for the object reference has been destroyed.
 ORB orb(Object obj)
          Return the ORB that created this delegate.
abstract  void release(Object obj)
          Release resources associated with the object reference provided.
abstract  Request request(Object obj, String operation)
          Create a Request instance for use in the Dynamic Invocation Interface.
 void servant_postinvoke(Object self, ServantObject servant)
           
 ServantObject servant_preinvoke(Object self, String operation, Class expectedType)
           
 Object set_policy_override(Object self, Policy[] policies, SetOverrideType set_add)
           
 
Methods inherited from class java.lang.Object
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

Method Detail

get_implementation

public abstract ImplementationDef get_implementation(Object obj)
Return an ImplementationDef for the object reference provided.
Parameters:
obj - The object reference which delegated to this delegate, and whose ImplementationDef needs to be returned.
Returns:
the ImplementationDef

get_interface

public abstract InterfaceDef get_interface(Object obj)
Return an InterfaceDef for the object reference provided.
Parameters:
obj - The object reference whose InterfaceDef needs to be returned
Returns:
the InterfaceDef

duplicate

public abstract Object duplicate(Object obj)
Return a duplicate of the object reference provided.
Parameters:
obj - The object reference whose duplicate needs to be returned
Returns:
the duplicate object reference

release

public abstract void release(Object obj)
Release resources associated with the object reference provided.
Parameters:
obj - The object reference whose resources need to be released

is_a

public abstract boolean is_a(Object obj,
                             String repository_id)
Check if the object reference is an instance of the given interface.
Parameters:
obj - The object reference to be checked.
repository_id - The repository identifier of the interface to check against.
Returns:
true if the object reference supports the interface

non_existent

public abstract boolean non_existent(Object obj)
Determines whether the server object for the object reference has been destroyed.
Parameters:
obj - The object reference which delegated to this delegate.

is_equivalent

public abstract boolean is_equivalent(Object obj,
                                      Object other)
Determines if the two object references are equivalent.
Parameters:
obj - The object reference which delegated to this delegate.
other - The object reference to check equivalence against.

hash

public abstract int hash(Object obj,
                         int max)
Returns an ORB-internal identifier (hashcode) for this object reference.
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 abstract Request request(Object obj,
                                String operation)
Create a Request instance for use in the Dynamic Invocation Interface.
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 abstract Request create_request(Object obj,
                                       Context ctx,
                                       String operation,
                                       NVList arg_list,
                                       NamedValue result)
Create a Request instance for use in the Dynamic Invocation Interface.
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 abstract Request create_request(Object obj,
                                       Context ctx,
                                       String operation,
                                       NVList arg_list,
                                       NamedValue result,
                                       ExceptionList exclist,
                                       ContextList ctxlist)
Create a Request instance for use in the Dynamic Invocation Interface.
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)
Return the ORB that created this delegate.

get_policy

public Policy get_policy(Object self,
                         int policy_type)

get_domain_managers

public DomainManager[] get_domain_managers(Object self)

set_policy_override

public Object set_policy_override(Object self,
                                  Policy[] policies,
                                  SetOverrideType set_add)

is_local

public boolean is_local(Object self)

servant_preinvoke

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

servant_postinvoke

public void servant_postinvoke(Object self,
                               ServantObject servant)

_request

public OutputStream _request(String operation,
                             boolean responseExpected)
_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).

_invoke

public InputStream _invoke(OutputStream output)
                    throws ApplicationException,
                           SystemException
_invoke is called 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.

_releaseReply

public void _releaseReply(InputStream input)
_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.

Java Platform 1.2
Beta 4

Submit a bug or feature
Submit comments/suggestions about new javadoc look
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.
This documentation was generated with a post-Beta4 version of Javadoc.