java - 在 Tomcat 8 上实现 Jersey 2.x 的最佳方法是什么？

Question

我了解 Web 容器和 Tomcat，可以部署静态和动态网站。但我是 REST 和 Jersey 的新手。我已阅读 2.6 用户指南，查看了许多网站和 youtube 视频。似乎有很多关于 1.x Jersey 的信息，但关于 2.x 的信息不多，我可以在我的环境中使用 1.18，但似乎无法获得适用于 2.x 的任何部署模型。我注意到在 2.x 中有一个应用程序部署模型。所以我想我会问一些非常通用的问题来开始。

1. 哪种部署模型最适合通过 Tomcat 8 的基本 REST 服务？为什么？
2. 我看到使用 2.6 部署的 .jars 与使用 1.18 部署的有很大不同。有没有一种简单的方法可以判断基本 Tomcat 安装需要哪些 jar？
3. 如果您有一个基本示例，那就太好了。

谢谢

Answer 1

以下是我希望能比较完整的解决你的问题。

你没有提到 Maven，所以我会:Maven 是你的 friend 。

让我们从一个 pom 开始:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example.groupid</groupId>
  <artifactId>stack</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>org.glassfish.jersey.containers</groupId>
      <artifactId>jersey-container-servlet-core</artifactId>
      <version>2.13</version>
    </dependency>
    <dependency>
      <groupId>org.glassfish.jersey.containers</groupId>
      <artifactId>jersey-container-servlet</artifactId>
      <version>2.13</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>stack</finalName>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.5</version>
      </plugin>

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.2</version>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
  </build>
  <name>Stack</name>
</project>

就依赖性而言，这可能不是绝对最小值，但很接近。

但这只是 pom. web.xml 和 Java 类中的诡计仍在继续。

关于那个 web.xml...

这太复杂了，所以请耐心等待:

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         metadata-complete="false"
         version="3.1">
</web-app>

好吧，也许没那么复杂。

请注意，设置 metadata-complete="true" 可能会导致 Tomcat 启动得更快。

一对 Java 类

一个是“应用”，一个是rest调用***

其余调用非常简单:

package some.package;

import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/hello")
public class HelloRest {

  @GET
  public String message() {
    return "Hello, rest!";
  }
}

应用程序如下所示:

package some.package;

import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

import some.package.HelloRest;

@ApplicationPath("/rest")
public class RestApp extends Application {
  public Set<Class<?>> getClasses() {
    return new HashSet<Class<?>>(Arrays.asList(HelloRest.class));
  }
}

就是这样。当您导航到类似 http://localhost:8080/stack/rest/hello 的地方时，您应该会看到文本“Hello, rest!”

稍微利用 Jersey。

RestApp 中的

getClasses() 有点难看。您可以使用 Jersey 的 ResourceConfig，如 Jersey User's Guide ，看起来像这样:

public class RestApp extends ResourceConfig {
    public RestApp() {
        packages("some.package");
    }
}

但我不想使用 Maven!

很好。这些是 Eclipse 列为 Maven 依赖项的 jar:

• javax.servlet-api-3.1.0.jar
• jersey-container-servlet-core-2.13.jar
• javax.inject-2.3.0-b10.jar
• jersey-common-2.13.jar
• javax.annotation-api-1.2.jar
• jersey-guava-2.13.jar
• hk2-api-2.3.0-b10.jar
• hk2-utils-2.3.0-b10.jar
• aopalliance-repackaged-2.3.0-b10.jar
• hk2-locator-2.3.0-b10.jar
• javassist-3.18.1-GA.jar
• osgi-resource-locator-1.0.1.jar
• jersey-server-2.13.jar
• jersey-client-2.13.jar
• validation-api-1.1.0.Final.jar
• javax.ws.rs-api-2.0.1.jar
• jersey-container-servlet-2.13.jar

据推测，将这些手动添加到您的类路径应该可行。或者使用 Maven。