Muleアプリケーションのためのテストフレームワーク、MUnitを少し使ってみようと思います。
簡単なテストの作成
まずは、テストする簡単なフローを作成します。
HTTP Listnerでリクエストを受け付けて、Payloadに「Hello World」をセットして応答するだけの簡単なアプリケーションとします。
続いてこのフローのテストを作成します。
Anypoint Studioのプロジェクトを右クリック > Mew > MUnit Testを指定します。
「MUnit test suite」ダイアログボックスが表示されるので、先ほど作成したサンプルフローにチェックを入れて「Finish」ボタンを押下します。「Execution」でテスト対象のフローを呼び出すMUnitテストが作成されますので、結果の検証を行うため「Validation」に「Assert that」を追加します。
「Assert that」のプロパティに以下を指定します。
- General> Expressionとして、#[payload]を指定
- Isで#[MunitTools::matches('Hello World')]
※ MunitToolsの使い方については以下あたりを参照してください。
https://docs.mulesoft.com/munit/2.1/munit-matchers
これで準備完了です。テストを右クリックして「Run MUnit test」を選択してください。
テストが実施され成功します。
試しに比較する文字を「Stop World」に変更して実施してみてください。ちゃんとテストが失敗します。
Mockを使用する
つづいて、モック機能を使用してみようと思います。
サンプルフローにHTTPリクエストするコネクターを追加します。
接続先は架空のものにします。
ここで一度テストを実施してみましょう。「Connection refused」のエラーが発生してテストは失敗します。
そこで、HTTPリクエストの結果をMock化して、何かしらの正常な値が返却するようにします。
Behaviorに「Mock when」を配置し、以下を設定します。
- General > Processorに「http:request」
- Then returnを「Edit inline」
- Payloadにチェック
- Payload > Valueに#['Stop World']
ついでにAsert Thatの比較文字も「'Stop World'」に変更します。
テストを実施してください。テストが成功します。（Mockが設定されたため、HTTPのRequestコネクターで接続エラーとならず、結果として'Stop World'を返却されていたためです。）
Spyを使用する
次にSpyを使用してみます。Spyはテスト対象のフロー内のあるイベントが呼ばれた前後の動作の検証が行える機能です。
まずは、サンプルフローを以下のように変更します。
- sub_flowを追加して、Set PayloadでPayloadを「Start World」に変更するようにします。
- メインフローからサブフローを呼び出すFlow Referenceを追加します。（Display Nameを「call sub_flow」としてください。）
次に、追加したこのFlow Referenceの前後のpayloadの値を検証するSpyをテストに追加します。
Spyの設定は以下のようになります。
Processorには「mule:flow-ref」と、「mule:」を指定します。
また、flow-refを特定する必要がある（テスト対象にはflow-refは一つしか配置されていないのですが、テスト時の呼び出しと区別する必要がある（？）ようです）ため、With attributesのEdit inlineで以下を指定します。
doc:name ＝ call sub_flow
最後にSpyのBefore、AfterにAssert thatを追加し、それぞれPayloadが「Stop World」、「Start World」になるかを確認するように指定してください。
テストを実施して、テストが通ることを確認してください。
また、念のためMockや、sub_flowの処理を変更して、Spyのテストが正しく動作しているかを確認してみてください。
カバレッジの確認
最後にカバレッジレポートを作成します。
Munit CoverageというViewがありますので、そのViewの「Generate Report」ボタンを押してみてください。以下のようなHTML形式のレポートが生成されます。
あまり、いいサンプルではないですが。。
まとめ
以上で、MuleSoft Anypoint Platformのテストツール、MUnitの基本的な操作方法を簡単に説明してみました。
Flowと同様、慣れてしまえば割と簡単に自動テストが作れそうな感じがしますが、いかがでしょうか。