你好，我是A哥(YourBatman)。

上篇文章介绍了java.text.Format格式化体系，作为JDK 1.0就提供的格式化器，除了设计上存在肯定缺点，过于底层无奈标准化对使用者不够敌对，这都是对格式化器提出的更高要求。Spring作为Java开发的规范基建，本文就来看看它做了哪些补充。

本文提纲

版本约定

Spring Framework：5.3.x
Spring Boot：2.4.x

✍注释

在利用中（特地是web利用），咱们常常须要将前端/Client端传入的字符串转换成指定格局/指定数据类型，同样的服务端也心愿能把指定类型的数据依照指定格局 返回给前端/Client端，这种状况下Converter曾经无奈满足咱们的需要了。为此，Spring提供了格式化模块专门用于解决此类问题。

首先能够从宏观上先看看spring-context对format模块的目录构造安顿：

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

能够看到，该接口自身没有任何办法，而是聚合了另外两个接口Printer和Parser。

Printer&Parser

这两个接口是相同性能的接口。

Printer：格式化显示（输入）接口。将T类型转为String模式，Locale用于管制国际化

@FunctionalInterfacepublic interface Printer<T> {    // 将Object写为String类型    String print(T object, Locale locale);}

Parser：解析接口。将String类型转到T类型，Locale用于管制国际化。

@FunctionalInterfacepublic interface Parser<T> {    T parse(String text, Locale locale) throws ParseException;}

Formatter

格式化器接口，它的继承树如下：

由图可见，格式化动作只需关怀到两个畛域：

工夫日期畛域
数字畛域（其中包含货币）

工夫日期格式化

Spring框架从4.0开始反对Java 8，针对JSR 310日期工夫类型的格式化专门有个包org.springframework.format.datetime.standard：

值得一提的是：在Java 8进去之前，Joda-Time是Java日期工夫解决最好的解决方案，应用宽泛，甚至失去了Spring内置的反对。当初Java 8未然成为支流，JSR 310日期工夫API 齐全能够 代替Joda-Time（JSR 310的贡献者其实就是Joda-Time的作者们）。因而joda库也逐步辞别历史舞台，后续代码中不再举荐应用，本文也会选择性疏忽。

除了Joda-Time外，Java中对工夫日期的格式化还需分为这两大阵营来解决：

Date类型

尽管曾经2020年了（Java 8于2014年公布），但谈到工夫日期那必然还是得有java.util.Date，毕竟积重难返。所以呢，Spring提供了DateFormatter用于反对它的格式化。

因为Date早就存在，所以DateFormatter是随同着Formatter的呈现而呈现，@since 3.0

// @since 3.0public class DateFormatter implements Formatter<Date> {    private static final TimeZone UTC = TimeZone.getTimeZone("UTC");    private static final Map<ISO, String> ISO_PATTERNS;    static {        Map<ISO, String> formats = new EnumMap<>(ISO.class);        formats.put(ISO.DATE, "yyyy-MM-dd");        formats.put(ISO.TIME, "HH:mm:ss.SSSXXX");        formats.put(ISO.DATE_TIME, "yyyy-MM-dd'T'HH:mm:ss.SSSXXX");        ISO_PATTERNS = Collections.unmodifiableMap(formats);    }}

默认应用的TimeZone是UTC标准时区，ISO_PATTERNS代表ISO规范模版，这和@DateTimeFormat注解的iso属性是一一对应的。也就是说如果你不想指定pattern，能够疾速通过指定ISO来实现。

另外，对于格式化器来说有这些属性你都能够自在去定制：

DateFormatter：    @Nullable    private String pattern;    private int style = DateFormat.DEFAULT;    @Nullable    private String stylePattern;    @Nullable    private ISO iso;    @Nullable    private TimeZone timeZone;

它对Formatter接口办法的实现如下：

DateFormatter：    @Override    public String print(Date date, Locale locale) {        return getDateFormat(locale).format(date);    }    @Override    public Date parse(String text, Locale locale) throws ParseException {        return getDateFormat(locale).parse(text);    }    // 依据pattern、ISO等等失去一个DateFormat实例    protected DateFormat getDateFormat(Locale locale) { ... }

能够看到不论输出还是输入，底层依赖的都是JDK的java.text.DateFormat（理论为SimpleDateFormat），当初晓得为毛上篇文章要先讲JDK的格式化体系做铺垫了吧，万变不离其宗。

因而能够认为，Spring为此做的事件的外围，只不过是写了个依据Locale、pattern、IOS等参数生成DateFormat实例的逻辑而已，属于利用层面的封装。也就是须要通晓getDateFormat()办法的逻辑，此局部逻辑绘制成图如下：

因而：pattern、iso、stylePattern它们的优先级谁先谁后，一看便知。

代码示例

@Testpublic void test1() {    DateFormatter formatter = new DateFormatter();        Date currDate = new Date();    System.out.println("默认输入格局：" + formatter.print(currDate, Locale.CHINA));    formatter.setIso(DateTimeFormat.ISO.DATE_TIME);    System.out.println("指定ISO输入格局：" + formatter.print(currDate, Locale.CHINA));    formatter.setPattern("yyyy-mm-dd HH:mm:ss");    System.out.println("指定pattern输入格局：" + formatter.print(currDate, Locale.CHINA));}

运行程序，输入：

默认输入格局：2020-12-26指定ISO输入格局：2020-12-26T13:06:52.921Z指定pattern输入格局：2020-06-26 21:06:52

留神：ISO格局输入的工夫，是存在时差问题的，因为它应用的是UTC工夫，请稍加留神。

还记得本系列后面介绍的CustomDateEditor这个属性编辑器吗？它也是用于对String -> Date的转化，底层依赖也是JDK的DateFormat，但应用灵便度上没这个自在，已被摈弃/取代。

对于java.util.Date类型的格式化，在此，苦口婆心的号召一句：如果你是新我的项目，请全我的项目禁用Date类型吧；如果你是新代码，也请不要再应用Date类型，太拖后腿了。

JSR 310类型

JSR 310日期工夫类型是Java8引入的一套全新的工夫日期API。新的工夫及日期API位于java.time中，此包中的是类是不可变且线程平安的。上面是一些要害类

Instant——代表的是工夫戳（另外可参考Clock类）
LocalDate——不蕴含具体工夫的日期，如2020-12-12。它能够用来存储生日，周年纪念日，入职日期等
LocalTime——代表的是不含日期的工夫，如18:00:00
LocalDateTime——蕴含了日期及工夫，不过没有偏移信息或者说时区
ZonedDateTime——蕴含时区的残缺的日期工夫还有时区，偏移量是以UTC/格林威治工夫为基准的
Timezone——时区。在新API中时区应用ZoneId来示意。时区能够很不便的应用静态方法of来获取到

同时还有一些辅助类，如：Year、Month、YearMonth、MonthDay、Duration、Period等等。

从上图Formatter的继承树来看，Spring只提供了一些辅助类的格式化器实现，如MonthFormatter、PeriodFormatter、YearMonthFormatter等，且实现形式都是趋同的：

class MonthFormatter implements Formatter<Month> {    @Override    public Month parse(String text, Locale locale) throws ParseException {        return Month.valueOf(text.toUpperCase());    }    @Override    public String print(Month object, Locale locale) {        return object.toString();    }}

这里以MonthFormatter为例，其它辅助类的格式化器实现其实根本一样：

那么问题来了：Spring为毛没有给LocalDateTime、LocalDate、LocalTime这种更为罕用的类型提供Formatter格式化器呢？

其实是这样的：JDK 8提供的这套日期工夫API是十分优良的，本人就提供了十分好用的java.time.format.DateTimeFormatter格式化器，并且设计、性能上都曾经十分欠缺了。既然如此，Spring并不需要再反复造轮子，而是仅需思考如何整合此格式化器即可。

整合DateTimeFormatter

为了实现“整合”，把DateTimeFormatter融入到Spring本人的Formatter体系内，Spring筹备了多个API用于连接。

DateTimeFormatterFactory

java.time.format.DateTimeFormatter的工厂。和DateFormatter一样，它反对如下属性不便你间接定制：

DateTimeFormatterFactory：    @Nullable    private String pattern;    @Nullable    private ISO iso;    @Nullable    private FormatStyle dateStyle;    @Nullable    private FormatStyle timeStyle;    @Nullable    private TimeZone timeZone;    // 依据定制的参数，生成一个DateTimeFormatter实例    public DateTimeFormatter createDateTimeFormatter(DateTimeFormatter fallbackFormatter) { ... }

优先级关系二者是统一的：

pattern
iso
dateStyle/timeStyle

阐明：统一的设计，能够给与开发者近乎统一的编程体验，毕竟JSR 310和Date示意的都是工夫日期，尽量放弃一致性是一种很人性化的设计考量。

DateTimeFormatterFactoryBean

顾名思义，DateTimeFormatterFactory用于生成一个DateTimeFormatter实例，而本类用于把生成的Bean放进IoC容器内，实现和Spring容器的整合。客气的是，它间接继承自DateTimeFormatterFactory，从而本人同时就具备这两项能力：

生成DateTimeFormatter实例
将该实例放进IoC容器

多说一句：尽管这个工厂Bean非常简单，然而它开释的信号能够作为编程领导：

一个利用内，对日期、工夫的格式化尽量只存在1种模版标准。比方咱们能够向IoC容器里扔进去一个模版，须要时注入进来应用即可
1. 留神：这里指的利用内，个别不蕴含协定转换层应用的模版标准。如Http协定层能够应用本人独自的一套转换模版机制
日期工夫模版不要在每次应用时去长期创立，而是集中统一创立好治理起来（比方放IoC容器内），这样保护起来不便很多

阐明：DateTimeFormatterFactoryBean这个API在Spring外部并未应用，这是Spring专门给使用者用的，因为Spring也心愿你这么去做从而把日期工夫格式化模版治理起来

代码示例

@Testpublic void test1() {    // DateTimeFormatterFactory dateTimeFormatterFactory = new DateTimeFormatterFactory();    // dateTimeFormatterFactory.setPattern("yyyy-MM-dd HH:mm:ss");    // 执行格式化动作    System.out.println(new DateTimeFormatterFactory("yyyy-MM-dd HH:mm:ss").createDateTimeFormatter().format(LocalDateTime.now()));    System.out.println(new DateTimeFormatterFactory("yyyy-MM-dd").createDateTimeFormatter().format(LocalDate.now()));    System.out.println(new DateTimeFormatterFactory("HH:mm:ss").createDateTimeFormatter().format(LocalTime.now()));    System.out.println(new DateTimeFormatterFactory("yyyy-MM-dd HH:mm:ss").createDateTimeFormatter().format(ZonedDateTime.now()));}

运行程序，输入：

2020-12-26 22:44:442020-12-2622:44:442020-12-26 22:44:44

阐明：尽管你也能够间接应用DateTimeFormatter#ofPattern()静态方法失去一个实例，然而若在Spring环境下应用它我还是倡议应用Spring提供的工厂类来创立，这样能保障对立的编程体验，B格也略微高点。

应用倡议：当前对日期工夫类型（包含JSR310类型）就不要本人去写原生的SimpleDateFormat/DateTimeFormatter了，倡议能够用Spring包装过的DateFormatter/DateTimeFormatterFactory，应用体验更佳。

数字格式化

通过了上篇文章的学习之后，对数字的格式化就一点也不生疏了，什么数字、百分数、钱币等都属于数字的领域。Spring提供了AbstractNumberFormatter形象来专门解决数字格式化议题：

public abstract class AbstractNumberFormatter implements Formatter<Number> {    ...    @Override    public String print(Number number, Locale locale) {        return getNumberFormat(locale).format(number);    }    @Override    public Number parse(String text, Locale locale) throws ParseException {        // 伪代码，外围逻辑就这一句        return getNumberFormat.parse(text, new ParsePosition(0));    }    // 失去一个NumberFormat实例    protected abstract NumberFormat getNumberFormat(Locale locale);    ...}

这和DateFormatter的实现模式何其相似，几乎截然不同：底层实现依赖于（委托给）java.text.NumberFormat去实现。

此抽象类共有三个具体实现：

NumberStyleFormatter：数字格式化，如小数，分组等
PercentStyleFormatter：百分数格式化
CurrencyStyleFormatter：钱币格式化

数字格式化

NumberStyleFormatter应用NumberFormat的数字款式的通用数字格式化程序。可定制化参数为：pattern。外围源码如下：

NumberStyleFormatter：    @Override    public NumberFormat getNumberFormat(Locale locale) {        NumberFormat format = NumberFormat.getInstance(locale);        ...        // 解析时，永远返回BigDecimal类型        decimalFormat.setParseBigDecimal(true);        // 应用格式化模版        if (this.pattern != null) {            decimalFormat.applyPattern(this.pattern);        }        return decimalFormat;    }

代码示例：

@Testpublic void test2() throws ParseException {    NumberStyleFormatter formatter = new NumberStyleFormatter();    double myNum = 1220.0455;    System.out.println(formatter.print(myNum, Locale.getDefault()));    formatter.setPattern("#.##");    System.out.println(formatter.print(myNum, Locale.getDefault()));    // 转换    // Number parsedResult = formatter.parse("1,220.045", Locale.getDefault()); // java.text.ParseException: 1,220.045    Number parsedResult = formatter.parse("1220.045", Locale.getDefault());    System.out.println(parsedResult.getClass() + "-->" + parsedResult);}

运行程序，输入：

1,220.0451220.05class java.math.BigDecimal-->1220.045

可通过setPattern()指定数字格式化的模版（个别倡议显示指定）
parse()办法返回的是BigDecimal类型，从而保障了数字精度

百分数格式化

PercentStyleFormatter示意应用百分比款式去格式化数字。外围源码（其实是全副源码）如下：

PercentStyleFormatter：    @Override    protected NumberFormat getNumberFormat(Locale locale) {        NumberFormat format = NumberFormat.getPercentInstance(locale);        if (format instanceof DecimalFormat) {            ((DecimalFormat) format).setParseBigDecimal(true);        }        return format;    }

这个就更简略啦，pattern模版都不须要指定。代码示例：

@Testpublic void test3() throws ParseException {    PercentStyleFormatter formatter = new PercentStyleFormatter();    double myNum = 1220.0455;    System.out.println(formatter.print(myNum, Locale.getDefault()));    // 转换    // Number parsedResult = formatter.parse("1,220.045", Locale.getDefault()); // java.text.ParseException: 1,220.045    Number parsedResult = formatter.parse("122,005%", Locale.getDefault());    System.out.println(parsedResult.getClass() + "-->" + parsedResult);}

运行程序，输入：

122,005%class java.math.BigDecimal-->1220.05

百分数的格式化不能指定pattern，差评。

钱币格式化

应用钱币款式格式化数字，应用java.util.Currency来形容货币。代码示例：

@Testpublic void test3() throws ParseException {    CurrencyStyleFormatter formatter = new CurrencyStyleFormatter();    double myNum = 1220.0455;    System.out.println(formatter.print(myNum, Locale.getDefault()));    System.out.println("--------------定制化--------------");    // 指定货币品种（如果你晓得的话）    // formatter.setCurrency(Currency.getInstance(Locale.getDefault()));    // 指定所需的分数位数。默认是2    formatter.setFractionDigits(1);    // 舍入模式。默认是RoundingMode#UNNECESSARY    formatter.setRoundingMode(RoundingMode.CEILING);    // 格式化数字的模版    formatter.setPattern("#.#¤¤");    System.out.println(formatter.print(myNum, Locale.getDefault()));    // 转换    // Number parsedResult = formatter.parse("￥1220.05", Locale.getDefault());    Number parsedResult = formatter.parse("1220.1CNY", Locale.getDefault());    System.out.println(parsedResult.getClass() + "-->" + parsedResult);}

运行程序，输入：

￥1,220.05--------------定制化--------------1220.1CNYclass java.math.BigDecimal-->1220.1

值得关注的是：这三个实现在Spring 4.2版本之前是“耦合”在一起。直到4.2才拆开，职责拆散。

✍总结

本文介绍了Spring的Formatter形象，让格式化器大一统。这就是Spring最强能力：API设计、形象、大一统。

Converter能够从任意源类型，转换为任意指标类型。而Formatter则是从String类型转换为工作指标类型，有点相似PropertyEditor。能够感觉出Converter是Formater的超集，实际上在Spring中Formatter是被拆解成PrinterConverter和ParserConverter，而后再注册到ConverterRegistry，供后续应用。

对于格式化器的注册核心、注册员，这就是下篇文章内容喽，欢送放弃继续关注。

♨本文思考题♨

看完了不肯定懂，看懂了不肯定记住，记住了不肯定把握。来，文末3个思考题帮你复盘：

Spring为何没有针对JSR310工夫类型提供专用转换器实现？
Spring内建泛滥Formatter实现，如何治理？
格式化器Formatter和转换器Converter是如何整合到一起的？

♚申明♚

本文所属专栏：Spring类型转换，公号后盾回复专栏名即可获取全部内容。

分享、成长，回绝浅藏辄止。关注公众号【BAT的乌托邦】，回复关键字专栏有Spring技术栈、中间件等小而美的原创专栏供以收费学习。本文已被 https://www.yourbatman.cn 收录。

本文是 A哥(YourBatman) 原创文章，未经作者容许不得转载，谢谢合作。

☀举荐浏览☀

......
5. 穿过拥挤的人潮，Spring已为你制作好高级赛道
6. 抹平差别，对立类型转换服务ConversionService
7. JDK拍了拍你：字符串拼接肯定记得用MessageFormat#format
......