SSM框架之SpringMVC（2）参数绑定及自定义类型转换

r囧r小猫 2022-02-04 12:13 204阅读 0赞

# SpringMVC（2）参数绑定及自定义类型转换 #

## 1、请求参数的绑定 ##

### 1.1、 请求参数的绑定说明 ###

#### 1.1.1、绑定机制 ####

1.  表单提交的数据都是k=v格式的 username=haha&password=123
2.  SpringMVC的参数绑定过程是把表单提交的请求参数，作为控制器中方法的参数进行绑定的
3.  要求：提交表单的name和参数的名称是相同的

例子：

请求的html

对应方法

@RequestMapping("/testParam")
    public String testParam(String username,String password){ 
        System.out.println("请求成功....");
        System.out.println("username = " + username + ",password = " + password);
        return "success";
    }

#### 1.1.2、支持的数据类型 ####

1.  基本数据类型和字符串类型
2.  实体类型（JavaBean）
3.  集合数据类型（List、map集合等）

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

#### 1.1.3、使用要求 ####

**如果是基本类型或者 String 类型：**  
要求我们的参数名称必须和控制器中方法的形参名称保持一致。 (严格区分大小写)

**如果是 POJO 类型，或者它的关联对象：**  
要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。

**如果是集合类型,有两种方式**

第一种：  
要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。  
给 List 集合中的元素赋值， 使用下标。  
给 Map 集合中的元素赋值， 使用键值对。  
第二种：  
接收的请求参数是 json 格式数据。需要借助一个注解实现

### 1.2、参数绑定示例 ###

#### 1.2.1、对基本类型的绑定 ####

请求的html

对应方法

#### 1.2.2、对实体类型的绑定（pojo） ####

实体类：

public class Account implements Serializable { 
        private String username;
        private String password;
        private Double money;
        /*getting和setting*/
    }

请求的html

接收请求的方法

@RequestMapping("/saveAccount")
    public String saveAccount(Account account){ 
        System.out.println("请求成功....");
        System.out.println(account);
        return "success";
    }

#### 1.2.3、对实体类型中包含集合类型的绑定（pojo） ####

实体类：

public class Account implements Serializable { 
        private String username;
        private String password;
        private Double money;
    
        private List<User> list;
        private Map<String,User> map;
        /*getting和setting*/
    }
    
    
    public class User implements Serializable { 
        private String uname;
        private Integer age;
        /*getting和setting*/
    }

请求的html

接收请求的方法

@RequestMapping("/saveAccount")
    public String saveAccount(Account account){ 
        System.out.println("请求成功....");
        System.out.println(account);
        return "success";
    }

### 1.3、自定义类型转换器 ###

> 注意:  
> 它还可以实现一些数据类型自动转换。 内置转换器全都在：  
> 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  
> …  
> 如遇特殊类型转换要求，需要我们自己编写自定义类型转换器

mvc中的类型转换的内部转换器可以实现1999/11/11的字符串转为日期类型，但是如果1999-11-11字符串那么就不能被自动转换，需要我们自定义类型转换器。

**实现步骤**

#### 1、定义类实现Converter接口，并在其中必须类型转换的方法 ####

import org.springframework.core.convert.converter.Converter;
    
    import java.text.DateFormat;
    import java.text.SimpleDateFormat;
    import java.util.Date;
    
    /** * 字符串转日期 */
    public class StringToDateConverter implements Converter<String , Date> { 
    
        /** * * @param source 传入的字符串 * @return 转换后的日期类型 */
        @Override
        public Date convert(String source) { 
            if (source == null){ 
                throw new RuntimeException("请传入数据");
            }
            DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
            try { 
                return df.parse(source);
            } catch (Exception e) { 
                throw new RuntimeException("数据转换异常");
            }
        }
    }

#### 2、在配置文件中开启对自定义类型转换器的支持 ####

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
    
        <context:component-scan base-package="wf"></context:component-scan>
    
        
        <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="prefix" value="/WEB-INF/pages/"/>
            <property name="suffix" value=".jsp"/>
        </bean>
    
        
        <bean id="conversionService2" class="org.springframework.context.support.ConversionServiceFactoryBean">
            <property name="converters">
                <set>
                    <bean class="wf.untils.StringToDateConverter"></bean>
                </set>
            </property>
        </bean>
    
        
        
        <mvc:annotation-driven conversion-service="conversionService2"></mvc:annotation-driven>
    
    </beans>

#### 3、测试 ####

使用的实体类

import java.io.Serializable;
    import java.util.Date;
    
    public class User implements Serializable { 
        private String uname;
        private Integer age;
        private Date date;
    }

定义html测试表单

## 2、请求参数乱码问题 ##

### 2.1、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>
          
        <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 的配置文件中可以配置，静态资源不过滤：

<mvc:resources location="/css/" mapping="/css/**"/>
    <mvc:resources location="/images/" mapping="/images/**"/>
    <mvc:resources location="/scripts/" mapping="/javascript/**"/>

### 2.2、get 请求方式： ###

tomacat 对 GET 和 POST 请求处理方式是不同的， GET 请求的编码问题， 要改 tomcat 的 server.xml配置文件，如下 ：

改为：

如果遇到 ajax 请求仍然乱码，请把：  
useBodyEncodingForURI="true"改为 URIEncoding=“UTF-8”  
即可

## 3、获取servlet原生api ##

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

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

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

测试用例：

<a href="param/testServlet">Servlet原生api</a>

@RequestMapping("/testServlet")
    public String testServlet(HttpServletRequest request, HttpServletResponse response){ 
        System.out.println("请求成功....");
        System.out.println(request);
        HttpSession session = request.getSession();
        System.out.println(session);
        ServletContext servletContext = session.getServletContext();
        System.out.println(servletContext);
        System.out.println(response);
        return "success";
    }