JavaTM 2 Platform
Standard Ed. 6

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

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策