org.omg.CORBA
Interface Object

All Known Subinterfaces:
AdapterActivator, BindingIterator, ClientRequestInfo, ClientRequestInterceptor, Codec, CodecFactory, Current, Current, Current, DomainManager, DynAny, DynAny, DynAnyFactory, DynArray, DynArray, DynEnum, DynEnum, DynFixed, DynFixed, DynSequence, DynSequence, DynStruct, DynStruct, DynUnion, DynUnion, DynValue, DynValue, DynValueBox, DynValueCommon, IdAssignmentPolicy, IDLType, IdUniquenessPolicy, ImplicitActivationPolicy, Interceptor, IORInfo, IORInterceptor, IORInterceptor_3_0, IRObject, LifespanPolicy, NamingContext, NamingContextExt, ORBInitializer, ORBInitInfo, POA, POAManager, Policy, PolicyFactory, RequestInfo, RequestProcessingPolicy, RunTime, ServantActivator, ServantLocator, ServantManager, ServantRetentionPolicy, ServerRequestInfo, ServerRequestInterceptor, ThreadPolicy
All Known Implementing Classes:
_BindingIteratorImplBase, _BindingIteratorStub, _DynAnyFactoryStub, _DynAnyStub, _DynArrayStub, _DynEnumStub, _DynFixedStub, _DynSequenceStub, _DynStructStub, _DynUnionStub, _DynValueStub, _IDLTypeStub, _NamingContextExtImplBase, _NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, _PolicyStub, _Remote_Stub, _ServantActivatorStub, _ServantLocatorStub, DynamicImplementation, LocalObject, ObjectImpl, ObjectImpl, Stub

public interface Object

The CORBA object reference. The object can be either local or remote. For the local object, the methods of the derived object are called like on any other java object. For the remote object, the reference points to the stup (proxy), responsible for the remote invocation.


Method Summary
 Request _create_request(Context context, String operation, NVList parameters, NamedValue returns)
          Create a request to invoke the method of this object.
 Request _create_request(Context context, String operation, NVList parameters, NamedValue returns, ExceptionList exceptions, ContextList ctx_list)
          Create a request to invoke the method of this object, specifying context list and the list of the expected exception.
 Object _duplicate()
          Duplicate the object reference.
 DomainManager[] _get_domain_managers()
          Retrieve the domain managers for this object.
 Object _get_interface_def()
          Get the InterfaceDef for this Object.
 Policy _get_policy(int a_policy_type)
          Returns the Policy, applying to this object.
 int _hash(int maximum)
          Get the hashcode this object reference.
 boolean _is_a(String repositoryIdentifer)
          Check if this object can be referenced by the given repository id.
 boolean _is_equivalent(Object other)
          Return true if the other object references are equivalent, so far as it is possible to determine this easily.
 boolean _non_existent()
          Determines if the server object for this reference has already been destroyed.
 void _release()
          Free resoureces, occupied by this reference.
 Request _request(String operation)
          Create a request to invoke the method of this CORBA object.
 Object _set_policy_override(Policy[] policies, SetOverrideType how)
          Returns a new object with the new policies either replacing or extending the current policies, depending on the second parameter.
 

Method Detail

_create_request

Request _create_request(Context context,
                        String operation,
                        NVList parameters,
                        NamedValue returns)
Create a request to invoke the method of this object.

Parameters:
context - a list of additional properties.
operation - the name of method to be invoked.
parameters - the method parameters.
returns - the container for tge method returned value.
Returns:
the created reaquest.

_create_request

Request _create_request(Context context,
                        String operation,
                        NVList parameters,
                        NamedValue returns,
                        ExceptionList exceptions,
                        ContextList ctx_list)
Create a request to invoke the method of this object, specifying context list and the list of the expected exception.

Parameters:
context - a list of additional properties.
operation - the name of method to be invoked.
parameters - the method parameters.
returns - the container for tge method returned value.
exceptions - the list of the possible exceptions that the method can throw.
ctx_list - the list of the context strings that need to be resolved and send as a context instance.
Returns:
the created reaquest.

_duplicate

Object _duplicate()
Duplicate the object reference. This does not make much sense for java platform and is just included for the sake of compliance with CORBA APIs. The method may return the object reference itself.

Returns:
as a rule, this.

_get_domain_managers

DomainManager[] _get_domain_managers()
Retrieve the domain managers for this object.

Returns:
the domain managers.

_get_interface_def

Object _get_interface_def()
Get the InterfaceDef for this Object.


_get_policy

Policy _get_policy(int a_policy_type)
                   throws BAD_PARAM
Returns the Policy, applying to this object.

Parameters:
a_policy_type - a type of policy to be obtained.
Returns:
a corresponding Policy object.
Throws:
BAD_PARAM - if the policy of the given type is not associated with this object, or if it is not supported by this ORB.

_hash

int _hash(int maximum)
Get the hashcode this object reference. The same hashcode still does not means that the references are the same. From the other side, two different references may still refer to the same CORBA object. The returned value must not change during the object lifetime.

Parameters:
maximum - the maximal value to return.
Returns:
the hashcode.

_is_a

boolean _is_a(String repositoryIdentifer)
Check if this object can be referenced by the given repository id.

Parameters:
repositoryIdentifer - the repository id.
Returns:
true if the passed parameter is a repository id of this CORBA object.

_is_equivalent

boolean _is_equivalent(Object other)
Return true if the other object references are equivalent, so far as it is possible to determine this easily.

Parameters:
other - the other object reference.
Returns:
true if both references refer the same object, false if they probably can refer different objects.

_non_existent

boolean _non_existent()
Determines if the server object for this reference has already been destroyed.

Returns:
true if the object has been destroyed, false otherwise.

_release

void _release()
Free resoureces, occupied by this reference. The object implementation is not notified, and the other references to the same object are not affected.


_request

Request _request(String operation)
Create a request to invoke the method of this CORBA object.

Parameters:
operation - the name of the method to invoke.
Returns:
the request.

_set_policy_override

Object _set_policy_override(Policy[] policies,
                            SetOverrideType how)
Returns a new object with the new policies either replacing or extending the current policies, depending on the second parameter.

Parameters:
policies - the policy additions or replacements.
how - either SetOverrideType.SET_OVERRIDE to override the current policies of SetOverrideType.ADD_OVERRIDE to replace them.
Returns:
the new reference with the changed policies.