Eclipse、maven、Jersey REST 服务、servlet 3.0、Tomcat 7.0、HTTP 404 错误

Question

我知道这个标题好像很多人以前都问过这个问题，但我做了很多研究，找不到任何解决方案可以解决我的问题。我在这个问题上花了两天时间，所以请帮帮我！

我正在尝试使用 Eclipse Kepler Service Release 2、Jersey、Eclipse 内置 maven、Servlet 3.0 和 Tomcat 7.0 构建一个简单的“hello world”类型的 restful web 服务。当我使用“运行方式”->“在服务器上运行”运行我的服务时，加载默认的“index.jsp”页面没有问题，但是在加载我的服务时我不断收到 HTTP 404 错误。

This image shows my project layout.

我实现Application的类如下：

package com.ys.java.ws;

import java.util.HashSet;
import java.util.Set;

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

import com.ys.java.ws.resources.MyService;

@ApplicationPath("/ys")
public class MyApplication extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> s = new HashSet<Class<?>>();
        s.add(MyService.class);
        return s;
    }

}

我的资源类是：

package com.ys.java.ws.resources;

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

@Path("/test")
public class MyService {

    public MyService() {

    }

    @GET
    @Path("/hello")
    //@Produces(MediaType.TEXT_PLAIN)
    @Produces("text/html")
    public String getTestMsg() {
        return "It works";
    }
}

我的 pom.xml 文件是：

<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.ys.java.ws</groupId>
    <artifactId>ysNoWebXML</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>ysNoWebXML Maven Webapp</name>
    <url>http://maven.apache.org</url>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
        <!-- Servlet 3.0 API -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.0.1</version>
        </dependency>
        <!--JAX-rs web service API -->
        <dependency>
            <groupId>org.glassfish.jersey.core</groupId>
            <artifactId>jersey-server</artifactId>
            <version>2.23.1</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.core</groupId>
            <artifactId>jersey-common</artifactId>
            <version>2.23.1</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet</artifactId>
            <version>2.23.1</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet-core</artifactId>
            <version>2.23.1</version>
        </dependency>
    </dependencies>
    <build>
        <finalName>TestService</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.3</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

我的 web.xml 是：

<web-app xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
          http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    version="3.0">
    <display-name>Servlet 3.0 Web Application</display-name>
    <servlet>
        <servlet-name>com.ys.java.ws.MyApplication</servlet-name>
    </servlet>
    <servlet-mapping>
        <servlet-name>com.ys.java.ws.MyApplication</servlet-name>
        <url-pattern>/rest</url-pattern>
    </servlet-mapping>
</web-app>

请注意：在 MyApplication 类中，我设置了 @ApplicationPath("/ys")，在 web.xml 中我设置了 <url-pattern>/rest</url-pattern>。我故意这样做，因为根据jax-rs document，

If both the <servlet-mapping> and @ApplicationPath are specified, the <servlet-mapping> takes precedence.

我想测试是否是这种情况，但无论我使用哪个路径，我都会收到 HTTP 404 错误。

Answer 1

以下是 web.xml 工作方式的示例：

<web-app xmlns="http://java.sun.com/xml/ns/javaee" version="2.5">
    <servlet>
        <servlet-name>comingsoon</servlet-name>
        <servlet-class>mysite.server.ComingSoonServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>comingsoon</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
</web-app>

也许您需要同时拥有 servlet-name 和 servlet-class。请注意，servlet-mapping 部分中的 servlet-name 必须与 servlet 部分中的 servlet-name 匹配。

请注意，您还需要在 url 模式中使用星号。你的看起来像“/rest/*”。

Answer 2

我终于成功了！在这里发布我的解决方案，以防将来有人遇到类似问题。

我之前犯了一些错误，现在更正了。

1. 在<url-pattern> 中添加/* 很重要。我看到很多教程不使用*，但这是错误的。
2. servlet 3.0 中不需要<servlet-class> 标记。相反，将应用程序类的完全限定名称放在<servlet-name> 标记中。所以 jax-rs 文档是正确的。
3. 这个项目符号不是那么重要，但我对它很好奇，现在理解它并分享它。所以“jersey-container-servlet-core”和“jersey-container-servlet”是类似的包，但前者适应Jersey 2.x，不适用于Jersey 3.x。 This blog 谈细节。因此，我的 pom.xml 文件中只需要“jersey-container-servlet”。

所以我最终的 web.xml 是：

<web-app xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
          http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    version="3.0">
    <display-name>Servlet 3.0 Web Application</display-name>
    <servlet>
        <servlet-name>com.ys.java.ws.MyApplication</servlet-name>
    </servlet>
    <servlet-mapping>
        <servlet-name>com.ys.java.ws.MyApplication</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
</web-app>