JavaTM 2 Platform
Standard Ed. 6

org.omg.CORBA
介面 Object

所有已知子介面:
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 物件參考繼承層次結構的根,類似於用於 RMI 遠端物件的 java.rmi.Remote

CORBA 物件可以是本地的,也可以是遠端的。如果該物件是一個本地物件(即與客戶端運行在同一 VM 中),則可以直接在該物件實例上進行調用,物件參考可以指向實際的物件實作類別實例。如果 CORBA 物件是一個遠端物件(即與客戶端運行在不同的 VM 中),則物件參考指向某一 stub(代理),該 stub 使用 ORB 機制在物件實作駐留的伺服器上進行遠端調用。

org.omg.CORBA.portable.ObjectImpl 類別中提供介面 org.omg.CORBA.Object 中方法的預設實作,該類別是 stub 和物件實作的基礎類別。

另請參見:
ObjectImpl

方法摘要
 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()
          檢索此物件的 DomainManager
 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()
          確定此物件參考的 server 物件是否已經被銷毀。
 void _release()
          發出信號,指示此物件參考調用者已經使用完畢,因而可以釋放與此物件參考關聯的內部 ORB 資源。
 Request _request(String operation)
          創建一個在動態調用介面 (Dynamic Invocation Interface) 中使用的 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()
確定此物件參考的 server 物件是否已經被銷毀。

返回:
如果 ORB 確信 server 物件不存在,則返回 true;否則返回 false

_hash

int _hash(int maximum)
返回此物件參考的 ORB 內部標識符。這是一個雜湊標識符,在物件參考的生存期間該標識符不會發生更改,因此該標識符的任何雜湊函數也不會發生更改。不保證返回值是唯一的;換句話說,另一個物件參考可以有相同的雜湊值。如果兩個物件參考的雜湊值不同,則它們是不同的物件參考,但是它們仍然可以參考相同的 CORBA 物件。

參數:
maximum - ORB 返回的雜湊值的上限
返回:
此物件參考的 ORB 內部雜湊標識符

_duplicate

Object _duplicate()
返回此 CORBA 物件參考的副本。server 物件實作不涉及創建副本,並且該實作無法區分請求時使用的是原始物件參考還是副本。

注意,此方法在 Java 平臺上不是很有用,因為記憶體管理由 VM 處理。包含此方法是為了與 CORBA API 保持一致。

_duplicate 方法可能返回此物件參考本身。

返回:
此物件參考的副本或此物件參考本身

_release

void _release()
發出信號,指示此物件參考調用者已經使用完畢,因而可以釋放與此物件參考關聯的內部 ORB 資源。注意,此操作中不涉及物件實作,並且不影響對同一物件的其他參考。


_get_interface_def

Object _get_interface_def()
獲取此物件參考所參考的物件實作的 InterfaceDef。可以使用 InterfaceDef 物件對此物件參考所參考物件的方法、屬性和其他型別資訊進行內省。

返回:
Repository 介面中的 InterfaceDef 物件,它提供了有關此物件參考所參考的物件的型別資訊。

_request

Request _request(String operation)
創建一個在動態調用介面 (Dynamic Invocation Interface) 中使用的 Request 實例。

參數:
operation - 使用 Request 實例調用的方法的名稱
返回:
新創建的 Request 實例

_create_request

Request _create_request(Context ctx,
                        String operation,
                        NVList arg_list,
                        NamedValue result)
創建一個 Request 實例,並使用給定上下文、方法名稱、參數列表和用於該方法返回值的容器進行初始化。

參數:
ctx - 套件含屬性列表的 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 物件
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_type 參數指定的型別的 Policy 物件
拋出:
BAD_PARAM - 當由於此 ORB 不支持指定型別或者該型別的策略物件沒有與此物件關聯而導致策略型別值無效時

_get_domain_managers

DomainManager[] _get_domain_managers()
檢索此物件的 DomainManager。這允許管理服務(和應用程序)檢索域管理程序,從而使得安全性和其他策略能應用於作為該域成員的各個物件。

返回:
此類別直接封裝的域管理程序列表。至少有一個域管理程序總是返回在列表中,因為預設情況下,每個類別在創建時至少關聯一個域管理程序。

_set_policy_override

Object _set_policy_override(Policy[] policies,
                            SetOverrideType set_add)
返回一個新的 Object,使用給定策略替換此 Object 中的所有現有策略,或者根據給定 SetOverrideType 物件的值將給定策略添加到現有策略。

參數:
policies - 一個 Policy 物件陣列,包含將添加或用作替代策略的策略
set_add - 該值可以為 SetOverrideType.SET_OVERRIDE,指示給定策略將替換所有現有策略;也可以為 SetOverrideType.ADD_OVERRIDE,指示應該添加到所有現有策略的給定策略
返回:
一個新 Object,此 Object 中的策略已使用給定策略替換或添加

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only