- 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
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-org/omg/corba/localobject.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.