SpringBoot 实战：优雅的使用枚举参数（原理篇，这一次带你搞懂 Spring 代理创建过程

获取输入参数的逻辑在org.springframework.web.method.annotation.RequestParamMethodArgumentResolver#resolveName，单参数返回的是 String 类型，多参数返回 String 数组。核心代码如下：

所以说，无论我们的目标参数是什么，输入参数都是 String 类型或 String 数组，然后 Spring 把它们转换为我们期望的类型。

找到目标参数的逻辑在DispatcherServlet中，根据 uri 找到对应的 Controller 处理方法，找到方法就找到了目标参数类型。

接下来就是检查是否需要转换逻辑，也就是org.springframework.validation.DataBinder#convertIfNecessary，顾名思义，如果需要就转换，将字符串类型转换为目标类型。在我们的例子中，就是将 String 转换为枚举值。

查找转换器

继续深扒，会在org.springframework.beans.TypeConverterDelegate#convertIfNecessary方法中找到这么一段逻辑：

这段逻辑中，调用了org.springframework.core.convert.support.GenericConversionService#canConvert方法，检查是否可转换，如果可以转换，将会执行类型转换逻辑。

检查是否可转换的本质就是检查是否能够找到对应的转换器。如果能找到，就用找到的转换器开始转换逻辑，如果找不到，那就是不能转换，走其他逻辑。

我们可以看看查找转换器的代码org.springframework.core.convert.support.GenericConversionService#getConverter，可以对我们自己写代码有一些启发：

转换为伪代码就是：

1. 根据参数类型和目标

《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》
浏览器打开：qq.cn.hn/FTe 免费领取

类型，构造缓存 key

2. 根据缓存 key，从缓存中查询转换器

3. 如果能找到且不是 NO_MATCH，返回转换器；如果是 NO_MATCH，返回 null；如果未找到，继续

4. 通过 org.springframework.core.convert.support.GenericConversionService.Converters#find 查询转换器

5. 如果未找到，检查源类型和目标类型是否可以强转，也就是类型一致。如果是，返回 NoOpConverter，如果否，返回 null。

6. 检查找到的转换器是否为 null，如果不是，将转换器加入到缓存中，返回该转换器

7. 如果否，在缓存中添加 NO_MATCH 标识，返回 null

Spring 内部使用Map作为缓存，用来存储通用转换器接口GenericConverter，这个接口会是我们自定义转换器的包装类。我们还可以看到，转换器缓存用的是ConcurrentReferenceHashMap，这个类是线程安全的，可以保证并发情况下，不会出现异常存储。但是getConverter方法没有使用同步逻辑。换句话说，并发请求时，可能存在性能损耗。不过，对于 web 请求场景，并发损耗好过阻塞等待。

我们在看下 Spring 是如何查找转换器的，在org.springframework.core.convert.support.GenericConversionService.Converters#find中就是找到对应转换器的核心逻辑：

我们可以看到，Spring 是通过源类型和目标类型组合起来，查找对应的转换器。而且，Spring 还通过getClassHierarchy方法，将源类型和目标类型的家族族谱全部列出来，用双层 for 循环遍历查找。

上面的代码中，还有一个matches方法，在这个方法里面，调用了ConverterFactory#getConverter方法，也就是用这个工厂方法，创建了指定类型的转换器。

类型转换

经过上面的逻辑，已经找到判断可以进行转换。其核心逻辑就是已经找到对应的转换器了，下面就是转换逻辑，在org.springframework.core.convert.support.GenericConversionService#convert中：

其中的GenericConverter converter = getConverter(sourceType, targetType)就是前文中getConverter方法。此处还是可以给我们编码上的一些借鉴的：getConverter方法在canConvert中调用了一次，然后在后续真正转换的时候又调用一次，这是参数转换逻辑，我们该怎么优化这种同一请求内多次调用相同逻辑或者请求相同参数呢？那就是使用缓存。为了保持一次请求中前后两次数据的一致性和请求的高效，推荐使用内存缓存。

执行到这里，直接调用ConversionUtils.invokeConverter(converter, source, sourceType, targetType)转换，其内部是使用org.springframework.core.convert.support.GenericConversionService.ConverterFactoryAdapter#convert方法，代码如下：

这里就是调用ConverterFactory工厂类构建转换器（即IdCodeToEnumConverterFactory类的getConverter方法），然后调用转换器的conver方法（即IdCodeToEnumConverter类的convert方法），将输入参数转换为目标类型。具体实现可以看一下实战篇中的代码，这里不做赘述。

至此，我们把整个路程通了下来。

文末总结