7.6.2. HTTPメッセージング¶

7.6.2.1.1. MOMメッセージング と同じ作り方ができる¶

HTTPメッセージングでは、メッセージの送受信の実装を MOMメッセージング と同じ以下のAPIで行う。 そのため、 MOMメッセージング の経験があれば、少ない学習時間で実装することができる。

• MessagingAction
• MessageSender

7.6.2.3.1. HTTPメッセージングを使うための設定を行う¶

メッセージ受信の場合は、実行制御基盤のハンドラ構成以外に特に設定は不要である。

メッセージ送信の場合は、以下のクラスをコンポーネント定義に追加する。

• MessageSenderClient の実装クラス (HTTPの送受信)

以下に設定例を示す。

ポイント

• MessageSenderClient のデフォルト実装として HttpMessagingClient を提供している。
• ルックアップして使用されるため、コンポーネント名は messageSenderClient と指定する。

<component name="messageSenderClient"
           class="nablarch.fw.messaging.realtime.http.client.HttpMessagingClient" />

7.6.2.3.2. メッセージを受信する(HTTPメッセージ受信)¶

外部システムからメッセージを受信し、その応答を送信する。

実装例

ポイント

• HTTPメッセージ受信は、 MessagingAction で作成する。
• 応答電文は、 RequestMessage.reply で作成する。

public class SampleAction extends MessagingAction {
    protected ResponseMessage onReceive(RequestMessage request,
                                        ExecutionContext context) {
        // 受信データ処理
        Map<String, Object> reqData = request.getParamMap();

        // (省略)

        // 応答データ返却
        return request.reply()
                .setStatusCodeHeader("200")
                .addRecord(new HashMap() {{     // メッセージボディの内容
                     put("FIcode",     "9999");
                     put("FIname",     "ﾅﾌﾞﾗｰｸｷﾞﾝｺｳ");
                     put("officeCode", "111");
                     /*
                      * (後略)
                      */
                  }});
    }
}

7.6.2.3.3. メッセージを送信する(HTTPメッセージ送信)¶

外部システムに対してメッセージを送信し、その応答を受信する。 応答メッセージを受信するか、待機タイムアウト時間が経過するまで待機する。

規定時間内に応答を受信できずにタイムアウトした場合は、何らかの補償処理を行う必要がある。

実装例

ポイント

• 要求電文は、 SyncMessage で作成する。
• メッセージ送信には、 MessageSender#sendSync を使用する。 使い方の詳細は、リンク先のJavadocを参照。

// 要求電文の作成
SyncMessage requestMessage = new SyncMessage("RM11AC0202")        // メッセージIDを設定
                               .addDataRecord(new HashMap() {{    // メッセージボディの内容
                                    put("FIcode",     "9999");
                                    put("FIname",     "ﾅﾌﾞﾗｰｸｷﾞﾝｺｳ");
                                    put("officeCode", "111");
                                    /*
                                     * (後略)
                                     */
                                }})
// 要求電文の送信
SyncMessage responseMessage = MessageSender.sendSync(requestMessage);

また、HTTPヘッダーとして独自の項目を送信したい場合は、下記のように作成したメッセージのヘッダレコードに設定する。

// メッセージヘッダの内容
requestMessage.getHeaderRecord().put("Accept-Charset", "UTF-8");

7.6.2.4.1. フレームワーク制御ヘッダの読み書きを変更する¶

外部システムで既に電文フォーマットが規定されている場合など、 フレームワーク制御ヘッダの読み書きを変更したい場合がある。 この場合は、プロジェクトで実装を追加することで対応する。 以下に、送受信の種類ごとに対応方法を示す。

HTTPメッセージ送信の場合

フレームワーク制御ヘッダの読み書きは、メッセージボディのフォーマット定義により行う。 そのため、変更内容に合わせてメッセージボディのフォーマット定義を変更すればよい。

HTTPメッセージ受信の場合

フレームワーク制御ヘッダの読み書きは、 FwHeaderDefinition インタフェースを実装したクラスが行う。 デフォルトでは、 StandardFwHeaderDefinition が使用される。

そのため、 StandardFwHeaderDefinition を参考に、 プロジェクトで FwHeaderDefinition インタフェースを実装したクラスを作成し、 HTTPメッセージングリクエスト変換ハンドラ と HTTPメッセージングレスポンス変換ハンドラ に設定すればよい。

7.6.2.4.2. HTTPメッセージ送信のHTTPクライアント処理を変更する¶

HTTPメッセージ送信では、 HTTPメッセージングを使うための設定を行う で説明した通り、 HttpMessagingClient を使用している。

HttpMessagingClient では、HTTPクライアントとして様々な処理を行っている。 例えば、送信するメッセージのHTTPヘッダに、 Accept: text/json,text/xml が固定で設定される。

もし、HttpMessagingClient のデフォルト動作がプロジェクトの要件に合わない場合は、 HttpMessagingClient を継承したクラスを作成し、 HTTPメッセージングを使うための設定を行う に示した方法でコンポーネント定義に追加することでカスタマイズを行うこと。