springMVC-请求参数绑定

绑定机制

我们都知道，表单中请求参数都是基于 key=value 的。
SpringMVC 绑定请求参数的过程是通过把表单提交请求参数，作为控制器中方法参数进行绑定的。
例如：
<a href="account/findAccount?accountId=10">查询账户</a>
中请求参数是：
accountId=10
/**
* 查询账户
* @return
*/
@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
...
如遇特殊类型转换要求，需要我们自己编写自定义类型转换器

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

jsp代码
<a href="params/testParams?username=rainbow&password=123456">请求参数的绑定</a>

控制器代码
    @RequestMapping("/testParams")
    public String testParams(String username,int password){
        System.out.println("执行了参数的绑定");
        System.out.println("用户名：" + username);
        System.out.println("密码：" + password);
        return "success";
    }

2.POJO类型作为参数

pojo类
public class Account {
    private String accountNumber;
    private String password;
    private double money;
    ...
}
jsp代码
    <form method="post" action="params/saveAccount">
        帐号：<input type="text" name="accountNumber"/><br/>
        密码：<input type="text" name="password"/><br/>
        金额：<input type="text" name="money"/><br/>
        <input type="submit" value="保存帐号"/><br/>
    </form>

控制器代码
    @RequestMapping("saveAccount")
    public String saveAccount(Account account){
        System.out.println(account);
        return "success";
    }

3.POJO类含有pojo成员变量

pojo类
public class User implements Serializable{
    private Account account;
    private String name;
    private int age;
    private String addr;
    ...
}
jsp代码
    <form method="post" action="params/saveUser">
        姓名：<input type="text" name="name"/><br/>
        年龄：<input type="text" name="age"/><br/>
        地址：<input type="text" name="addr"/><br/>
        帐号：<input type="text" name="account.accountNumber"/><br/>
        密码：<input type="text" name="accunt.password"/><br/>
        金额：<input type="text" name="account.money"/><br/>
        <input type="submit" value="保存用户"/><br/>
    </form>

控制器代码
    @RequestMapping("saveUser")
    public String saveUser(User user){
        System.out.println(user);
        return "success";
    }

4.POJO 类中包含集合类型参数 

pojo类
public class User2 {
    private String name;
    private int age;
    private String addr;
    private List<Account> accountList;
    private Map<String,Account> accountMap;
    ...
}

jsp代码
    <form method="post" action="params/saveUsers">
        姓名：<input type="text" name="name"/><br/>
        年龄：<input type="text" name="age"/><br/>
        地址：<input type="text" name="addr"/><br/>
        帐号1：<input type="text" name="accountList[0].accountNumber"/><br/>
        密码1：<input type="text" name="accountList[0].password"/><br/>
        金额1：<input type="text" name="accountList[0].money"/><br/>
        帐号2：<input type="text" name="accountList[1].accountNumber"/><br/>
        密码2：<input type="text" name="accountList[1].password"/><br/>
        金额2：<input type="text" name="accountList[1].money"/><br/>
        帐号3：<input type="text" name="accountMap['one'].accountNumber"/><br/>
        密码3：<input type="text" name="accountMap['one'].password"/><br/>
        金额3：<input type="text" name="accountMap['one'].money"/><br/>
        <input type="submit" value="保存多帐号用户"/><br/>
    </form>

控制器代码
    @RequestMapping("saveUsers")
    public String saveUser(User2 user2){
        System.out.println(user2);
        return "success";
    }

5.请求参数中文乱码的问题

在上面的用户名如果写的是中文，会出现乱码的情况

 可以通过配置过滤器处理中文乱码的情况

get方式请求

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"
即可。

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>
</web-app>

配置了过滤器就可以解决乱码问题

另外

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

6.自定义类型转换

比如，在java中，默认的日期格式是yyyy/MM/dd

如果我输入的是yyyy-MM-dd，就会出现错误

jsp代码
    <form method="post" action="params/saveDate">
        日期：<input type="text" name="date"/><br/>
        <input type="submit" value="保存日期"/><br/>
    </form>

控制器代码
    @RequestMapping("saveDate")
    public String saveDate(Date date){
        System.out.println(date);
        return "success";
    }

所以需要写一个自定义类型的转换器，这个转换器需要实现Converter接口

public interface Converter<S, T> {//S:表示接受的类型， T：表示目标类型
    /**
    * 实现类型转换的方法
    */
    @Nullable
    T convert(S source);
}

本身已经有很多这个实现了这个接口的自动类型转换，比如

步骤 

1.要写一个字符串类型转换成Date类型的转换器

public class StringToDateConverter implements Converter<String,Date> {
    @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("输入日期有误");
        }
    }
}

2.在 spring 配置文件中配置类型转换器。
spring 配置类型转换器的机制是，将自定义的转换器注册到类型转换服务中去。

ConversionServiceFactoryBean里面有一个set类型的converters，我们需要的就是将自己写的转换器注册到里面去

    <!--日期转换-->
   <bean class="org.springframework.context.support.ConversionServiceFactoryBean" id="conversionService2">
       <property name="converters">
           <set>
               <bean class="com.cong.utils.StringToDateConverter"></bean>
           </set>
       </property>
   </bean>

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

 <mvc:annotation-driven conversion-service="conversionService2"></mvc:annotation-driven>
</beans>

这样就可以写自己想要的日期格式

使用 ServletAPI 对象作为方法参数 

SpringMVC 还支持使用原始 ServletAPI 对象作为控制器方法的参数。支持原始 ServletAPI 对象有：
HttpServletRequest
HttpServletResponse
HttpSession
java.security.Principal
Locale
InputStream
OutputStream
Reader
Writer
我们可以把上述对象，直接写在控制的方法参数中使用

示例

jsp代码
    <a href="params/testServlet">Servlet原生的API</a>

控制器代码
    @RequestMapping("testServlet")
    public String testServlet(HttpServletRequest request, HttpServletResponse response){
        System.out.println("run...");
        System.out.println(request);
        HttpSession session = request.getSession();
        System.out.println(session);
        ServletContext context = session.getServletContext();
        System.out.println(context);
        return "success";
    }

执行结果