|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The definition for a CORBA object reference.
A CORBA object reference is a handle for a particular CORBA object implemented by a server. A CORBA object reference identifies the same CORBA object each time the reference is used to invoke a method on the object. A CORBA object may have multiple, distinct object references.
The org.omg.CORBA.Object
interface is the root of
the inheritance hierarchy for all CORBA object references in the Java
programming language, analogous to java.rmi.Remote
for RMI remote objects.
A CORBA object may be either local or remote. If it is a local object (that is, running in the same VM as the client), invocations may be directly serviced by the object instance, and the object reference could point to the actual instance of the object implementation class. If a CORBA object is a remote object (that is, running in a different VM from the client), the object reference points to a stub (proxy) which uses the ORB machinery to make a remote invocation on the server where the object implementation resides.
Default implementations of the methods in the interface
org.omg.CORBA.Object
are provided in the class org.omg.CORBA.portable.ObjectImpl
,
which is the base class for stubs and object implementations.
ObjectImpl
Method Summary | |
Request |
_create_request(Context ctx,
String operation,
NVList arg_list,
NamedValue result)
Creates a Request instance initialized with the
given context, method name, list of arguments, and container
for the method's return value. |
Request |
_create_request(Context ctx,
String operation,
NVList arg_list,
NamedValue result,
ExceptionList exclist,
ContextList ctxlist)
Creates a Request instance initialized with the
given context, method name, list of arguments, container
for the method's return value, list of possible exceptions,
and list of context strings needing to be resolved. |
Object |
_duplicate()
Returns a duplicate of this CORBA object reference. |
DomainManager[] |
_get_domain_managers()
Retrieves the DomainManagers of this object. |
Object |
_get_interface_def()
Obtains an InterfaceDef for the object implementation
referenced by this object reference. |
Policy |
_get_policy(int policy_type)
Returns the Policy object of the specified type
which applies to this object. |
int |
_hash(int maximum)
Returns an ORB-internal identifier for this object reference. |
boolean |
_is_a(String repositoryIdentifier)
Checks whether this object is an instance of a class that implements the given interface. |
boolean |
_is_equivalent(Object other)
Determines whether the two object references are equivalent, so far as the ORB can easily determine. |
boolean |
_non_existent()
Determines whether the server object for this object reference has been destroyed. |
void |
_release()
Signals that the caller is done using this object reference, so internal ORB resources associated with this object reference can be released. |
Request |
_request(String operation)
Creates a Request instance for use in the
Dynamic Invocation Interface. |
Object |
_set_policy_override(Policy[] policies,
SetOverrideType set_add)
|
Method Detail |
public boolean _is_a(String repositoryIdentifier)
repositoryIdentifier
- the interface to check againsttrue
if this object reference is an instance
of a class that implements the interface;
false
otherwisepublic boolean _is_equivalent(Object other)
other
- the other object reference with which to check for equivalencetrue
if this object reference is known to be
equivalent to the given object reference.
Note that false
indicates only that the two
object references are distinct, not necessarily that
they reference distinct objects.public boolean _non_existent()
true
if the ORB knows authoritatively that the
server object does not exist; false
otherwisepublic int _hash(int maximum)
maximum
- the upper bound on the hash value returned by the ORBpublic Object _duplicate()
Note that this method is not very useful in the Java platform, since memory management is handled by the VM. It is included for compliance with the CORBA APIs.
The method _duplicate
may return this object reference itself.
public void _release()
public Object _get_interface_def()
InterfaceDef
for the object implementation
referenced by this object reference.
The InterfaceDef
object
may be used to introspect on the methods, attributes, and other
type information for the object referred to by this object reference.InterfaceDef
object in the Interface Repository
which provides type information about the object referred to by
this object referencepublic Request _request(String operation)
Request
instance for use in the
Dynamic Invocation Interface.operation
- the name of the method to be invoked using the
Request
instanceRequest
instancepublic Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result)
Request
instance initialized with the
given context, method name, list of arguments, and container
for the method's return value.ctx
- a Context
object containing
a list of propertiesoperation
- the name of the method to be invokedarg_list
- an NVList
containing the actual arguments
to the method being invokedresult
- a NamedValue
object to serve as a
container for the method's return valueRequest
objectRequest
,
NVList
,
NamedValue
public Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist)
Request
instance initialized with the
given context, method name, list of arguments, container
for the method's return value, list of possible exceptions,
and list of context strings needing to be resolved.ctx
- a Context
object containing
a list of propertiesoperation
- the name of the method to be invokedarg_list
- an NVList
containing the actual arguments
to the method being invokedresult
- a NamedValue
object to serve as a
container for the method's return valueexclist
- an ExceptionList
object containing a
list of possible exceptions the method can throwctxlist
- a ContextList
object containing a list of
context strings that need to be resolved and sent with the
Request
instanceRequest
objectRequest
,
NVList
,
NamedValue
,
ExceptionList
,
ContextList
public Policy _get_policy(int policy_type)
Policy
object of the specified type
which applies to this object.policy_type
- the type of policy to be obtainedPolicy
object of the type specified by
the policy_type parameterpublic DomainManager[] _get_domain_managers()
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.public Object _set_policy_override(Policy[] policies, SetOverrideType set_add)
|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |