SpringMVC：请求参数的绑定

SpringMVC：请求参数的绑定

• SpringMVC 绑定请求参数的过程是通过把表单提交请求参数，作为控制器中方法参数进行绑定的。

支持的数据类型

1、基本类型参数 ：
	包括基本类型和 String 类型
2、POJO  类型参数 ：
	包括实体类，以及关联的实体类
3、数组和集合类型参数 ：
	包括 List 结构和 Map 结构的集合（包括数组）
	
SpringMVC 绑定请求参数是自动实现的，但是要想使用，必须遵循使用要求：
	1、如果是基本类型或者 String  类型：
		要求我们的参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)
	2、如果是 POJO  类型 ，或者 它的关联对象 ：
		要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。
	3、如果是集合类型, 有两种方式：
		第一种：
			要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。
			给 List 集合中的元素赋值，使用下标。
			给 Map 集合中的元素赋值，使用键值对。
		第二种：
			接收的请求参数是 json 格式数据。需要借助一个注解实现。
			
注意:
	它还可以实现一些数据类型自动转换。如遇特殊类型转换要求，需要我们自己编写自定义类型转换器。

示例代码

基本类型以及String类型

jsp代码

<h3>testBasicType</h3>
<a href="test/testBasicType?account=1000&userName=zhangsan">testBasicType</a>

控制器代码
 @RequestMapping(path = "/testBasicType")
    public String testBasicType(Integer account,String userName){
        System.out.println("HtestBasicType:account "+ account +" userName: " +userName);
        return "success";
    }

POJO类型

实体类代码
public class Account implements Serializable {

    private String username;
    private double money;
    private User user;
}
public class User implements Serializable {

    private Integer id;
    private String username;
    private String address;
    private Date date;
}

jsp代码
<h3>testPOJO</h3>
<form action="test/testPOJO" method="post">
	username:<input type="text" name="username"><br>
	money:<input type="text" name="money"><br>
	address:<input type="text" name="user.address"><br>
	date:<input type="text" name="user.date"><br>
	<input type="submit" value="提交"><br>
</form>

控制器代码
 @RequestMapping(path = "/testPOJO")
 public String testPOJOType(Account account){
      System.out.println("testPOJOType:account "+ account);
      return "success";
  }

POJO中包含集合类型

实体类代码
public class Account implements Serializable {

    private String username;
    private double money;
    private List<User> list;
    private Map<String,User> map;
}
jsp代码
<h3>testList</h3>
<form action="test/testList" method="post">
	username:<input type="text" name="username"><br>
	money:<input type="text" name="money"><br>
	用户1 address:<input type="text" name="list[0].address"><br>
	用户1 date:<input type="text" name="list[0].date"><br>
	用户2 address:<input type="text" name="map['two'].address"><br>
	用户2 date:<input type="text" name="map['two'].date"><br>
	<input type="submit" value="提交"><br>
</form>

控制器代码
@RequestMapping(path = "/testList")
public String testList(Account account){
    System.out.println("testList:account "+ account);
    return "success";
}

自定义类型转换器

第一步：定义一个类，实现 Converter  接口，该接口有两个泛型。
public interface Converter<S, T> {//S:表示接受的类型，T：表示目标类型
	/**
	* 实现类型转换的方法
	*/
	@Nullable
	T convert(S source);
}
/**
* 自定义类型转换器
* @author 黑马程序员
* @Company http://www.ithiema.com
* @Version 1.0
*/
public class StringToDateConverter implements Converter<String, Date> {
	/**
	* 用于把 String 类型转成日期类型
	*/
	@Override
	public Date convert(String source) {
		DateFormat format = null;
			try {
				if(StringUtils.isEmpty(source)) {
					throw new NullPointerException("请输入要转换的日期");
				}
				format = new SimpleDateFormat("yyyy-MM-dd");
				Date date = format.parse(source);
				return date;
			} catch (Exception e) {
				throw new RuntimeException("输入日期有误");
		}
	}
}

第二步：在 spring  配置文件中配置类型转换器。
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";
}

请求参数乱码问题

post  请求方式：
在 web.xml 中配置一个过滤器
<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>
  </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"