ステップ 4.検証とエラー処理の追加

Studio の ​hello-world-app​ プロジェクトで、​hello-world-api.xml​ がまだ開いていなければ開き、キャンバスの ​[Message Flow (メッセージフロー)]​ タブを表示します。

[Mule Palette (Mule パレット)]​ で、​[Add Modules (モジュールを追加)] > [Validation (検証)]​ を選択して ​[Mule Palette (Mule パレット)]​ にドラッグします。

操作のリストから、​Validate size​ を Studio キャンバスにドラッグして、エンドポイントモジュール内の ​Set Payload​ の右にドロップします。

Validate size​ をクリックして ​[General (一般)]​ 設定タブを表示します。

[General (一般)]​ タブで以下の値を設定します。

Studio のメインメニューから ​[File (ファイル)] > [Save All (すべて保存)]​ を選択して、変更内容を保存します。

キャンバス内を右クリックして、​[Run project hello-world-app (hello-world-app プロジェクトを実行)]​ を選択します。

hello-world-app​ がデプロイされたことを示すコンソールメッセージが表示されたら、Advanced Rest クライアントまたは同様のツールを使用して要求を送信します。

http://localhost:8081/api/greeting

キャンバスを右クリックして、​[Stop project hello-world-app (hello-world-app プロジェクトを停止)]​ を選択します。

Studio の ​hello-world-app​ プロジェクトで ​hello-world-api.xml​ を開きます。

Set Payload​ をクリックして、値を ​Hi.​ に設定します。

[Mule Palette (Mule パレット)]​ で ​[Favorites (お気に入り)] > [Logger]​ を選択し、Logger を ​Set Payload​ と ​Validate size​ の間にドラッグします。Logger はデバッグしやすいようにプロセスを停止します。Logger の設定は不要です。

Set Payload​ を右クリックして ​[Add Breakpoint (ブレークポイントを追加)]​. を選択します。

Logger​ と ​Validate size​ で上記の手順を繰り返します。

キャンバスを右クリックして、​[Debug project hello-world-app (hello-world-app プロジェクトをデバッグ)]​ を選択します。[Mule Debug (Mule デバッグ)] パースペクティブを開くように求められたら、​[Remember my decision (私の決定を記憶する)] チェックボックスをオンにして ​[Yes (はい)]​ をクリックします。

Advanced REST クライアントで ​/greeting​ エンドポイントに要求を送信します。

http://localhost:8081/api/greeting

Studio に戻り、​Set Payload​ が破線で囲まれていることを確認します。

キャンバスで ​Set Payload​ をクリックし、​[Mule Debugger (Mule デバッガー)]​ で ​Set Payload​ ノードを開きます。

Set Payload​ を開いて、ペイロード値が ​Hi.​ の 3 文字であることを確認します。

デバッガーウィンドウの上に表示されている ​[Next processor (次のプロセッサー)]​ (曲線の黄色い矢印) をクリックします。

曲線の黄色い矢印を再びクリックして、​Validate size​ 操作に移動します。

曲線の黄色い矢印を再びクリックすると、定義したエラーメッセージがデバッガーペインの ​error​ オブジェクトに表示され、破線が ​Validate size​ 操作内に表示されていることを確認できます。

[Next processor (次のプロセッサー)]​ を再びクリックして、キャンバスにメッセージフローの先頭が表示され、インポート時に追加されたスキャフォールディング項目の 1 つである APIkit ルーターが赤い破線で囲まれていることを確認します。このルーターがエラーを処理します。

[Next processor (次のプロセッサー)]​ を再びクリックしてフローを完了します。プロセスが完了したため、Mule デバッガーペインは空白になります。

Advanced Rest クライアントを確認します。​500 Server Error​ とペイロード値が表示されます。

キャンバスを右クリックして、​[Stop project hello-world-app (hello-world-app プロジェクトを停止)]​ を選択します。

[Window (ウィンドウ)] > [Perspective (パースペクティブ)] > [Open Perspective (パースペクティブを開く)] > [Mule Design (Mule デザイン)]​ を選択してデバッガービューを終了します。

Studio の ​[Mule Palette (Mule パレット)]​ で ​[Core] > [On Error Propagate]​ を選択し、このエラーハンドラーを ​get:\greeting:hello-world-app-config​ の ​Error handling​ までドラッグします。

[General (一般)]​ 設定タブで、エラーハンドラーを設定します。

Set Payload​ 操作を新しい ​On Error Propagate​ エラーハンドラーにドラッグします。

新しい Set Payload 操作を設定します。

[File (ファイル)] > [Save All (すべて保存)]​ をクリックして、変更内容を保存します。

Set Payload​、​Logger​、​Validate size​ のブレークポイントを削除してある場合は、これらにブレークポイントを追加します。

キャンバス内を右クリックして、​[Debug project hello-world-app (hello-world-app プロジェクトをデバッグ)]​ を選択します。

アプリケーションがデプロイされたら、Advanced Rest クライアントからクエリ ​http://localhost:8081/api/greeting​ を送信し、曲線の黄色い矢印を使用して各ブレークポイントをステップ実行します。

On Error Propagate​ の ​Set Payload​ に達すると、ペイロードが ​Validate size​ で作成したエラーメッセージに設定されているのを確認できます。

メッセージフローの ​APIkit Router​ に達すると、元のペイロード ​Hi.​ の代わりにエラーメッセージが表示されます。

ステップを最後まで実行して Advanced Rest クライアントの応答を確認すると、​500 Server Error​ がエラーメッセージと一緒に返されていることが分かります。

元のペイロードを ​Today the greeting is Hello.​ に戻します。

Studio のビューを ​[Window (ウィンドウ)] > [Perspective (パースペクティブ)] > [Open Perspective (パースペクティブを開く)] > [Mule Design (Mule デザイン)]​ に戻します。

Studio の ​Package Explorer​ で、​hello-world-app​ プロジェクトを右クリックします。

[Anypoint Platform] > [Publish to Exchange (Exchange にパブリッシュ)]​ を選択します。

以前と同じビジネスグループを選択します。有効なビジネスグループを選択するまで、​[Next (次へ)]​ ボタンはアクティブになりません。

バージョン番号は自動的に増分されますので、そのまま受け入れます。

[Project type (プロジェクトタイプ)]​ で ​[Example (サンプル)]​ を選択します。

[Next (次へ)]​ をクリックします。

[Finish (完了)]​ をクリックします。