SpringMVC无法获取请求中的参数的问题的调查与解决

Posted 路漫漫其修远兮

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringMVC无法获取请求中的参数的问题的调查与解决相关的知识,希望对你有一定的参考价值。

使用框架可以节约开发时间,但有时由于隐藏了一些实现细节,导致对底层的原理知之不详,碰到问题时不知道该从哪一个层面入手解决。因此我特意记录了下面这个典型问题的调查和解决过程供参考。

 

事情是这样的,我们原来有一个移动端调用的发表评论的API,是几年前在NET平台上开发的,移植到JAVA后,发现安卓版APP无法正常发表汉字评论。

基于SpringMVC创建的JAVA版API接口大致如下,经调查发现,关键的content参数,在Controller层检查结果为空。

 

	@RequestMapping(value = "/Test.api")
	public Object test(
			HttpServletRequest request,
			HttpServletResponse response,
    		        @RequestParam(value = "content", required = false, defaultValue="") String content) {

                // 在这里,content的值为空   

        }

用Charles抓包检查Post的Form数据,确实有字段content,且有汉字值。但检查其Raw数据居然为这样的形式:content=%u611f%u53d7%u4e00%u4e0b%u8d85%u4eba%u7684%u808c%u8089%uff0c

 

我们知道,目前java常用的URLEncoder类,一般将汉字转换成"%xy"的形式,xy是两位16进制的数值,不会出现%u后面跟4个字符这种情况。

%u开头代表这是一种Unicode编码格式,后面的四个字符是二字节unicode的四位16进制码。在Charles软件上,支持这种解码,所以可以正常看到抓包数据中的汉字。

 

但是我们从SpringMVC框架层面统一指定了encoding为UTF-8,根据@RequestParam注解,使用UTF-8进行content参数的解码时,必然异常,由此导致了Post过来的content字段丢失。

 

和安卓团队确认,发现过去他们确实采用了自己独有的Encode方法对Post数据进行编码:

    public static String UrlEncodeUnicode(final String s)
    {
        if (s == null)
        {
            return null;
        }
        final int length = s.length();
        final StringBuilder builder = new StringBuilder(length); // buffer
        for (int i = 0; i < length; i++)
        {
            final char ch = s.charAt(i);
            if ((ch & 0xff80) == 0)
            {
                if (Utils.IsSafe(ch))
                {
                    builder.append(ch);
                }
                else if (ch == ‘ ‘)
                {
                    builder.append(‘+‘);
                }
                else
                {
                    builder.append("%");
                    builder.append(Utils.IntToHex((ch >> 4) & 15));
                    builder.append(Utils.IntToHex(ch & 15));
                }
            }
            else
            {
                builder.append("%u");
                builder.append(Utils.IntToHex((ch >> 12) & 15));
                builder.append(Utils.IntToHex((ch >> 8) & 15));
                builder.append(Utils.IntToHex((ch >> 4) & 15));
                builder.append(Utils.IntToHex(ch & 15));
            }
        }
        return builder.toString();
    }

采用这种方式的原因已经不可考证,并且安卓团队已经决定将在未来版本中放弃该编码方式,采用JAVA常用的Encoder类进行UTF-8的编码。问题定位后,决定新版API中必须要兼容新旧两种编码方式。

但是目前SpringMVC的@RequestParam注解负责了请求数据的解码,我们从哪一层切入,截获请求数据,判断其编码方式,并动态选用不同的解码方式来处理呢?

 

经过DEBUG,觉得下面两种方式是可行的。

 

解决问题的方法1:

修改API的接口形式,放弃@RequestParam注解,使用@RequestBody注解,直接获取POST请求的Raw数据,在Controller层独立解码

    @RequestMapping(value = "/Test.api")
    public Object test(
            HttpServletRequest request,
            HttpServletResponse response,
                    @RequestBody String body) {

                // 在这里,可以获得如下的raw数据: Id=185904&content=%u611f%u53d7%u4e00%u4e0b 
                // 可以自己对raw数据进行解析和解码 (具体的解码方式暂不考虑)

        }

 

解决问题的方法2:

通过自定义Filter的形式,在doFilter()方法中获取request的getInputStream(),也可以得到raw数据,解析后通过setAttribute()方法可以保存request中。

但这个操作过程和@RequestBody注解相比,要改web.xml加Filter配置等,更麻烦一些,不一定要用。

但有一个需要特别注意的事项,就是getInputStream()是一个一次性的动作,一旦被执行了,如果其他地方用到,就无效了。参考下面代码的注释:

package org.jiagoushi.api.aop;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.Map;

import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class MyFilter implements Filter {
    protected FilterConfig filterConfig;
    String encoding = null;

    public void destroy() {
        this.filterConfig = null;
    }

    /**
     * 初始化
     */
    public void init(FilterConfig filterConfig) {
        this.filterConfig = filterConfig;
    }


    /**
     * 过滤处理
     */
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain chain) throws IOException, ServletException {


        // String s = servletRequest.getInputStream()
        String line = "";
        StringBuilder body = new StringBuilder();
        int counter = 0;
        
        InputStream stream;
        stream = servletRequest.getInputStream();
        
        //读取POST提交的数据内容
        BufferedReader reader = new BufferedReader(new InputStreamReader(stream));
        while ((line = reader.readLine()) != null) {
            if(counter > 0){
                body.append("\r\n");
            }
            body.append(line);
            counter++;
        }
        
        //POST请求的raw数据可以获得
        System.out.println(body);
        
        //注意事项:因为servletRequest.getInputStream()被调用过1次,以后再调用也没有了。
        //下面的getParameterMap()和getParameter()方法,本质上也是去getInputStream(),
//所以都无法再获取到任何参数了
HttpServletRequest request = (HttpServletRequest) servletRequest; HttpServletResponse response = (HttpServletResponse) servletResponse; Map map = request.getParameterMap(); String v = request.getParameter("content"); // 继续执行下一个 filter, 无一下个 filter 则执行请求 chain.doFilter(request, response); } }

要让上面的Filter生效,web.xml中需要增加如下配置,注意Filter调用顺序和web.xml中写的先后顺序移植

    <filter>
        <filter-name>myFilter</filter-name>
        <filter-class>org.jiagoushi.api.aop.MyFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>myFilter</filter-name>
        <url-pattern>/Test.api</url-pattern>
    </filter-mapping>

 

此问题的调查告一段落,欢迎讨论。

以上是关于SpringMVC无法获取请求中的参数的问题的调查与解决的主要内容,如果未能解决你的问题,请参考以下文章

SpringMVC— “SpringMVC获取请求参数的方法”

SpringMVC— “SpringMVC获取请求参数的方法”

SpringMVC— “SpringMVC获取请求参数的方法”

SpringMVC— “SpringMVC获取请求参数的方法”

Spring MVC 学习笔记 --- [SpringMVC的几个注解标签说明,获取请求数据,springmvc提供的中文乱码过滤配置]

SpringMVC--04获取请求参数