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

13

我了解Web容器和Tomcat,并可以部署静态和动态网站。但是我对REST和Jersey还不熟悉。我已阅读了2.6用户指南,查看了许多网站和YouTube视频。1.x Jersey似乎有很多信息,但2.x的信息很少。我可以在我的环境中使用1.18,但好像无法为2.x获取任何部署模型。我注意到在2.x中有一个应用程序部署模型。所以我想问一些非常通用的问题来开始这个过程。

  1. 对于通过Tomcat 8提供基本REST服务,哪种部署模型最好?为什么?
  2. 我发现与1.18部署的.jars相比,使用2.6部署的.jars有很大的区别。有没有简单的方法告诉你需要哪些.jars才能进行基本的Tomcat安装?
  3. 如果您有一个基本示例,那就太好了。

谢谢


我刚开始学习Jersey,之前几年一直在使用RestEasy。你为什么要“强制”使用Tomcat呢?问这个问题是因为我按照Jersey用户指南上的步骤进行了操作,使用Maven进行构建并使用Grizzly作为Web服务器,然后一切都顺利运行了。我相信最初的示例使用的是Jersey 2.6版本。 - mikemil
当你说“强制Tomcat”时,你是指Jersey在Grizzly上进行了测试,我应该使用Grizzly而不是Tomcat吗?顺便说一句,我按照用户指南中的说明在Tomcat上使其工作。我的测试中出现了用户错误,导致看起来它没有工作,实际上只是我尝试访问错误的路径。 - rss181919
并不是贬义的语气,只是最近我也在经历同样的过程,使用他们用户指南中的“默认值”非常容易。很高兴听到你已经让它运行起来了!顺便说一句,请确保接受您自己问题的答案 - 这样您就可以获得一些声望点数! :-) - mikemil
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类

其中一个是"应用程序",另一个是REST调用。

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用户指南中所示:

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。


4
哇!这是一个极好的答案!我想我从未见过更完整的答案了... - markvgti
我希望能够不使用XML,而是像HttpServer一样使用main()方法来完成相同的事情。 - Sridhar Sarnobat
  1. 如果想使用不同版本的Jersey(而不是Tomcat服务器中已经存在的版本),需要做什么?
  2. 可以部署包含Servlet jar的war文件吗?
  3. 在现有的Tomcat服务器中使用不同版本的Jersey是否可行?
- Rohit Kumar

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>

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接