2.4. 构建并运行 REST API booster

REST API 级别 0 任务演示了如何使用 REST 框架通过 HTTP 将业务运营映射到通过 HTTP 的远程过程调用端点。这个任务与用于 Matson Maturity Model 中的 Level 0 对应。

REST API 提升器引入了与使用 HTTP 协议的远程(由 Apache Camel 公开)服务交互的机制。通过使用此 Fuse 提升,您可以快速构建并灵活地设计 REST API。

使用这个 booster 来:

  • camel/greetings/{name} 端点上执行 HTTP GET 请求。此请求以 JSON 格式生成响应,有效负载为 Hello, $name! (其中 $name 替换为 HTTP GET 请求中的 URL 参数的值)。
  • 更改 URL {name} 参数的值,以查看响应中已更改的值。
  • 查看 REST API 的 Swagger 页面。

先决条件

流程

按照以下步骤,在本地机器上构建并运行 REST API booster 作为独立项目:

  1. 下载项目并在本地文件系统中提取存档。
  2. 构建项目:

    cd PROJECT_DIR
    mvn clean package
  3. 运行该服务:

    mvn spring-boot:run
  4. 打开 Web 浏览器 :http://localhost:8080
  5. 要执行 HTTP GET 请求示例,请单击 camel/greetings/{name} 按钮。

    此时会打开一个新的 Web 浏览器窗口,其中包含 localhost:8080/camel/greetings/Jacopo URL。URL {name} 参数的默认值为 Jacopo

    JSON 响应会出现在浏览器窗口中:

    REST API booster 的 JSON 响应
  6. 要更改 {name} 参数的值,请更改 URL。例如,要将名称更改为,可使用此 URL: localhost:8080/camel/greetings/ Thomas

    更新的 JSON 响应会出现在浏览器窗口中:

    更新了 REST API booster 的 JSON 响应
  7. 要查看 REST API 的 Swagger 页面,请点 API Swagger 页面按钮。

    API swagger 页面在浏览器窗口中打开。

    REST API Swagger 页面