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 要求に関連付けられたオブジェクト参照

_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

戻り値:

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