public class LocalObject extends Object implements Object
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
Constructor and Description |
---|
LocalObject()
Constructs a default
LocalObject instance. |
Modifier and Type | Method and Description |
---|---|
Request |
_create_request(Context ctx,
String operation,
NVList arg_list,
NamedValue result)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
Request |
_create_request(Context ctx,
String operation,
NVList arg_list,
NamedValue result,
ExceptionList exceptions,
ContextList contexts)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
Object |
_duplicate()
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
DomainManager[] |
_get_domain_managers()
Throws an
org.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. |
Object |
_get_interface_def()
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
Object |
_get_interface()
Throws an
org.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. |
Policy |
_get_policy(int policy_type)
Throws an
org.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.
|
InputStream |
_invoke(OutputStream output)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
boolean |
_is_a(String repository_id)
Throws an
org.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 |
_is_local()
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
boolean |
_non_existent()
Always returns
false . |
ORB |
_orb()
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
void |
_release()
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
void |
_releaseReply(InputStream input)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
Request |
_request(String operation)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
OutputStream |
_request(String operation,
boolean responseExpected)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
void |
_servant_postinvoke(ServantObject servant)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
ServantObject |
_servant_preinvoke(String operation,
Class expectedType)
Throws an
org.omg.CORBA.NO_IMPLEMENT exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object method. |
Object |
_set_policy_override(Policy[] policies,
SetOverrideType set_add)
Throws an
org.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 |
validate_connection()
Throws an
org.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. |
public boolean _is_equivalent(Object that)
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.
_is_equivalent
in interface Object
that
- the 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()
false
.
This method is the default implementation of the
org.omg.CORBA.Object
method._non_existent
in interface Object
false
public int _hash(int maximum)
org.omg.CORBA.Object
method.public boolean _is_a(String repository_id)
org.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 the
org.omg.CORBA.Object
method._is_a
in interface Object
repository_id
- a String
NO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectsCORBA
package
comments for unimplemented featurespublic Object _duplicate()
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method._duplicate
in interface Object
LocalObject
instance.NO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic void _release()
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method._release
in interface Object
NO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic Request _request(String operation)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method._request
in interface Object
operation
- a String
giving the name of an operation
to be performed by the request that is returnedRequest
object with the given operationNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method._create_request
in interface Object
ctx
- a Context
object containing
a list of propertiesoperation
- the String
representing 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
object initialized with the given
argumentsNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method._create_request
in interface Object
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 valueexceptions
- an ExceptionList
object containing a
list of possible exceptions the method can throwcontexts
- a ContextList
object containing a list of
context strings that need to be resolved and sent
with the
Request
instanceRequest
object initialized with the given
argumentsNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic Object _get_interface()
org.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 the
org.omg.CORBA.Object
method.NO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectsCORBA
package
comments for unimplemented featurespublic Object _get_interface_def()
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method._get_interface_def
in interface Object
InterfaceDef
object in the Interface Repository
which provides type information about the object referred to by
this object referenceNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic ORB _orb()
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method.ObjectImpl
NO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic Policy _get_policy(int policy_type)
org.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 the
org.omg.CORBA.Object
method._get_policy
in interface Object
policy_type
- an int
NO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectsCORBA
package
comments for unimplemented featurespublic DomainManager[] _get_domain_managers()
org.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 the
org.omg.CORBA.Object
method._get_domain_managers
in interface Object
NO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic Object _set_policy_override(Policy[] policies, SetOverrideType set_add)
org.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 the
org.omg.CORBA.Object
method._set_policy_override
in interface Object
policies
- an arrayset_add
- a flagNO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectsCORBA
package
comments for unimplemented featurespublic boolean _is_local()
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method.
Returns true
for this LocalObject
instance.
true
alwaysNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic ServantObject _servant_preinvoke(String operation, Class expectedType)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method.operation
- a String
indicating which operation
to preinvokeexpectedType
- the class of the type of operation mentioned aboveNO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectCORBA
package
comments for unimplemented featurespublic void _servant_postinvoke(ServantObject servant)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method.servant
- the servant object on which to post-invokeNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic OutputStream _request(String operation, boolean responseExpected)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.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).
operation
- the name of the operation being requestedresponseExpected
- true
if a response is expected,
false
if it is a one-way callNO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectsCORBA
package
comments for unimplemented featurespublic InputStream _invoke(OutputStream output) throws ApplicationException, RemarshalException
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.omg.CORBA.Object
method.
Called to invoke an operation. The stub provides an
OutputStream
that was previously returned by a
_request()
call. _invoke
returns an InputStream
which
contains the
marshaled reply. If an exception occurs, _invoke
may throw an
ApplicationException
object which contains an
InputStream
from
which the user exception state may be unmarshaled.
output
- the OutputStream
to invokeApplicationException
- If an exception occurs,
_invoke
may throw an
ApplicationException
object which contains
an InputStream
from
which the user exception state may be unmarshaled.RemarshalException
- If an exception occurs,
_invoke
may throw an
ApplicationException
object which contains
an InputStream
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 objectsCORBA
package
comments for unimplemented featurespublic void _releaseReply(InputStream input)
org.omg.CORBA.NO_IMPLEMENT
exception with
the message "This is a locally constrained object."
This method is the default implementation of the
org.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()
or
ApplicationException.getInputStream()
.
A null
value may also be passed to _releaseReply
, in which case the
method is a no-op.
input
- the reply stream back to the ORB or nullNO_IMPLEMENT
CORBA
package
comments for unimplemented featurespublic boolean validate_connection()
org.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 the
org.omg.CORBA.Object
method.NO_IMPLEMENT
- because this is a locally constrained object
and this method does not apply to local objectsCORBA
package
comments for unimplemented featuresCopyright © 2016 JBoss by Red Hat. All rights reserved.