org.omg.CORBA
Class LocalObject

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

All Implemented Interfaces:

Object

Direct Known Subclasses:

com.sssw.jbroker.orb.LocalityConstrainedObject

public class LocalObject

extends Object

implements Object

Provides default implementations of the org.omg.CORBA.Object methods.

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."

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

LocalObject()
Constructs a default LocalObject instance.

Method Summary

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."
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."
Object	_duplicate() Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
DomainManager[]	_get_domain_managers() Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
Object	_get_interface_def() Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
Object	_get_interface() Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
Policy	_get_policy(int policy_type) Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
int	_hash(int maximum) Retrieves a hashcode for this LocalObject instance 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." _invoke is called to invoke an operation.
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 is the default implementation of the org.omg.CORBA.Object method.
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."
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."
void	_release() Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
void	_releaseReply(InputStream input) Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object." _releaseReply may optionally be called by a stub to release a reply stream back to the ORB when the unmarshaling has completed.
Request	_request(String operation) Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
OutputStream	_request(String operation, boolean responseExpected) Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object." _request is called by a stub to obtain an OutputStream for marshaling arguments.
void	_servant_postinvoke(ServantObject servant) Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
ServantObject	_servant_preinvoke(String operation, Class expectedType) Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."
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."
boolean	validate_connection() Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalObject

public LocalObject()

Constructs a default LocalObject instance.

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 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. This method is the default implementation of the org.omg.CORBA.Object method.

Specified by:

_non_existent in interface Object

Returns:

false

_hash

public int _hash(int maximum)

Retrieves a hashcode for this LocalObject instance using the given number as the maximum. This method is the default implementation of the org.omg.CORBA.Object method.

Specified by:

_hash in interface Object

Parameters:

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

Returns:

this instance's hashcode

_is_a

public 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 is the default implementation of the org.omg.CORBA.Object method.

Specified by:

_is_a in interface Object

Parameters:

repository_id - a String identifying an object in the Interface Repository

Returns:

true if this LocalObject instance is an object identified by the given repository ID; false otherwise

Throws:

NO_IMPLEMENT

_duplicate

public 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.

Specified by:

_duplicate in interface Object

Returns:

a duplicate of this LocalObject instance

Throws:

NO_IMPLEMENT

_release

public 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.

Specified by:

_release in interface Object

Throws:

NO_IMPLEMENT

_request

public 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.

Specified by:

_request in interface Object

Parameters:

operation - a String 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

_create_request

public 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.

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:

a new Request object initialized with the given arguments

Throws:

NO_IMPLEMENT

See Also:

Request, NVList, NamedValue

_create_request

public 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.

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 new Request object initialized with the given arguments

Throws:

NO_IMPLEMENT

See Also:

Request, NVList, NamedValue, ExceptionList, ContextList

_get_interface

public Object _get_interface()

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.

Throws:

NO_IMPLEMENT

_get_interface_def

public 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.

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

Throws:

NO_IMPLEMENT

_orb

public 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.

Returns:

the ORB instance that created the Delegate contained in this ObjectImpl.

Throws:

NO_IMPLEMENT

_get_policy

public 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 is the default implementation of the org.omg.CORBA.Object method.

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

Throws:

NO_IMPLEMENT

_get_domain_managers

public DomainManager[] _get_domain_managers()

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."

Retrieves the domain managers for this local object.

Specified by:

_get_domain_managers in interface Object

Returns:

an array of DomainManager objects listing the domain managers for this LocalObject instance

Throws:

NO_IMPLEMENT

_set_policy_override

public 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."

When implemented, this method sets this LocalObject instance with the given policies. The second argument indicates whether to add the given policies or to replace the current policies with the given policies.

Specified by:

_set_policy_override in interface Object

Parameters:

policies - an array of the policies to be set

set_add - a flag indicating whether to set the given policies in place of the current ones or to add them

Returns:

an org.omg.CORBA.Object with the given policies either added to the existing ones or replacing the existing ones

Throws:

NO_IMPLEMENT

_is_local

public boolean _is_local()

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."

Returns true for this LocalObject instance.

Returns:

true always

_servant_preinvoke

public ServantObject _servant_preinvoke(String operation,
                                        Class expectedType)

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."

Throws:

NO_IMPLEMENT

_servant_postinvoke

public void _servant_postinvoke(ServantObject servant)

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."

Throws:

NO_IMPLEMENT

_request

public OutputStream _request(String operation,
                             boolean responseExpected)

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object." _request is 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).

Throws:

NO_IMPLEMENT

_invoke

public InputStream _invoke(OutputStream output)
                    throws ApplicationException,
                           RemarshalException

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object." _invoke is 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.

Parameters:

output -

Throws:

NO_IMPLEMENT

ApplicationException

RemarshalException

_releaseReply

public void _releaseReply(InputStream input)

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object." _releaseReply 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 noop.

Parameters:

input - the reply stream back to the ORB or null

Throws:

NO_IMPLEMENT

validate_connection

public boolean validate_connection()

Throws an org.omg.CORBA.NO_IMPLEMENT exception with the message "This is a locally constrained object."

Returns:

true if the connection is valid; false otherwise

Throws:

NO_IMPLEMENT