org.omg.CORBA
類別 LocalObject

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

所有已實作的介面：

Object

public class LocalObject
extends Object
implements Object

用作 Java 語言映射中的本地 IDL 介面實作的基本類別。該類別實作了 org.omg.CORBA.Object 介面中的所有操作。

本地介面是通過使用 CORBA::LocalObject 實作的，它提供 Object 偽操作的實作以及任何其他適用於這些物件的特定於 ORB 的支持機制。物件實作技術本來就是特定於語言映射的。因此，LocalObject 型別不是在 IDL 中定義的，而是在每個語言映射中指定的。

沒有應用於本地物件的方法拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally contrained object"。試圖使用 LocalObject 創建 DII 請求將導致 NO_IMPLEMENT 系統異常。試圖編組或字元串化 LocalObject 將導致 MARSHAL 系統異常。必須像對常規物件參考那樣來縮小或擴大對 LocalObjects 的參考。

LocalObject 被用作本地受約束物件（比如 PortableServer 模組中的那些物件）的基本類別。此規範基於 CORBA Components Volume I - orbos/99-07-01。

另請參見：

CORBA 套件中有關未實作特性的註釋

建構子摘要

LocalObject()
建構一個預設 LocalObject 實例。

方法摘要

Request	_create_request(Context ctx, String operation, NVList arg_list, NamedValue result) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Request	_create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Object	_duplicate() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
DomainManager[]	_get_domain_managers() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Object	_get_interface_def() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Object	_get_interface() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Policy	_get_policy(int policy_type) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
int	_hash(int maximum) 返回與物件的生命週期一致的雜湊值，使用給定數字作為最大值。
InputStream	_invoke(OutputStream output) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
boolean	_is_a(String repository_id) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
boolean	_is_equivalent(Object that) 在 ORB 確定時所需開銷不大的範圍內確定兩個物件參考是否相等。
boolean	_is_local() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
boolean	_non_existent() 總是返回 false。
ORB	_orb() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
void	_release() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
void	_releaseReply(InputStream input) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Request	_request(String operation) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
OutputStream	_request(String operation, boolean responseExpected) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
void	_servant_postinvoke(ServantObject servant) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
ServantObject	_servant_preinvoke(String operation, Class expectedType) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
Object	_set_policy_override(Policy[] policies, SetOverrideType set_add) 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。
boolean	validate_connection() 拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

LocalObject

public LocalObject()

建構一個預設 LocalObject 實例。

方法詳細資訊

_is_equivalent

public boolean _is_equivalent(Object that)

在 ORB 確定時所需開銷不大的範圍內確定兩個物件參考是否相等。兩個等同的物件參考是相等的。兩個實際參考相同物件的不同物件參考也是相等的。但是，ORB 不需要嘗試確定兩個不同的物件參考是否參考了相同的物件，因為這種確定所需的開銷可能非常昂貴。

此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _is_equivalent

參數：

that - 用來檢查相等性的物件參考

返回：

如果已知此物件參考與給定物件參考相等，則返回 true。注意，false 只指示兩個物件參考不同，不一定指示它們所參考的物件不同。

_non_existent

public boolean _non_existent()

總是返回 false。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _non_existent

返回：

false

_hash

public int _hash(int maximum)

返回與物件的生命週期一致的雜湊值，使用給定數字作為最大值。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _hash

參數：

maximum - 一個 int 值，它標識雜湊碼的最大值

返回：

此實例的雜湊碼

_is_a

public boolean _is_a(String repository_id)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法並不應用於本地物件，所以沒有實作。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _is_a

參數：

repository_id - String

返回：

NO_IMPLEMENT，因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_duplicate

public Object _duplicate()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _duplicate

返回：

此 LocalObject 實例的副本。

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_release

public void _release()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _release

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_request

public Request _request(String operation)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _request

參數：

operation - 一個 String，它提供將由返回的請求所執行的操作的名稱

返回：

具有給定操作的 Request 物件

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_create_request

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

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _create_request

參數：

ctx - 套件含屬性列表的 Context 物件

operation - 表示將被調用的方法名稱的 String

arg_list - 套件含實際調用的方法參數的 NVList

result - 將用作該方法返回值容器的 NamedValue 物件

返回：

使用給定參數初始化的新 Request 物件

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_create_request

public Request _create_request(Context ctx,
                               String operation,
                               NVList arg_list,
                               NamedValue result,
                               ExceptionList exceptions,
                               ContextList contexts)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _create_request

參數：

ctx - 套件含屬性列表的 Context 物件

