ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)

3.15.1 Servantインタフェース

3.15.1.1 org.omg.PortableServer.Servant._this_object()

名前

  org.omg.PortableServer.Servant._this_object

形式

[JDK/JRE1.3以前の場合]
(1)public final org.omg.CORBA.Object  _this_object();
(2)public final org.omg.CORBA.Object  _this_object(org.omg.CORBA.ORB orb);
[JDK/JRE1.4以降の場合]
(1)public final org.omg.CORBA.Object  _this_object();

機能説明

(1) 対象のServantオブジェクトに割り付けられたオブジェクトリファレンスを返します。対象とするServantオブジェクトは、RETAINポリシが設定されているPOAに関連づけられている必要があります。

(2) 対象のServantオブジェクトにサーバアプリケーションが使用しているORBのインスタンスを設定します。対象とするServantオブジェクトは、RETAINポリシが設定されているPOAに関連づけられている必要があります。復帰値には、対象のServantオブジェクトに割り付けられたオブジェクトリファレンスを返します(この動作は、org.omg.PortableServer.Servant._orb(orb)に続いて(1)を実行する場合に相当します)。

パラメタ

(1) なし。
(2)

  orb

  サーバアプリケーションが接続しているORBのインスタンス。

復帰値

(1)(2)共、正常終了した場合は、対象のServantオブジェクトのオブジェクトリファレンスを持つorg.omg.CORBA.Object型オブジェクトが返されます。

  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

  (2)の形式は、使用するJDK/JREのバージョンがJDK/JRE1.1.8、JDK/JRE1.2.2、およびJDK/JRE1.3の場合に使用できます。JDK/JRE1.4以降の場合は、“アプリケーション作成ガイド(CORBAサービス編)”の“Javaインタフェース(JDK/JRE1.3以前からJDK/JRE1.4以降への移行)”の“(8)org.omg.Portable.Servant._this_object()”を参照して必要な対処を行ってください。

3.15.1.2 org.omg.PortableServer.Servant._orb()

名前

  org.omg.PortableServer.Servant._orb()

形式

[JDK/JRE1.3以前の場合]
(1) public final org.omg.CORBA.ORB  _orb();
(2) public final void  _orb(org.omg.CORBA.ORB orb);
[JDK/JRE1.4以降の場合]
(1) public final org.omg.CORBA.ORB  _orb();

機能説明

(1) 対象のServantオブジェクトに登録されているORBのインスタンスを取得します。
(2) 対象のServantオブジェクトにサーバアプリケーションが接続しているORBのインスタンスを設定します。

パラメタ

(1) なし。
(2)

  orb

  サーバアプリケーションが接続しているORBのインスタンス。

復帰値

(1) 対象のServantオブジェクトに登録されているORBのインスタンスが返されます。
(2) なし。

  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

  (2)の形式は、使用するJDK/JREのバージョンがJDK/JRE1.1.8、JDK/JRE1.2.2、およびJDK/JRE1.3の場合に使用できます。JDK/JRE1.4以降の場合は、“アプリケーション作成ガイド(CORBAサービス編)”の“Javaインタフェース(JDK/JRE1.3以前からJDK/JRE1.4以降への移行)”の“(9)org.omg.Portable.Servant._orb()”を参照して必要な対処を行ってください。

3.15.1.3 org.omg.PortableServer.Servant._poa()

名前

  org.omg.PortableServer.Servant._poa()

形式

  public final org.omg.PortableServer.POA  _poa();

機能説明

  対象のServantオブジェクトを管理しているPOAオブジェクトを返します。

復帰値

  正常終了した場合は、Servantオブジェクトを管理しているPOAオブジェクトが返されます。
  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.15.1.4 org.omg.PortableServer.Servant._object_id()

名前

  org.omg.PortableServer.Servant._object_id

形式

  public final byte[]  _object_id();

機能説明

  対象のServantオブジェクトに割り付けられているオブジェクトIDが返されます。本メソッドはorg.omg.PortableServer.Current.get_object_id()を実行することと同一です。

復帰値

  正常終了した場合は、Servantオブジェクトに割り付けられているオブジェクトIDが返されます。
  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.15.1.5 org.omg.PortableServer.Servant._default_POA()

名前

  org.omg.PortableServer.Servant._default_POA

形式

  public org.omg.PortableServer.POA  _default_POA();

機能説明

  POA管理外のServantオブジェクトで本メソッドをコールすることにより、デフォルトのPOAオブジェクトが返されます。デフォルトPOAとしては、Servantオブジェクトが接続しているORBをもとに、ルートPOAが返されます。(ただし、当クラスのサブクラスでは、本メソッドをオーバライドして使用できるため、この場合は別のPOAオブジェクトを返すことが可能です。)

復帰値

  正常終了した場合は、デフォルトのPOAオブジェクトが返されます。
  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。