Каков наилучший подход для реализации Jersey 2.x на Tomcat 8?

У меня есть знания о веб-контейнере и Tomcat, и я могу развертывать статические и динамические веб-сайты. Но я новичок в REST и Джерси. Я прочитал руководство пользователя 2.6, просмотрел множество сайтов и видео на YouTube. Кажется, есть много информации о 1.x Jersey, но мало о 2.x. Я могу заставить 1.18 работать в моей среде, но не могу заставить какие-либо модели развертывания работать для 2.x. Я заметил, что в 2.x есть модель развертывания приложений. Поэтому я подумал, что задам несколько очень общих вопросов, чтобы начать.

  1. Какая модель развертывания лучше всего подходит для базовых служб REST с помощью Tomcat 8 и почему?
  2. Я вижу, что файлы .jars, развернутые в версии 2.6, сильно отличаются от файлов, развернутых в версии 1.18. Есть ли простой способ узнать, какие банки вам нужны для базовой установки Tomcat?
  3. Если у вас есть базовый пример, это было бы здорово.

Спасибо


person rss181919    schedule 27.02.2014    source источник
comment
Я только начал присматриваться к Джерси после того, как провел последние пару лет, работая с RestEasy. Есть ли причина, по которой вы «заставляете» Tomcat входить в ситуацию? Причина, по которой я спрашиваю, заключается в том, что я начал с Руководства пользователя Джерси и следовал их шагам, в которых используется Maven для сборки и Grizzly для веб-сервера, и все заработало. Я считаю, что первоначальный образец использует Джерси 2.6.   -  person mikemil    schedule 28.02.2014
comment
Когда вы говорите форсировать Tomcat, вы имеете в виду тот факт, что Джерси был протестирован на Гризли, и я должен использовать это вместо этого? Кстати, я заставил его работать в Tomcat в соответствии с указаниями в руководстве пользователя. У меня была ошибка пользователя в моем тестировании, из-за которой казалось, что он не работает, когда я просто пытался получить доступ к неправильному пути.   -  person rss181919    schedule 28.02.2014
comment
Не имел в виду это в негативном тоне, просто я недавно прохожу один и тот же процесс, и было очень легко использовать их «по умолчанию» из руководства пользователя. Рад слышать, что у вас все заработало! КСТАТИ. обязательно примите ответ на свой вопрос — за это вы получите очки репутации! :-)   -  person mikemil    schedule 28.02.2014


Ответы (2)


Далее следует то, что, я надеюсь, является относительно полным ответом на ваши вопросы.

Вы не упомянули Мейвена, поэтому я упомяну: Мейвен здесь ваш друг.

Начнем с помпона:

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

Это может быть не абсолютный минимум с точки зрения зависимостей, но он близок к этому.

Но это только помпон. Хитрость продолжается в 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-appmetadata-complete="true"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, вы должны увидеть текст «Привет, отдых!»

Немного используйте Джерси.

getClasses() в RestApp немного уродлив. Вы можете использовать ResourceConfig Джерси, как в Руководстве пользователя Джерси, которое будет выглядеть так: :

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

Но я не хочу использовать Maven!

Отлично. Это банки, которые Eclipse перечисляет как зависимости Maven:

  • javax.servlet-api-3.1.0.jar
  • Джерси-контейнер-сервлет-ядро-2.13.jar
  • javax.inject-2.3.0-b10.jar
  • Джерси-общий-2.13.jar
  • javax.annotation-api-1.2.jar
  • джерси-гуава-2.13.jar
  • hk2-api-2.3.0-b10.jar
  • hk2-utils-2.3.0-b10.jar
  • aopalliance-переупакованный-2.3.0-b10.jar
  • hk2-локатор-2.3.0-b10.jar
  • javassist-3.18.1-GA.jar
  • OSGI-ресурс-локатор-1.0.1.jar
  • Джерси-сервер-2.13.jar
  • Джерси-клиент-2.13.jar
  • проверка API-1.1.0.Final.jar
  • javax.ws.rs-api-2.0.1.jar
  • Джерси-контейнер-сервлет-2.13.jar

Предположительно, добавление их вручную в ваш путь к классам должно работать. Или используйте Мавен.

person 6cef    schedule 02.12.2014
comment
Ух ты! Это превосходный ответ! Не думаю, что я когда-либо встречал более полный ответ... - person markvgti; 21.04.2016
comment
Я бы хотел, чтобы то же самое можно было сделать без xml, но вместо этого использовать метод main(), как вы можете с HttpServer - person Sridhar Sarnobat; 09.04.2018
comment
1. что нужно сделать, если кто-то хочет использовать другую версию трикотажа (кроме уже присутствующей на сервере Tomcat)? 2. Можно ли развернуть военный файл в комплекте с банкой сервлета? 3. Можно ли использовать другую версию трикотажа в существующем сервере Tomcat? - person Rohit Kumar; 26.07.2020

Я смог заставить это работать, используя указания, приведенные в руководстве пользователя Jersey 2.6 для развертывания в контейнере сервлетов 3.x. В итоге я использовал что-то похожее на элемент ниже. Поскольку сопоставление URL-адресов предоставляется в XML-файле, вы можете опустить @ApplicationPath в подклассе Application.

<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>
person rss181919    schedule 28.02.2014