独立 Servlet 5 容器中的 JAX-RS(泽西岛)API 未启动

JAX-RS (Jersey) API in standalone Servlet 5 container does not start

只想构建一个带有 REST API(由 Jersey 2.33 实现的 JAX-RS)的 Java 应用程序,该应用程序在独立的 Servlet 5 容器中运行,例如Tomcat 10. 为此,构建过程(通过 Maven)创建一个 *.war 文件,随后将该文件放入 webapps/ 文件夹以启动它。

问题是 JAX-RS API,也就是说它的 servlet,没有出现。所以调用 URL

http://localhost:8080/weld/api/address

生成 HTTP 状态 404(未找到)。

pom.xml看起来如下:

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>de.test</groupId>
    <artifactId>weld</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <name>weld Maven Webapp</name>


    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <servlet-api.version>5.0.0</servlet-api.version>
        <jax-rs-api.version>2.1.6</jax-rs-api.version>
        <jersey.version>2.33</jersey.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>${servlet-api.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>jakarta.ws.rs</groupId>
            <artifactId>jakarta.ws.rs-api</artifactId>
            <version>${jax-rs-api.version}</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet</artifactId>
            <version>${jersey.version}</version>
        </dependency>
    </dependencies>

    <build>
        <finalName>weld</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>2.3</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

我已从 Jersey documentation 中阅读了所需的依赖项和使其正常工作的其余部分。 *.war 不包含任何 web.xml 因为从 Servlet API 3.1 开始这是可选的。 class javax.ws.rs.core.Application 实际上应该自动检测和 bootstrap JAX-RS API 如下所示:

package de.test.weld;

import org.glassfish.jersey.server.ResourceConfig;

import javax.ws.rs.ApplicationPath;

@ApplicationPath("api")
public class MyApplication extends ResourceConfig {

   public MyApplication() {
       registerClasses(AddressService.class);
   }
}

Java class 的终点看起来像这样:

package de.test.weld;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/address")
public class AddressService {

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public String getAddress() {
        return "any text, bla, nonsense";
    }
}

为了启动 Jersey Sevlet,似乎缺少任何必要的东西。

一瞥 *.war 看起来像这样:

$> jar -tvf webapps/weld.war 
     0 Sat Mar 13 13:13:24 CET 2021 META-INF/
   131 Sat Mar 13 13:13:22 CET 2021 META-INF/MANIFEST.MF
     0 Sat Mar 13 13:13:24 CET 2021 WEB-INF/
     0 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/
     0 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/de/
     0 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/de/test/
     0 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/de/test/weld/
     0 Sat Mar 13 13:13:24 CET 2021 WEB-INF/lib/
   619 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/de/test/weld/AddressService.class
  1025 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/de/test/weld/TestServlet.class
   581 Sat Mar 13 13:13:24 CET 2021 WEB-INF/classes/de/test/weld/MyApplication.class
 25058 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jakarta.annotation-api-1.3.5.jar
 19479 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/osgi-resource-locator-1.0.3.jar
1174508 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jersey-common-2.33.jar
942190 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jersey-server-2.33.jar
 18140 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jakarta.inject-2.6.1.jar
253811 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jersey-client-2.33.jar
 91930 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jakarta.validation-api-2.0.2.jar
 32383 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jersey-container-servlet-2.33.jar
 73402 Fri Mar 12 15:26:10 CET 2021 WEB-INF/lib/jersey-container-servlet-core-2.33.jar
140376 Fri Mar 12 15:11:24 CET 2021 WEB-INF/lib/jakarta.ws.rs-api-2.1.6.jar
     0 Sat Mar 13 13:13:24 CET 2021 META-INF/maven/
     0 Sat Mar 13 13:13:24 CET 2021 META-INF/maven/de.test/
     0 Sat Mar 13 13:13:24 CET 2021 META-INF/maven/de.test/weld/
  2757 Sat Mar 13 13:12:34 CET 2021 META-INF/maven/de.test/weld/pom.xml
   106 Sat Mar 13 13:13:24 CET 2021 META-INF/maven/de.test/weld/pom.properties

以下是有关正在使用的版本的一些信息: Java 11、Maven 3.6、JAX-RS(泽西岛 2.33)、Servlet API 5.0.0、Tomcat 10 或 Jetty 11

您需要使用 Jersey 3.x。 3.x 行是使用 Jakarta 命名空间的第一行。您拥有所有 Jakarta 依赖项(JAX-RS、Servlet),只是您使用的 Jersey 版本没有使用它们。请参阅 Jersey docs 以获得最新的 3.x 版本。

在新的 Jakarta EE 中,所有 javax 包装都已更改为 jakarta,例如jakarta.ws.rs.ApplicationPath。一旦你更改了 Jersey 版本(假设你没有任何其他旧的依赖项,你应该会收到导入错误。所有 javax 导入都应该显示错误。它们都应该用 jakarta 切换掉。All javax 导入(包括 JAX-RS、Servlet、Inject 等)。