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

3.18.3.2 com.fujitsu.ObjectDirector.CORBA.ORB.set_client_request_timer()

名前

　com.fujitsu.ObjectDirector.CORBA.ORB.set_client_request_timer()

形式

　public void set_client_request_timer(int time) 
　       throws  org.omg.CORBA.BAD_PARAM,
　       org.omg.CORBA.NO_MEMORY;

機能説明

　クライアントアプリケーションにおいて、サーバメソッドが復帰するまでの待機時間をtimeに設定します。ここで設定する待機時間は、本メソッドを発行したスレッドが今後発行するすべてのリクエストに対して有効となります。本メソッドを発行した場合、スレッドを終了する前にcom.fujitsu.ObjectDirector.CORBA.ORB.clear_client_request_timer()を発行する必要があります。

パラメタ

　time

　サーバメソッドが復帰するまでの待機時間（秒単位）。待機時間には、0から100000000までを指定することができます。0を指定する場合は、サーバメソッドが復帰するまでの待機時間を監視しません。

復帰値

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

　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_request_timer(time);

注意事項

• 本メソッドは、クライアントプロセスの待機時間を変更する必要がある場合に使用します。
• 本メソッドは、サーバへのリクエスト送信に先立って発行することにより、スレッド単位で待機時間を設定します。
• 本メソッドを発行した場合、スレッドを終了する前に、com.fujitsu.ObjectDirector.CORBA.ORB.clear_client_request_timer()を発行しないと、メモリリークが発生します。なお、プロセスが終了すると、本メソッドを発行することによって獲得したメモリは解放されます。
• 本メソッドを発行した後、com.fujitsu.ObjectDirector.CORBA.ORB.clear_client_request_timer()を発行するまで、スレッド名を変更しないでください。スレッド名を途中で変更した場合、メモリリークが発生します。
• 本メソッドを発行した後、タイムアウト時間を別の値に設定する場合は、再度本メソッドを発行します。その際、com.fujitsu.ObjectDirector.CORBA.ORB.clear_client_request_timer()を事前に発行する必要はありません。
• 待機時間の優先度は、以下のとおりです（高い順から記載します）。
  1. com.fujitsu.ObjectDirector.CORBA.ORB.set_client_request_timer()による設定
  2. com.fujitsu.ObjectDirector.CORBA.ORB.set_client_timer()による設定
  3. configファイルで設定される待機時間（period_receive_timeout×5秒）