SpringMVC--Converter（类型转换器）详解

╰+攻爆jí腚メ 2021-08-13 17:26 502阅读 0赞

#### Spring MVC Converter ####

Spring MVC 框架的 Converter<S，T> 是一个可以将一种数据类型转换成另一种数据类型的接口，这里 S 表示源类型，T 表示目标类型。开发者在实际应用中使用框架内置的类型转换器基本上就够了，但有时需要编写具有特定功能的类型转换器。

#### 内置的类型转换器 ####

在 Spring MVC 框架中，对于常用的数据类型，开发者无须创建自己的类型转换器，因为 Spring MVC 框架有许多内置的类型转换器用于完成常用的类型转换。Spring MVC 框架提供的内置类型转换包括以下几种类型。

**1）标量转换器**

<table> 
 <thead> 
  <tr> 
   <th align="left">名称</th> 
   <th align="left">作用</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">StringToBooleanConverter</td> 
   <td align="left">String 到 boolean 类型转换</td> 
  </tr> 
  <tr> 
   <td align="left">ObjectToStringConverter</td> 
   <td align="left">Object 到 String 转换，调用 toString 方法转换</td> 
  </tr> 
  <tr> 
   <td align="left">StringToNumberConverterFactory</td> 
   <td align="left">String 到数字转换（例如 Integer、Long 等）</td> 
  </tr> 
  <tr> 
   <td align="left">NumberToNumberConverterFactory</td> 
   <td align="left">数字子类型（基本类型）到数字类型（包装类型）转换</td> 
  </tr> 
  <tr> 
   <td align="left">StringToCharacterConverter</td> 
   <td align="left">String 到 Character 转换，取字符串中的第一个字符</td> 
  </tr> 
  <tr> 
   <td align="left">NumberToCharacterConverter</td> 
   <td align="left">数字子类型到 Character 转换</td> 
  </tr> 
  <tr> 
   <td align="left">CharacterToNumberFactory</td> 
   <td align="left">Character 到数字子类型转换</td> 
  </tr> 
  <tr> 
   <td align="left">StringToEnumConverterFactory</td> 
   <td align="left">String 到枚举类型转换，通过 Enum.valueOf 将字符串转换为需要的枚举类型</td> 
  </tr> 
  <tr> 
   <td align="left">EnumToStringConverter</td> 
   <td align="left">枚举类型到 String 转换，返回枚举对象的 name 值</td> 
  </tr> 
  <tr> 
   <td align="left">StringToLocaleConverter</td> 
   <td align="left">String 到 java.util.Locale 转换</td> 
  </tr> 
  <tr> 
   <td align="left">PropertiesToStringConverter</td> 
   <td align="left">java.util.Properties 到 String 转换，默认通过 ISO-8859-1 解码</td> 
  </tr> 
  <tr> 
   <td align="left">StringToPropertiesConverter</td> 
   <td align="left">String 到 java.util.Properties 转换，默认使用 ISO-8859-1 编码</td> 
  </tr> 
 </tbody> 
</table>

**2）集合、数组相关转换器**

<table> 
 <thead> 
  <tr> 
   <th align="left">名称</th> 
   <th align="left">作用</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">ArrayToCollectionConverter</td> 
   <td align="left">任意数组到任意集合（List、Set）转换</td> 
  </tr> 
  <tr> 
   <td align="left">CollectionToArrayConverter</td> 
   <td align="left">任意集合到任意数组转换</td> 
  </tr> 
  <tr> 
   <td align="left">ArrayToArrayConverter</td> 
   <td align="left">任意数组到任意数组转换</td> 
  </tr> 
  <tr> 
   <td align="left">CollectionToCollectionConverter</td> 
   <td align="left">集合之间的类型转换</td> 
  </tr> 
  <tr> 
   <td align="left">MapToMapConverter</td> 
   <td align="left">Map之间的类型转换</td> 
  </tr> 
  <tr> 
   <td align="left">ArrayToStringConverter</td> 
   <td align="left">任意数组到 String 转换</td> 
  </tr> 
  <tr> 
   <td align="left">StringToArrayConverter</td> 
   <td align="left">字符串到数组的转换，默认通过“，”分割，且去除字符串两边的空格（trim）</td> 
  </tr> 
  <tr> 
   <td align="left">ArrayToObjectConverter</td> 
   <td align="left">任意数组到 Object 的转换，如果目标类型和源类型兼容，直接返回源对象；否则返回数组的第一个元素并进行类型转换</td> 
  </tr> 
  <tr> 
   <td align="left">ObjectToArrayConverter</td> 
   <td align="left">Object 到单元素数组转换</td> 
  </tr> 
  <tr> 
   <td align="left">CollectionToStringConverter</td> 
   <td align="left">任意集合（List、Set）到 String 转换</td> 
  </tr> 
  <tr> 
   <td align="left">StringToCollectionConverter</td> 
   <td align="left">String 到集合（List、Set）转换，默认通过“，”分割，且去除字符串两边的空格（trim）</td> 
  </tr> 
  <tr> 
   <td align="left">CollectionToObjectConverter</td> 
   <td align="left">任意集合到任意 Object 的转换，如果目标类型和源类型兼容，直接返回源对象；否则返回集合的第一个元素并进行类型转换</td> 
  </tr> 
  <tr> 
   <td align="left">ObjectToCollectionConverter</td> 
   <td align="left">Object 到单元素集合的类型转换</td> 
  </tr> 
 </tbody> 
