org.omg.PortableServer

クラス Servant

java.lang.Object

org.omg.PortableServer.Servant

直系の既知のサブクラス:

BindingIteratorPOA, DynamicImplementation, NamingContextExtPOA, NamingContextPOA, ServantActivatorPOA, ServantLocatorPOA

public abstract class Servant
extends Object

ネイティブな Servant 型を定義します。Java では、Servant 型は Java の org.omg.PortableServer.Servant クラスにマップされます。このクラスは、すべての POA サーバント実装の基底クラスとして機能し、アプリケーションプログラマが呼び出すことのできるいくつかのメソッドのほかに、POA そのものによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドも提供します。IDL - Java 間の仕様 (CORBA V2.3.1) ptc/00-01-08.pdf に準拠しています。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Servant()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract String[]	_all_interfaces(POA poa, byte[] objectId) ORB がサーバントから完全な型情報を取得するために使用します。
POA	_default_POA() サーバントに関連付けられた ORB インスタンスからルート POA を返します。
Delegate	_get_delegate() ORB ベンダー固有の PortableServer::Servant 実装を取得します。
Object	_get_interface_def() Servant によって実装された CORBA::Object の実行時の型を定義する CORBA::Object として InterfaceDef オブジェクトを返します。
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) 委譲を介して ORB の移植性をサポートするクラスをメソッドに提供することにより、Java ORB の移植性のあるインタフェースをサポートします。
Object	_this_object() サーバントが、その要求に対して生成しているターゲットの CORBA オブジェクトのオブジェクト参照を取得できるようにします。
Object	_this_object(ORB orb) サーバントが、その要求に対して生成しているターゲットの 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()

ORB ベンダー固有の PortableServer::Servant 実装を取得します。

戻り値:

_delegate ORB ベンダー固有の PortableServer::Servant 実装。

_set_delegate

public final void _set_delegate(Delegate delegate)

委譲を介して ORB の移植性をサポートするクラスをメソッドに提供することにより、Java ORB の移植性のあるインタフェースをサポートします。

パラメータ:

delegate - ORB ベンダー固有の PortableServer::Servant 実装。

_this_object

public final Object _this_object()

サーバントが、その要求に対して生成しているターゲットの CORBA オブジェクトのオブジェクト参照を取得できるようにします。

戻り値:

this_object リクエストに関連付けられた Object 参照。

_this_object

public final Object _this_object(ORB orb)

サーバントが、その要求に対して生成しているターゲットの CORBA オブジェクトのオブジェクト参照を取得できるようにします。

パラメータ:

orb - サーバントが関連付けられている ORB。

戻り値:

リクエストに関連付けられた _this_object 参照。

_orb

public final ORB _orb()

Servant に現在関連付けられている ORB のインスタンスを返します (簡易メソッド)。

戻り値:

orb Servant に現在関連付けられている ORB のインスタンス。

_poa

public final POA _poa()

共通のメソッドを簡単に実行できるようにします (PortableServer::Current:get_POA と同じ)。

戻り値:

poa サーバントに関連付けられた POA。

_object_id

public final byte[] _object_id()

共通のメソッドを簡単に実行できるようにします (PortableServer::Current::get_object_id を呼び出すのと同じ)。

戻り値:

object_id このサーバントに関連付けられた Object ID。

_default_POA

public POA _default_POA()

サーバントに関連付けられた ORB インスタンスからルート POA を返します。サブクラスはこのメソッドをオーバーライドして、別の POA を返すことができます。

戻り値:

default_POA Servant に関連付けられた 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 指定された repository_id がリポジトリリストに含まれているか、ジェネリック CORBA オブジェクトと同じであるかを示す boolean。

_non_existent

public boolean _non_existent()

Object の存在を確認します。Servant は、派生サーバントによってオーバーライドできる _non_existent() のデフォルト実装を提供します。

戻り値:

non_existent 該当するオブジェクトが存在しない場合は true、存在しない場合は false。

_get_interface_def

public Object _get_interface_def()

Servant によって実装された CORBA::Object の実行時の型を定義する CORBA::Object として InterfaceDef オブジェクトを返します。_get_interface_def の呼び出し側では、その結果を InterfaceDef にナロー変換してから使用する必要があります。

_get_interface_def() のデフォルトの実装は、デフォルトの動作が適切でない場合に派生サーバントによってオーバーライドできます。CORBA 2.3.1 仕様のセクション 11.3.1 に定義されているように、_get_interface_def() のデフォルトの動作は、静的サーバントの最上位の派生インタフェースまたは動的サーバントから取り出された最上位の派生インタフェースを使用して InterfaceDef を取得することです。この動作は、Servant を実装する Delegate によってサポートされている必要があります。

戻り値:

get_interface_def Servant によって実装された CORBA::Object の実行時の型を定義する CORBA::Object としての InterfaceDef オブジェクト。

_all_interfaces

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

ORB がサーバントから完全な型情報を取得するために使用します。

パラメータ:

poa - サーバントが関連付けられている POA。

objectId - このサーバントに関連付けられたオブジェクトに対応する ID。

戻り値:

このオブジェクトの型情報のリスト。