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 包中有关未实现特性的注释