3.18.3.1 com.fujitsu.ObjectDirector.CORBA.ORB.set_client

Interstage Application Server リファレンスマニュアル（API編）

目次索引

第3章 Javaインタフェース

> 3.18 その他のインタフェース

> 3.18.3 サーバメソッド待機時間設定インタフェース

3.18.3.1 com.fujitsu.ObjectDirector.CORBA.ORB.set_client_timer()

名前

　com.fujitsu.ObjectDirector.CORBA.ORB.set_client_timer

形式

　public void set_client_timer ( org.omg.CORBA.Object obj, int time ) 
　throws org.omg.CORBA.INV_OBJREF, 
       org.omg.CORBA.BAD_PARAM,
       org.omg.CORBA.NO_MEMORY;

機能説明

　クライアントアプリケーションにおいて、objに指定したサーバオブジェクトに対するサーバメソッドが復帰するまでの待機時間をtimeに設定します。ここで設定する待機時間は、objに指定したホスト上で動作するサーバオブジェクトすべてに対して有効となります。

パラメタ

　obj: 　待機時間を設定するサーバオブジェクトのオブジェクトリファレンス。待機時間には、0から100000000までを指定することができます。
　time: 　サーバメソッドが復帰するまでの待機時間（秒単位）。0を指定する場合は、サーバメソッドが復帰するまでの待機時間を監視しません。

復帰値

　正常終了した場合は、ありません。
　異常終了した場合は、以下のSystemExceptionが発生します。

　org.omg.CORBA.INV_OBJREF: 　objに不当なオブジェクトを指定しました。
　org.omg.CORBA.BAD_PARAM: 　timeに不当な値を指定しました。
　org.omg.CORBA.NO_MEMORY: 　メモリ不足が発生しました。

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

使用方法

　ORB.init()メソッドにより取得したORBクラスのインスタンスをcom.fujitsu.ObjectDirector.CORBA.ORB型にキャストしてから本メソッドを呼び出します。
　ただし、import宣言でcom.fujitsu.ObjectDirector.CORBAパッケージは指定しないでください。
　以下にコーディング例を記述します。

  org.omg.CORBA.ORB orb=org.omg.CORBA.ORB.init(app, props);
                     :
   ((com.fujitsu.ObjectDirector.CORBA.ORB)orb).set_client_timer(obj, time);

注意事項

本メソッドは、クライアントプロセスの待機時間をconfigファイルで設定される待機時間（period_receive_timeout×5秒）から変更する必要がある場合に使用します。
本メソッドは、サーバオブジェクトのオブジェクトリファレンスの獲得後にサーバへのリクエスト送信に先立って発行することにより、プロセス単位で待機時間を設定します。
業務アプリ動作中に待機時間を変更する場合、com.fujitsu.ObjectDirector.CORBA.ORB.net_disconnect()でコネクション情報を解放後、本メソッドを発行することにより新たに待機時間の設定ができます。
サーバオブジェクトのオブジェクトリファレンスの獲得前、または獲得時に、同じサーバマシンに対してリクエストが発行されていた場合は、本メソッドを発行する前にcom.fujitsu.ObjectDirector.CORBA.ORB.net_disconnect()によってコネクション情報を解放する必要があります。例えば、サーバオブジェクトのオブジェクトリファレンスの獲得時にorg.omg.CosNaming.NamingContext.resolve()を使用した場合、かつネーミングサービスが動作しているマシンとサーバアプリケーションが動作しているマシンが同一である場合が該当します。
引数を持たないORB.init()により作成したORBインスタンスに対して本メソッドは使用できません。

目次索引