3.18.2 通信資源解放インタフェース

名前

com.fujitsu.ObjectDirector.CORBA.ORB.net_disconnect

形式

public void net_disconnect( org.omg.CORBA.Object obj ) 
throws org.omg.CORBA.INV_OBJREF, 
     org.omg.CORBA.COMM_FAILURE;

機能説明

objで指定したオブジェクトが使用している通信資源を解放します。

パラメタ

obj: 切断するオブジェクトリファレンス。

復帰値

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

org.omg.CORBA.INV_OBJREF: 不当なオブジェクトを指定しました。
コネクションがすでに切断済です。

org.omg.CORBA.COMM_FAILURE: 通信異常が発生しました。

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

使用方法

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

以下にコーディング例を記述します。

org.omg.CORBA.ORB orb=org.omg.CORBA.ORB.init();
                   :
 ((com.fujitsu.ObjectDirector.CORBA.ORB)orb).net_disconnect(obj);

注意事項

本関数を発行した場合、クライアントアプリケーションの状態により以下のエラーが通知される場合があります。
- スレッドモードで動作するアプリケーションの場合で本関数を発行したスレッド以外でサーバとの通信を行っていた場合、サーバと通信を行っているスレッドにorg.omg.CORBA.COMM_FAILUREが通知されます。
- 非同期リクエストを発行している場合に非同期依頼の結果が受け取れません。
- 同一のobjに対し本関数を発行した場合、org.omg.CORBA.INV_OBJREFが通知されます。
- サーバマシンに対するコネクション情報が存在しない場合は、org.omg.CORBA.INV_OBJREFまたはorg.omg.CORBA.COMM_FAILUREが通知されます。
本関数を発行したクライアントプロセスでパラメタに指定した解放対象のobjが存在するサーバマシンを共用するその他のオブジェクトの持つインスタンス情報も併せて解放されます。

3.18.2 通信資源解放インタフェース

3.18.2.1 com.fujitsu.ObjectDirector.CORBA.ORB.net_disconnect()