6. 抹平差异,统一类型转换服务ConversionService(下)

简介: 6. 抹平差异,统一类型转换服务ConversionService(下)

3、转换功能(ConversionService)


上半部分介绍完GenericConversionService对转换器管理部分的实现(对ConverterRegistry接口的实现),接下来就看看它是如何实现转换功能的(对ConversionService接口的实现)。


判断

@Override
public boolean canConvert(@Nullable Class<?> sourceType, Class<?> targetType) {
  return canConvert((sourceType != null ? TypeDescriptor.valueOf(sourceType) : null), TypeDescriptor.valueOf(targetType));
}
@Override
public boolean canConvert(@Nullable TypeDescriptor sourceType, TypeDescriptor targetType) {
  if (sourceType == null) {
    return true;
  }
  // 查找/匹配对应的转换器
  GenericConverter converter = getConverter(sourceType, targetType);
  return (converter != null);
}


能否执行转换判断的唯一标准:能否匹配到可用于转换的转换器。而这个查找匹配逻辑,稍稍抬头往上就能看到。


转换

@Override
@SuppressWarnings("unchecked")
@Nullable
public <T> T convert(@Nullable Object source, Class<T> targetType) {
  return (T) convert(source, TypeDescriptor.forObject(source), TypeDescriptor.valueOf(targetType));
}
@Override
@Nullable
public Object convert(@Nullable Object source, @Nullable TypeDescriptor sourceType, TypeDescriptor targetType) {
  if (sourceType == null) {
    return handleResult(null, targetType, convertNullSource(null, targetType));
  }
  // 校验:source必须是sourceType的实例
  if (source != null && !sourceType.getObjectType().isInstance(source)) {
    throw new IllegalArgumentException("Source to convert from must be an instance of [" + sourceType + "]; instead it was a [" + source.getClass().getName() + "]");
  }
  // ============拿到转换器,执行转换============
  GenericConverter converter = getConverter(sourceType, targetType);
  if (converter != null) {
    Object result = ConversionUtils.invokeConverter(converter, source, sourceType, targetType);
    return handleResult(sourceType, targetType, result);
  }
  // 若没进行canConvert的判断直接调动,可能出现此种状况:一般抛出ConverterNotFoundException异常
  return handleConverterNotFound(source, sourceType, targetType);
}



同样的,执行转换的逻辑很简单,非常好理解的两个步骤:


  1. 查找匹配到一个合适的转换器(查找匹配的逻辑同上)
  2. 拿到此转换器执行转换converter.convert(...)


说明:其余代码均为一些判断、校验、容错,并非核心,本文给与适当忽略。


GenericConversionService实现了转换器管理、转换服务的所有功能,是可以直接面向开发者使用的。但是开发者使用时可能并不知道需要注册哪些转换器来保证程序正常运转,Spring并不能要求开发者知晓其内建实现。基于此,Spring在3.1又提供了一个默认实现DefaultConversionService,它对使用者更友好。


DefaultConversionService


Spirng容器默认使用的转换服务实现,继承自GenericConversionService,在其基础行只做了一件事:构造时添加内建的默认转换器们。从而天然具备有了基本的类型转换能力,适用于不同的环境。如:xml解析、@Value解析、http协议参数自动转换等等。


小细节:它并非Spring 3.0就有,而是Spring 3.1新推出的API


// @since 3.1
public class DefaultConversionService extends GenericConversionService {
  // 唯一构造器
  public DefaultConversionService() {
    addDefaultConverters(this);
  }
}


本类核心代码就这一个构造器,构造器内就这一句代码:addDefaultConverters(this)。接下来需要关注Spring默认情况下给我们“安装”了哪些转换器呢?也就是了解下addDefaultConverters(this)这个静态方法


默认注册的转换器们

// public的静态方法,注意是public的访问权限
public static void addDefaultConverters(ConverterRegistry converterRegistry) {
  addScalarConverters(converterRegistry);
  addCollectionConverters(converterRegistry);
  converterRegistry.addConverter(new ByteBufferConverter((ConversionService) converterRegistry));
  converterRegistry.addConverter(new StringToTimeZoneConverter());
  converterRegistry.addConverter(new ZoneIdToTimeZoneConverter());
  converterRegistry.addConverter(new ZonedDateTimeToCalendarConverter());
  converterRegistry.addConverter(new ObjectToObjectConverter());
  converterRegistry.addConverter(new IdToEntityConverter((ConversionService) converterRegistry));
  converterRegistry.addConverter(new FallbackObjectToStringConverter());
  converterRegistry.addConverter(new ObjectToOptionalConverter((ConversionService) converterRegistry));
}


该静态方法用于注册全局的、默认的转换器们,从而让Spring有了基础的转换能力,进而完成绝大部分转换工作。为了方便记忆这个注册流程,我把它绘制成图供以你保存:



image.png


特别强调:转换器的注册顺序非常重要,这决定了通用转换器的匹配结果(谁在前,优先匹配谁,first win)。


针对这幅图,你可能还会有如下疑问:


JSR310转换器只看到TimeZone、ZoneId等转换,怎么没看见更为常用的LocalDate、LocalDateTime等这些类型转换呢?难道Spring默认是不支持的?

