| java.lang.Object
 org.omg.CORBA.portable.Delegate
All known Subclasses: org.omg.CORBA_2_3.portable.Delegate,
| Delegate | | abstract public class Delegate (Code) | | 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: org.omg.CORBA.Object
author:
OMG
version:
1.44 05/05/07 |
| Method Summary | |
| abstract public Request | create_request(org.omg.CORBA.Object obj, Context ctx, String operation, NVList arg_list, NamedValue result)
Creates a Request instance for use in the Dynamic Invocation Interface.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
ctx - The context to be used.
Parameters:
operation - The name of the operation to beinvoked.
Parameters:
arg_list - The arguments to the operation in theform of an NVList.
Parameters:
result - A container for the result as a NamedValue. | | abstract public Request | create_request(org.omg.CORBA.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.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
ctx - The context to be used.
Parameters:
operation - The name of the operation to beinvoked.
Parameters:
arg_list - The arguments to the operation in theform of an NVList.
Parameters:
result - A container for the result as a NamedValue.
Parameters:
exclist - A list of possible exceptions theoperation can throw.
Parameters:
ctxlist - A list of context strings that needto be resolved and sent with theRequest. | | abstract public org.omg.CORBA.Object | duplicate(org.omg.CORBA.Object obj)
Returns a duplicate of the object reference provided. | | public boolean | equals(org.omg.CORBA.Object self, java.lang.Object obj)
Provides the implementation to override the equals(java.lang.Object obj)
method of the delegating CORBA object. | | public org.omg.CORBA.DomainManager[] | get_domain_managers(org.omg.CORBA.Object self)
Retrieves the DomainManagers of this object.
This allows administration services (and applications) to retrieve the
domain managers, and hence the security and other policies applicable
to individual objects that are members of the domain.
Parameters:
self - The object reference which delegated to this delegate. | | abstract public org.omg.CORBA.Object | get_interface_def(org.omg.CORBA.Object self)
Return an InterfaceDef for the object reference provided. | | public org.omg.CORBA.Policy | get_policy(org.omg.CORBA.Object self, int policy_type)
Returns the Policy object of the specified type
which applies to this object.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
policy_type - The type of policy to be obtained. | | abstract public int | hash(org.omg.CORBA.Object obj, int max)
Returns an ORB-internal identifier (hashcode) for this object reference.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
max - specifies an upper bound on the hash value returned bythe ORB. | | public int | hashCode(org.omg.CORBA.Object self)
Provides the implementation to override the hashCode() method
of the delegating CORBA object. | | public InputStream | invoke(org.omg.CORBA.Object self, OutputStream output)
invoke is called by a stub to invoke an operation. | | abstract public boolean | is_a(org.omg.CORBA.Object obj, String repository_id)
Checks if the object reference is an instance of the given interface.
Parameters:
obj - The object reference to be checked.
Parameters:
repository_id - The repository identifier of the interface to check against. | | abstract public boolean | is_equivalent(org.omg.CORBA.Object obj, org.omg.CORBA.Object other)
Determines if the two object references are equivalent.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
other - The object reference to check equivalence against. | | public boolean | is_local(org.omg.CORBA.Object self)
Returns true if this object is implemented by a local servant. | | abstract public boolean | non_existent(org.omg.CORBA.Object obj)
Determines whether the server object for the object reference has been
destroyed.
Parameters:
obj - The object reference which delegated to this delegate. | | public org.omg.CORBA.ORB | orb(org.omg.CORBA.Object obj)
Provides a reference to the orb associated with its parameter.
Parameters:
obj - the object reference which delegated to this delegate. | | abstract public void | release(org.omg.CORBA.Object obj)
Releases resources associated with the object reference provided. | | public void | releaseReply(org.omg.CORBA.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. | | abstract public Request | request(org.omg.CORBA.Object obj, String operation)
Creates a Request instance for use in the Dynamic Invocation Interface.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
operation - The name of the operation to be invoked using theRequest instance. | | public OutputStream | request(org.omg.CORBA.Object self, String operation, boolean responseExpected)
request is called by a stub to obtain an OutputStream for
marshaling arguments. | | public void | servant_postinvoke(org.omg.CORBA.Object self, ServantObject servant)
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. | | public ServantObject | servant_preinvoke(org.omg.CORBA.Object self, String operation, Class expectedType)
Returns a Java reference to the servant which should be used for this
request. | | public org.omg.CORBA.Object | set_policy_override(org.omg.CORBA.Object self, org.omg.CORBA.Policy[] policies, org.omg.CORBA.SetOverrideType set_add)
Associates the policies passed in
with a newly created object reference that it returns. | | public String | toString(org.omg.CORBA.Object self)
Provides the implementation to override the toString() method
of the delegating CORBA object. |
| create_request | | abstract public Request create_request(org.omg.CORBA.Object obj, Context ctx, String operation, NVList arg_list, NamedValue result)(Code) | | Creates a Request instance for use in the Dynamic Invocation Interface.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
ctx - The context to be used.
Parameters:
operation - The name of the operation to beinvoked.
Parameters:
arg_list - The arguments to the operation in theform of an NVList.
Parameters:
result - A container for the result as a NamedValue. The created Request object. |
| create_request | | abstract public Request create_request(org.omg.CORBA.Object obj, Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist)(Code) | | Creates a Request instance for use in the Dynamic Invocation Interface.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
ctx - The context to be used.
Parameters:
operation - The name of the operation to beinvoked.
Parameters:
arg_list - The arguments to the operation in theform of an NVList.
Parameters:
result - A container for the result as a NamedValue.
Parameters:
exclist - A list of possible exceptions theoperation can throw.
Parameters:
ctxlist - A list of context strings that needto be resolved and sent with theRequest. The created Request object. |
| duplicate | | abstract public org.omg.CORBA.Object duplicate(org.omg.CORBA.Object obj)(Code) | | Returns a duplicate of the object reference provided.
Parameters:
obj - The object reference whose duplicate needs to be returned the duplicate object reference |
| equals | | public boolean equals(org.omg.CORBA.Object self, java.lang.Object obj)(Code) | | Provides the implementation to override the equals(java.lang.Object obj)
method of the delegating CORBA object.
Parameters:
self - the object reference that delegated to this delegate
Parameters:
obj - the Object with which to compare true if obj equals self;false otherwise |
| get_domain_managers | | public org.omg.CORBA.DomainManager[] get_domain_managers(org.omg.CORBA.Object self)(Code) | | Retrieves the DomainManagers of this object.
This allows administration services (and applications) to retrieve the
domain managers, and hence the security and other policies applicable
to individual objects that are members of the domain.
Parameters:
self - The object reference which delegated to this delegate. The list of immediately enclosing domain managers of this object.At least one domain manager is always returned in the list since bydefault each object is associated with at least one domain manager atcreation.
See Also: portable
See Also: package comments for unimplemented features |
| get_interface_def | | abstract public org.omg.CORBA.Object get_interface_def(org.omg.CORBA.Object self)(Code) | | Return an InterfaceDef for the object reference provided.
Parameters:
self - The object reference whose InterfaceDef needs to be returned the InterfaceDef |
| get_policy | | public org.omg.CORBA.Policy get_policy(org.omg.CORBA.Object self, int policy_type)(Code) | | Returns the Policy object of the specified type
which applies to this object.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
policy_type - The type of policy to be obtained. A Policy object of the type specified bythe policy_type parameter.
exception:
org.omg.CORBA.BAD_PARAM - raised when the value of policy typeis not valid either because the specified type is not supported by thisORB or because a policy object of that type is not associated with thisObject.
See Also: portable
See Also: package comments for unimplemented features |
| hash | | abstract public int hash(org.omg.CORBA.Object obj, int max)(Code) | | Returns an ORB-internal identifier (hashcode) for this object reference.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
max - specifies an upper bound on the hash value returned bythe ORB. ORB-internal hash identifier for object reference |
| hashCode | | public int hashCode(org.omg.CORBA.Object self)(Code) | | Provides the implementation to override the hashCode() method
of the delegating CORBA object.
Parameters:
self - the object reference that delegated to this delegate an int that represents the hashcode for theobject reference that delegated to this Delegateobject |
| invoke | | public InputStream invoke(org.omg.CORBA.Object self, OutputStream output) throws ApplicationException, RemarshalException(Code) | | 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.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
output - the OutputStream which contains marshaled arguments 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.
throws:
RemarshalException - thrown when remarshalling fails.
See Also: portable
See Also: package comments for unimplemented features |
| is_a | | abstract public boolean is_a(org.omg.CORBA.Object obj, String repository_id)(Code) | | Checks if the object reference is an instance of the given interface.
Parameters:
obj - The object reference to be checked.
Parameters:
repository_id - The repository identifier of the interface to check against. true if the object reference supports the interface |
| is_equivalent | | abstract public boolean is_equivalent(org.omg.CORBA.Object obj, org.omg.CORBA.Object other)(Code) | | Determines if the two object references are equivalent.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
other - The object reference to check equivalence against. true if the objects are CORBA-equivalent. |
| is_local | | public boolean is_local(org.omg.CORBA.Object self)(Code) | | Returns true if this object is implemented by a local servant.
Parameters:
self - The object reference which delegated to this delegate. true only if the servant incarnating this object is located in this Java VM. Return false if the servant is not local or the ORB does not support local stubs for this particular servant. The default behavior of is_local() is to return false. |
| non_existent | | abstract public boolean non_existent(org.omg.CORBA.Object obj)(Code) | | Determines whether the server object for the object reference has been
destroyed.
Parameters:
obj - The object reference which delegated to this delegate. true if the ORB knows authoritatively that the server object doesnot exist, false otherwise |
| release | | abstract public void release(org.omg.CORBA.Object obj)(Code) | | Releases resources associated with the object reference provided.
Parameters:
obj - The object reference whose resources need to be released |
| releaseReply | | public void releaseReply(org.omg.CORBA.Object self, InputStream input)(Code) | | 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.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
input - the InputStream returned from invoke().
See Also: portable
See Also: package comments for unimplemented features |
| request | | abstract public Request request(org.omg.CORBA.Object obj, String operation)(Code) | | Creates a Request instance for use in the Dynamic Invocation Interface.
Parameters:
obj - The object reference which delegated to this delegate.
Parameters:
operation - The name of the operation to be invoked using theRequest instance. the created Request instance |
| request | | public OutputStream request(org.omg.CORBA.Object self, String operation, boolean responseExpected)(Code) | | 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).
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
operation - a string containing the operation name.The operation name corresponds to the operation name as it would beencoded in a GIOP request.
Parameters:
responseExpected - false if the operation is a one way operation,and true otherwise. OutputStream the OutputStream into which request arguments can be marshaled.
See Also: portable
See Also: package comments for unimplemented features |
| servant_postinvoke | | public void servant_postinvoke(org.omg.CORBA.Object self, ServantObject servant)(Code) | | 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.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
servant - the instance of the ServantObject returned from the servant_preinvoke() method. |
| servant_preinvoke | | public ServantObject servant_preinvoke(org.omg.CORBA.Object self, String operation, Class expectedType)(Code) | | 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.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
operation - a string containing the operation name.The operation name corresponds to the operation name as it would be encoded in a GIOP request.
Parameters:
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). 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. |
| set_policy_override | | public org.omg.CORBA.Object set_policy_override(org.omg.CORBA.Object self, org.omg.CORBA.Policy[] policies, org.omg.CORBA.SetOverrideType set_add)(Code) | | Associates the policies passed in
with a newly created object reference that it returns. Only certain
policies that pertain to the invocation of an operation at the client
end can be overridden using this operation. Attempts to override any
other policy will result in the raising of the CORBA::NO_PERMISSION
exception.
Parameters:
self - The object reference which delegated to this delegate.
Parameters:
policies - A sequence of references to Policy objects.
Parameters:
set_add - Indicates whether these policies should be added onto any otheroverrides that already exist (ADD_OVERRIDE) in the object reference, or they should be added to a clean override free object reference (SET_OVERRIDE). A new object reference with the new policies associated with it.
See Also: portable
See Also: package comments for unimplemented features |
| toString | | public String toString(org.omg.CORBA.Object self)(Code) | | Provides the implementation to override the toString() method
of the delegating CORBA object.
Parameters:
self - the object reference that delegated to this delegate a String object that represents the objectreference that delegated to this Delegateobject |
|
|