Servlet 3.0 和 JAX-RS

Question

我发现此问题的答案相互矛盾，但未能成功运行示例。

可以只使用带有注释的 Servlet 3.0（特别是 Tomcat 7）来实现 JAX-RS，而不必实现另一个 Servlet 容器吗？

如果不是，请解释为什么本书中的以下引用不正确或我在解释它是错误的。

因为此示例部署在 Java EE 应用服务器或 独立的 Servlet 3.x 容器，我们只需要一个空的 web.xml 文件。服务器将检测到 Application 类在您的 WAR 并自动部署它。 （带有 JAX-RS 2.0 的 RESTful Java，Bill Burke）

为了澄清我不需要需要帮助...我已经成功地使用 web.xml 在带有 Jersey 的 Tomcat 7 中实现了 JAX-RS，所以，我不需要任何解释如何这样做。此外，我完全了解其他 Java EE/Servlet 容器（TomEE、Glassfish、Jersey、Websphere 等）都是开箱即用的 JAX-RS。我只需要知道我是否在试图让 Tomcat 7 (Servlet 3.0) 在不添加 Servlet 容器和 web.xml 条目的情况下与 JAX-RS 一起工作。

Answer 1

在 Servlet 环境中，Jersey 作为 servlet 或 servlet 过滤器运行。没办法。那么不在 web.xml 中声明它是如何工作的呢？此功能的两个主要组件

• Servlet 组件（即 Servlet 和过滤器）的编程注册。你可以用谷歌搜索，你应该会找到一些例子。

• Servlet 3.x 中引入的 Servlet 可插入性。它的工作原理是实现一个ServletContainerInitializer，将该实现列在一个名为javax.servlet.ServletContainerInitializer 的文件中，然后将该文件放在jar 的META-INF/services 目录中。 servlet 容器应该扫描 jar 以查找此文件。当它找到时，它会看到实现，找到实现，实例化它，然后调用它onStartup 方法。

  Jersey 在JerseyServletContainerInitializer 中有这样一个SevletContainerInitializer 的实现。这个类位于jersey-container-servlet jar 中。所以你需要这个罐子才能工作。如果您查看this method，您将在此处看到ServletContainer 的编程注册（与您在web.xml 中声明的相同

但这还不是全部。我们仍然需要某种方式来配置我们的应用程序，至少声明 servlet 映射。这就是Application 类和@ApplicationPath 注释出现的地方。我们将扩展Application 类并注释@ApplicationPath("/path")，其中"path" 与web.xml 中的servlet 映射相同

@ApplicationPath("/api")
public class MyApplication extends Application {}

这是标准的 JAX-RS。通常使用 Jersey 而不是 Application 类，我们使用 ResourceConfig 类（它是 Application 的子类）

@ApplicationPath("/api")
public class MyApplication extends ResourceConfig {
    public MyApplication() {
        packages("package.to.scan");
    }
}

您可以在 Servlet 3.x 环境中查看有关 Jersey 部署选项的更多信息，here。

还应注意，Java EE 服务器具有 JAX-RS 实现，因此我们只需将 javaee-api jar 作为提供的依赖项添加到我们的应用程序中。但是在 servlet 容器中，我们需要提供自己的实现，Jersey 就是这样的实现。

如果你使用 Maven，你需要的主要依赖就是这个

<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet</artifactId>
    <version>${jersey2.version}</version>
</dependency>

这会拉入一堆其他的 jars。如果你没有使用 Maven，那么你可以下载所有的 jars here (the JAX-RS 2.0 RI bundle)，然后将它们全部放入你的应用程序中。

另请参阅：

• How to use Jersey as JAX-RS implementation without web.xml?