spring内置的转换器
在spring xml 文件中,配置属性的时候, 不管实际是 list 还是map ,还是Date, 或者原生的java 类型, 我们只能配置xml 给它们。 那么 spring 在实例化bean 的时候, 这些属性是必须要经过转换的。 那么,spring 具体是怎么实现的呢?
答案就是:
public class DefaultConversionService extends GenericConversionService { private static final boolean javaUtilOptionalClassAvailable = ClassUtils.isPresent("java.util.Optional", DefaultConversionService.class.getClassLoader()); private static final boolean jsr310Available = ClassUtils.isPresent("java.time.ZoneId", DefaultConversionService.class.getClassLoader()); private static final boolean streamAvailable = ClassUtils.isPresent("java.util.stream.Stream", DefaultConversionService.class.getClassLoader()); private static volatile DefaultConversionService sharedInstance; public static ConversionService getSharedInstance() { if(sharedInstance == null) { Class var0 = DefaultConversionService.class; synchronized(DefaultConversionService.class) { if(sharedInstance == null) { sharedInstance = new DefaultConversionService(); } } } return sharedInstance; } public DefaultConversionService() { addDefaultConverters(this); } public static void addDefaultConverters(ConverterRegistry converterRegistry) { addScalarConverters(converterRegistry); // 注册 标量的转换器, 也就是把xml配置文件中 字面值 转换为 常见的简单的普通类型 addCollectionConverters(converterRegistry); // 转换为 集合 converterRegistry.addConverter(new ByteBufferConverter((ConversionService)converterRegistry)); if(jsr310Available) { DefaultConversionService.Jsr310ConverterRegistrar.registerJsr310Converters(converterRegistry); } converterRegistry.addConverter(new ObjectToObjectConverter()); converterRegistry.addConverter(new IdToEntityConverter((ConversionService)converterRegistry)); converterRegistry.addConverter(new FallbackObjectToStringConverter()); if(javaUtilOptionalClassAvailable) { converterRegistry.addConverter(new ObjectToOptionalConverter((ConversionService)converterRegistry)); } } public static void addCollectionConverters(ConverterRegistry converterRegistry) { ConversionService conversionService = (ConversionService)converterRegistry; converterRegistry.addConverter(new ArrayToCollectionConverter(conversionService)); converterRegistry.addConverter(new CollectionToArrayConverter(conversionService)); converterRegistry.addConverter(new ArrayToArrayConverter(conversionService)); converterRegistry.addConverter(new CollectionToCollectionConverter(conversionService)); converterRegistry.addConverter(new MapToMapConverter(conversionService)); converterRegistry.addConverter(new ArrayToStringConverter(conversionService)); converterRegistry.addConverter(new StringToArrayConverter(conversionService)); converterRegistry.addConverter(new ArrayToObjectConverter(conversionService)); converterRegistry.addConverter(new ObjectToArrayConverter(conversionService)); converterRegistry.addConverter(new CollectionToStringConverter(conversionService)); converterRegistry.addConverter(new StringToCollectionConverter(conversionService)); converterRegistry.addConverter(new CollectionToObjectConverter(conversionService)); converterRegistry.addConverter(new ObjectToCollectionConverter(conversionService)); if(streamAvailable) { converterRegistry.addConverter(new StreamConverter(conversionService)); } } private static void addScalarConverters(ConverterRegistry converterRegistry) { converterRegistry.addConverterFactory(new NumberToNumberConverterFactory()); converterRegistry.addConverterFactory(new StringToNumberConverterFactory()); converterRegistry.addConverter(Number.class, String.class, new ObjectToStringConverter()); converterRegistry.addConverter(new StringToCharacterConverter()); converterRegistry.addConverter(Character.class, String.class, new ObjectToStringConverter()); converterRegistry.addConverter(new NumberToCharacterConverter()); converterRegistry.addConverterFactory(new CharacterToNumberFactory()); converterRegistry.addConverter(new StringToBooleanConverter()); converterRegistry.addConverter(Boolean.class, String.class, new ObjectToStringConverter()); converterRegistry.addConverterFactory(new StringToEnumConverterFactory()); converterRegistry.addConverter(new EnumToStringConverter((ConversionService)converterRegistry)); converterRegistry.addConverterFactory(new IntegerToEnumConverterFactory()); converterRegistry.addConverter(new EnumToIntegerConverter((ConversionService)converterRegistry)); converterRegistry.addConverter(new StringToLocaleConverter()); converterRegistry.addConverter(Locale.class, String.class, new ObjectToStringConverter()); converterRegistry.addConverter(new StringToCharsetConverter()); converterRegistry.addConverter(Charset.class, String.class, new ObjectToStringConverter()); converterRegistry.addConverter(new StringToCurrencyConverter()); converterRegistry.addConverter(Currency.class, String.class, new ObjectToStringConverter()); converterRegistry.addConverter(new StringToPropertiesConverter()); converterRegistry.addConverter(new PropertiesToStringConverter()); converterRegistry.addConverter(new StringToUUIDConverter()); converterRegistry.addConverter(UUID.class, String.class, new ObjectToStringConverter()); } private static final class Jsr310ConverterRegistrar { private Jsr310ConverterRegistrar() { } public static void registerJsr310Converters(ConverterRegistry converterRegistry) { converterRegistry.addConverter(new StringToTimeZoneConverter()); converterRegistry.addConverter(new ZoneIdToTimeZoneConverter()); converterRegistry.addConverter(new ZonedDateTimeToCalendarConverter()); } } }
大致的堆栈是:
at org.springframework.core.convert.support.StringToNumberConverterFactory$StringToNumber.convert(StringToNumberConverterFactory.java:59)
at org.springframework.core.convert.support.StringToNumberConverterFactory$StringToNumber.convert(StringToNumberConverterFactory.java:49)
at org.springframework.core.convert.support.GenericConversionService$ConverterFactoryAdapter.convert(GenericConversionService.java:436)
at org.springframework.core.convert.support.ConversionUtils.invokeConverter(ConversionUtils.java:37)
at org.springframework.core.convert.support.GenericConversionService.convert(GenericConversionService.java:203)
at org.springframework.beans.TypeConverterDelegate.convertIfNecessary(TypeConverterDelegate.java:173)
at org.springframework.beans.AbstractNestablePropertyAccessor.convertIfNecessary(AbstractNestablePropertyAccessor.java:576)
at org.springframework.beans.AbstractNestablePropertyAccessor.convertForProperty(AbstractNestablePropertyAccessor.java:603)
at org.springframework.beans.BeanWrapperImpl.convertForProperty(BeanWrapperImpl.java:216)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.convertForProperty(AbstractAutowireCapableBeanFactory.java:1538)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.applyPropertyValues(AbstractAutowireCapableBeanFactory.java:1497)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.populateBean(AbstractAutowireCapableBeanFactory.java:1237)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:552)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:483)
at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:306)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:230)
- locked <0x677> (a java.util.concurrent.ConcurrentHashMap)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:302)
spring xml中常见属性的注入:
注入array 或者list 有两种方式:
1 直接使用 <value>, 每个 item 使用 逗号分隔, 这个时候使用的是 StringToCollectionConverter
如:
<property name="strArr">
<value>aaa,bbb,ccc</value>
</property>
2 使用 <list> 子标签, (别看名字是 list, 但它可以转换list 和 array; spring 并没有单独对 数组即 array 进行转换, 而是把list/array 统一为 list 了) 。但是实际处理的时候是区分开了的, array 使用的是 ArrayToArrayConverter, list 使用的是CollectionToCollectionConverter 。
<property name="strArr">
<list>
<value> // list 下面每个 value 是一个item
AAA
</value>
<value>
BBB
</value>
<value>
CCC
</value>
</list>
</property>
注入Set 有两种方式:
同样, 注入set 也有两种方式:
1 使用 <value> , 和数组或list相同, 这个时候使用的是 StringToCollectionConverter,
2 或者使用 <set> 标签 ,对应 set 使用的和数组和list相同: CollectionToCollectionConverter ;
<property name="aSet">
<set><value>aaa</value><value>bbb</value></set>
</property>
注入Map 或者 Properties:
而, 对于map 或者 properties 的注入, 可以使用<map> 或者 <props> ( 因为他们是可以相互转换的). 对应的 都 是MapToMapConverter
<property name="strMap">
<props>
<prop key="k1">V1</prop>
<prop key="k2">V2</prop>
</props>
</property>
<property name="strProp">
<map>
<entry key="aa" value="AA"></entry>
<entry key="bb" value="BB"></entry>
</map>
</property>
另外, 对于 properties, 我们还可以使用 value 直接注入, 它实际使用的转换器是:StringToPropertiesConverter
格式是, 每行一个 entry, 用 = 分隔 kv :
<property name="strProp">
<value>
aa = aa
bb = BB
</value>
</property>
但是map 不能这样注入。 因为并不存在 StringToMapConverter