Что лучше всего подходит для внедрения Jersey 2.x на Tomcat 8?

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

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

Спасибо

Ответ 1

Следующее - это то, на что я надеюсь, относительно полные решения ваших вопросов.

Вы не упоминаете 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>

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

Но это просто пом. Трюк продолжается в 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, который будет выглядеть следующим образом:

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

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

Fine. Это jars 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
  • jersey-server-2.13.jar
  • джерси-клиент-2.13.jar
  • валидация-апи-1.1.0.Final.jar
  • javax.ws.rs-апи-2.0.1.jar
  • джерси-контейнер-сервлет-2.13.jar

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

Ответ 2

Мне удалось получить эту работу, используя указания, приведенные в руководстве пользователя 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>