public interface Object
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
Modifier and Type | Method and Description |
---|---|
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)
Returns a new
Object with the given policies
either replacing any existing policies in this
Object or with the given policies added
to the existing ones, depending on the value of the
given SetOverrideType object. |
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
otherwiseboolean _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.boolean _non_existent()
true
if the ORB knows authoritatively that the
server object does not exist; false
otherwiseint _hash(int maximum)
maximum
- the upper bound on the hash value returned by the ORBObject _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.
void _release()
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 referenceRequest _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
instanceRequest _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
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
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 parameterBAD_PARAM
- when the value of policy type
is not valid either because the specified type is not supported by this
ORB or because a policy object of that type is not associated with this
ObjectDomainManager[] _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.Object _set_policy_override(Policy[] policies, SetOverrideType set_add)
Object
with the given policies
either replacing any existing policies in this
Object
or with the given policies added
to the existing ones, depending on the value of the
given SetOverrideType
object.policies
- an array of Policy
objects containing
the policies to be added or to be used as replacementsset_add
- either SetOverrideType.SET_OVERRIDE
, indicating
that the given policies will replace any existing ones, or
SetOverrideType.ADD_OVERRIDE
, indicating that
the given policies should be added to any existing onesObject
with the given policies replacing
or added to those in this Object
Copyright © 2016 JBoss by Red Hat. All rights reserved.