JavaTM 2
Platform
Std. Ed. v1.4.0

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 ベンダー固有の o@throwf PortableServer::Servant 実装

_set_delegate

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


_this_object

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

戻り値:
this_object 要求に関連付けられたオブジェクト参照

_this_object

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

戻り値:
_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 であるかを確認します。

戻り値:
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 がサーバントから完全な型情報を取得するために使用します。

戻り値:
このオブジェクトの型情報のリスト

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.