{@link TypeDescriptor} 参数支持类型化集合： + * 例如，调用者可能更喜欢{@code List}，而不是简单的{@code List}。 + * @param value 要转换的值 + * @param sourceType 提供有关源对象的额外信息的类型描述符 + * @param targetType 提供有关所请求结果类型的额外信息的类型描述符 + * @return 转换后的值 + * @throws EvaluationException 如果转换失败或根本无法进行转换 + */ + @Nullable + Object convertValue(@Nullable Object value, @Nullable TypeDescriptor sourceType, TypeDescriptor targetType); + +} +``` + +`StandardTypeConverter`是`TypeConverter`接口的默认实现，它委托给核心的Spring `ConversionService`来执行类型转换。该实现提供了两个构造方法，一个使用默认的`ConversionService`，另一个接受用户指定的`ConversionService`。它实现了`canConvert`方法来判断是否可以进行类型转换，并实现了`convertValue`方法来执行实际的类型转换操作。 + +```java +/** + * {@link TypeConverter}接口的默认实现，委托给核心的Spring {@link ConversionService}。 + * + * @author Juergen Hoeller + * @author Andy Clement + * @since 3.0 + * @see org.springframework.core.convert.ConversionService + */ +public class StandardTypeConverter implements TypeConverter { + + private final ConversionService conversionService; + + + /** + * 创建一个使用默认ConversionService的StandardTypeConverter。 + * @see DefaultConversionService#getSharedInstance() + */ + public StandardTypeConverter() { + this.conversionService = DefaultConversionService.getSharedInstance(); + } + + /** + * 创建一个使用给定ConversionService的StandardTypeConverter。 + * @param conversionService 要委托的ConversionService + */ + public StandardTypeConverter(ConversionService conversionService) { + Assert.notNull(conversionService, "ConversionService must not be null"); + this.conversionService = conversionService; + } + + + @Override + public boolean canConvert(@Nullable TypeDescriptor sourceType, TypeDescriptor targetType) { + return this.conversionService.canConvert(sourceType, targetType); + } + + @Override + @Nullable + public Object convertValue(@Nullable Object value, @Nullable TypeDescriptor sourceType, TypeDescriptor targetType) { + try { + return this.conversionService.convert(value, sourceType, targetType); + } + catch (ConversionException ex) { + throw new SpelEvaluationException(ex, SpelMessage.TYPE_CONVERSION_ERROR, + (sourceType != null ? sourceType.toString() : (value != null ? value.getClass().getName() : "null")), + targetType.toString()); + } + } + +} +``` + +### 六、主要实现 + +1. **StandardTypeConverter** + + `StandardTypeConverter`是`TypeConverter`接口的默认实现，它利用核心的Spring `ConversionService`来实现类型转换。 + +### 七、最佳实践 + +使用SpEL表达式以及`TypeConverter`进行类型转换。首先，通过SpEL表达式解析器创建解析器对象，并创建一个EvaluationContext作为表达式的运行环境。然后，定义一个需要转换的字符串值，通过解析表达式获取表达式对象，再通过`expression.getValue(context, Integer.class)`将字符串值转换为整数类型。最后，打印转换后的整数值。 + +```java +public class TypeConverterDemo { + + public static void main(String[] args) { + // 创建SpEL表达式解析器 + SpelExpressionParser parser = new SpelExpressionParser(); + + // 创建一个EvaluationContext + StandardEvaluationContext context = new StandardEvaluationContext(); + + // 定义一个需要转换的值 + String stringValue = "'123'"; + + // 解析表达式 + Expression expression = parser.parseExpression(stringValue); + + // 使用TypeConverter进行转换 + Integer intValue = expression.getValue(context, Integer.class); + + // 打印转换后的值 + System.out.println("Converted Integer value: " + intValue); + } +} +``` + +运行结果，成功将字符串 `'123'` 转换为整数类型，并输出转换后的整数值 `123`。 + +```properties +Converted Integer value: 123 +``` + +### 八、与其他组件的关系 + +1. **ConversionService接口** + + + `TypeConverter`接口是`ConversionService`接口的一部分，它是ConversionService的SPI（Service Provider Interface）。`ConversionService`提供了一种通用的类型转换机制，它定义了一组用于在不同类型之间进行转换的方法。`TypeConverter`接口是`ConversionService`中用于执行具体类型转换的一部分，通过`ConversionService`接口，可以更方便地管理和使用`TypeConverter`。 + +2. **SpEL表达式语言（Spring Expression Language）** + + + `TypeConverter`接口通常与SpEL表达式语言一起使用，以支持在表达式中进行类型转换的功能。在SpEL表达式中，可以直接调用`TypeConverter`接口的方法来进行类型转换，从而实现更复杂的表达式计算和处理。 + +3. **StandardEvaluationContext类** + + + `TypeConverter`接口通常与`StandardEvaluationContext`类一起使用，`StandardEvaluationContext`提供了表达式的运行环境，包括变量、函数、类型转换器等。在`StandardEvaluationContext`中可以配置`TypeConverter`，以便在SpEL表达式中使用。 + +### 九、常见问题 + +1. **类型转换失败** + + + 在进行类型转换时，可能会出现转换失败的情况，例如源对象的类型无法转换为目标类型，或者转换过程中发生异常。这可能会导致应用程序逻辑错误或异常。 + +2. **类型不兼容** + + + 在某些情况下，源对象的类型和目标类型之间可能存在不兼容的情况，无法进行转换。例如，将一个对象转换为不兼容的目标类型，或者将一个字符串转换为无法表示的目标类型。 + +3. **缺少类型转换器** + + + 如果没有合适的类型转换器可用，可能无法执行某些类型转换操作。在这种情况下，需要自定义类型转换器来满足特定的转换需求。 diff --git a/spring-spel/spring-spel-typeConverter/pom.xml b/spring-spel/spring-spel-typeConverter/pom.xml new file mode 100644 index 0000000..f877fa4 --- /dev/null +++ b/spring-spel/spring-spel-typeConverter/pom.xml @@ -0,0 +1,14 @@ + + + + com.xcs.spring + spring-spel + 0.0.1-SNAPSHOT + + + 4.0.0 + spring-spel-typeConverter + + \ No newline at end of file diff --git a/spring-spel/spring-spel-typeConverter/src/main/java/com/xcs/spring/TypeConverterDemo.java b/spring-spel/spring-spel-typeConverter/src/main/java/com/xcs/spring/TypeConverterDemo.java new file mode 100644 index 0000000..2aaf09c --- /dev/null +++ b/spring-spel/spring-spel-typeConverter/src/main/java/com/xcs/spring/TypeConverterDemo.java @@ -0,0 +1,28 @@ +package com.xcs.spring; + +import org.springframework.expression.Expression; +import org.springframework.expression.spel.standard.SpelExpressionParser; +import org.springframework.expression.spel.support.StandardEvaluationContext; + +public class TypeConverterDemo { + + public static void main(String[] args) { + // 创建SpEL表达式解析器 + SpelExpressionParser parser = new SpelExpressionParser(); + + // 创建一个EvaluationContext + StandardEvaluationContext context = new StandardEvaluationContext(); + + // 定义一个需要转换的值 + String stringValue = "'123'"; + + // 解析表达式 + Expression expression = parser.parseExpression(stringValue); + + // 使用TypeConverter进行转换 + Integer intValue = expression.getValue(context, Integer.class); + + // 打印转换后的值 + System.out.println("Converted Integer value: " + intValue); + } +}
- [`BeanResolver`](spring-spel/spring-spel-beanResolver/README.md): 解析bean定义，包括依赖、属性设置，实例化并返回。
- [`ListableBeanFactory`](spring-factory/spring-factory-listableBeanFactory/README.md)：支持按类型获取Bean的集合。