程序包 com.agentsflex.core.util

类 JsonSchemaTypeMapper

java.lang.Object

com.agentsflex.core.util.JsonSchemaTypeMapper

public final class JsonSchemaTypeMapper
extends Object

Java 类型到 JSON Schema 类型的映射工具类

支持标准类型、集合类型、泛型类型及自定义类型注册

JSON Schema 标准类型: string, number, integer, boolean, object, array, null

从以下版本开始:

2026/03/10

作者:

fuhai

嵌套类概要

嵌套类

修饰符和类型	类	说明
static interface	JsonSchemaTypeMapper.TypeMappingStrategy	类型映射策略函数式接口（支持扩展）

字段概要

字段

修饰符和类型	字段	说明
private static final Map<Class<?>,JsonSchemaTypeMapper.TypeMappingStrategy>	CUSTOM_STRATEGIES	自定义类型映射策略（可扩展）
private static final Map<Class<?>,String>	TYPE_CACHE	类型映射缓存：避免重复反射解析，提升性能

构造器概要

构造器

限定符	构造器	说明
private	JsonSchemaTypeMapper()	私有构造，防止实例化

方法概要

修饰符和类型	方法	说明
static void	clearCache()	清除缓存（测试或热更新场景使用）
private static String	doMapType(Class<?> type)
private static boolean	isFloatingNumericType(Class<?> type)
private static boolean	isIntegerNumericType(Class<?> type)
private static boolean	isStringLikeType(Class<?> type)
static String	mapToSchemaType(Class<?> javaType)	将 Java Class 映射为 JSON Schema 类型字符串
static void	registerStrategy(Class<?> type, JsonSchemaTypeMapper.TypeMappingStrategy strategy)	注册自定义类型映射策略
static String	resolveArrayItemType(Type genericType)	解析数组/集合元素的 JSON Schema 类型（支持泛型）
private static String	resolveType(Type type)

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

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

字段详细资料

TYPE_CACHE

private static final Map<Class<?>,String> TYPE_CACHE

类型映射缓存：避免重复反射解析，提升性能

CUSTOM_STRATEGIES

private static final Map<Class<?>,JsonSchemaTypeMapper.TypeMappingStrategy> CUSTOM_STRATEGIES

自定义类型映射策略（可扩展）

构造器详细资料

JsonSchemaTypeMapper

private JsonSchemaTypeMapper()

私有构造，防止实例化

方法详细资料

mapToSchemaType

@NotNull
public static String mapToSchemaType(@Nullable
 Class<?> javaType)

将 Java Class 映射为 JSON Schema 类型字符串

参数:

javaType - Java 类型

返回:

JSON Schema 类型: string/number/integer/boolean/object/array/null

resolveArrayItemType

@NotNull
public static String resolveArrayItemType(@Nullable
 Type genericType)

解析数组/集合元素的 JSON Schema 类型（支持泛型）

参数:

genericType - 泛型类型信息，如 List<String> 的 String

返回:

元素类型的 JSON Schema 类型

registerStrategy

public static void registerStrategy(@NotNull
 Class<?> type,
 @NotNull
 JsonSchemaTypeMapper.TypeMappingStrategy strategy)

注册自定义类型映射策略

示例：registerStrategy(LocalDateTime.class, t -> "string", "date-time")

参数:

type - Java 类型

strategy - 映射策略

clearCache

public static void clearCache()

清除缓存（测试或热更新场景使用）

doMapType

@NotNull
private static String doMapType(@NotNull
 Class<?> type)

resolveType

@NotNull
private static String resolveType(@Nullable
 Type type)

isIntegerNumericType

private static boolean isIntegerNumericType(Class<?> type)

isFloatingNumericType

private static boolean isFloatingNumericType(Class<?> type)

isStringLikeType

private static boolean isStringLikeType(Class<?> type)