operation - 將被調用的方法的名稱

arg_list - 套件含實際調用的方法參數的 NVList

result - 將用作該方法返回值容器的 NamedValue 物件

exceptions - 一個 ExceptionList 物件，包含該方法可能拋出的異常所組成的列表

contexts - 一個 ContextList 物件，包含需要解析並隨 Request 實例一起發送的上下文字元串所組成的列表

返回：

使用給定參數初始化的新 Request 物件

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_get_interface

public Object _get_interface()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法並不應用於本地物件，所以沒有實作。此方法是 org.omg.CORBA.Object 方法的預設實作。

返回：

NO_IMPLEMENT，因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_get_interface_def

public Object _get_interface_def()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _get_interface_def

返回：

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

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_orb

public ORB _orb()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

返回：

創建此 ObjectImpl 中所包含 Delegate 的 ORB 實例

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_get_policy

public Policy _get_policy(int policy_type)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法並不應用於本地物件，所以沒有實作。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _get_policy

參數：

policy_type - int 值

返回：

NO_IMPLEMENT，因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_get_domain_managers

public DomainManager[] _get_domain_managers()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法並不應用於本地物件，所以沒有實作。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _get_domain_managers

返回：

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

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_set_policy_override

public Object _set_policy_override(Policy[] policies,
                                   SetOverrideType set_add)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法並不應用於本地物件，所以沒有實作。此方法是 org.omg.CORBA.Object 方法的預設實作。

指定者：

介面 Object 中的 _set_policy_override

參數：

policies - 一個陣列

set_add - 一個標誌

返回：

NO_IMPLEMENT，因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_is_local

public boolean _is_local()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

對於此 LocalObject 實例返回 true。

返回：

總是返回 true

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_servant_preinvoke

public ServantObject _servant_preinvoke(String operation,
                                        Class expectedType)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

參數：

operation - 指示將提前調用哪一項操作的 String

expectedType - 上述操作型別的類別

返回：

NO_IMPLEMENT，因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_servant_postinvoke

public void _servant_postinvoke(ServantObject servant)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

參數：

servant - 進行後調用的 servant 物件

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

_request

public OutputStream _request(String operation,
                             boolean responseExpected)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

此方法由 stub 調用，以獲得用於編組參數的 OutputStream。stub 必須提供操作名稱，並指示是否希望應答（即是否為單向調用）。

參數：

operation - 被請求的操作的名稱

responseExpected - 如果期望應答，則該值為 true；如果該調用是單向調用，則該值為 false

返回：

NO_IMPLEMENT 因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_invoke

public InputStream _invoke(OutputStream output)
                    throws ApplicationException,
                           RemarshalException

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

可調用此方法來調用某項操作。stub 提供以前由 _request() 調用返回的 OutputStream。_invoke 返回一個套件含已編組應答的 InputStream。如果發生異常，則 _invoke 拋出 ApplicationException 物件，該物件包含一個 InputStream，從中可解組使用者異常狀態。

參數：

output - 要調用的 OutputStream

返回：

NO_IMPLEMENT 因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

ApplicationException - 如果發生異常，則 _invoke 拋出 ApplicationException 物件，該物件包含一個 InputStream，從中可解組使用者異常狀態。

RemarshalException - 如果發生異常，則 _invoke 拋出 ApplicationException 物件，該物件包含一個 InputStream，從中可解組使用者異常狀態。

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋

_releaseReply

public void _releaseReply(InputStream input)

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法是 org.omg.CORBA.Object 方法的預設實作。

stub 可以有選擇地調用此方法，以在完成解組時將應答串流釋放回 ORB。stub 傳遞由 _invoke() 或 ApplicationException.getInputStream() 返回的 InputStream。還可以將 null 值傳遞給 _releaseReply，在這種情況下，此方法不執行任何操作。

參數：

input - 釋放回 ORB 的應答串流或 null

拋出：

NO_IMPLEMENT

另請參見：

CORBA 套件中有關未實作特性的註釋

validate_connection

public boolean validate_connection()

拋出 org.omg.CORBA.NO_IMPLEMENT 異常，並帶有訊息 "This is a locally constrained object"。此方法並不應用於本地物件，所以沒有實作。此方法是 org.omg.CORBA.Object 方法的預設實作。

返回：

NO_IMPLEMENT，因為此為本地受約束物件，並且此方法並不應用於本地物件

拋出：

NO_IMPLEMENT - 因為此為本地受約束物件，並且此方法並不應用於本地物件

另請參見：

CORBA 套件中有關未實作特性的註釋