Servant

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

org.omg.PortableServer
类 Servant

java.lang.Object
  org.omg.PortableServer.Servant

直接已知子类：: BindingIteratorPOA, DynamicImplementation, NamingContextExtPOA, NamingContextPOA, ServantActivatorPOA, ServantLocatorPOA

public abstract class Servant
extends Object
extends Object

定义本机 Servant 类型。在 Java 中，Servant 类型被映射到 Java org.omg.PortableServer.Servant 类。它充当所有 POA servant 实现的基类，提供许多可由应用程序员调用的方法，以及可由 POA 本身调用（也可由用户重写）以控制 servant 行为各方面的方法。基于 IDL to Java 规范。(CORBA V2.3.1) ptc/00-01-08.pdf。

构造方法摘要
`Servant()`

方法摘要
`abstract String[]`	`_all_interfaces(POA poa, byte[] objectId)` ORB 使用此操作从 servant 获取完整的类型信息。
`POA`	`_default_POA()` 从与 servant 关联的 ORB 实例返回根 POA。
`Delegate`	`_get_delegate()` 获取 `PortableServer::Servant` 特定于供应商的 ORB 实现。
`Object`	`_get_interface_def()` 以 `CORBA::Object` 的形式返回 `InterfaceDef` 对象，该对象定义由 `Servant` 实现的 `CORBA::Object` 的运行时类型。
`boolean`	`_is_a(String repository_id)` 查看指定的 `repository_id` 是否存在于 `_all_interfaces()` 返回的列表，或者其是否是一般 CORBA 对象的 `repository_id`。
`boolean`	`_non_existent()` 检查 `Object` 是否存在。
`byte[]`	`_object_id()` 允许便捷地执行公共方法，等效于调用 `PortableServer::Current::get_object_id`。
`ORB`	`_orb()` 返回当前与 `Servant` 关联的 ORB 实例（便捷方法）。
`POA`	`_poa()` 允许便捷地执行共用方法，等效于 `PortableServer::Current:get_POA`。
`void`	`_set_delegate(Delegate delegate)` 此操作支持 Java ORB 可移植性接口，它向通过代理支持 ORB 可移植性的类提供一个设置其委托的方法。
`Object`	`_this_object()` 允许 servant 获取为请求实现的目标 CORBA 对象的对象引用。
`Object`	`_this_object(ORB orb)` 允许 servant 获取为请求实现的目标 CORBA 对象的对象引用。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

Servant

public Servant()

方法详细信息

_get_delegate

public final Delegate _get_delegate()

获取 PortableServer::Servant 特定于供应商的 ORB 实现。

返回：: _delegate，PortableServer::Servant 特定于供应商的 ORB 实现

_set_delegate

public final void _set_delegate(Delegate delegate)

此操作支持 Java ORB 可移植性接口，它向通过代理支持 ORB 可移植性的类提供一个设置其委托的方法。

参数：: delegate - PortableServer::Servant 特定于供应商的 ORB 实现。

_this_object

public final Object _this_object()

允许 servant 获取为请求实现的目标 CORBA 对象的对象引用。

返回：: 关联请求的 this_object Object 引用。

_this_object

public final Object _this_object(ORB orb)

允许 servant 获取为请求实现的目标 CORBA 对象的对象引用。

参数：: orb - 与 servant 关联的 ORB。
返回：: 与请求关联的 _this_object 引用。

_orb

public final ORB _orb()

返回当前与 Servant 关联的 ORB 实例（便捷方法）。

返回：: 当前与 Servant 关联的 ORB 实例 orb。

_poa

public final POA _poa()

允许便捷地执行共用方法，等效于 PortableServer::Current:get_POA。

返回：: 与 servant 关联的 POA poa。

_object_id

public final byte[] _object_id()

允许便捷地执行公共方法，等效于调用 PortableServer::Current::get_object_id。

返回：: 与此 servant 关联的 Object ID object_id。

_default_POA

public POA _default_POA()

从与 servant 关联的 ORB 实例返回根 POA。子类可重写此方法来返回不同的 POA。

返回：: 与 Servant 关联的 POA default_POA。

_is_a

public boolean _is_a(String repository_id)

查看指定的 repository_id 是否存在于 _all_interfaces() 返回的列表，或者其是否是一般 CORBA 对象的 repository_id。

参数：: repository_id - 要在存储库列表中检查（或根据通用 CORBA 对象的 id 检查）的 repository_id。
返回：: is_a boolean 值，指示指定的 repository_id 是否在存储列表中或者其是否与 CORBA 对象的相同。

_non_existent

public boolean _non_existent()

检查 Object 是否存在。Servant 提供 _non_existent() 的默认实现，该实现可通过派生的 servant 重写。

返回：: 如果该对象不存在，则返回 true；否则返回 false。

_get_interface_def

public Object _get_interface_def()

以 CORBA::Object 的形式返回 InterfaceDef 对象，该对象定义由 Servant 实现的 CORBA::Object 的运行时类型。_get_interface_def 的调用者必须缩小 InterfaceDef 的结果以便使用。

如果默认行为无法满足要求，则可以通过派生的 servant 重写此 _get_interface_def() 默认实现。根据 CORBA 2.3.1 规范第 11.3.1 小节中的定义，_get_interface_def() 的默认行为是使用静态 servant 的最终派生接口或者从动态 servant 中得到的最终派生接口来获取 InterfaceDef。实现 Servant 的 Delegate 必须支持此行为。

返回：: get_interface_def（CORBA::Object 形式的 InterfaceDef 对象），它定义由 Servant 实现的 CORBA::Object 的运行时类型。

_all_interfaces

public abstract String[] _all_interfaces(POA poa,
                                         byte[] objectId)

ORB 使用此操作从 servant 获取完整的类型信息。

参数：: poa - 与 servant 关联的 POA。; objectId - 对应于与此 servant 关联的对象的 id。
返回：: 对象类型信息列表。

概述