Mule アプリケーション開発チュートリアル

Exchange で [Training: American Flights API (トレーニング: American Flights API)]​ に移動し、[GET (取得)] ボタンをクリックして JSON でサンプル応答を表示します。

Anypoint Studio​ をダウンロードしてインストールします。

Anypoint Platform トライアルアカウントがない場合は作成します。

Postman や Advanced REST クライアントなどの REST API クライアントを選択します。このチュートリアルでは、Advanced REST クライアントを使用します。

Anypoint Studio を開き、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

[Project Name (プロジェクト名)]​ を ​dw-tutorial4-flights-ws​ に設定します。

その他はすべてデフォルトのままにして、​[Finish (完了)]​ を選択してプロジェクトを作成します。

American Flights API をリスンするために HTTP Listener 操作を追加します。[Mule Palette (Mule パレット)] で、HTTP 操作を表示するために [HTTP] を選択し、Listener 操作をキャンバスまでドラッグします。

Listener 操作をダブルクリックしてそのプロパティタブを表示し、緑色のプラス記号をクリックして新しい設定を追加します。

HTTP Listener 設定ダイアログで、以下の値を追加します。

[OK]​ をクリックしてこれらの変更を保存し、ダイアログを閉じます。

Listener の [General (全般)] タブで、​[Path: (パス:)]​ 項目を ​/flights​ に変更します。変更は自動的に保存されます。

[Mule Palette (Mule パレット)] で、​[Add Modules (モジュールを追加)]​ を選択してモジュールおよびコネクタのリストを表示し、Database Connector を [Mule Palette (Mule パレット)] の左側までドラッグします。バージョンの選択を要求される場合があります。最新バージョンを選択します。

Database Connector が [Mule Palette (Mule パレット)] に追加され、その操作を表示できるようになります。Select 操作をフローまでドラッグします。

MuleSoft サンプル MySQL データベースからの応答をリスンするように Database 操作を設定しましょう。Select オペレータをクリックしてそのプロパティタブを表示し、追加ボタン (緑色の十字) をクリックして [Database Config (データベース設定)] ダイアログを開きます。

ダイアログで Mule のサンプルデータベース値を選択または入力します。

[Database Config (データベース設定)] ダイアログを表示したまま、​[Configure (設定)] > [Add Maven dependency (Maven 連動関係を追加)]​ を選択します。

[Pick a Maven dependency (Maven 連動関係を選択)]​ ダイアログで、​[Search Maven Central (Maven Central を検索)]​ 検索項目に ​mysql-​ と入力します。

表示された項目から ​mysql:mysql-connector-java​ を選択します。

[Finish (完了)]​ を選択して [Database Config (データベース設定)] ダイアログに戻ります。

[Test Connection (接続をテスト)]​ を選択します。​Test connection successful​ メッセージが表示されます。このメッセージが表示されない場合、前のステップに戻り、エラーを探してください。

[OK]​ を選択して [Database Config (データベース設定)] ダイアログに戻ります。

Training: American Flights API からのすべてのフライトを返すクエリを作成します。

さらに設定をテストするには、プロジェクトを実行します。フローが定義されているキャンバスを右クリックして、​[Run Project dw-tutorial4-flights-ws (プロジェクト dw-tutorial4-flights-ws を実行)]​ を選択できます。

[Console (コンソール)] タブを確認し、アプリケーションが実行されたら REST API クライアントを開きます。

クライアントで、要求を ​http://localhost:8081/flights/​ に送信します。この時点で、アプリケーションは American Flights API に対するクエリから受け取ったデータを処理できないため、​500 Server Error​ メッセージを返します。このエラーに対処するため、トレーニングの次のセクションでフローに Transform コンポーネントを追加します。

[Mule Palette (Mule パレット)] で [Core (コア)] を選択し、[Transform Message] コンポーネントを見つけます。

[Transform Message] をキャンバスの Select 操作の右側までドラッグアンドドロップします。

[Transform Message] コンポーネントをクリックしてグラフィカルビューとソースコードビューを表示します。

コードビューで、行 2 の出力タイプを ​application/java​ から ​application/json​ に変更し、行 4 および 5 の括弧を ​payload​ に置き換えます。

変更内容を保存して、プロジェクトを再デプロイします。

REST クライアントで GET 要求を送信し、この変更内容をテストします: GET http://localhost:8081/flights​。

[Transform Message] の [Output (出力)] パネルで、​[Define metadata (メタデータを定義)]​ を選択して ​[Select metadata type (メタデータ型を選択)]​ ダイアログを開きます。

[Add (追加)]​ を選択して ​[Create new type (新しい型を作成)]​ ダイアログを開きます。

american_flights_json​ を入力して ​[Create type (型を作成)]​ を選択します。

[Select metadata type (メタデータ型を選択)]​ ダイアログで、型を ​[JSON]​ に設定します。

[Type (型)] の下のドロップダウンで、​[Schema (スキーマ)]​ を ​[Example (例)]​ に変更します。

次の内容をコピーしてファイルに貼り付け、ローカルマシンまたは環境で保存します。ファイルに ​american-flights-example.json​ という名前を付けます。

[{
	"ID": 1,
	"code": "ER38sd",
	"price": 400.00,
	"departureDate": "2016/03/20",
	"origin": "MUA",
	"destination": "SFO",
	"emptySeats": 0,
	"plane": {
		"type": "Boeing 737",
		"totalSeats": 150
	}
}, {
	"ID": 2,
	"code": "ER45if",
	"price": 345.99,
	"departureDate": "2016/02/11",
	"origin": "MUA",
	"destination": "LAX",
	"emptySeats": 52,
	"plane": {
		"type": "Boeing 777",
		"totalSeats": 300
	}
}]

[Select metadata type (メタデータ型)]​ ダイアログで、3 つのドットのボタンをクリックして作成したばかりのファイルに移動し、選択します。

[Select (選択)]​ を選択して変更内容を保存します。入力および出力のデータ構造が DataWeave インターフェースに表示されます。

項目のマッピングを開始して変換を作成しましょう。

サンプルデータを追加して、マッピング結果をプレビューしましょう。(不要であればこのステップはスキップできます)。コードビューで ​[Preview (プレビュー)]​ を選択し、​[Create required sample data to execute preview (プレビューを実行するために必要なサンプルデータを作成)]​ リンクをクリックします。

入力パネルの ​[payload (ペイロード)]​ タブで、すべてのクエスチョンマークをデータに置き換えます。これらの値は [Output (出力)] パネルにも表示されます。Studio のメインメニューから ​[File (ファイル)] > [Save All (すべて保存)]​ を選択します。

変換の定義が完了したら、テストしましょう。前にお勧めしたとおりに Mule アプリケーションを実行したままにしているとして、REST クライアントを開いて別の要求を API に送信します: GET http://localhost:8081/flights​。