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

所有已知实现类：

_BindingIteratorImplBase ， _BindingIteratorStub ， _DynAnyFactoryStub ， _DynAnyStub ， _DynArrayStub ， _DynEnumStub ， _DynFixedStub ， _DynSequenceStub ， _DynStructStub ， _DynUnionStub ， _DynValueStub ， _IDLTypeStub ， _NamingContextExtStub ， _NamingContextImplBase ， _NamingContextStub ， _PolicyStub ， _Remote_Stub ， _ServantActivatorStub ， _ServantLocatorStub ， DynamicImplementation ， LocalObject ， ObjectImpl ， ObjectImpl ， Stub

public interface Object

CORBA对象引用的定义。

CORBA对象引用是由服务器实现的特定CORBA对象的句柄。 每次使用引用来调用对象上的方法时，CORBA对象引用都会标识相同的CORBA对象。 CORBA对象可能有多个不同的对象引用。

org.omg.CORBA.Object接口是Java编程语言中所有CORBA对象引用的org.omg.CORBA.Object层次结构的根，类似于RMI远程对象的java.rmi.Remote 。

CORBA对象可能是本地或远程的。 如果它是一个本地对象（即与客户端在同一个虚拟机中运行），则调用可以由对象实例直接服务，并且对象引用可以指向对象实现类的实际实例。 如果CORBA对象是一个远程对象（即在与客户端不同的虚拟机中运行），则对象引用指向使用ORB机制的对象引用（代理）在对象实现所在的服务器上进行远程调用。

在接口的方法的默认实现org.omg.CORBA.Object在类中提供org.omg.CORBA.portable.ObjectImpl ，其是用于存根和对象实现的基类。

另请参见：

ObjectImpl

方法摘要

Modifier and Type	Method and Description
Request	_create_request(Context ctx, String operation, NVList arg_list, NamedValue result) 创建一个 Request实例，使用给定的上下文，方法名称，参数列表和容器返回值进行初始化。
Request	_create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist) 创建一个 Request实例与给定的上下文，方法名称，参数列表，用于该方法的返回值的容器，可能的例外列表和上下文字符串需要被解决的名单初始化。
Object	_duplicate() 返回此CORBA对象引用的副本。
DomainManager[]	_get_domain_managers() 检索此对象的 DomainManagers 。
Object	_get_interface_def() 获取一个 InterfaceDef此对象引用所引用的对象实现。
Policy	_get_policy(int policy_type) 返回 Policy其应用于此对象的指定类型的对象。
int	_hash(int maximum) 返回此对象引用的ORB内部标识符。
boolean	_is_a(String repositoryIdentifier) 检查此对象是否是实现给定接口的类的实例。
boolean	_is_equivalent(Object other) 确定两个对象引用是否相等，只要ORB可以轻松确定。
boolean	_non_existent() 确定此对象引用的服务器对象是否已被销毁。
void	_release() 通过使用此对象引用来指示调用者，因此可以释放与此对象引用关联的内部ORB资源。
Request	_request(String operation) 创建一个用于动态调用接口的 Request实例。
Object	_set_policy_override(Policy[] policies, SetOverrideType set_add) 返回一个新 Object给定的政策或者替换这个现有的政策 Object或添加到现有的给定的政策，根据给定的值 SetOverrideType对象。

方法详细信息

_is_a

boolean _is_a(String repositoryIdentifier)

检查此对象是否是实现给定接口的类的实例。

参数

repositoryIdentifier - 检查的接口

结果

true如果此对象引用是实现该接口的类的实例; false否则

_is_equivalent

boolean _is_equivalent(Object other)

确定两个对象引用是否相等，只要ORB可以轻松确定。 两个对象引用是相同的，如果它们是相同的。 实际上指向同一个对象的两个不同的对象引用也是等效的。 然而，ORB不需要尝试确定两个不同的对象引用是指相同的对象，因为这样的确定可能是不切实际的昂贵的。

参数

other - 用于检查等价物的另一个对象引用

结果

true如果此对象引用已知与给定对象引用相当。 请注意， false仅表示两个对象引用是不同的，不一定是引用不同的对象。

_non_existent

boolean _non_existent()

确定此对象引用的服务器对象是否已被销毁。

结果

true如果ORB权威地知道服务器对象不存在; false否则

_hash

int _hash(int maximum)

