SpringMVC参数绑定

﹏ヽ暗。殇╰゛Y 2022-07-13 14:53 224阅读 0赞

# SpringMVC参数绑定 #

@(SpringMVC)\[springmvc, 参数绑定\]

*  SpringMVC参数绑定
    
     *  基本介绍
     *  SpringMVC支持的数据类型
        
         *  Springmvc默认支持的类型
            
             *  HttpServletRequest
             *  HttpServletResponse
             *  HttpSession
             *  ModelModelMap
             *  案例
         *  简单数据类型
            
             *  支持的数据类型
             *  RequestParam
             *  案例
         *  pojo类型
         *  复杂pojo类型
         *  数组类型
         *  List集合类型
            
             *  name属性取值
         *  值对象的基本概念value object
            
             *  使用值对象统一参数绑定格式
                
                 *  QueryVo
                 *  统一的参数绑定
     *  SpringMVC自定义参数绑定
        
         *  创建Date转换器
         *  在SpringMVC配置文件中配置

## 基本介绍 ##

SpringMVC的参数绑定是由SpringMVC中的一个处理器适配器实现的。其采用的是命令模式。

SpringMVC支持的类型很多，除了默认支持的`HttpServletRequest`、`HttpServletResponse`等，还有简单数据类型，像是`String`、`Integer`、`int`，还有POJO类型、复杂POJO类型、数组类型等等。

SpringMVC还支持自定义参数绑定，比如Date类型的绑定。

## SpringMVC支持的数据类型 ##

### Springmvc默认支持的类型 ###

#### HttpServletRequest ####

通过request对象获取请求信息

#### HttpServletResponse ####

通过response处理响应信息

#### HttpSession ####

通过session对象得到session中存放的对象

#### Model/ModelMap ####

ModelMap是Model接口的实现类，通过Model或ModelMap向页面传递数据。

页面通过$\{item.XXXX\}获取item对象的属性值。  
使用Model和ModelMap的效果一样，如果直接使用Model，springmvc会实例化ModelMap。

如果使用Model则可以不使用ModelAndView对象，Model对象可以向页面传递数据，View对象则可以使用String返回值替代。不管是Model还是ModelAndView，其本质都是使用Request对象向jsp传递数据。

#### 案例 ####

/** * * 演示接收默认参数类型 * HttpServletRequest request, HttpServletResponse response, HttpSession session, Model model * */
        @RequestMapping("/toEdit")
        public String toEdit(HttpServletRequest request, Model model) throws Exception{
            String idStr = request.getParameter("id");
            Items items = itemsService.findItemsById(Integer.parseInt(idStr));
    
            //返回给页面数据可以借助于默认支持的参数类型Model
            //将数据放入Model中, model底层是将model中的数据放入到了request域中.
            model.addAttribute("item", items);
    
            //springMvc规定只要Controller方法返回一个普通的string字符串就认为是页面的地址
            //springMvc中的视图解析器会自动进行路径的拼接
            return "editItem";
        }

### 简单数据类型 ###

当请求的参数名称和处理器形参名称一致时会将请求参数与形参进行绑定。从Request取参数的方法可以进一步简化。

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

参数类型推荐使用包装数据类型，因为基础数据类型不可以为null  
整形：Integer、int  
字符串：String  
单精度：Float、float  
双精度：Double、double  
布尔型：Boolean、boolean  
说明：对于布尔类型的参数，请求的参数值为true或false。

#### @RequestParam ####

使用`@RequestParam`常用于处理简单类型的绑定。

*  `value`：参数名字，即传入参的请求参数名字；
 *  `required`：是否必须，默认是true，表示请求中一定要有相应的参数，否则将报错：`TTP Status 400 - Required Integer parameter 'XXXX' is not present`
 *  `defaultValue`：默认值，表示如果请求中没有同名参数时的默认值

#### 案例 ####

/** * 接收简单类型的参数 * String, double, long, boolean, integer等 * 接收时参数的变量名称必须等于, 页面上input框name属性值 */
        @RequestMapping("/update")
        public String update(@RequestParam(value = "id", required = true)Integer id, String name, Float price, String detail) throws Exception{
            Items items = new Items();
            items.setId(id);
            items.setName(name);
            items.setPrice(price);
            items.setDetail(detail);
            items.setCreatetime(new Date());
            itemsService.updateItems(items);
    
            return "success";
        }

### pojo类型 ###

/** * 接收Pojo类型 * 页面上input框的name属性值必须等于pojo中的属性名称 */
        @RequestMapping("/update")
        public String update(Items items) throws Exception{
            items.setCreatetime(new Date());
            itemsService.updateItems(items);
    
            return "success";
        }

### 复杂pojo类型 ###

复杂POJO类型的意思是，一个POJO类里面有另一个POJO类的对象，比如`Order`类里面有`Item`类的对象。

