Jersey - servlet 上下文路径和/或 servlet 路径包含百分比编码的字符

Posted

技术标签:

【中文标题】Jersey - servlet 上下文路径和/或 servlet 路径包含百分比编码的字符【英文标题】:Jersey - The servlet context path and/or the servlet path contain characters that are percent encoded 【发布时间】:2015-05-14 22:16:40 【问题描述】:

我正在使用 Jersey 和 Tomcat,每次单击链接时都会收到以下消息:

HTTP Status 500 - The servlet context path and/or the servlet path contain
characters that are percent encoded

type: Exception report

message: The servlet context path and/or the servlet path contain characters
         that are percent encoded

description: The server encountered an internal error that prevented it from
             fulfilling this request.

exception:
    javax.ws.rs.ProcessingException: The servlet context path and/or the servlet path
    contain characters that are percent encoded
        org.glassfish.jersey.servlet.ServletContainer.service(ServletContainer.java:317)
        org.glassfish.jersey.servlet.ServletContainer.service(ServletContainer.java:221)
        org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)

note: The full stack trace of the root cause is available in the Apache Tomcat/7.0.56
      logs.

REST服务的路径是:

http://localhost:8070/simple-service-webapp/rest/hello

当我在 URL 栏中输入它时,它可以工作,但是当我点击某个链接时,URL 变成了这样:

http://localhost:8070/simple%2Dservice%2Dwebapp/rest/hello

不知何故,Jersey 默认不处理百分比编码的 URL。

有人可以帮我在不删除 URL 中的破折号的情况下让它工作吗?我的搜索没有提供有效的解决方案。

列表

HelloResource.java

package com.example;

import javax.ws.rs.*;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.UriInfo;

@Path("hello")
public class HelloResource 

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String sayHelloPlainText(@Context UriInfo uriInfo) 

        String name = uriInfo.getQueryParameters().getFirst("name");

        if (name == null) 
            name = "unknown user";
        

        return "Hello " + name + "!";
    

    @GET
    @Produces(MediaType.TEXT_html)
    public String sayHelloHtml(@Context UriInfo uriInfo) 

        String text = sayHelloPlainText(uriInfo);

        String result = "<html>" + "<head>" + "<title>Hello Jersey</title>" + "</head>"
                      + "<body>" + "<h1>" + text + "</h1>" + "</body>" + "</html>";

        return result;
    

    @GET
    @Produces(MediaType.TEXT_XML)
    public String sayHelloXml(@Context UriInfo uriInfo) 

        String text = sayHelloPlainText(uriInfo);

        String result = "<?xml version=\"1.0\"?>" + "<hello>Hello " + text + "!" + "</hello>";

        return result;
    

index.jsp

<!DOCTYPE html>

<html>

<head>
    <meta charset="UTF-8">

    <title>RESTful Web Application</title>
</head>

<body>
    <h2>My RESTful Web Application!</h2>

    <ul>
        <li><a href="rest/hello">Hello from Jersey</a></li>
        <li><a href="rest/hello?name=Johannes">Hello using parameters</a></li>
    </ul>
</body>

</html>

web.xml

<?xml version="1.0" encoding="UTF-8"?>

<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"
         version="3.1">

    <servlet>
        <servlet-name>Jersey Web Application</servlet-name>
        <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>

        <init-param>
            <param-name>jersey.config.server.provider.packages</param-name>
            <param-value>com.example</param-value>
        </init-param>

        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>Jersey Web Application</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
</web-app>

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.example</groupId>
    <artifactId>simple-service-webapp</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>simple-service-webapp</name>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

        <jersey.version>2.16</jersey.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.glassfish.jersey</groupId>
                <artifactId>jersey-bom</artifactId>
                <version>$jersey.version</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet</artifactId>
        </dependency>
    </dependencies>

    <build>
        <finalName>simple-service-webapp</finalName>

        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.5.1</version>

                <inherited>true</inherited>

                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.wildfly.plugins</groupId>
                <artifactId>wildfly-maven-plugin</artifactId>
                <version>1.0.2.Final</version>

                <configuration>
                    <id>WildFlyServer</id>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>

                <configuration>
                    <server>TomcatServer</server>

                    <url>http://localhost:8070/manager/text</url>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

【问题讨论】:

这个有什么解决办法吗?? 只是不要使用任何将被百分比编码的字符不能被接受作为答案。 ???? 【参考方案1】:

我遇到了这个确切的问题。将您的工件 id 更改为“SimpleWebApp”之类的东西(注意我去掉了'-')并且它可以工作。对于我想做的事情,不值得找出这行不通的确切原因。我不认为是球衣,而是关于 tomcat 的东西。

mvn archetype:generate -DarchetypeArtifactId=jersey-quickstart-webapp \
                -DarchetypeGroupId=org.glassfish.jersey.archetypes -DinteractiveMode=false \
                -DgroupId=com.example -DartifactId=SimpleWebapp -Dpackage=com.example \
                -DarchetypeVersion=2.22.1

【讨论】:

【参考方案2】:

看来jetty 9.4标准编码request.getContextPath(),见Jetty 9.4 ServletContextHandler.setContextPath behavior or Request data change。

和调试球衣(版本 2.30.1 -> 2.35)ServletContainer 我发现以下代码(第 94 行+):

        String decodedBasePath = request.getContextPath() + servletPath + "/";
        String encodedBasePath = UriComponent.encode(decodedBasePath, Type.PATH);
        if (!decodedBasePath.equals(encodedBasePath)) 
            this.setResponseForInvalidUri(response, new ProcessingException("The servlet context path and/or the servlet path contain characters that are percent encoded"));
         else 

所以 Jersey 不希望 request.getContextPath() 被编码。

即看来球衣需要升级以适应新的 jetty 9.4 行为!

在那之前,我们将无法拥有例如URL 中的空格按以前的方式处理...

【讨论】:

以上是关于Jersey - servlet 上下文路径和/或 servlet 路径包含百分比编码的字符的主要内容,如果未能解决你的问题,请参考以下文章

Jersey 的 servlet 或过滤器

[servlet.service()对于路径为[/messenger.service]的Servlet [Jersey Web应用程序]引发了异常[java.lang.NullPointerExcep

我可以在 Spring Boot 中将 Jersey 用作 servlet 和过滤器吗?

Jersey初始化功能:在Application对象或ServletContextListner中

Servlet 过滤器和 Jersey 过滤器有啥区别?

什么是泽西过滤器?