参数的绑定

绑定的机制

我们都知道，表单中请求参数都是基于 key=value 的。
SpringMVC 绑定请求参数的过程是通过把表单提交请求参数，作为控制器中方法参数进行绑定的。
例如：

<a href="account/findAccount?accountId=10">查询账户</a>
中请求参数是：accountId=10

@RequestMapping("/findAccount")
public String findAccount(Integer accountId) { System.out.println("查询了账户。。。。"+accountId); return "success";
}

支持的数据类型

基本类型参数：
包括基本类型和 String 类型
POJO 类型参数：
包括实体类，以及关联的实体类
数组和集合类型参数：
包括 List 结构和 Map 结构的集合（包括数组）

SpringMVC 绑定请求参数是自动实现的，但是要想使用，必须遵循使用要求。

使用要求

如果是基本类型或者 String 类型：
要求我们的参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)
如果是 POJO 类型，或者它的关联对象：
要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。如果是集合类型,有两种方式：

• 第一种：
  要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。
  给 List 集合中的元素赋值，使用下标。
  给 Map 集合中的元素赋值，使用键值对。
• 第二种：
  接收的请求参数是 json 格式数据。需要借助一个注解实现。
  注意:
  它还可以实现一些数据类型自动转换。内置转换器全都在：org.springframework.core.convert.support 包下。有：

java.lang.Boolean -> java.lang.String : ObjectToStringConverter 
java.lang.Character -> java.lang.Number : CharacterToNumberFactory 
java.lang.Character -> java.lang.String : ObjectToStringConverter 
java.lang.Enum -> java.lang.String : EnumToStringConverter 
java.lang.Number -> java.lang.Character : NumberToCharacterConverter 
java.lang.Number -> java.lang.Number : NumberToNumberConverterFactory 
java.lang.Number -> java.lang.String : ObjectToStringConverter 
java.lang.String -> java.lang.Boolean : StringToBooleanConverter 
java.lang.String -> java.lang.Character : StringToCharacterConverter 
java.lang.String -> java.lang.Enum : StringToEnumConverterFactory 
java.lang.String -> java.lang.Number : StringToNumberConverterFactory 
java.lang.String -> java.util.Locale : StringToLocaleConverter 
java.lang.String -> java.util.Properties : StringToPropertiesConverter 
java.lang.String -> java.util.UUID : StringToUUIDConverter 
java.util.Locale -> java.lang.String : ObjectToStringConverter 
java.util.Properties -> java.lang.String : PropertiesToStringConverter 
java.util.UUID -> java.lang.String : ObjectToStringConverter

使用示例

基本类型和 String 类型作为参数

jsp代码：

<!-- 基本类型示例 -->
<a href="account/findAccount?accountId=10&accountName=zhangsan">查询账户</a>

控制器代码：

/**
*	查询账户
*	@return
*/ @RequestMapping("/findAccount")
public String findAccount(Integer accountId,String accountName) {
}

运行结果：

POJO类型作为参数

实体类代码：

/**
*	账户信息实体类
*/
public class Account implements Serializable {

private Integer id; 
private String name; 
private Float money; 
private Address address;
//getters and setters
}

/**
*	地址的实体类
*/
public class Address implements Serializable {

private String provinceName;
private String cityName;
//getters and setters
}

jsp代码：

<!-- pojo 类型演示 -->
<form action="account/saveAccount" method="post">
账户名称：<input type="text" name="name" ><br/>
账户金额：<input type="text" name="money" ><br/>
账户省份：<input type="text" name="address.provinceName" ><br/>
账户城市：<input type="text" name="address.cityName" ><br/>
<input type="submit" value="保存">
</form>

控制器代码：

/**
* 保存账户
*/ 
@RequestMapping("/saveAccount")
public String saveAccount(Account account) { 
  System.out.println("保存了账户。。。。"+account); 
  return "success";
}

运行结果：

POJO 类中包含集合类型参数

实体类代码

实体类代码：
/**
*	用户实体类
*/
public class User implements Serializable {

private String username; private String password; private Integer age;
private List<Account> accounts;
private Map<String,Account> accountMap;
//getters and setters

@Override
public String toString() {
    return "User [username=" + username + ", password=" + password + ", age="
    + age + ",\n accounts=" + accounts
    + ",\n accountMap=" + accountMap + "]";
  }
}

jsp代码：

<!-- POJO 类包含集合类型演示 -->
<form action="account/updateAccount" method="post">
  用户名称：<input type="text" name="username" ><br/>
  用户密码：<input type="password" name="password" ><br/>
  用户年龄：<input type="text" name="age" ><br/>
  账户 1 名称：<input type="text" name="accounts[0].name" ><br/> 
  账户 1 金额：<input type="text" name="accounts[0].money" ><br/> 
  账户 2 名称：<input type="text" name="accounts[1].name" ><br/> 
  账户 2 金额：<input type="text" name="accounts[1].money" ><br/>
  账户 3 名称：<input type="text" name="accountMap['one'].name" ><br/> 
  账户 3 金额：<input type="text" name="accountMap['one'].money" ><br/> 
  账户 4 名称：<input type="text" name="accountMap['two'].name" ><br/> 
  账户 4 金额：<input type="text" name="accountMap['two'].money" ><br/>
