SpringFrameworkJava 杂谈阿里云

深入分析Spring Formatter

2018-07-24  本文已影响17人  良辰美景TT

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

package org.springframework.format;

import java.util.Locale;

public interface Printer<T> {
        //将Objct转成String
    String print(T object, Locale locale);
}
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体系进行类型转换
上一篇下一篇

猜你喜欢

热点阅读