Used as a base class for implementation of a local IDL interface in the
Java language mapping. It is a class which implements all the operations
in the org.omg.CORBA.Object interface.
Local interfaces are implemented by using CORBA::LocalObject
to provide implementations of Object
pseudo
operations and any other ORB-specific support mechanisms that are
appropriate for such objects. Object implementation techniques are
inherently language-mapping specific. Therefore, the
LocalObject
type is not defined in IDL, but is specified
in each language mapping.
Methods that do not apply to local objects throw
an org.omg.CORBA.NO_IMPLEMENT
exception with the message,
"This is a locally contrained object." Attempting to use a
LocalObject to create a DII request results in NO_IMPLEMENT
system exception. Attempting to marshal or stringify a
LocalObject results in a MARSHAL system exception. Narrowing
and widening references to LocalObjects must work as for regular
object references.
LocalObject
is to be used as the base class of locally
constrained objects, such as those in the PortableServer module.
The specification here is based on the CORBA Components
Volume I - orbos/99-07-01