Package org.omg.CORBA

Interface Object

All Known Subinterfaces:
AdapterActivator, AliasDef, ArrayDef, AttributeDef, BindingIterator, ClientRequestInfo, ClientRequestInterceptor, CodeBase, CodeBase, Codec, CodecFactory, ConstantDef, Contained, Container, Control, Coordinator, Current, Current, Current, Current, DomainManager, DynamicStub, DynAny, DynAny, DynAnyFactory, DynArray, DynArray, DynEnum, DynEnum, DynFixed, DynFixed, DynSequence, DynSequence, DynStruct, DynStruct, DynUnion, DynUnion, DynValue, DynValue, DynValueBox, DynValueCommon, EnumDef, ExceptionDef, IdAssignmentPolicy, IDLType, IdUniquenessPolicy, ImplicitActivationPolicy, Interceptor, InterfaceDef, InvocationPolicy, IORInfo, IORInterceptor, IORInterceptor_3_0, IRObject, LifespanPolicy, MaxHopsPolicy, ModuleDef, NamingContext, NamingContextExt, NativeDef, NonTxTargetPolicy, OperationDef, ORBInitializer, ORBInitInfo, OTSPolicy, POA, POAManager, Policy, PolicyFactory, PrimitiveDef, QueueOrderPolicy, RebindPolicy, RecoveryCoordinator, ReferenceFactory, ReferenceFactoryManager, RelativeRequestTimeoutPolicy, RelativeRoundtripTimeoutPolicy, ReplyEndTimePolicy, ReplyPriorityPolicy, ReplyStartTimePolicy, Repository, Repository, RequestEndTimePolicy, RequestInfo, RequestPriorityPolicy, RequestProcessingPolicy, RequestStartTimePolicy, Resource, RoutingPolicy, RunTime, SequenceDef, ServantActivator, ServantLocator, ServantManager, ServantRetentionPolicy, ServerRequestInfo, ServerRequestInterceptor, StringDef, StructDef, SubtransactionAwareResource, Synchronization, SyncScopePolicy, Terminator, ThreadPolicy, TransactionalObject, TransactionFactory, TypedefDef, UnionDef, ValueBoxDef, ValueDef, ValueMemberDef
All Known Implementing Classes:
_AliasDefStub, _ArrayDefStub, _AttributeDefStub, _BindingIteratorStub, _CodeBaseImplBase, _CodeBaseStub, _CodeBaseStub, _ConstantDefStub, _ContainedStub, _ContainerStub, _ControlStub, _CoordinatorStub, _CurrentStub, _DynAnyFactoryStub, _DynAnyStub, _DynArrayStub, _DynEnumStub, _DynFixedStub, _DynSequenceStub, _DynStructStub, _DynUnionStub, _DynValueBoxStub, _DynValueCommonStub, _DynValueStub, _EnumDefStub, _ExceptionDefStub, _IDLTypeStub, _IDLTypeStub, _InterfaceDefStub, _InvocationPolicyStub, _MaxHopsPolicyStub, _ModuleDefStub, _NamingContextExtStub, _NamingContextStub, _NativeDefStub, _NonTxTargetPolicyStub, _OperationDefStub, _OTSPolicyStub, _PolicyStub, _PrimitiveDefStub, _QueueOrderPolicyStub, _RebindPolicyStub, _RecoveryCoordinatorStub, _RelativeRequestTimeoutPolicyStub, _RelativeRoundtripTimeoutPolicyStub, _Remote_Stub, _ReplyEndTimePolicyStub, _ReplyPriorityPolicyStub, _ReplyStartTimePolicyStub, _RepositoryStub, _RequestEndTimePolicyStub, _RequestPriorityPolicyStub, _RequestStartTimePolicyStub, _ResourceStub, _RoutingPolicyStub, _RunTimeStub, _SequenceDefStub, _ServantActivatorStub, _ServantLocatorStub, _StringDefStub, _StructDefStub, _SubtransactionAwareResourceStub, _SynchronizationStub, _SyncScopePolicyStub, _TerminatorStub, _TransactionalObjectStub, _TransactionFactoryStub, _TypedefDefStub, _UnionDefStub, _ValueBoxDefStub, _ValueDefStub, _ValueMemberDefStub, CachedCodeBase, CDREncapsCodec, ClientGroupManager, ClientGroupManager.GIS, ClientRequestInfoImpl, CodecFactoryImpl, CodegenStubBase, CopyObjectPolicy, CORBAObjectImpl, DynamicImplementation, DynamicStubImpl, DynAnyBasicImpl, DynAnyCollectionImpl, DynAnyComplexImpl, DynAnyConstructedImpl, DynAnyFactoryImpl, DynAnyImpl, DynArrayImpl, DynEnumImpl, DynFixedImpl, DynSequenceImpl, DynStructImpl, DynUnionImpl, DynValueBoxImpl, DynValueCommonImpl, DynValueImpl, FVDCodeBaseImpl, GroupInfoServiceBase, IdAssignmentPolicyImpl, IdUniquenessPolicyImpl, ImplicitActivationPolicyImpl, InitialGroupInfoService.InitialGISServantLocator, IORInfoImpl, LifespanPolicyImpl, LoadBalancingPolicy, LocalObject, NoConnectionCacheImpl, ObjectAdapterBase, ObjectImpl, ObjectImpl, ORBInitInfoImpl, ParserTable.TestORBInitializer1, ParserTable.TestORBInitializer2, PICurrent, POACurrent, POAImpl, POAManagerImpl, ReferenceFactoryImpl, ReferenceFactoryManagerImpl, ReferenceFactoryManagerImpl.AdapterActivatorImpl, ReferenceFactoryManagerImpl.ReferenceManagerPolicy, ReferenceManagerConfigurator.RMIORInterceptor, ReferenceManagerConfigurator.RMORBInitializer, RequestInfoImpl, RequestPartitioningPolicy, RequestProcessingPolicyImpl, RetryClientRequestInterceptor, RetryServerRequestInterceptor, ServantCachingPolicy, ServantRetentionPolicyImpl, ServerGroupManager, ServerRequestInfoImpl, Stub, StubWrapper, ThreadPolicyImpl, TOAImpl, TSIdentificationImpl, VirtualAddressAgentImpl, ZeroPortPolicy