<input type="submit" value="保存">
</form>

控制器代码：

/**
* 更新账户
*/ 
@RequestMapping("/updateAccount")
public String updateAccount(User user) { 
  System.out.println("更新了账户。。。。"+user); 
  return "success";
}

请求参数乱码问题

如果有的话修改下面配置。
post 请求方式：
在 web.xml 中配置一个过滤器

<!-- 配置 springMVC 编码过滤器 -->
<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>
在 springmvc 的配置文件中可以配置，静态资源不过滤：
<!-- location 表示路径，mapping 表示文件，**表示该目录下的文件以及子目录的文件 -->
<mvc:resources location="/css/" mapping="/css/**"/>
<mvc:resources location="/images/" mapping="/images/**"/>
<mvc:resources location="/scripts/" mapping="/javascript/**"/>

get 请求方式：
tomacat 对 GET 和 POST 请求处理方式是不同的，GET 请求的编码问题，要改 tomcat 的 server.xml
配置文件，如下：
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>
改为：
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"/>
如果遇到 ajax 请求仍然乱码，请把：
useBodyEncodingForURI="true"改为 URIEncoding="UTF-8"
即可。

特殊情况

自定义类型转换器

使用场景

jsp代码：

<!-- 特殊情况之：类型转换问题 -->
<a href="account/deleteAccount?date=2018-01-01">根据日期删除账户</a>

控制器代码：

/**
* 删除账户
*/ 
@RequestMapping("/deleteAccount")
public String deleteAccount(String date) { 
  System.out.println("删除了账户。。。。"+date); 
  return "success";
}

运行结果：

当我们把控制器中方法参数类型改为Data时：

/**
* 删除账户
*/ 
@RequestMapping("/deleteAccount")
public String deleteAccount(Date date) { 
  System.out.println("删除了账户。。。。"+date); 
  return "success";
}

运行结果：

就是String不能直接转为Date.

解决方式：
自定一个类型转换器：

package com.zjw.utils;

import org.springframework.core.convert.converter.Converter;

import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

/**
 * 自定义日期类型转换器
 */
public class StringToDateConverter implements Converter<String, Date> {

    @Override
    public Date convert(String source) {
        if ("".equals(source)){
            System.out.println("请传入数据");
            throw new RuntimeException("请传入数据");
        }
        DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
        try {
            return df.parse(source);
        } catch (ParseException e) {
            throw new RuntimeException(e);
        }
    }
}

在spring配置文件中配置类型转换器。

<!-- 配置类型转换器工厂 -->
<bean id="converterService" class="org.springframework.context.support.ConversionServiceFactoryBean">
<!-- 给工厂注入一个新的类型转换器 -->
<property name="converters">
  <array>
  <!-- 配置自定义类型转换器 -->
    <bean class="com.itheima.web.converter.StringToDateConverter"></bean>
  </array>
</property>
</bean>

在 annotation-driven 标签中引用配置的类型转换服务

<!-- 引用自定义类型转换器 -->
<mvc:annotation-driven conversion-service="converterService"></mvc:annotation-driven>

使用ServletAPI对象作为方法参数

SpringMVC 还支持使用原始 ServletAPI 对象作为控制器方法的参数。支持原始 ServletAPI 对象有：

HttpServletRequest 
HttpServletResponse 
HttpSession 
java.security.Principal 
Locale
InputStream 
OutputStream 
Reader 
Writer

我们可以把上述对象，直接卸载控制的方法参数中使用。
jsp

<!-- 原始 ServletAPI 作为控制器参数 -->
<a href="account/testServletAPI">测试访问 ServletAPI</a>

控制器：

@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request,
                              HttpServletResponse response, 
                              HttpSession session) {
  System.out.println(request); 
  System.out.println(response); 
  System.out.println(session); 
  return "success";
}

本栏目推荐文章
• Jmeter 参数化之用户参数
• 函数的参数类型
• 手把手教你MongoDB 数据库连接URL 格式、authSource参数
• 11-函数进阶-参数类型
• Python逆向爬虫入门教程: 酷狗音乐加密参数signature逆向解析
• Chrome 浏览器插件 V3 版本 Manifest.json 文件中 Action 的类型（Types）、方法（Methods）和事件（Events）的属性和参数解析
• C# 方法中的 引用参数 ref out 的使用
• JVM内存参数设置
• [cpp]: 以模板作为模板参数 -- <template>
• Dating Java8系列之通过行为参数化传递代码

SpringMVC 参数springmvc参数 springmvc参数restful springmvc参数 日期java8 参数springmvc方法 工作流程springmvc流程 参数 springmvc参数 方式 springmvc参数01 注解springmvc常用 参数 注解springmvc参数 springmvc