《Spring MVC》第六章 MVC类型转换器、格式化器

た入场券 2023-09-26 21:54 36阅读 0赞

## 系列文章目录 ##

[第一章 MVC模式][MVC]  
[第二章 让程序run起来][_run]  
[第三章 @Controller、@RequestMapping 注解和获取请求参数][_Controller_RequestMapping]  
[第四章 域对象、视图、转发和重定向][Link 1]  
[第五章 第五章 实现RESTful][_ _RESTful]  
[第六章 MVC类型转换器、格式化器][MVC 1]  
[第七章 JSON数据交互][JSON]  
[第八章 拦截器实现权限验证、异常处理][Link 2]  
[第九章 文件上传、下载][Link 3]  
[第十章 使用logback+Slf4j打印日志][_logback_Slf4j]  
[第十一章 单体架构任务调度][Link 4]

--------------------

#### 文章目录 ####

*  系列文章目录
 *  前言
 *  1、使用场景
 *  2、解决步骤
 *   *  2.1、定义Convertor转换器
     *  2.2、springMVC.xml 配置转换器
 *  3、自定义类型转换器
 *  4、内置类型转换器
 *   *  4.1、标量转换器
     *  4.2、集合、数组相关转换器
 *  5、日期和数值格式化格式化注解
 *   *  5.1、@DateTimeFormat 注解主要包含以下 3 个属性。

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

--------------------

## 前言 ##

介绍MVC类型转换器、格式化器

## 1、使用场景 ##

@PostMapping(value = "/register")
    public ModelAndView register(User user){
        
        System.out.println(user.getUserName());
        System.out.println(user.getPassword());
        System.out.println(user.getBirthday());
    
        ModelAndView modelAndView = new ModelAndView();
        //给request对象设置一个属性
        modelAndView.addObject("userName","Tiger");
        //设置跳转的视图
        modelAndView.setViewName("success");
        return modelAndView;
    }

**前端提交：**  
![在这里插入图片描述][625048d5675e4d0791a2e7f80918e3db.png]

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

![在这里插入图片描述][e7dfd81323724076882f66f45d55a49d.png]  
错误是日期类型转换异常。如何解决？

## 2、解决步骤 ##

### 2.1、定义Convertor转换器 ###

package com.hqyj.springmvc.common;
    
    import org.springframework.core.convert.converter.Converter;
    import java.text.ParseException;
    import java.text.SimpleDateFormat;
    import java.util.Date;
    
    public class StringDateConverter implements Converter<String, Date> {
        
    
        public Date convert(String source) {
        
            String format = "yyyy-MM-dd";
            SimpleDateFormat simpleDateFormat = new SimpleDateFormat(format);
            Date parse = null;
            try {
        
                parse = simpleDateFormat.parse(source);
            } catch (ParseException e) {
        
                e.printStackTrace();
            }
            return parse;
        }
        
    }

### 2.2、springMVC.xml 配置转换器 ###

<mvc:annotation-driven conversion-service="conversionService"/>
    <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.hqyj.springmvc.common.StringDateConverter"/>
            </set>
        </property>
    </bean>

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

<table> 
 <thead> 
  <tr> 
   <th align="left">接口</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Converter&lt;S,T&gt;</td> 
   <td align="left">该接口使用了泛型，第一个类型 S 表示原类型，第二个类型 T 表示目标类型，里面定义了一个 convert() 方法，能够将原类型对象作为参数传入，进行转换之后返回目标类型对象。</td> 
  </tr> 
  <tr> 
   <td align="left">ConverterFactory</td> 
   <td align="left">如果我们希望将一种类型的对象转换为另一种类型及其子类对象，例如将 String 转换为 Number 以及 Number 的子类 Integer、Double 等类型的对象，那么就需要一系列的 Converter，如 StringToInteger、StringToDouble 等。ConverterFactory&lt;S,R&gt; 接口的作用就是将这些相同系列的多个 Converter 封装在一起。</td> 
  </tr> 
  <tr> 
   <td align="left">GenericConverter</td> 
   <td align="left">该接口会根据源类对象及目标类对象的上下文信息进行类型转换。</td> 
  </tr> 
 </tbody> 
</table>

## 4、内置类型转换器 ##

### 4.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">ObjectToString</td> 
   <td align="left">ConverterObject 到 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>

### 4.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>

## 5、日期和数值格式化格式化注解 ##

<table> 
 <thead> 
  <tr> 
   <th align="left">格式化注解</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">@DateTimeFormat 注解</td> 
   <td align="left">使用该注解，能够实现对日期类型数据的格式化</td> 
  </tr> 
  <tr> 
   <td align="left">@NumberFormat 注解</td> 
   <td align="left">使用该注解，能够实现对数值类型数据的格式化 2,000,777</td> 
  </tr> 
 </tbody> 
