MuleSoft(ミュールソフト)でAPIを作成|Anypoint Studioで起動し実装するまで

MuleSoft
MuleSoft

この記事では、MuleSoft(ミュールソフト)でAPIを作成する方法を解説いたします。

手順は、Anypoint Studioを起動、Muleプロジェクト作成、API実行するまでの流れです。Muleで簡単なHTTPリクエストを受信したときに、レスポンスに「Hello Mule」を返却するAPIについても解説します。

※今回はローカル環境にてAPIを動かすため、Anypoint Platformを経由しません。またSalesforce環境にも接続しません。そのため、開発環境用のPCにAnypoint StudioとAPIを確認するためのAdvanced REST Clientを用意します。

Anypoint StudioでAPIを作成する方法、手順

Anypoint StudioでAPIを作成する方法、手順について画像を使って解説します。

<手順>

  • Anypoint Studioを起動する
  • Muleプロジェクトを作成する
  • APIを作成する

早速見ていきましょう。

Anypoint Studioを起動する

インストールしたAnypoint Studioを開くと、ワークスペースの選択ダイアログが出るため、任意の場所に指定します。

Anypoint StudioはEclipseベースの開発統合環境のため、Mule開発に必要なプラグインが既にインストール済みの状態です(その分、Anypoint Studio自体の動作は若干重めです)。プラグインを最新化するために、[Help]→[Check for Updates]からインストール可能なプラグインかないかを確認します。

更新可能なソフトウェアがあれば、最新化しておきましょう。

Muleプロジェクトを作成する

Anypoint Studioを最新化したところで、次はプロジェクトを作成します。Javaなどと同じように、Muleでも同様にプロジェクトを作っていきます。

Package Explorerにある[Create a Mule Project]または[File]→[New]→[Mule Project]からプロジェクトを作成します。

プロジェクト名は任意の名前でOKです。以外の入力やチェックはデフォルトのままでOKです。

プロジェクトは以下のような構成となっています。これから作成していくMuleのAPIは「src/main/mule」の中で作成していくことになります、プロジェクト作成の段階で、「プロジェクト名.xml」という名前のMuleのAPI(中身は空です)のプログラムが記載されたファイルが作成されています。これをMuleコンフィグレーションファイルと呼びます。

APIを作成する

今回はこのデフォルトで作成されているコンフィグレーションファイルにAPIのロジックを記載していきます。プログラムと言っても、ソースコードを打ち込むという感じではなく、GUIベースで必要なコンポーネントを追加しながらフローを組み立てていく形での実装となります。

それでは早速作っていきましょう!

まずは、HTTPのリクエストを受信するためのHTTP Listenerを配置します。右側にあるMule Paletteから[HTTP]→[Listener]をドラッグ&ドロップします。

以下のようにHTTP Listenerが作成されます。HTTP Listenerには必須の設定がありますので、下部にあるプロパティからいくつか設定を入れておきます。

今回はGETメソッドのAPIを作成したいと思います。

まずは、[General]の[Basic Setting]にある[Connector configuration]からHTTPのコネクタ設定を行います。右側の「+」アイコンからHTTP_Listener_configを作成します。今回はlocalhostで作っていくためデフォルトのままでOKです。

次にパスを設定します。[General]の[General]にある[Path]に「/hellomule」と入力します。

最後にメソッドの設定をします。GETメソッドで動作するようにしたいので、[Advanced]の[Allowed methods]に「GET」と入力します。

これでHTTP Listenerの設定は終了です。必須項目を入力したことで、Listenerに付いていたエラーのアイコンが消えているかと思います。

Listenerの次は「Hello Mule」を返すレスポンスを設定します。こちらはMule Paletteの[Core]→[Set Payload]をフローのProcess上にドラッグ&ドロップします。

Set Payloadのプロパティから[General]→[Value]の値に「Hello Mule」を入力します。

以上で簡単ではありますが、APIの作成が終了です。

作成したAPIを動かしてみる

それでは作成したAPIを動かしてみましょう。まずは作成したAPIをデプロイします。今回はローカル環境へデプロイすることになるので、フロー上を右クリックして、[Run project プロジェクト名]または[Run]→[Run]から実行します。デバッグを実施したい場合は、[Debug project プロジェクト名]でもOKです。

エラーがなければコンソール上に「DEPLOYED」というログが出力されます。これが出ればフローが有効化された状態となり、APIを実行することができます。

Advanced REST Clientから動作を確認します。URLを「http://localhost:8081/hellomule」と入力して送信して、レスポンスに「Hell Mule」と表示されれば成功です!

おわりに

簡単ではありますが、APIを作成して実際に動かすところまでの流れを紹介しました。あとは、Muleフローに組み込むコンポーネントの機能を理解しつつ、フローを組み立てればいろいろなことができるようになるのではないかと思います。

次回はSalesforce環境を使って実際に連携するAPIを作ってみたいと思います。

セールスフォースのご相談・お問い合わせ

タイトルとURLをコピーしました