</table>

类型转换是在视图与控制器相互传递数据时发生的。Spring MVC 框架对于基本类型（例如 int、long、float、double、boolean 以及 char 等）已经做好了基本类型转换。

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

当 Spring MVC 框架内置的类型转换器不能满足需求时，开发者可以开发自己的类型转换器。

例如有一个应用 springMVCDemo 希望用户在页面表单中输入信息来创建商品信息。当输入“apple，10.58，200”时表示在程序中自动创建一个 new Goods，并将“apple”值自动赋给 goodsname 属性，将“10.58”值自动赋给 goodsprice 属性，将“200”值自动赋给 goodsnumber 属性。

**1）创建实体类**

package pers.zhang.pojo;
    
    public class GoodsModel { 
        private String goodsname;
        private double goodsprice;
        private int goodsnumber;
        
    	public String getGoodsname() { 
    		return goodsname;
    	}
    	public void setGoodsname(String goodsname) { 
    		this.goodsname = goodsname;
    	}
    	public double getGoodsprice() { 
    		return goodsprice;
    	}
    	public void setGoodsprice(double goodsprice) { 
    		this.goodsprice = goodsprice;
    	}
    	public int getGoodsnumber() { 
    		return goodsnumber;
    	}
    	public void setGoodsnumber(int goodsnumber) { 
    		this.goodsnumber = goodsnumber;
    	}
        
    }

**2）创建控制器类**

package pers.zhang.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.ui.Model;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    
    import pers.zhang.pojo.GoodsModel;
    
    
    @Controller
    @RequestMapping("/my")
    public class ConverterController { 
    	
        @RequestMapping("/converter")
        /* * 使用@RequestParam * ("goods")接收请求参数，然后调用自定义类型转换器GoodsConverter将字符串值转换为GoodsModel的对象gm */
        public String myConverter(@RequestParam("goods") GoodsModel gm, Model model) { 
            model.addAttribute("goods", gm);
            return "showGoods";
        }
    }

**3）创建自定义类型转换器类**  
自定义类型转换器类需要实现 Converter<S,T> 接口，重写 convert(S) 接口方法。

convert(S) 方法的功能是将源数据类型 S 转换成目标数据类型 T。

package pers.zhang.converter;
    
    import org.springframework.core.convert.converter.Converter;
    
    import pers.zhang.pojo.GoodsModel;
    
    public class GoodsConverter implements Converter<String, GoodsModel> { 
    
    	@Override
    	public GoodsModel convert(String source) { 
    		// 创建一个Goods实例
    	    GoodsModel goods = new GoodsModel();
    	    // 以“，”分隔
    	    String stringvalues[] = source.split(",");
    	    if (stringvalues != null && stringvalues.length == 3) { 
    	        // 为Goods实例赋值
    	        goods.setGoodsname(stringvalues[0]);
    	        goods.setGoodsprice(Double.parseDouble(stringvalues[1]));
    	        goods.setGoodsnumber(Integer.parseInt(stringvalues[2]));
    	        return goods;
    	    } else { 
    	        throw new IllegalArgumentException(String.format(
    	                "类型转换失败， 需要格式'apple, 10.58,200 ',但格式是[% s ] ", source));
    	    }
    	}
        
        
    }

**4）注册类型转换器**

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    	
        
        
        <context:component-scan base-package="pers.zhang.controller" />
        
        
        <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
            <property name="converters">
                <list>
                    <bean class="pers.zhang.converter.GoodsConverter"/>
                </list>
            </property>
        </bean>
        <mvc:annotation-driven conversion-service="conversionService"/>
        
        
        <mvc:resources location="/css/" mapping="/css/**" />
        
        <mvc:resources location="/html/" mapping="/html/**" />
        
        <mvc:resources location="/images/" mapping="/images/**" />
        
        
        
        
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="prefix" value="/WEB-INF/jsp/" />
            <property name="suffix" value=".jsp" />
        </bean>
    </beans>

**5）创建相关视图**  
input.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
        pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html>
    <head>
    <meta charset="UTF-8">
    <title>Insert title here</title>
    </head>
    <body>
    	<form action="${pageContext.request.contextPath}/my/converter" method= "post">
    	    请输入商品信息（格式为apple, 10.58,200）:
    	    <input type="text" name="goods" /><br>
    	    <input type="submit" value="提交" />
    	</form>
    </body>
    </html>

showGoods.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
        pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html>
    <head>
    <meta charset="UTF-8">
    <title>Insert title here</title>
    </head>
    <body>
        您创建的商品信息如下：
        
        商品名称为:${goods.goodsname }
        商品价格为:${goods.goodsprice }
        商品名称为:${goods.goodsnumber }
    </body>
    </html>

**6）测试**  
![在这里插入图片描述][20191031160651924.png]

![在这里插入图片描述][20191031161040644.png]

[20191031160651924.png]: /images/20210813/5621946634d84323a72100a2ce4786fa.png
[20191031161040644.png]: /images/20210813/cf4c8586d4bf4354968dc112fd29848a.png