第 4 章 定义 REST 服务

REST DSL （位于 camel-core）是为定义 REST 服务提供简化的构建器 API 的教授或封装层。REST DSL 本身不 提供 REST 实施：它必须与底层 REST 实施相结合。例如，以下 Java 代码演示了如何使用 REST DSL 定义一个简单的 Hello World 服务：

rest("/say")
    .get("/hello/{name}").route().transform().simple("Hello ${header.name}");

如需了解更多详细信息，请参阅 第 4.2 节 “使用 REST DSL 定义服务”。

Rest 组件（在 camel-core）是一个打包程序层，它可让您使用 URI 语法定义 REST 服务。与 REST DSL 一样，Rest 组件本身 不提供 REST 实施。它必须与底层 REST 实施结合使用。

如果您没有显式配置 HTTP 传输组件，则 REST DSL 会自动通过检查 classpath 上的可用组件来发现要使用的 HTTP 组件。REST DSL 查找任何 HTTP 组件的默认名称，并使用它找到的第一个名称。如果 classpath 中没有 HTTP 组件，而您没有显式配置 HTTP 传输，则默认的 HTTP 组件是 camel-http。

以下 Java 代码演示了如何使用 camel-rest 组件定义一个简单的 Hello World 服务：

from("rest:get:say:/hello/{name}").transform().simple("Hello ${header.name}");

Spark-Rest 组件(in camel-spark-rest)是一种 REST 实施，可让您使用 URI 语法定义 REST 服务。Spark 框架本身是一个 Java API，它基于 Sinatra 框架（一个 Python API）。例如，以下 Java 代码演示了如何使用 Spark-Rest 组件定义一个简单的 Hello World 服务：

from("spark-rest:get:/say/hello/:name").transform().simple("Hello ${header.name}");

请注意，与 Rest 组件不同，URI 中的变量语法为 :name，而不是 {name}。

Restlet 组件(in camel-restlet)是 REST 实施，它可以原则上分层于不同的传输协议（尽管此组件仅针对 HTTP 协议进行测试）。此组件还提供了与 Restlet Framework 集成，这是用于在 Java 中开发 REST 服务的商业框架。例如，以下 Java 代码演示了如何使用 Restlet 组件定义一个简单的 Hello World 服务：

from("restlet:http://0.0.0.0:9091/say/hello/{name}?restletMethod=get")
    .transform().simple("Hello ${header.name}");

如需了解更多详细信息，请参阅 Apache Camel 组件参考指南 中的 Restlet。

Servlet 组件( camel-servlet)是一个将 Java servlet 绑定到 Camel 路由的组件。换句话说，Servlet 组件可让您打包和部署 Camel 路由，就像它是标准的 Java servlet 一样。因此，如果需要在 servlet 容器（例如，在 Apache Tomcat HTTP 服务器或 JBoss 企业应用平台容器中）部署 Camel 路由，则 Servlet 组件特别有用。

但是，本身的 Servlet 组件不提供任何方便的 REST API 来定义 REST 服务。因此，使用 Servlet 组件的最简单方法是将其与 REST DSL 合并，以便您可以使用用户友好的 API 定义 REST 服务。

如需了解更多详细信息，请参阅 Apache Camel 组件参考指南 中的 Servlet。