13

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

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

谢谢

4

2 回答 2

44

以下是我希望对您的问题提供相对完整的解决方案。

你没有提到 Maven，所以我会：Maven 是你的朋友。

让我们从一个 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 类

一个是“应用程序”，另一个是其余调用。***

其余的调用非常简单：

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!”

稍微利用一下泽西岛。

getClasses()在 RestApp 中有点难看。您可以使用 Jersey 的 ResourceConfig，如Jersey User's Guide中所示，如下所示：

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

但我不想使用 Maven！

美好的。这些是 Eclipse 作为 Maven 依赖项列出的 jars：

  • 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-资源定位器-1.0.1.jar
  • jersey-server-2.13.jar
  • jersey-client-2.13.jar
  • 验证-api-1.1.0.Final.jar
  • javax.ws.rs-api-2.0.1.jar
  • jersey-container-servlet-2.13.jar

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

于 2014-12-02T23:46:20.693 回答
1

我能够使用 Jersey 2.6 用户指南中提供的用于部署到 3.x servlet 容器的说明来完成这项工作。我最终使用了类似于以下项目的东西。因为 URL 映射是在 .xml 中提供的，所以您可以从 Application 子类中省略 @ApplicationPath。

<web-app version="3.0"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

    <!-- Servlet declaration can be omitted in which case
         it would be automatically added by Jersey -->
    <servlet>
        <servlet-name>org.example.MyApplication</servlet-name>
    </servlet>

    <!-- Servlet mapping can be omitted in case the Application subclass
         is annotated with @ApplicationPath annotation; in such case
         the mapping would be automatically added by Jersey -->
    <servlet-mapping>
        <servlet-name>org.example.MyApplication</servlet-name>
        <url-pattern>/myresources/*</url-pattern>
    </servlet-mapping>
</web-app>
于 2014-02-28T17:26:42.660 回答