本文最后更新于：1 年前

获得请求参数

客户端请求参数的格式是：name=value&name=value… …

服务器端要获得请求的参数，有时还需要进行数据的封装，SpringMVC可以接收如下类型的参数：

获得基本类型参数

Controller 中的业务方法的参数名称要与请求参数的 name 一致，参数值会自动映射匹配。

http://localhost:8080/quick9?username=zhangsan&age=12

@RequestMapping(value = "/quick10")
@ResponseBody  //直接回写数据而不是跳转
public void save10(String username, int age) {
    System.out.println(username);
    System.out.println(age);
}

获得POJO类型参数

Controller中的业务方法的POJO参数的属性名与请求参数的name一致，参数值会自动映射匹配。

public class King {
    private String name;
    private int age;

    public String getName() { return name; }

    public int getAge() { return age; }

    public void setName(String name) { this.name = name; }

    public void setAge(int age) { this.age = age; }
    
    @Override
    public String toString() { return "King{" + "name='" + name + '\'' + ", age=" + age +'}'; }
}

@RequestMapping(value = "/quick11")
@ResponseBody  //直接回写数据而不是跳转
public void save11(King king) {
    System.out.println(king);
}

获得数组类型参数

Controller 中的业务方法数组名称与请求参数的 name 一致，参数值会自动映射匹配。

@RequestMapping(value = "/quick12")
@ResponseBody
public void save11(String[] strs) {
    System.out.println(Arrays.toString(strs));
}

获得集合类型参数

获得集合参数时，要将集合参数包装到一个POJO中才可以。

public class VO {
    private List<King> kingList;

    public List<King> getKingList() { return kingList; }

    public void setKingList(List<King> kingList) { this.kingList = kingList; }

    @Override
    public String toString() { return "VO{" + "kingList=" + kingList + '}'; }
}

<%--form.jsp--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>form</title>
</head>
<body>
    <form action="${pageContext.request.contextPath}/user/quick13" method="post">
        <%--表明是第几个King对象的第几个name和age--%>
       king1的name：<input type="text" name="kingList[0].name"><br>
       king1的age：<input type="text" name="kingList[0].age"><br>
       king2的name：<input type="text" name="kingList[1].name"><br>
       king2的age：<input type="text" name="kingList[1].age"><br>
       king3的name：<input type="text" name="kingList[2].name"><br>
       king3的age：<input type="text" name="kingList[2].age"><br>

       <input type="submit" value="提交">
    </form>
</body>
</html>

@RequestMapping(value = "/quick13")
@ResponseBody
public void save13(VO vo) {
    System.out.println(vo.toString());
}

当使用ajax提交时，可以指定 contentType 为json形式，那么在方法参数位置使用 @RequestBody 可以直接接收集合数据而无需使用POJO进行包装。

<--在ajax.jsp中模拟数据-->
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>ajax</title>
    <script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
    <script>
        var kingList = new Array();
        kingList.push({name: "gaojie", age: 22})
        kingList.push({name: "zhangsan", age: 20})

        $.ajax({
            type: "POST",
            url: "${pageContext.request.contextPath}/user/quick14",
            data: JSON.stringify(kingList),
            contentType: "application/json;charset=utf-8"
        });
    </script>
</head>
<body>

</body>
</html>

当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。

@RequestMapping(value = "/quick14")
@ResponseBody
public void save14(@RequestBody List<King> kingList) {
    System.out.println(kingList);
}

注意：通过浏览器开发者工具抓包发现，没有加载到 jquery 文件，原因是 SpringMVC 的前端控制器 DispatcherServlet 的 url-pattern 配置的是 /，代表对所有的资源都进行过滤操作，我们可以通过以下两种方式指定放行静态资源：

在 spring-mvc.xml 配置文件中指定放行的资源

1 2	`<--开发资源的访问权限--/> <mvc:resources mapping="/js/**" location="/js/"/>`

让原始容器寻找静态资源

1 2	`<--让Tomcat寻找静态资源--/> <mvc:default-servlet-handler/>`

获取数据细节

请求数据乱码问题

前端编码

JSP页面：

1	`<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %>`

HTML页面：
1
<meta charset="UTF-8">

服务器编码

tomcat/conf/server.xml

1
2
3

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"  URIEncoding="UTF-8"/>

设置SpringMVC的编码方式

