Class LocalObject
- All Implemented Interfaces:
Object
- Direct Known Subclasses:
CDREncapsCodec
,ClientGroupManager
,CodecFactoryImpl
,CopyObjectPolicy
,DynAnyFactoryImpl
,DynAnyImpl
,GroupInfoServiceBase
,IdAssignmentPolicyImpl
,IdUniquenessPolicyImpl
,ImplicitActivationPolicyImpl
,InitialGroupInfoService.InitialGISServantLocator
,IORInfoImpl
,LifespanPolicyImpl
,LoadBalancingPolicy
,NoConnectionCacheImpl
,ObjectAdapterBase
,ORBInitInfoImpl
,ParserTable.TestORBInitializer1
,ParserTable.TestORBInitializer2
,PICurrent
,POAManagerImpl
,ReferenceFactoryImpl
,ReferenceFactoryManagerImpl
,ReferenceFactoryManagerImpl.AdapterActivatorImpl
,ReferenceFactoryManagerImpl.ReferenceManagerPolicy
,ReferenceManagerConfigurator.RMIORInterceptor
,ReferenceManagerConfigurator.RMORBInitializer
,RequestInfoImpl
,RequestPartitioningPolicy
,RequestProcessingPolicyImpl
,RetryClientRequestInterceptor
,RetryServerRequestInterceptor
,ServantCachingPolicy
,ServantRetentionPolicyImpl
,ServerGroupManager
,ThreadPolicyImpl
,TSIdentificationImpl
,VirtualAddressAgentImpl
,ZeroPortPolicy
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
- See Also:
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription_create_request
(Context ctx, String operation, NVList arg_list, NamedValue result) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method._create_request
(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented.Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented.Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method._get_policy
(int policy_type) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented.int
_hash
(int maximum) Returns a hash value that is consistent for the lifetime of the object, using the given number as the maximum._invoke
(OutputStream output) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.boolean
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented.boolean
_is_equivalent
(Object that) Determines whether the two object references are equivalent, so far as the ORB can easily determine.boolean
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.boolean
Always returnsfalse
._orb()
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.void
_release()
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.void
_releaseReply
(InputStream input) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.void
_servant_postinvoke
(ServantObject servant) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method._servant_preinvoke
(String operation, Class expectedType) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method._set_policy_override
(Policy[] policies, SetOverrideType set_add) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented.boolean
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented.
-
Field Details
-
reason
-
-
Constructor Details
-
LocalObject
public LocalObject()Constructs a defaultLocalObject
instance.
-
-
Method Details
-
_is_equivalent
Determines whether the two object references are equivalent, so far as the ORB can easily determine. Two object references are equivalent if they are identical. Two distinct object references which in fact refer to the same object are also equivalent. However, ORBs are not required to attempt determination of whether two distinct object references refer to the same object, since such determination could be impractically expensive.
Default implementation of the org.omg.CORBA.Object method.
- Specified by:
_is_equivalent
in interfaceObject
- Parameters:
that
- the object reference with which to check for equivalence- Returns:
true
if this object reference is known to be equivalent to the given object reference. Note thatfalse
indicates only that the two object references are distinct, not necessarily that they reference distinct objects.
-
_non_existent
public boolean _non_existent()Always returnsfalse
. This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_non_existent
in interfaceObject
- Returns:
false
-
_hash
public int _hash(int maximum) Returns a hash value that is consistent for the lifetime of the object, using the given number as the maximum. This method is the default implementation of theorg.omg.CORBA.Object
method. -
_is_a
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented. This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_is_a
in interfaceObject
- Parameters:
repository_id
- aString
- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_duplicate
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_duplicate
in interfaceObject
- Returns:
- a duplicate of this
LocalObject
instance. - Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_release
public void _release()Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_release
in interfaceObject
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_request
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_request
in interfaceObject
- Parameters:
operation
- aString
giving the name of an operation to be performed by the request that is returned- Returns:
- a
Request
object with the given operation - Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_create_request
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_create_request
in interfaceObject
- Parameters:
ctx
- aContext
object containing a list of propertiesoperation
- theString
representing the name of the method to be invokedarg_list
- anNVList
containing the actual arguments to the method being invokedresult
- aNamedValue
object to serve as a container for the method's return value- Returns:
- a new
Request
object initialized with the given arguments - Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_create_request
public Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts) Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_create_request
in interfaceObject
- Parameters:
ctx
- aContext
object containing a list of propertiesoperation
- the name of the method to be invokedarg_list
- anNVList
containing the actual arguments to the method being invokedresult
- aNamedValue
object to serve as a container for the method's return valueexceptions
- anExceptionList
object containing a list of possible exceptions the method can throwcontexts
- aContextList
object containing a list of context strings that need to be resolved and sent with theRequest
instance- Returns:
- the new
Request
object initialized with the given arguments - Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_get_interface
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented. This method is the default implementation of theorg.omg.CORBA.Object
method.- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_get_interface_def
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_get_interface_def
in interfaceObject
- Returns:
- the
InterfaceDef
object in the Interface Repository which provides type information about the object referred to by this object reference - Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_orb
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Returns:
- the ORB instance that created the Delegate contained in this
ObjectImpl
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_get_policy
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented. This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_get_policy
in interfaceObject
- Parameters:
policy_type
- anint
- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_get_domain_managers
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented. This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_get_domain_managers
in interfaceObject
- Returns:
- the list of immediately enclosing domain managers of this object. At least one domain manager is always returned in the list since by default each object is associated with at least one domain manager at creation.
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_set_policy_override
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented. This method is the default implementation of theorg.omg.CORBA.Object
method.- Specified by:
_set_policy_override
in interfaceObject
- Parameters:
policies
- an arrayset_add
- a flag- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_is_local
public boolean _is_local()Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.Returns
true
for thisLocalObject
instance.- Returns:
true
always- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_servant_preinvoke
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Parameters:
operation
- aString
indicating which operation to preinvokeexpectedType
- the class of the type of operation mentioned above- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local object- See Also:
-
_servant_postinvoke
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.- Parameters:
servant
- the servant object on which to post-invoke- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_request
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.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:
operation
- the name of the operation being requestedresponseExpected
-true
if a response is expected,false
if it is a one-way call- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_invoke
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.Called to invoke an operation. The stub provides an
OutputStream
that was previously returned by a_request()
call._invoke
returns anInputStream
which contains the marshaled reply. If an exception occurs,_invoke
may throw anApplicationException
object which contains anInputStream
from which the user exception state may be unmarshaled.- Parameters:
output
- theOutputStream
to invoke- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
ApplicationException
- If an exception occurs,_invoke
may throw anApplicationException
object which contains anInputStream
from which the user exception state may be unmarshaled.RemarshalException
- If an exception occurs,_invoke
may throw anApplicationException
object which contains anInputStream
from which the user exception state may be unmarshaled.NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
_releaseReply
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method is the default implementation of theorg.omg.CORBA.Object
method.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()
orApplicationException.getInputStream()
. A null value may also be passed to_releaseReply
, in which case the method is a no-op.- Parameters:
input
- the reply stream back to the ORB or null- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-
validate_connection
public boolean validate_connection()Throws anorg.omg.CORBA.NO_IMPLEMENT
exception with the message "This is a locally constrained object." This method does not apply to local objects and is therefore not implemented. This method is the default implementation of theorg.omg.CORBA.Object
method.- Returns:
- NO_IMPLEMENT because this is a locally constrained object and this method does not apply to local objects
- Throws:
NO_IMPLEMENT
- because this is a locally constrained object and this method does not apply to local objects- See Also:
-