acquireExistingTransformationConnection

acquireExistingTransformationConnection メソッドの目的は以下の 2 つです。
  • 中間チェーン統合オブジェクトによるサーブレット・コンテキストから変換接続へのアクセスを可能にする
  • アプリケーションをクライアント・コンテナーからチェックアウトして、初期要求の処理中にブラウザーからの後続の要求をブロックする。
つまり、ユーザーが変換接続が取得された後、それを解放する前に変換接続へのアクセスを試みた場合は、ブラウザーが「アプリケーションは使用中です。」というメッセージ・ページを表示します。このページは、考えられる原因がアプリケーションが準備完了になる前に Web ページを再ロードしていることを示しています。呼び出し元は、返されたラベルを使用して、統合オブジェクトの setHPubStartChainName() メソッドを呼び出します。統合オブジェクトは、このラベルを使用して実行対象の接続を見つけます。ヌルのラベルが返された場合は、接続は統合オブジェクトにアクセスできません。HostConnectionException がスローされた場合は、アプリケーション・インスタンスは存在しますが、変換接続が存在しません。ApplicationUnavailableException がスローされた場合は、アプリケーション・インスタンスが存在しないか、または存在する場合は現在チェックアウトされています。エラーが発生した場合に、統合オブジェクトが変換接続を破棄することを回避するために、doHPTransaction() を呼び出す前に setHPubSaveConnOnError(true) メソッドを呼び出して統合オブジェクトを実行します。