ホスト・アクセス統合オブジェクトのメソッド
次のメソッドは、Host Publisher で作成して ZIETrans にインポートしたホスト統合オブジェクトの中で、&studio で作成した統合オブジェクトと共に使用できます。これらのメソッドは、Host Publisher で作成したデータベース・アクセス統合オブジェクトでは使用できません。
- java.lang.String getHPubLinkKey()
- このメソッドは、統合オブジェクト・チェーンの接続を表すキーの名前を返します。この値は、非 Web コンテナーで統合オブジェクトを実行後にチェーン内の最初の統合オブジェクトから取得する必要があります。
- void setHPubLinkKey(java.lang.String value)
- このメソッドは、統合オブジェクト・チェーンの接続を表すキーの名前を設定します。この値は、非 Web コンテナーで統合オブジェクトを実行する前に、チェーン内の最初の統合オブジェクト以外のすべてのチェーニングされた統合オブジェクトに対して設定する必要があります。
- java.lang.String getHPubStartChainName()
- このメソッドは、チェーン内の中間または最後の統合オブジェクトが作成されたときに定義された開始状態ラベルの名前を返します。チェーン内の最初の統合オブジェクトと、チェーニングされていない統合オブジェクトの場合、この値は Null です。
- java.lang.String getHPubEndChainName()
- チェーン内で最初の統合オブジェクトが作成されたときに定義された停止状態ラベルを戻します。チェーン内の最後の統合オブジェクトと、チェーニングされていない統合オブジェクトの場合、この値は Null です。
- java.lang.String getHPubScreenState()
- このメソッドは、マクロが停止したときに実行された最後の &HOD マクロ画面の名前を返します。
- java.lang.String getHPubMacroMessage()
- このメソッドは、現在の &HOD; マクロ画面で実行された最後の画面のメッセージ・タグの値を返します。
- public java.lang.String getHPubConnectionOverrides()
- このメソッドは、IO で使用する接続オーバーライドを「key1=value1, key2=value2」または空ストリングの形式で返します。
詳しくは、「接続オーバーライドの指定」を参照してください。
- public void setHPUBConnectionOverrides(String overrides)
- このメソッドは、統合オブジェクト用のホスト接続を確立する際に適用する接続オーバーライドを指定します。接続オーバーライドは、統合オブジェクトの processRequest() メソッドまたは doHPTransaction() メソッドを呼び出す前に設定する必要があります。接続オーバーライドは、「key1=value1, key2=value2」という形式にする必要があります。この形式は、Web サービスを作成する場合に特に便利です。
このメソッドは、ZIETrans EJB Access Bean に基づくクライアント・プログラムで、または ZIETrans Web サービスで使用するために生成された Web サービス・クライアントで使用します。
接続オーバーライドが指定されている場合、統合オブジェクトの doHPTransaction() メソッドまたは processRequest() メソッドが呼び出されると、その統合オブジェクト用の新規の接続プールが作成されます。この新規プールは、その統合オブジェクトの元の接続プールおよび指定された接続オーバーライドを基にして作成されます。統合オブジェクトは、この新規の接続プールを使用するように自動的に切り替えられます。新規プールの名前は、統合オブジェクト・インスタンスの getHPubStartPoolName() メソッドを使用して取得することができます。
詳しくは、「接続オーバーライドの指定」を参照してください。
- public void setHPubConnectionOverrides(Properties overrides)
- このメソッドは、統合オブジェクト用のホスト接続を確立する際に適用する接続オーバーライドを設定します。接続オーバーライドは、ホスト接続を確立する統合オブジェクトの processRequest() ビジネス・メソッドまたは doHPTransaction() ビジネス・メソッドを呼び出す前に設定する必要があります。
統合オブジェクトの doHPTransaction() メソッドまたは processRequest() メソッドを呼び出す際に、その統合オブジェクトと関連付けられた接続オーバーライドがある場合は、その統合オブジェクト用の新規の接続プールが、その統合オブジェクトの接続プールおよび接続オーバーライドを基にして作成されます。新規プールの名前は、統合オブジェクト・インスタンスの getHPubStartPoolName() メソッドを使用して取得することができます。
詳しくは、「接続オーバーライドの指定」を参照してください。