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

戻り値:

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