Contents | Package | Class | Tree | Deprecated | Index | Help | Java 1.2 Beta 3 | ||
PREV | NEXT | SHOW LISTS | HIDE LISTS |
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.
Method Summary | |
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.
|
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.
|
Object | _duplicate()
|
ImplementationDef | _get_implementation()
ImplementationDef object for the object
implementation referenced by this object reference.
|
InterfaceDef | _get_interface()
InterfaceDef for the object implementation
referenced by this object reference.
|
int | _hash(int maximum)
|
boolean | _is_a(String repositoryIdentifier)
|
boolean | _is_equivalent(Object other)
|
boolean | _non_existent()
|
void | _release()
|
Request | _request(String operation)
Request instance for use in the
Dynamic Invocation Interface.
|
Method Detail |
public boolean _is_a(String repositoryIdentifier)
repositoryIdentifier
- the interface to check against
true
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 equivalence
true
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 ORB
public 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 ImplementationDef _get_implementation()
ImplementationDef
object for the object
implementation referenced by this object reference.ImplementationDef
object in the
Implementation Repository that describes the object implementation
referred to by this object referencepublic InterfaceDef _get_interface()
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
instance
Request
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 properties
operation
- the name of the method to be invoked
arg_list
- an NVList
containing the actual arguments
to the method being invoked
result
- a NamedValue
object to serve as a
container for the method's return value
Request
objectpublic 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 properties
operation
- the name of the method to be invoked
arg_list
- an NVList
containing the actual arguments
to the method being invoked
result
- a NamedValue
object to serve as a
container for the method's return value
exclist
- an ExceptionList
object containing a
list of possible exceptions the method can throw
ctxlist
- a ContextList
object containing a list of
context strings that need to be resolved and sent with the
Request
instance
Request
objectContents | Package | Class | Tree | Deprecated | Index | Help | Java 1.2 Beta 3 | ||
PREV | NEXT | SHOW LISTS | HIDE LISTS |