16.1.2 Agentのメソッド
-
public java.lang.String[ ] all_agent_locations( )
throws
com.inprise.vbroker.ObjLocation.Fail
このメソッドは,osagentが常駐しているホスト名を取得します。
このメソッドでは,次の例外が発生します。
- Fail
-
使用できるエージェントがありません。またはosagentとの通信に失敗しました。
-
public org.omg.CORBA.Object[ ] all_instances(
java.lang.String repository_id)
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,指定されたリポジトリIDを満足させる,インタフェースのインスタンスのオブジェクトリファレンスを取得します。
-
repository_id
リポジトリIDを含む文字列
このメソッドでは,次の例外が発生します。
- Fail
-
リポジトリIDが無効です。
-
-
public com.inprise.vbroker.ObjLocation.Desc[ ] all_instances_descs(
java.lang.String repository_id)
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,指定されたリポジトリIDをインプリメントするインタフェースのインスタンスに対する完全な記述情報を取得します。
-
repository_id
リポジトリIDを含む文字列
このメソッドでは,次の例外が発生します。
- Fail
-
リポジトリIDが無効です。
-
-
public org.omg.CORBA.Object[ ] all_replica(
java.lang.String repository_id,
java.lang.String instance_name)
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,指定されたリポジトリIDとインスタンス名を満足させる,インタフェースのインスタンスのオブジェクトリファレンスを取得します。
-
repository_id
リポジトリIDを含む文字列
-
instance_name
インスタンス名を含む文字列
このメソッドでは,次の例外が発生します。
- Fail
-
リポジトリID,またはインスタンス名が無効です。
-
-
public com.inprise.vbroker.ObjLocation.Desc[ ] all_replica_descs(
java.lang.String repository_id,
java.lang.String instance_name)
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,指定されたリポジトリIDをインプリメントし,指定したインスタンス名を持つインタフェースの類似名インスタンスに対する完全な記述情報を取得します。
-
repository_id
リポジトリIDを含む文字列
-
instance_name
インスタンス名を含む文字列
このメソッドでは,次の例外が発生します。
- Fail
-
リポジトリID,またはインスタンス名が無効です。
-
-
public java.lang.String[ ] all_repository_ids( )
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,任意のosagentが保持しているすべてのインタフェースを検索します。
このメソッドでは次の例外が発生します。
- Fail
-
リポジトリIDが無効です。
-
com.inprise.vbroker.ObjLocation.TriggerDesc desc,
com.inprise.vbroker.ObjLocation.TriggerHandler handler)
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,トリガーハンドラを登録します。
-
desc
インスタンスの記述。インスタンス記述として指定できるのは,リポジトリID,インスタンス名,およびホスト名など,インスタンス情報の組み合わせです。インスタンス情報が多いほど,具体的にインスタンスの指定ができます。
-
handler
登録対象のTriggerHandlerオブジェクト
このメソッドでは,次の例外が発生します。
- Fail
-
該当するトリガーはありません。
-
-
com.inprise.vbroker.ObjLocation.TriggerDesc desc,
com.inprise.vbroker.ObjLocation.TriggerHandler handler)
throws
com.inprise.inprise.vbroker.ObjLocation.Fail
このメソッドは,トリガーハンドラを登録解除します。
-
desc
インスタンスの記述。インスタンス記述として指定できるのは,リポジトリID,インスタンス名,およびホスト名など,インスタンス情報の組み合わせです。インスタンス情報が多いほど,具体的にインスタンスの指定ができます。
-
handler
登録解除対象のTriggerHandlerオブジェクト
- 注
-
トリガーは何度も呼び出されることがあります。TriggerHandlerは,トリガー記述を満たすオブジェクトがアクセスできるたびに呼び出されます。最初のインスタンスがいつアクセスできるかということを知りたい場合,エージェントのunreg_trigger( )メソッドを呼び出して,最初のイベントが見つかったあとはトリガーを登録解除してください。
このメソッドでは,次の例外が発生します。
- Fail
-
該当するトリガーはありません。
-