2.4. REST API ブースターのビルドおよび実行
REST API Level 0 のミッションでは、REST フレームワークを使用して、HTTP 経由でリモートプロシージャー呼び出しエンドポイントにビジネスオペレーションをマッピングする方法を示します。このミッションは、Richardson Maturity Model の Level 0 に該当します。
REST API ブースターは、HTTP プロトコルを使用して、Apache Camel によって公開されるリモートサービスと対話する仕組みを紹介します。この Fuse ブースターを使用すると、迅速に REST API のプロトタイプを作成し、柔軟に REST API を設定することができます。
このブースターを使用して、以下を行います。
-
camel/greetings/{name}エンドポイントで HTTP GET 要求を実行します。このリクエストは、ペイロードHello, $name!を使用して JSON 形式の応答を生成します ($nameは HTTP GET リクエストからの URL パラメーターの値に置き換えられます)。 -
URL
{name}パラメーターの値を変更すると、変更後の値が応答に反映されます。 - REST API の Swagger ページを表示します。
前提条件
- 「ブースタープロジェクトの生成」 に記載されている手順を完了している必要があります。
手順
以下の手順に従って、REST API ブースターをローカルマシンのスタンドアロンプロジェクトとしてビルドおよび実行します。
- プロジェクトをダウンロードし、ローカルファイルシステムでアーカイブを展開します。
プロジェクトをビルドします。
cd PROJECT_DIR mvn clean package
サービスを実行します。
mvn spring-boot:run
- Web ブラウザーで http://localhost:8080 を開きます。
HTTP GET リクエストの例を実行するには、camel/greetings/{name} ボタンをクリックします。
localhost:8080/camel/greetings/JacopoURL で新しい Web ブラウザーウインドウが開きます。URL{name}パラメーターのデフォルト値は Jacopo です。ブラウザーウインドウに JSON 応答が表示されます。
{name}パラメーターの値を変更するには、URL を変更します。たとえば、名前を Thomas に変更するには、URLlocalhost:8080/camel/greetings/Thomasを使用します。ブラウザーウインドウに更新された JSON 応答が表示されます。
REST API の Swagger ページを表示するには、API Swagger ページボタンをクリックします。
ブラウザーウィンドウに API swagger ページが表示されます。
