- java.lang.Object
-
- org.omg.CORBA.LocalObject
-
- All Implemented Interfaces:
- Object
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, theLocalObject
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 Summary
Constructors Constructor and Description LocalObject()
Constructs a defaultLocalObject
instance.
-
Method Summary
Methods Modifier and Type Method and Description Request
_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.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.Object
_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.DomainManager[]
_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.Object
_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.Object
_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.Policy
_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.InputStream
_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
_is_a(String repository_id)
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
_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.boolean
_non_existent()
Always returnsfalse
.ORB
_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.Request
_request(String operation)
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.OutputStream
_request(String operation, boolean responseExpected)
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.ServantObject
_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.Object
_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
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.
-
-
-
Method Detail
-
_is_equivalent
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.
- 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
public boolean _is_a(String repository_id)
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:
CORBA
package comments for unimplemented features
-
_duplicate
public Object _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
- See Also:
CORBA
package comments for unimplemented features
-
_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
- See Also:
CORBA
package comments for unimplemented features
-
_request
public Request _request(String operation)
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
- See Also:
CORBA
package comments for unimplemented features
-
_create_request
public Request _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.- 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
- See Also:
CORBA
package comments for unimplemented features
-
_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
- See Also:
CORBA
package comments for unimplemented features
-
_get_interface
public Object _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:
CORBA
package comments for unimplemented features
-
_get_interface_def
public Object _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
- See Also:
CORBA
package comments for unimplemented features
-
_orb
public ORB _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
- See Also:
CORBA
package comments for unimplemented features
-
_get_policy
public Policy _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. 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:
CORBA
package comments for unimplemented features
-
_get_domain_managers
public DomainManager[] _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
- See Also:
CORBA
package comments for unimplemented features
-
_set_policy_override
public Object _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. 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:
CORBA
package comments for unimplemented features
-
_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
- See Also:
CORBA
package comments for unimplemented features
-
_servant_preinvoke
public ServantObject _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.- 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:
CORBA
package comments for unimplemented features
-
_servant_postinvoke
public 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.- Parameters:
servant
- the servant object on which to post-invoke- Throws:
NO_IMPLEMENT
- See Also:
CORBA
package comments for unimplemented features
-
_request
public OutputStream _request(String operation, boolean responseExpected)
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:
CORBA
package comments for unimplemented features
-
_invoke
public InputStream _invoke(OutputStream output) throws ApplicationException, RemarshalException
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:
CORBA
package comments for unimplemented features
-
_releaseReply
public 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.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
- See Also:
CORBA
package comments for unimplemented features
-
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:
CORBA
package comments for unimplemented features
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
05/11/2024 19:54:44 Cette version de la page est en cache (à la date du 05/11/2024 19:54:44) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 16/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-org/omg/CORBA/LocalObject.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.