🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
# 第四章 Controller接口控制器详解(6)——跟着开涛学SpringMVC ### [第一章 Web MVC简介 —— 跟开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1593441 "第一章 Web MVC简介 —— 跟开涛学SpringMVC") ### [第二章 Spring MVC入门 —— 跟开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1594806 "第二章 Spring MVC入门 —— 跟开涛学SpringMVC ") ### [第三章 DispatcherServlet详解 ——跟开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1602617 "第三章 DispatcherServlet详解 ——跟开涛学SpringMVC") ### [第四章 Controller接口控制器详解(1)——跟着开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1608234 "第四章 Controller接口控制器详解(1)——跟着开涛学SpringMVC") ### [第四章 Controller接口控制器详解(2)——跟着开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1611743 "第四章 Controller接口控制器详解(2)——跟着开涛学SpringMVC") ### [第四章 Controller接口控制器详解(3)——跟着开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1622684 "第四章 Controller接口控制器详解(3)——跟着开涛学SpringMVC") ### [第四章 Controller接口控制器详解(4)——跟着开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1629956 "第四章 Controller接口控制器详解(4)——跟着开涛学SpringMVC") ### [第四章 Controller接口控制器详解(5)——跟着开涛学SpringMVC](http://jinnianshilongnian.iteye.com/blog/1630585 "第四章 Controller接口控制器详解(5)——跟着开涛学SpringMVC") ### [第四章 Controller接口控制器详解(6)——跟着开涛学SpringMVC](http://www.iteye.com/blogs/subjects/records/1594 "第四章 Controller接口控制器详解(6)——跟着开涛学SpringMVC") ## 4.16、数据类型转换和数据验证 ![](https://box.kancloud.cn/2016-05-15_5737edd82363e.JPG) **流程:** 1、首先创建数据绑定器,在此此会创建ServletRequestDataBinder类的对象,并设置messageCodesResolver(错误码解析器); 2、提供第一个扩展点,初始化数据绑定器,在此处我们可以覆盖该方法注册自定义的PropertyEditor(请求参数——&gt;命令对象属性的转换); 3、进行数据绑定,即请求参数——&gt;命令对象的绑定; 4、提供第二个扩展点,数据绑定完成后的扩展点,此处可以实现一些自定义的绑定动作; 5、验证器对象的验证,验证器通过validators注入,如果验证失败,需要把错误信息放入Errors(此处使用BindException实现); 6、提供第三个扩展点,此处可以实现自定义的绑定/验证逻辑; 7、将errors传入功能处理方法进行处理,功能方法应该判断该错误对象是否有错误进行相应的处理。 ### 4.16.1、数据类型转换 请求参数(String)——&gt;命令对象属性(可能是任意类型)的类型转换,即数据绑定时的类型转换,使用PropertyEditor实现绑定时的类型转换。 **一、Spring内建的PropertyEditor如下所示:** | **类名** | **说明** | **默认是否注册** | | --- | --- | --- | | ByteArrayPropertyEditor | String&lt;——&gt;byte[] | √ | | ClassEditor | String&lt;——&gt;Class当类没有发现抛出`IllegalArgumentException` | √ | | CustomBooleanEditor | String&lt;——&gt;Booleantrue/yes/on/1转换为true,false/no/off/0转换为false | √ | | CustomCollectionEditor | 数组/Collection——&gt;Collection普通值——&gt;Collection(只包含一个对象)如String——&gt;Collection不允许Collection——&gt;String(单方向转换) | √ | | CustomNumberEditor | String&lt;——&gt;Number(Integer、Long、Double) | √ | | FileEditor | String&lt;——&gt;File | √ | | InputStreamEditor | String——&gt;InputStream单向的,不能InputStream——&gt;String | √ | | LocaleEditor | String&lt;——&gt;Locale,(String的形式为[语言]_[国家]_[变量],这与Local对象的toString()方法得到的结果相同) | √ | | PatternEditor | String&lt;——&gt;Pattern | √ | | PropertiesEditor | String&lt;——&gt;java.lang.Properties | √ | | URLEditor | String&lt;——&gt;URL | √ | | StringTrimmerEditor | 一个用于trim 的 String类型的属性编辑器如默认删除两边的空格,charsToDelete属性:可以设置为其他字符emptyAsNull属性:将一个空字符串转化为null值的选项。 | × | | CustomDateEditor | String&lt;——&gt;java.util.Date | × | **二、Spring内建的PropertyEditor支持的属性(符合JavaBean规范)操作:** | **表达式** | **设值/取值说明** | | --- | --- | --- | | username | 属性username设值方法setUsername()/取值方法getUsername() 或 isUsername() | | schooInfo.schoolType | 属性schooInfo的嵌套属性schoolType设值方法getSchooInfo().setSchoolType()/取值方法getSchooInfo().getSchoolType() | | hobbyList[0] | 属性hobbyList的第一个元素索引属性可能是一个数组、列表、其它天然有序的容器。 | | map[key] | 属性map(java.util.Map类型)map中key对应的值 | **三、示例:** 接下来我们写自定义的属性编辑器进行数据绑定: **(1、模型对象:** ``` package cn.javass.chapter4.model; //省略import public class DataBinderTestModel { private String username; private boolean bool;//Boolean值测试 private SchoolInfoModel schooInfo; private List hobbyList;//集合测试,此处可以改为数组/Set进行测试 private Map map;//Map测试 private PhoneNumberModel phoneNumber;//String->自定义对象的转换测试 private Date date;//日期类型测试 private UserState state;//String——>Enum类型转换测试 //省略getter/setter } package cn.javass.chapter4.model; //如格式010-12345678 public class PhoneNumberModel { private String areaCode;//区号 private String phoneNumber;//电话号码 //省略getter/setter } ``` **(2、PhoneNumber属性编辑器** 前台输入如010-12345678自动转换为PhoneNumberModel。 ``` package cn.javass.chapter4.web.controller.support.editor; //省略import public class PhoneNumberEditor extends PropertyEditorSupport { Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$"); @Override public void setAsText(String text) throws IllegalArgumentException { if(text == null || !StringUtils.hasLength(text)) { setValue(null); //如果没值,设值为null } Matcher matcher = pattern.matcher(text); if(matcher.matches()) { PhoneNumberModel phoneNumber = new PhoneNumberModel(); phoneNumber.setAreaCode(matcher.group(1)); phoneNumber.setPhoneNumber(matcher.group(2)); setValue(phoneNumber); } else { throw new IllegalArgumentException(String.format("类型转换失败,需要格式[010-12345678],但格式是[%s]", text)); } } @Override public String getAsText() { PhoneNumberModel phoneNumber = ((PhoneNumberModel)getValue()); return phoneNumber == null ? "" : phoneNumber.getAreaCode() + "-" + phoneNumber.getPhoneNumber(); } } ``` **PropertyEditorSupport:**一个PropertyEditor的支持类; **setAsText:**表示将String——&gt;PhoneNumberModel,根据正则表达式进行转换,如果转换失败抛出异常,则接下来的验证器会进行验证处理; **getAsText:**表示将PhoneNumberModel——&gt;String。 **(3、控制器** 需要在控制器注册我们自定义的属性编辑器。 此处我们使用AbstractCommandController,因为它继承了BaseCommandController,拥有绑定流程。 ``` package cn.javass.chapter4.web.controller; //省略import public class DataBinderTestController extends AbstractCommandController { public DataBinderTestController() { setCommandClass(DataBinderTestModel.class); //设置命令对象 setCommandName("dataBinderTest");//设置命令对象的名字 } @Override protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Object command, BindException errors) throws Exception { //输出command对象看看是否绑定正确 System.out.println(command); return new ModelAndView("bindAndValidate/success").addObject("dataBinderTest", command); } @Override protected void initBinder(HttpServletRequest request, ServletRequestDataBinder binder) throws Exception { super.initBinder(request, binder); //注册自定义的属性编辑器 //1、日期 DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); CustomDateEditor dateEditor = new CustomDateEditor(df, true); //表示如果命令对象有Date类型的属性,将使用该属性编辑器进行类型转换 binder.registerCustomEditor(Date.class, dateEditor); //自定义的电话号码编辑器 binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor()); } } ``` **initBinder:**第一个扩展点,初始化数据绑定器,在此处我们注册了两个属性编辑器; **CustomDateEditor:**自定义的日期编辑器,用于在String&lt;——&gt;日期之间转换; binder.registerCustomEditor(Date.**class**, dateEditor):表示如果命令对象是Date类型,则使用dateEditor进行类型转换; **PhoneNumberEditor:**自定义的电话号码属性编辑器用于在String&lt;——&gt; PhoneNumberModel之间转换; binder.registerCustomEditor(PhoneNumberModel.**class**, **new**PhoneNumberEditor()):表示如果命令对象是PhoneNumberModel类型,则使用PhoneNumberEditor进行类型转换; `**(4、spring配置文件chapter4-servlet.xml**` ``` <bean name="/dataBind" class="cn.javass.chapter4.web.controller.DataBinderTestController"/> ``` **(5、视图页面(WEB-INF/jsp/bindAndValidate/success.jsp)** ``` EL phoneNumber:${dataBinderTest.phoneNumber}<br/> EL state:${dataBinderTest.state}<br/> EL date:${dataBinderTest.date}<br/> ``` 视图页面的数据没有预期被格式化,如何进行格式化显示呢?请参考【第七章  注解式控制器的数据验证、类型转换及格式化】。 **(6、测试:** **1、在浏览器地址栏输入请求的URL,如** http://localhost:9080/springmvc-chapter4/dataBind?username=zhang&bool=yes&schooInfo.specialty=computer&hobbyList[0]=program&hobbyList[1]=music&map[key1]=value1&map[key2]=value2&phoneNumber=010-12345678&date=2012-3-18 16:48:48&state=blocked **2、控制器输出的内容:** DataBinderTestModel [username=zhang, bool=true, schooInfo=SchoolInfoModel [schoolType=null, schoolName=null, specialty=computer], hobbyList=[program, music], map={key1=value1, key2=value2}, phoneNumber=PhoneNumberModel [areaCode=010, phoneNumber=12345678], date=Sun Mar 18 16:48:48 CST 2012, state=锁定] 类型转换如图所示: ![](https://box.kancloud.cn/2016-05-15_5737edd8424b3.JPG) **四、注册PropertyEditor** **1、使用WebDataBinder进行控制器级别注册PropertyEditor(控制器独享)** 如“【三、示例】”中所使用的方式,使用WebDataBinder注册控制器级别的PropertyEditor,这种方式注册的PropertyEditor只对当前控制器独享,即其他的控制器不会自动注册这个PropertyEditor,如果需要还需要再注册一下。 **2、使用**`**WebBindingInitializer批量注册**`**PropertyEditor** 如果想在多个控制器同时注册多个相同的PropertyEditor时,可以考虑使用WebBindingInitializer。 示例: (1、实现WebBindingInitializer ``` package cn.javass.chapter4.web.controller.support.initializer; //省略import public class MyWebBindingInitializer implements WebBindingInitializer { @Override public void initBinder(WebDataBinder binder, WebRequest request) { //注册自定义的属性编辑器 //1、日期 DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); CustomDateEditor dateEditor = new CustomDateEditor(df, true); //表示如果命令对象有Date类型的属性,将使用该属性编辑器进行类型转换 binder.registerCustomEditor(Date.class, dateEditor); //自定义的电话号码编辑器 binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor()); } } ``` 通过实现WebBindingInitializer并通过binder注册多个PropertyEditor。 (2、修改【三、示例】中的DataBinderTestController,注释掉initBinder方法; (3、修改chapter4-servlet.xml配置文件: ``` <!-- 注册WebBindingInitializer实现 --> <bean id="myWebBindingInitializer" class="cn.javass.chapter4.web.controller.support.initializer.MyWebBindingInitializer"/> <bean name="/dataBind" class="cn.javass.chapter4.web.controller.DataBinderTestController"> <!-- 注入WebBindingInitializer实现 --> <property name="webBindingInitializer" ref="myWebBindingInitializer"/> </bean> ``` (4、尝试访问“【三、示例】”中的测试URL即可成功。 使用WebBindingInitializer的好处是当你需要在多个控制器中需要同时使用多个相同的PropertyEditor可以在WebBindingInitializer实现中注册,这样只需要在控制器中注入WebBindingInitializer即可注入多个PropertyEditor。 **3、全局级别注册PropertyEditor(全局共享)** 只需要将我们自定义的PropertyEditor放在和你的模型类同包下即可,且你的Editor命名规则必须是“模型类名Editor”,这样Spring会自动使用标准JavaBean架构进行自动识别,如图所示: ![](https://box.kancloud.cn/2016-05-15_5737edd85a7d3.JPG) 此时我们把“DataBinderTestController”的“binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor());”注释掉,再尝试访问“【三、示例】”中的测试URL即可成功。 这种方式不仅仅在使用Spring时可用,在标准的JavaBean等环境都是可用的,可以认为是全局共享的(不仅仅是Spring环境)。 **PropertyEditor被限制为只能String&lt;——&gt;Object之间转换,不能Object&lt;——&gt;Object,Spring3提供了更强大的类型转换(Type**`**Conversion)支持,它可以在任意对象之间进行类型转换,不仅仅是String**`**&lt;**`**——&gt;Object。**` 如果我在地址栏输入错误的数据,即数据绑定失败,Spring Web MVC该如何处理呢?如果我输入的数据不合法呢?如用户名输入100个字符(超长了)那又该怎么处理呢?出错了需要错误消息,那错误消息应该是硬编码?还是可配置呢? 接下来我们来学习一下数据验证器进行数据验证吧。 [私塾在线学习网](http://sishuok.com/)原创内容([http://sishuok.com](http://sishuok.com/)) 原创内容,转载请注明私塾在线【[http://sishuok.com/forum/blogPost/list/5677.html](http://sishuok.com/forum/blogPost/list/0/5514.html)】