public interface Object
The definition for a CORBA object reference.

A CORBA object reference is a handle for a particular CORBA object implemented by a server. A CORBA object reference identifies the same CORBA object each time the reference is used to invoke a method on the object. A CORBA object may have multiple, distinct object references.

The org.omg.CORBA.Object interface is the root of the inheritance hierarchy for all CORBA object references in the Java programming language, analogous to java.rmi.Remote for RMI remote objects.

A CORBA object may be either local or remote. If it is a local object (that is, running in the same VM as the client), invocations may be directly serviced by the object instance, and the object reference could point to the actual instance of the object implementation class. If a CORBA object is a remote object (that is, running in a different VM from the client), the object reference points to a stub (proxy) which uses the ORB machinery to make a remote invocation on the server where the object implementation resides.

Default implementations of the methods in the interface org.omg.CORBA.Object are provided in the class org.omg.CORBA.portable.ObjectImpl, which is the base class for stubs and object implementations.

See Also:
  • Method Summary

    Modifier and Type
    Method
    Description
    _create_request(Context ctx, String operation, NVList arg_list, NamedValue result)
    Creates a Request instance initialized with the given context, method name, list of arguments, and container for the method's return value.
    _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist)
    Creates a Request instance initialized with the given context, method name, list of arguments, container for the method's return value, list of possible exceptions, and list of context strings needing to be resolved.
    Returns a duplicate of this CORBA object reference.
    Retrieves the DomainManagers of this object.
    Obtains an InterfaceDef for the object implementation referenced by this object reference.
    _get_policy(int policy_type)
    Returns the Policy object of the specified type which applies to this object.
    int
    _hash(int maximum)
    Returns an ORB-internal identifier for this object reference.
    boolean
    _is_a(String repositoryIdentifier)
    Checks whether this object is an instance of a class that implements the given interface.
    boolean
    Determines whether the two object references are equivalent, so far as the ORB can easily determine.
    boolean
    Determines whether the server object for this object reference has been destroyed.
    void
    Signals that the caller is done using this object reference, so internal ORB resources associated with this object reference can be released.
    _request(String operation)
    Creates a Request instance for use in the Dynamic Invocation Interface.
    Returns a new Object with the given policies either replacing any existing policies in this Object or with the given policies added to the existing ones, depending on the value of the given SetOverrideType object.
  • Method Details

    • _is_a

      boolean _is_a(String repositoryIdentifier)
      Checks whether this object is an instance of a class that implements the given interface.
      Parameters:
      repositoryIdentifier - the interface to check against
      Returns:
      true if this object reference is an instance of a class that implements the interface; false otherwise
    • _is_equivalent

      boolean _is_equivalent(Object other)
      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.
      Parameters:
      other - 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

      boolean _non_existent()
      Determines whether the server object for this object reference has been destroyed.
      Returns:
      true if the ORB knows authoritatively that the server object does not exist; false otherwise
    • _hash

      int _hash(int maximum)
      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.
      Parameters:
      maximum - the upper bound on the hash value returned by the ORB
      Returns:
      the ORB-internal hash identifier for this object reference
    • _duplicate

      Object _duplicate()
      Returns a duplicate of this CORBA object reference. The server object implementation is not involved in creating the duplicate, and the implementation cannot distinguish whether the original object reference or a duplicate was used to make a request.

      Note that this method is not very useful in the Java platform, since memory management is handled by the VM. It is included for compliance with the CORBA APIs.

      The method _duplicate may return this object reference itself.

      Returns:
      a duplicate of this object reference or this object reference itself
    • _release

      void _release()
      Signals that the caller is done using this object reference, so internal ORB resources associated with this object reference can be released. Note that the object implementation is not involved in this operation, and other references to the same object are not affected.
    • _get_interface_def

      Object _get_interface_def()
      Obtains an InterfaceDef for the object implementation referenced by this object reference. The InterfaceDef object may be used to introspect on the methods, attributes, and other type information for the object referred to by this object reference.
      Returns:
      the InterfaceDef object in the Interface Repository which provides type information about the object referred to by this object reference
    • _request

      Request _request(String operation)
      Creates a Request instance for use in the Dynamic Invocation Interface.
      Parameters:
      operation - the name of the method to be invoked using the Request instance
      Returns:
      the newly-created Request instance
    • _create_request

      Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result)
      Creates a Request instance initialized with the given context, method name, list of arguments, and container for the method's return value.
      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:
    • _create_request

      Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist)
      Creates a Request instance initialized with the given context, method name, list of arguments, container for the method's return value, list of possible exceptions, and list of context strings needing to be resolved.
      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
      exclist - an ExceptionList object containing a list of possible exceptions the method can throw
      ctxlist - 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:
    • _get_policy

      Policy _get_policy(int policy_type)
      Returns the Policy object of the specified type which applies to this 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:
      BAD_PARAM - when the value of policy type is not valid either because the specified type is not supported by this ORB or because a policy object of that type is not associated with this Object
    • _get_domain_managers

      DomainManager[] _get_domain_managers()
      Retrieves the DomainManagers of this object. This allows administration services (and applications) to retrieve the domain managers, and hence the security and other policies applicable to individual objects that are members of the domain.
      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

      Object _set_policy_override(Policy[] policies, SetOverrideType set_add)
      Returns a new Object with the given policies either replacing any existing policies in this Object or with the given policies added to the existing ones, depending on the value of the given SetOverrideType 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