org.omg.CORBA
Class LocalObject

java.lang.Object
  org.omg.CORBA.LocalObject

All Implemented Interfaces:

Object

public abstract class LocalObject
extends java.lang.Object
implements Object

Provides a base class for the implementation of IDL local interfaces. Note that most of the methods defined in the org.omg.CORBA.Object throw CORBA::NO_IMPLEMENT exception for local objects.

Constructor Summary

LocalObject()

Method Summary

Request	_create_request(Context ctx, java.lang.String operation, NVList arg_list, NamedValue result) Throws CORBA::NO_IMPLEMENT exception.
Request	_create_request(Context ctx, java.lang.String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts) Throws CORBA::NO_IMPLEMENT exception.
Object	_duplicate() Throws CORBA::NO_IMPLEMENT exception.
DomainManager[]	_get_domain_managers() Throws CORBA::NO_IMPLEMENT exception.
Object	_get_interface_def() Throws CORBA::NO_IMPLEMENT exception.
InterfaceDef	_get_interface() Deprecated. Deprecated by CORBA 2.4
Policy	_get_policy(int policy_type) Throws CORBA::NO_IMPLEMENT exception.
int	_hash(int maximum) Returns an ORB-internal identifier for this object reference.
java.lang.String[]	_ids() Throws CORBA::NO_IMPLEMENT exception.
InputStream	_invoke(OutputStream output) Throws CORBA::NO_IMPLEMENT exception.
boolean	_is_a(java.lang.String repositoryId) Local objects that wish to support the _is_a operation should always extend from LocalBase class generated by the IDL to Java compiler and must overrride the _ids() method.
boolean	_is_equivalent(Object that) Provides default implementation by doing an "equals" check on the two object references.
boolean	_is_local() Always returns true.
boolean	_non_existent() Always returns false for local objects.
ORB	_orb() Throws CORBA::NO_IMPLEMENT exception.
void	_release() Throws CORBA::NO_IMPLEMENT exception.
void	_releaseReply(InputStream input) Throws CORBA::NO_IMPLEMENT exception.
Request	_request(java.lang.String operation) Throws CORBA::NO_IMPLEMENT exception.
OutputStream	_request(java.lang.String operation, boolean responseExpected) Throws CORBA::NO_IMPLEMENT exception.
void	_servant_postinvoke(ServantObject servant) Throws CORBA::NO_IMPLEMENT exception.
ServantObject	_servant_preinvoke(java.lang.String operation, java.lang.Class expectedType) Throws CORBA::NO_IMPLEMENT exception.
Object	_set_policy_override(Policy[] policies, SetOverrideType set_add) Throws CORBA::NO_IMPLEMENT exception.
boolean	validate_connection() Throws CORBA::NO_IMPLEMENT exception.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalObject

public LocalObject()

Method Detail

_is_equivalent

public boolean _is_equivalent(Object that)

Provides default implementation by doing an "equals" check on the two object references.

Specified by:

_is_equivalent in interface Object

Parameters:

that - the other 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 that false indicates only that the two object references are distinct, not necessarily that they reference distinct objects.

_non_existent

public boolean _non_existent()

Always returns false for local objects.

Specified by:

_non_existent in interface Object

Returns:

true if the ORB knows authoritatively that the server object does not exist; false otherwise

_hash

public int _hash(int maximum)

Description copied from interface: Object

Returns an ORB-internal identifier for this object reference. This is a hash identifier, which does not change during the lifetime of the object reference, and so neither will any hash function of that identifier change. The value returned is not guaranteed to be unique; in other words, another object reference may have the same hash value. If two object references hash differently, then they are distinct object references; however, both may still refer to the same CORBA object.

Specified by:

_hash in interface Object

Parameters:

maximum - the upper bound on the hash value returned by the ORB

Returns:

the ORB-internal hash identifier for this object reference

_ids

public java.lang.String[] _ids()

Throws CORBA::NO_IMPLEMENT exception. Local objects that wish to support the _is_a operation should always extend from LocalBase class generated by the IDL to Java compiler and overrride this method.

_is_a

public boolean _is_a(java.lang.String repositoryId)