当我们发起 post 请求时，Tomcat 服务器会出现乱码问题：

我们可以在web.xml中配置SpringMVC编码过滤器的编码方式，设置一个过滤器来进行编码的过滤：

<!--配置全局过滤的filter-->
<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>utf-8</param-value>
    </init-param>
    <init-param>     <!--强制编码（可选）-->
        <param-name>forceEncoding</param-name>   
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

参数绑定注解 @requestParam

当请求的参数名称与 Controller 的业务方法参数名称不一致时，就需要通过 @RequestParam 注解显示的绑定。

@RequestMapping(value = "/quick10")
@ResponseBody  //直接回写数据而不是跳转
public void save10(@RequestParam("name" ) String username, int age) {
    System.out.println(username);
    System.out.println(age);
}

注解 @RequestParam 还有如下参数可以使用：

value：与请求参数名称
required：此在指定的请求参数是否必须包括，默认是true，提交时如果没有此参数则报错
defaultValue：当没有指定请求参数时，则使用指定的默认值赋值

@RequestMapping(value = "/quick15")
@ResponseBody  //直接回写数据而不是跳转
public void save15(@RequestParam(value = "name", required = false, defaultValue = "gaojie.cc") String username) {
    System.out.println(username);
}

获得Restful风格的参数

Restful 是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。

Restful 风格的请求是使用『url+请求方式』表示一次请求目的的，HTTP 协议里面四个表示操作方式的动词如下：

GET：用于获取资源。（如： /user/1 GET —> 得到id=1的user）
POST：用于新建资源。（如： /user POST —> 新增user）
PUT：用于更新资源。（如： /user/1 PUT —> 更新id=1的user）
DELETE：用于删除资源。（如： /user/1 DELETE —> 删除id=1的user）

上述 url 地址 /user/1 中的 1 就是要获得的请求参数，在 SpringMVC 中可以使用占位符进行参数绑定。地址 /user/1 可以写成 /user/{id} ，占位符 {id} 对应的就是 1 的值。在业务方法中我们可以使用 @PathVariable 注解进行占位符的匹配获取工作。

自定义类型转换器

SpringMVC 默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。

但是不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：日期类型的数据就需要自定义转换器。

自定义类型转换器的开发步骤：

① 定义转换器类实现Converter接口
② 在配置文件中声明转换器
③ 在 <annotation-driven> 中引用转换器

定义转换器类实现 Converter 接口

public class DateConverter implements Converter<String, Date> {
    @Override
    public Date convert(String dateStr) {
        //将日期字符串转换成日期对象，返回
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        Date date = null;
        try {
            date = format.parse(dateStr);
            return date;
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return null;
    }
}

在核心配置文件中声明转换器

<!--声明转换器-->
<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
    <property name="converters">
        <list>
            <bean class="cc.gaojie.converter.DateConverter"/>
        </list>
    </property>
</bean>

在 <annotation-driven> 中引用转换器

1 2	`<!--MVC的注解驱动--> <mvc:annotation-driven conversion-service="conversionService"/>`

Controller 中的业务方法

@RequestMapping(value = "/quick18")
@ResponseBody
public void save18(Date date) {
    System.out.println(date);
}

获得Servlet相关API

SpringMVC 支持使用原始 ServletAPI 对象作为控制器方法的参数进行注入。常用的对象如下：

HttpServletRequest
HttpServletResponse
HttpSession

@RequestMapping(value = "/quick18")
@ResponseBody
public void save18(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
    System.out.println(request);
    System.out.println(response);
    System.out.println(session);
}

获得请求头

使用 @RequestHeader 可以获得请求头信息，相当于 web 阶段学习的 request.getHeader(name) 。

@RequestHeader 注解的属性如下：

value：请求头的名称。
required：是否必须携带此请求头。

//获得User-Agent
@RequestMapping(value = "/quick19")
@ResponseBody
public void save19 (@RequestHeader(value = "User-Agent",required = false) String user_agent) {
    System.out.println(user_agent);
}

//获取cookie值
@RequestMapping(value = "/quick20")
@ResponseBody
public void save20 (@CookieValue(value = "JSESSIONID") String jsessionID) {
    System.out.println(jsessionID);
}

SSM框架 SpringMVC

SpringMVC

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议，转载请注明出处！

深入模板上一篇

SpringMVC之REST风格开发下一篇

SpringMVC获得请求数据