深入分析Spring Formatter

  在Web项目中,通常需要将数据转换为具有某种格式的字符串进行展示,因此Spring3引入了格式化转换器(Formatter SPI) 和格式化服务API(FormattingConversionService)从而支持这种需求。现在来看看格式转换器相关的接口定义:

  • Printer接口:格式化显示接口,将T类型的对象根据Locale信息以某种格式进行打印显示(即返回字符串形式),源码如下图所示:
package org.springframework.format;

import java.util.Locale;

public interface Printer<T> {
        //将Objct转成String
    String print(T object, Locale locale);
}
  • Parser接口:解析接口,根据Locale信息解析字符串到T类型的对象;
package org.springframework.format;

import java.text.ParseException;
import java.util.Locale;

public interface Parser<T> {
  //根据text转成T对象
    T parse(String text, Locale locale) throws ParseException;

}

从这两个接口定义中我们可以很清晰的看出定义了两个相反的接口。而下面的接口却同时继承了上面的两个接口。Formatter接口:格式化SPI接口,继承Printer和Parser接口,完成T类型对象的格式化和解析功能;源码如下:

package org.springframework.format;

public interface Formatter<T> extends Printer<T>, Parser<T> {

}

Formatter接口体系是如何融入到Converter体系的呢,从上面接口的定义我们可以认为Print接口是将任意类型换成String类型的converter,而Parser接口是将String类型转换成任意类型的converter。在Spring内部实现上也是这么做的,下面是ParserConverter的类定义,关键的信息有相应的注释,这个类定义在FormattingConversionService这个类中,代码如下图所示:

而Printer的显示内部也是转成PrinterConverter,这个类的定义也在FormattingConversionService类中。这两个类都是private类型的,从这也可以看出这些类只是用于spring内部逻辑的处理,外部是不能够使用的。关键代码如下:

FormattingConversionService

FormattingConversionService这个类又是用来作什么的呢,我们先看这个类的继承结构,如下图所示:

从上图可以看出FormattingConversionService继承了ConversionService,自然就有ConversionService体系的一系列方法了。在FormattingConversionService内部会将Printer和Parser转成他内部实现的Converter。我们来看看源码是如何做的吧,源代码如下:

通过上面的分析能够很清晰的看出用的还是Spring Conversion的转换体系。

DateTimeFormat

  有过Web开发经验的应该都用过@DateTimeFormat注解用于将特定格式的String转成Data类型吧。Spring为了支持注解类型的parse和print定义了AnnotationFormatterFactory接口以下是源码:

来看看Spring内部用的DateTimeFormat的Factory是如何实现的吧,以下是源代码,关键实现点有相应的说明,如下图所示:
对于AnnotationFormatterFactory类型FormattingConversionService内部又是如何处理的呢,其实还是把AnnotationFormatterFactory转成内部使用的Coverter。来看看AnnotationParserConverter的源码,如下图所示:
对于格式化Printer类型源码也差不多,只是在convert方法内部调用的方法不一样而以,以下是相应的源码和描述:
FormattingConversionService内部构建相应Converter的代码如下所示:

总结:
Formatter会转成Converter体系进行类型转换

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • IoC 容器 Bean 的作用域 自定义作用域实现 org.springframework.beans.facto...
    Hsinwong阅读 2,517评论 0 7
  • Spring Web MVC Spring Web MVC 是包含在 Spring 框架中的 Web 框架,建立于...
    Hsinwong阅读 22,600评论 1 92
  • 1、通过CocoaPods安装项目名称项目信息 AFNetworking网络请求组件 FMDB本地数据库组件 SD...
    阳明AI阅读 16,019评论 3 119
  • 【1月4日 369/3650 】 1,【(效能)】全勤,今日吃青蛙*3。 2,【(健康)】鼻塞塞到不想说话,1月运...
    佩娜阅读 157评论 0 0
  • [幸福路人 宋艳俊 平顶山郏县 坚持分享第278天 2018、5.18] 在孩子的成长过程中,家庭教育是重要的环节...
    简单男孩阅读 212评论 0 1