答:当然不是。 这么常见的场景Spring怎能会不支持呢?不过与其说这是类型转换,倒不如说是格式化更合适。所以放在该系列后几篇关于格式化章节中再做讲述

一般的Converter都见名之意,但StreamConverter有何作用呢?什么场景下会生效

答:上文已讲述

对于兜底的转换器,有何含义?这种极具通用性的转换器作用为何

答:上文已讲述

最后,需要特别强调的是:它是一个静态方法,并且还是public的访问权限,且不仅仅只有本类调用。实际上,DefaultConversionService仅仅只做了这一件事,所以任何地方只要调用了该静态方法都能达到前者相同的效果,使用上可谓给与了较大的灵活性。比如Spring Boot环境下不是使用DefaultConversionService而是ApplicationConversionService,后者是对FormattingConversionService扩展,这个话题放在后面详解。


Spring Boot在web环境默认向容易注册了一个WebConversionService,因此你有需要可直接@Autowired使用


ConversionServiceFactoryBean


顾名思义,它是用于产生ConversionService类型转换服务的工厂Bean,为了方便和Spring容器整合而使用。


public class ConversionServiceFactoryBean implements FactoryBean<ConversionService>, InitializingBean {
  @Nullable
  private Set<?> converters;
  @Nullable
  private GenericConversionService conversionService;
  public void setConverters(Set<?> converters) {
    this.converters = converters;
  }
  @Override
  public void afterPropertiesSet() {
    // 使用的是默认实现哦
    this.conversionService = new DefaultConversionService();
    ConversionServiceFactory.registerConverters(this.converters, this.conversionService);
  }
  @Override
  @Nullable
  public ConversionService getObject() {
    return this.conversionService;
  }
  ...
}



这里只有两个信息量需要关注:


使用的是DefaultConversionService,因此那一大串的内建转换器们都会被添加进来的

自定义转换器可以通过setConverters()方法添加进来

值得注意的是方法入参是Set<?>并没有明确泛型类型,因此那三种转换器(1:1/1:N/N:N)你是都可以添加.、


✍总结


通读本文过后,相信能够给与你这个感觉:曾经望而却步的Spring类型转换服务ConversionService,其实也不过如此嘛。通篇我用了多个简单字眼来说明,因为拆开之后,无一高复杂度知识点。


迎难而上是积攒涨薪底气和勇气的途径,况且某些知识点其实并不难,所以我觉得从性价比角度来看这类内容是非常划算的,你pick到了麽?


正所谓类型转换和格式化属于两组近义词,在Spring体系中也经常交织在一起使用,有种傻傻分不清楚之感。从下篇文章起进入到本系列关于Formatter格式化器知识的梳理,什么日期格式化、@DateTimeFormat、@NumberFormat都将帮你捋清楚喽,有兴趣者可保持持续关注。

相关文章
|
6月前
|
安全 编译器 C++
【C/C++ 类型转换规则】一文了解C/C++ 中的类型转换规则,帮助你更好的编程
【C/C++ 类型转换规则】一文了解C/C++ 中的类型转换规则,帮助你更好的编程
93 0
|
6月前
|
存储 编译器 C语言
【C++】C++中规范[ 类型转换标准 ] 的四种形式
【C++】C++中规范[ 类型转换标准 ] 的四种形式
|
6月前
|
JavaScript 前端开发 编译器
TypeScript基础(三)扩展类型-接口和类型兼容性
在TypeScript中,接口(Interface)用于定义对象的结构和类型。它是一种约定,用于描述对象应该具有哪些属性和方法。接口可以提高代码的可读性、可维护性和可重用性。 接口的定义使用关键字interface,后面跟着接口的名称和一对花括号。在花括号中,可以定义接口的属性、方法和其他成员。
82 0
|
自然语言处理 数据管理
数据标准和数据规范到底有什么区别???
数据标准和数据规范到底有什么区别???
|
JavaScript 索引
数据类型及相互规则转换,我被问麻了!!!
数据类型及相互规则转换,我被问麻了!!!
106 2
|
JavaScript 前端开发
【TypeScript】原始数据的类型详解概念
【TypeScript】原始数据的类型详解概念
|
存储 SQL BI
数据字典标准与统一的重要性(码表&枚举值)
关于“公共代码、编码、码表、枚举值”的含义,以及在软件开发中的应用场景。
443 0
数据字典标准与统一的重要性(码表&枚举值)
|
前端开发 程序员 C#
【C#】通过扩展对象的方式,对字符串等数据类型进行数据进一步处理
在本篇文章中,我们讲一起了解下对象扩展的使用 在实际项目开发中,对象扩展使用的场景还是挺多的,比如:需要对时间值进行再处理,或者字符串中的斜杠(/)转为反斜杠(\)
116 0
typescript50-交叉类型和接口之间的类型说明
typescript50-交叉类型和接口之间的类型说明
90 0
typescript50-交叉类型和接口之间的类型说明
typescript46-函数之间的类型兼容性
typescript46-函数之间的类型兼容性
78 0
typescript46-函数之间的类型兼容性