返回此对象引用的ORB内部标识符。 这是一个哈希标识符，它不会在对象引用的生存期内发生变化，因此该标识符的任何散列函数都不会更改。 返回的值不能保证是唯一的; 换句话说，另一个对象引用可以具有相同的哈希值。 如果两个对象引用散列不同，那么它们是不同的对象引用; 但是，两者可能仍然引用相同的CORBA对象。

参数

maximum - 由ORB返回的哈希值的上限

结果

该对象引用的ORB内部散列标识符

_duplicate

Object _duplicate()

返回此CORBA对象引用的副本。 服务器对象实现不涉及创建副本，并且实现无法区分原始对象引用或副本是否用于发出请求。

请注意，该方法在Java平台中不是很有用，因为内存管理由VM处理。 包含在CORBA API中。

方法_duplicate可以返回此对象引用本身。

结果

该对象引用的副本或此对象引用本身

_release

void _release()

通过使用此对象引用来指示调用者，因此可以释放与此对象引用关联的内部ORB资源。 请注意，对象实现不涉及此操作，并且对同一对象的其他引用不受影响。

_get_interface_def

Object _get_interface_def()

获取一个InterfaceDef此对象引用所引用的对象实现。 可以使用InterfaceDef对象来对本对象引用引用的对象的方法，属性和其他类型信息进行内省。

结果

InterfaceDef中的 InterfaceDef对象，该对象提供了此对象引用引用的对象的类型信息

_request

Request _request(String operation)

创建一个用于动态调用接口的 Request实例。

参数

operation - 要使用 Request实例调用的方法的名称

结果

新创建的 Request实例

_create_request

Request _create_request(Context ctx,
                        String operation,
                        NVList arg_list,
                        NamedValue result)

创建一个 Request实例与给定的上下文，方法名称，参数列表，以及容器的方法的返回值初始化。

参数

ctx - 一个 Context属性列表的Context对象

operation - 要调用的方法的名称

arg_list -一个 NVList包含实际参数传递给被调用方法的

result - 一个 NamedValue对象，用作方法返回值的容器

结果

新创建的 Request对象

另请参见：

Request ， NVList ， NamedValue

_create_request

Request _create_request(Context ctx,
                        String operation,
                        NVList arg_list,
                        NamedValue result,
                        ExceptionList exclist,
                        ContextList ctxlist)

创建一个 Request实例与给定的上下文，方法名称，参数列表，用于该方法的返回值的容器，可能的例外列表和上下文字符串需要被解决的名单初始化。

参数

ctx - 一个 Context属性列表的Context对象

operation - 要调用的方法的名称

arg_list - 一个 NVList其中包含要调用的方法的实际参数

result - 一个 NamedValue对象，用作方法的返回值的容器

exclist - 一个 ExceptionList对象，包含方法可以抛出的可能的异常列表

ctxlist - 一个 ContextList对象，其中包含需要解析并使用 Request实例发送的上下文字符串列表

结果

新创建的 Request对象

另请参见：

Request ， NVList ， NamedValue ， ExceptionList ， ContextList

_get_policy

Policy _get_policy(int policy_type)

返回 Policy其应用于此对象的指定类型的对象。

参数

policy_type - 要获得的政策类型

结果

由 Policy指定的类型的Policy对象

异常

BAD_PARAM - 当策略类型的值无效时，因为此ORB不支持指定的类型，或者因为该类型的策略对象与此对象不关联

_get_domain_managers

DomainManager[] _get_domain_managers()

检索此对象的DomainManagers 。 这允许管理服务（和应用程序）检索域管理器，从而适用于作为域成员的各个对象的安全性和其他策略。

结果

该对象的立即封闭域管理器的列表。 至少一个域管理器总是在列表中返回，因为默认情况下，每个对象与创建时的至少一个域管理器相关联。

_set_policy_override

Object _set_policy_override(Policy[] policies,
                            SetOverrideType set_add)

使用给定的策略返回一个新的 Object ，取代该给定 SetOverrideType对象的值，替换此 Object现有策略或添加到现有策略中的给定策略。

参数

policies - 包含要添加或用作替换的策略的 Policy对象的数组

set_add - SetOverrideType.SET_OVERRIDE ，表示给定的政策将取代任何现有的政策，或 SetOverrideType.ADD_OVERRIDE ，表示给定的政策应该添加到任何现有的

结果

一个新的 Object与给定的政策取代或添加到这 Object那些