JavaTM 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

ネイティブな 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
戻り値:
このオブジェクトの型情報のリスト

JavaTM 2 Platform
Standard Ed. 5.0

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

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。