程序包 com.agentsflex.core.util

类 TypeConverter

java.lang.Object

com.agentsflex.core.util.TypeConverter

public class TypeConverter
extends Object

高性能通用类型转换工具类

转换策略优先级（按性能排序）：

1. null 处理 & 类型匹配 → 直接返回
2. 基本类型 & 包装类型 → 直接转换（零 JSON 开销）
3. String/Number/Boolean → 类型安全转换
4. Date/Time/Enum → 特殊处理（多格式解析 + 缓存）
5. 复杂对象/泛型集合 → 走 JSON 转换（兜底）

线程安全：本类所有方法均为静态无状态，可安全并发调用

从以下版本开始:

1.0

作者:

Michael

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	TypeConverter.ConversionException	类型转换异常

字段概要

字段

修饰符和类型	字段	说明
private static final String[]	DATE_PATTERNS	日期格式列表（按命中率降序排列，提升平均性能）
private static final Set<String>	FALSE_VALUES	Boolean 假值集合（不区分大小写）
private static final Map<String,DateTimeFormatter>	FORMATTER_CACHE	DateTimeFormatter 缓存（Key: pattern）
private static final Set<Class<?>>	NUMBER_TYPES	数值类型集合
private static final Map<Class<?>,Class<?>>	PRIMITIVE_WRAPPER_MAP	基本类型 → 包装类型映射
private static final Pattern	PURE_INTEGER_PATTERN	纯整数正则：可选符号 + 数字
private static final com.alibaba.fastjson2.JSONWriter.Feature[]	SERIAL_FEATURES	JSON 序列化特性配置
private static final Pattern	TIMESTAMP_PATTERN	时间戳正则：10位(秒) 或 13位(毫秒)
private static final Set<String>	TRUE_VALUES	Boolean 真值集合（不区分大小写）

构造器概要

构造器

构造器	说明
TypeConverter()

方法概要

修饰符和类型	方法	说明
static <T> T	convert(Object value, Type toType)	通用类型转换入口
static <T> T	convert(Object value, Type toType, T defaultValue)	带默认值的转换：转换失败或结果为 null 时返回默认值
private static Boolean	convertBoolean(Object value)
private static Object	convertByJson(Object value, Class<?> targetType)
private static Character	convertChar(Object value)
private static Object	convertComplexType(Object value, Type toType)
private static Number	convertNumber(Object value, Class<?> targetType)
private static Object	convertSimpleType(Object value, Class<?> targetType)
private static Date	convertToDate(Object value)
private static <E extends Enum<E>> E	convertToEnum(Object value, Class<E> enumClass)
private static Instant	convertToInstant(Object value)
private static LocalDate	convertToLocalDate(Object value)
private static LocalDateTime	convertToLocalDateTime(Object value)
static Type	createParameterizedType(Class<?> rawType, Type... typeArgs)	动态创建 ParameterizedType（用于运行时泛型）
private static DateTimeFormatter	getCachedFormatter(String pattern)
private static boolean	isDecimalString(String str)	判断是否为小数字符串（包含小数点）
private static boolean	isPureNumeric(String str)	判断是否为纯整数字符串（可选符号 + 数字）
private static Date	parseDateFromString(String str)
private static Date	tryFuzzyParse(String str)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

PRIMITIVE_WRAPPER_MAP

private static final Map<Class<?>,Class<?>> PRIMITIVE_WRAPPER_MAP

基本类型 → 包装类型映射

NUMBER_TYPES

private static final Set<Class<?>> NUMBER_TYPES

数值类型集合

TRUE_VALUES

private static final Set<String> TRUE_VALUES

Boolean 真值集合（不区分大小写）

FALSE_VALUES

private static final Set<String> FALSE_VALUES

Boolean 假值集合（不区分大小写）

PURE_INTEGER_PATTERN

private static final Pattern PURE_INTEGER_PATTERN

纯整数正则：可选符号 + 数字

TIMESTAMP_PATTERN

private static final Pattern TIMESTAMP_PATTERN

时间戳正则：10位(秒) 或 13位(毫秒)

DATE_PATTERNS

private static final String[] DATE_PATTERNS

日期格式列表（按命中率降序排列，提升平均性能）

FORMATTER_CACHE

private static final Map<String,DateTimeFormatter> FORMATTER_CACHE

DateTimeFormatter 缓存（Key: pattern）

SERIAL_FEATURES

private static final com.alibaba.fastjson2.JSONWriter.Feature[] SERIAL_FEATURES

JSON 序列化特性配置

构造器详细资料

TypeConverter

public TypeConverter()

方法详细资料

convert

public static <T> T convert(Object value,
 Type toType)

通用类型转换入口

类型参数:

T - 目标类型泛型

参数:

value - 源数据

toType - 目标类型（支持 Class / ParameterizedType）

返回:

转换后的对象，失败时抛出 ConversionException

convert

public static <T> T convert(Object value,
 Type toType,
 T defaultValue)

带默认值的转换：转换失败或结果为 null 时返回默认值

类型参数:

T - 目标类型泛型

参数:

value - 源数据

toType - 目标类型

defaultValue - 默认值

返回:

转换结果或默认值

createParameterizedType

public static Type createParameterizedType(Class<?> rawType,
 Type... typeArgs)

动态创建 ParameterizedType（用于运行时泛型）

参数:

rawType - 原始类型，如 List.class

typeArgs - 泛型参数，如 User.class

返回:

ParameterizedType 实例

convertSimpleType

private static Object convertSimpleType(Object value,
 Class<?> targetType)

convertNumber

private static Number convertNumber(Object value,
 Class<?> targetType)

isPureNumeric

private static boolean isPureNumeric(String str)

判断是否为纯整数字符串（可选符号 + 数字）

isDecimalString

private static boolean isDecimalString(String str)

判断是否为小数字符串（包含小数点）

convertBoolean

private static Boolean convertBoolean(Object value)

convertChar

private static Character convertChar(Object value)

convertToDate

private static Date convertToDate(Object value)

parseDateFromString

private static Date parseDateFromString(String str)

getCachedFormatter

private static DateTimeFormatter getCachedFormatter(String pattern)

tryFuzzyParse

private static Date tryFuzzyParse(String str)

convertToLocalDate

private static LocalDate convertToLocalDate(Object value)

convertToLocalDateTime

private static LocalDateTime convertToLocalDateTime(Object value)

convertToInstant

private static Instant convertToInstant(Object value)

convertToEnum

private static <E extends Enum<E>> E convertToEnum(Object value,
 Class<E> enumClass)

convertComplexType

private static Object convertComplexType(Object value,
 Type toType)

convertByJson

private static Object convertByJson(Object value,
 Class<?> targetType)