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提供的中文乱码过滤配置]