Local objects that wish to support the _is_a operation should always extend from LocalBase class generated by the IDL to Java compiler and must overrride the _ids() method.

Specified by:

_is_a in interface Object

Parameters:

repositoryId - the interface to check against

Returns:

true if this object reference is an instance of a class that implements the interface; false otherwise

_duplicate

public Object _duplicate()

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_duplicate in interface Object

Returns:

a duplicate of this object reference or this object reference itself

_release

public void _release()

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_release in interface Object

_request

public Request _request(java.lang.String operation)

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_request in interface Object

Parameters:

operation - the name of the method to be invoked using the Request instance

Returns:

the newly-created Request instance

_create_request

public Request _create_request(Context ctx,
                               java.lang.String operation,
                               NVList arg_list,
                               NamedValue result)

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_create_request in interface Object

Parameters:

ctx - a Context object containing a list of properties

operation - the name of the method to be invoked

arg_list - an NVList containing the actual arguments to the method being invoked

result - a NamedValue object to serve as a container for the method's return value

Returns:

the newly-created Request object

See Also:

Request, NVList, NamedValue

_create_request

public Request _create_request(Context ctx,
                               java.lang.String operation,
                               NVList arg_list,
                               NamedValue result,
                               ExceptionList exceptions,
                               ContextList contexts)

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_create_request in interface Object

Parameters:

ctx - a Context object containing a list of properties

operation - the name of the method to be invoked

arg_list - an NVList containing the actual arguments to the method being invoked

result - a NamedValue object to serve as a container for the method's return value

exceptions - an ExceptionList object containing a list of possible exceptions the method can throw

contexts - a ContextList object containing a list of context strings that need to be resolved and sent with the Request instance

Returns:

the newly-created Request object

See Also:

Request, NVList, NamedValue, ExceptionList, ContextList

_get_interface

public InterfaceDef _get_interface()

Deprecated. Deprecated by CORBA 2.4

Throws CORBA::NO_IMPLEMENT exception.

_get_interface_def

public Object _get_interface_def()

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_get_interface_def in interface Object

Returns:

the InterfaceDef object in the Interface Repository which provides type information about the object referred to by this object reference

_orb

public ORB _orb()

Throws CORBA::NO_IMPLEMENT exception.

_get_policy

public Policy _get_policy(int policy_type)

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_get_policy in interface Object

Parameters:

policy_type - the type of policy to be obtained

Returns:

A Policy object of the type specified by the policy_type parameter

_get_domain_managers

public DomainManager[] _get_domain_managers()

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_get_domain_managers in interface Object

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.

_set_policy_override

public Object _set_policy_override(Policy[] policies,
                                   SetOverrideType set_add)

Throws CORBA::NO_IMPLEMENT exception.

Specified by:

_set_policy_override in interface Object

Parameters:

policies - an array of Policy objects containing the policies to be added or to be used as replacements

set_add - either SetOverrideType.SET_OVERRIDE, indicating that the given policies will replace any existing ones, or SetOverrideType.ADD_OVERRIDE, indicating that the given policies should be added to any existing ones

Returns:

a new Object with the given policies replacing or added to those in this Object

_is_local

public boolean _is_local()

Always returns true.

_servant_preinvoke

public ServantObject _servant_preinvoke(java.lang.String operation,
                                        java.lang.Class expectedType)

Throws CORBA::NO_IMPLEMENT exception.

_servant_postinvoke

public void _servant_postinvoke(ServantObject servant)

Throws CORBA::NO_IMPLEMENT exception.

_request

public OutputStream _request(java.lang.String operation,
                             boolean responseExpected)

Throws CORBA::NO_IMPLEMENT exception.

_invoke

public InputStream _invoke(OutputStream output)
                    throws ApplicationException,
                           RemarshalException

Throws CORBA::NO_IMPLEMENT exception.

Throws:

ApplicationException

RemarshalException

_releaseReply

public void _releaseReply(InputStream input)

Throws CORBA::NO_IMPLEMENT exception.

validate_connection

public boolean validate_connection()

Throws CORBA::NO_IMPLEMENT exception.