第 4 章 定义 REST 服务

REST DSL （在 camel-core中）是一个 facade 或 wrapper 层，它为定义 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 组件( 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 组件（在 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 容器中部署 Camel 路由（例如，在 Apache Tomcat HTTP 服务器或 JBoss Enterprise Application Platform 容器中）部署 Camel 路由，则 Servlet 组件特别有用。

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

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