</table>

### 5.1、@DateTimeFormat 注解主要包含以下 3 个属性。 ###

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">类型</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">pattern</td> 
   <td align="left">String</td> 
   <td align="left">用于指定解析或格式化日期时间的模式，其常用取值包括 yyyy-MM-dd、yyyy-MM-dd hh:mm:ss 等。</td> 
  </tr> 
  <tr> 
   <td align="left">iso</td> 
   <td align="left">DateTimeFormat.ISO</td> 
   <td align="left">用于指定解析或格式化日期时间的 ISO 模式，其取值有 4 种： 
    <ul> 
     <li>DATE：yyyy-MM-dd</li> 
     <li>TIME：hh:mm:ss:SSSZ</li> 
     <li>DATE_TIME：yyyy-MM-dd hh:mm:ss:SSSZ</li> 
     <li>NONE：无</li> 
    </ul></td> 
  </tr> 
  <tr> 
   <td align="left">style</td> 
   <td align="left">String</td> 
   <td align="left">用于指定日期时间的格式。<br>该属性由两个字符组成，第一个字符表示日期的格式，第二个字符表示时间的格式。 
    <ul> 
     <li>S：短日期/时间格式</li> 
     <li>M：中日期/时间格式</li> 
     <li>L：长日期/时间格式</li> 
     <li>F：完整日期/时间格式</li> 
     <li> 其默认值为“SS”，即日期和时间都采用短格式。</li> 
    </ul></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <thead> 
  <tr> 
   <th align="left">描述</th> 
   <th align="left">字符串值</th> 
   <th align="left">示例输出</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">短格式（这是缺省值）</td> 
   <td align="left">SS</td> 
   <td align="left">8/30/64 11:24 AM</td> 
  </tr> 
  <tr> 
   <td align="left">中等格式</td> 
   <td align="left">MM</td> 
   <td align="left">Aug 30, 1964 11:24:41 AM</td> 
  </tr> 
  <tr> 
   <td align="left">长格式</td> 
   <td align="left">LL</td> 
   <td align="left">August 30, 1964 11:24:41 AM CDT</td> 
  </tr> 
  <tr> 
   <td align="left">完整格式</td> 
   <td align="left">FF</td> 
   <td align="left">Sunday, August 30, 1964 11:24:41 AM CDT</td> 
  </tr> 
  <tr> 
   <td align="left">使用短横线省略日期或时间</td> 
   <td align="left">M-</td> 
   <td align="left">Aug 30, 1964</td> 
  </tr> 
 </tbody> 
</table>

@NumberFormat 注解拥有两个互斥的属性，如下表。

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">类型</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">style</td> 
   <td align="left">NumberFormat.Style</td> 
   <td align="left">该属性用于指定数值的样式类型，其取值有以下 4 种：DEFAULT：默认类型NUMBER：正常数值类型PERCENT：百分数类型CURRENCY：货币数值类型</td> 
  </tr> 
  <tr> 
   <td align="left">pattern</td> 
   <td align="left">String</td> 
   <td align="left">该属性用于自定义数值的样式星星，例如 #,###</td> 
  </tr> 
 </tbody> 
</table>

[MVC]: https://blog.csdn.net/s445320/article/details/130258278
[_run]: https://blog.csdn.net/s445320/article/details/130262162
[_Controller_RequestMapping]: https://blog.csdn.net/s445320/article/details/130269635
[Link 1]: https://blog.csdn.net/s445320/article/details/130280198
[_ _RESTful]: https://blog.csdn.net/s445320/article/details/130281010
[MVC 1]: https://blog.csdn.net/s445320/article/details/130283399
[JSON]: https://blog.csdn.net/s445320/article/details/130356789
[Link 2]: https://blog.csdn.net/s445320/article/details/130377972
[Link 3]: https://blog.csdn.net/s445320/article/details/130378084
[_logback_Slf4j]: https://blog.csdn.net/s445320/article/details/130481373
[Link 4]: https://blog.csdn.net/s445320/article/details/130559857
[eecd1e293648421393277d3c4e3b430d.png]: https://img-blog.csdnimg.cn/eecd1e293648421393277d3c4e3b430d.png
[625048d5675e4d0791a2e7f80918e3db.png]: https://img-blog.csdnimg.cn/625048d5675e4d0791a2e7f80918e3db.png
[9609f92a48e2441d8f49e591cf910a29.png]: https://img-blog.csdnimg.cn/9609f92a48e2441d8f49e591cf910a29.png
[e7dfd81323724076882f66f45d55a49d.png]: https://img-blog.csdnimg.cn/e7dfd81323724076882f66f45d55a49d.png