/** * 接收复杂pojo的类型 * 接收复杂pojo类型, 那么要求页面上input框的name属性值必须等于复杂pojo类型中的属性.属性.属性.... */
        @RequestMapping("/search")
        public String search(Order order) throws Exception{
            System.out.println(order);
            return "success";
        }

PS：order对象中有一Item类型的属性，名为item。页面上input的name为：item.name、item.price、item.detail。

### 数组类型 ###

// 接收数组类型
        // 页面上input框的name属性值与参数名相同
        @RequestMapping("/delAll")
        public String delAll(String[] ids) throws Exception{
            for (String id : ids) {
                System.out.println(id);
            }
            return "success";
        }

### List集合类型 ###

// 接收List集合类型
        // 页面上input框的name属性值必须等于值对象中的集合属性名称+[集合下标]+.+对应的集合泛型中的属性名称
        @RequestMapping("/updateAll")
        public String updateAll(QueryVo vo) throws Exception{
            System.out.println(vo);
            return "success";
        }

#### name属性取值 ####

<c:forEach items="${itemList}" var="item" varStatus="status"> 
        
        <input type="hidden" name="itemsList[${status.index}].id" value="${item.id}"/>
        <input type="text" name="itemsList[${status.index}].name" value="${item.name}"/>
        <input type="text" name="itemsList[${status.index}].price" value="${item.price}"/>
    </c:forEach>

### 值对象的基本概念(value object) ###

1.  值对象通常用于业务层之间的数据传递，和PO一样也是仅仅包含数据而已。
2.  但应是抽象出的业务对象,可以和表对应,也可以不,这根据业务的需要。
3.  精确点讲它是业务对象，是存活在业务层的，是业务逻辑使用的，它存活的目的就是为数据提供一个生存的地方。

#### 使用值对象统一参数绑定格式 ####

值对象可以看做是对象的包装类，也可以看做是上述几种参数绑定类型中复杂POJO类型。  
使用值对象之后，就可以统一参数绑定，具体见下代码：

##### QueryVo #####

package com.pc.springmvc.pojo;
    
    import java.util.List;
    /** * 商品查询值对象，用于商品参数绑定 * * @author Switch * @data 2017年1月11日 * @version V1.0 */
    public class QueryVo { 
        //封装商品对象
        private Items items;
        // 封装商品id数组
        private Integer[] ids;
        // 封装商品列表
        private List<Items> itemsList;
    
        public List<Items> getItemsList() {
            return itemsList;
        }
    
        public void setItemsList(List<Items> itemsList) {
            this.itemsList = itemsList;
        }
    
        public Integer[] getIds() {
            return ids;
        }
    
        public void setIds(Integer[] ids) {
            this.ids = ids;
        }
    
        public Items getItems() {
            return items;
        }
    
        public void setItems(Items items) {
            this.items = items;
        }
    }

##### 统一的参数绑定 #####

// 接收Pojo类型
        @RequestMapping("/update")
        public String update(QueryVo vo) throws Exception{
            vo.items.setCreatetime(new Date());
            itemsService.updateItems(vo.getItems());
    
            return "success";
        }
    
        // 接收数组类型
        @RequestMapping("/delAll")
        public String delAll(QueryVo vo) throws Exception{
            for (String id : vo.ids) {
                System.out.println(id);
            }
            return "success";
        }
    
        // 接收List集合类型
        @RequestMapping("/updateAll")
        public String updateAll(QueryVo vo) throws Exception{
            System.out.println(vo.getItemsList());
            return "success";
        }

## SpringMVC自定义参数绑定 ##

### 创建Date转换器 ###

package com.pc.ssm.web.converter;
    
    import java.text.ParseException;
    import java.text.SimpleDateFormat;
    import java.util.Date;
    
    import org.springframework.core.convert.converter.Converter;
    
    /** * Date自定义参数绑定 * * @author Switch * @data 2017年1月11日 * @version V1.0 */
    public class DateConverter implements Converter<String, Date> { 
    
        @Override
        public Date convert(String source) {
            try {
                return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").parse(source);
            } catch (ParseException e) {
                e.printStackTrace();
            }
            return null;
        }
    }

### 在SpringMVC配置文件中配置 ###

<mvc:annotation-driven conversion-service="conversionService"/>
    
        
        <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
            <property name="converters">
                <set>
                    <bean class="com.pc.ssm.web.converter.DateConverter" />
                </set>
            </property>
        </bean>

PS：自定义参数绑定的用法远不止这么一点，比如想要在获取数据的时候去掉首尾空格，拆分字符串等等都可以用自定义`Converter`实现。

GitHub：[SSMIntegrationDemo][]

[SSMIntegrationDemo]: https://github.com/Switch-vov/SSMIntegrationDemo/