Package org.miaixz.bus.core.xyz

Class TypeKit

java.lang.Object

org.miaixz.bus.core.xyz.TypeKit

public class TypeKit
extends Object

针对 Type 的工具类封装 最主要功能包括：

 1. 获取方法的参数和返回值类型（包括Type和Class）
 2. 获取泛型参数类型（包括对象的泛型参数或集合元素的泛型类型）
 

Since:

Java 17+

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor	Description
TypeKit()

Method Summary

Modifier and Type	Method	Description
static Type	getActualType(Type type, Field field)	获得泛型字段对应的泛型实际类型，如果此变量没有对应的实际类型，返回null
static Type	getActualType(Type type, ParameterizedType parameterizedType)	获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理复杂的泛型化对象，类似于Map<User, Key<Long>>
static Type	getActualType(Type type, Type typeVariable)	获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理：
static Type	getActualType(Type type, TypeVariable<?> typeVariable)	获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回typeVariable
static Type[]	getActualTypes(Type type, Type... typeVariables)	获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null
static Class<?>	getClass(Field field)	获得Field对应的原始类
static Class<?>	getClass(Type type)	获得Type对应的原始类
static Type	getClosestParentType(Class<?> cls, Class<?> superClass)	获取与superClass 指定的超类最接近的父类
static Type	getFieldType(Class<?> clazz, String fieldName)	获得字段的泛型类型
static Class<?>	getFirstParamClass(Method method)	获取方法的第一个参数类
static Type	getFirstParamType(Method method)	获取方法的第一个参数类型 优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes
static ParameterizedType[]	getGenerics(Class<?> clazz)	获取指定类所有泛型父类和泛型接口 指定类及其所有的泛型父类 指定类实现的直接泛型接口
static Type[]	getImplicitBounds(TypeVariable<?> typeVariable)	如果TypeVariable.getBounds()返回一个空数组, 则返回一个包含Object 唯一类型的数组.
static Type[]	getImplicitUpperBounds(WildcardType wildcardType)	如果WildcardType.getUpperBounds()返回一个空数组， 则返回一个包含Object唯一值的数组否则， 它将返回传递给normalizeUpperBounds(java.lang.reflect.Type[])的 WildcardType.getUpperBounds()的结果
static Class<?>	getParamClass(Method method, int index)	获取方法的参数类
static Class<?>[]	getParamClasses(Method method)	解析方法的参数类型列表 依赖jre\lib\rt.jar
static Type	getParamType(Method method, int index)	获取方法的参数类型 优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes
static Type[]	getParamTypes(Method method)	获取方法的参数类型列表 优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes
static Class<?>	getReturnClass(Method method)	解析方法的返回类型类列表
static Type	getReturnType(Method method)	获取方法的返回值类型 获取方法的GenericReturnType
static Type	getType(Field field)	获取字段对应的Type类型 方法优先获取GenericType，获取不到则获取Type
static Type	getTypeArgument(Type type)	获得给定类的第一个泛型参数
static Type	getTypeArgument(Type type, int index)	获得给定类的泛型参数
static Map<TypeVariable<?>,Type>	getTypeArguments(Class<?> cls, Class<?> toClass, Map<TypeVariable<?>,Type> subtypeVarAssigns)	在toClass的上下文中返回类的类型参数的映射
static Map<TypeVariable<?>,Type>	getTypeArguments(ParameterizedType type)	检索此参数化类型的所有类型参数，包括所有者层次结构参数
static Map<TypeVariable<?>,Type>	getTypeArguments(ParameterizedType parameterizedType, Class<?> toClass, Map<TypeVariable<?>,Type> subtypeVarAssigns)	在toClass的上下文中返回参数化类型的类型参数的映射
static Type[]	getTypeArguments(Type type)	获得指定类型中所有泛型参数类型，例如：
static Map<TypeVariable<?>,Type>	getTypeArguments(Type type, Class<?> toClass)	获取基于子类型的类/接口的类型参数
static Map<TypeVariable<?>,Type>	getTypeArguments(Type type, Class<?> toClass, Map<TypeVariable<?>,Type> subtypeVarAssigns)	在toClass的上下文中返回type的类型参数的映射
static Map<Type,Type>	getTypeMap(Class<?> clazz)	获取泛型变量和泛型实际类型的对应关系Map 例如：
static boolean	hasTypeVariable(Type... types)	指定泛型数组中是否含有泛型变量
static boolean	isAbstract(Class<?> clazz)	是否为抽象类
static boolean	isAbstractOrInterface(Class<?> clazz)	是抽象类或者接口
static boolean	isArray(Class<?> clazz)	是否为 数组 class 类型
static boolean	isArrayType(Type type)	了解指定的类型是否表示数组类型
static boolean	isAssignable(Type type, Type toType)	检查subject类型是否可以按照Java泛型规则隐式转换为目标类型.
static boolean	isBase(Class<?> clazz)	是否为基本类型 1. 8大基本类型 2.
static boolean	isCollection(Class<?> clazz)	是否为 Collection class 类型
static boolean	isIterable(Class<?> clazz)	是否为 Iterable class 类型
static boolean	isJavaBean(Class<?> clazz)	是否为标准的类 这个类必须：
static boolean	isJdk(Class<?> clazz)	判断一个类是JDK 自带的类型 jdk 自带的类,classLoader 是为空的
static boolean	isMap(Class<?> clazz)	是否为 map class 类型
static boolean	isUnknown(Type type)	是否未知类型 type为null或者TypeVariable 都视为未知类型
static Type[]	normalizeUpperBounds(Type[] bounds)	该方法在类型变量类型和通配符类型中去除冗余的上界类型
static ParameterizedType	toParameterizedType(Type type)	将Type 转换为ParameterizedType ParameterizedType用于获取当前类或父类中泛型参数化后的类型 一般用于获取泛型参数具体的参数类型，例如：
static ParameterizedType	toParameterizedType(Type type, int interfaceIndex)	将Type 转换为ParameterizedType ParameterizedType用于获取当前类或父类中泛型参数化后的类型 一般用于获取泛型参数具体的参数类型，例如：

Methods inherited from class java.lang.Object

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

Constructor Details

TypeKit

public TypeKit()

Method Details

isMap

public static boolean isMap(Class<?> clazz)

是否为 map class 类型

Parameters:

clazz - 对象类型

Returns:

是否为 map class

isArray

public static boolean isArray(Class<?> clazz)

是否为 数组 class 类型

Parameters:

clazz - 对象类型

Returns:

是否为 数组 class

isCollection

public static boolean isCollection(Class<?> clazz)

是否为 Collection class 类型

Parameters:

clazz - 对象类型

Returns:

是否为 Collection class

isIterable

public static boolean isIterable(Class<?> clazz)

是否为 Iterable class 类型

Parameters:

clazz - 对象类型

Returns:

是否为 数组 class

isBase

public static boolean isBase(Class<?> clazz)

是否为基本类型 1. 8大基本类型 2. 常见的值类型

Parameters:

clazz - 对象类型

Returns:

是否为基本类型

isAbstract

public static boolean isAbstract(Class<?> clazz)

是否为抽象类

Parameters:

clazz - 类

Returns:

是否为抽象类

isAbstractOrInterface

public static boolean isAbstractOrInterface(Class<?> clazz)

是抽象类或者接口

Parameters:

clazz - 类信息

Returns:

是否

isJavaBean

public static boolean isJavaBean(Class<?> clazz)

是否为标准的类 这个类必须：

 0、不为 null
 1、非接口
 2、非抽象类
 3、非Enum枚举
 4、非数组
 5、非注解
 6、非原始类型(int, long等)
 7、非集合 Iterable
 8、非 Map.clas
 9、非 JVM 生成类
 

Parameters:

clazz - 类

Returns:

是否为标准类

isJdk

public static boolean isJdk(Class<?> clazz)

判断一个类是JDK 自带的类型 jdk 自带的类,classLoader 是为空的

Parameters:

clazz - 类

Returns:

是否为 java 类

isAssignable

public static boolean isAssignable(Type type,
 Type toType)

检查subject类型是否可以按照Java泛型规则隐式转换为目标类型. 如果这两种类型都是Class对象， 则该方法返回ClassKit.isAssignable(Class, Class)的结果

Parameters:

type - 要分配给目标类型的主题类型

toType - 目标类型

Returns:

如果type可赋值给toType，则true.

isArrayType

public static boolean isArrayType(Type type)

了解指定的类型是否表示数组类型

Parameters:

type - 要检查的类型

Returns:

如果type是数组类或GenericArrayType，则为true

isUnknown

public static boolean isUnknown(Type type)

是否未知类型 type为null或者TypeVariable 都视为未知类型

Parameters:

type - Type类型

Returns:

是否未知类型

getClass

public static Class<?> getClass(Type type)

获得Type对应的原始类

Parameters:

type - Type

Returns:

原始类，如果无法获取原始类，返回null

getType

public static Type getType(Field field)

获取字段对应的Type类型 方法优先获取GenericType，获取不到则获取Type

Parameters:

field - 字段

Returns:

Type，可能为null

getFieldType

public static Type getFieldType(Class<?> clazz,
 String fieldName)

获得字段的泛型类型

Parameters:

clazz - Bean类

fieldName - 字段名

Returns:

字段的泛型类型

getClass

public static Class<?> getClass(Field field)

获得Field对应的原始类

Parameters:

field - Field

Returns:

原始类，如果无法获取原始类，返回null

getFirstParamType

public static Type getFirstParamType(Method method)

获取方法的第一个参数类型 优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes

Parameters:

method - 方法

Returns:

Type，可能为null

getFirstParamClass

public static Class<?> getFirstParamClass(Method method)

获取方法的第一个参数类

Parameters:

method - 方法

Returns:

第一个参数类型，可能为null

getParamType

public static Type getParamType(Method method,
 int index)

获取方法的参数类型 优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes

Parameters:

method - 方法

index - 第几个参数的索引，从0开始计数

Returns:

Type，可能为null

getParamClass

public static Class<?> getParamClass(Method method,
 int index)

获取方法的参数类

Parameters:

method - 方法

index - 第几个参数的索引，从0开始计数

Returns:

参数类，可能为null

getParamTypes

public static Type[] getParamTypes(Method method)

获取方法的参数类型列表 优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes

Parameters:

method - 方法

Returns:

Type列表，可能为null

See Also:

• Method.getGenericParameterTypes()
• Method.getParameterTypes()

getParamClasses

public static Class<?>[] getParamClasses(Method method)

解析方法的参数类型列表 依赖jre\lib\rt.jar

Parameters:

method - t方法

Returns:

参数类型类列表

See Also:

• Method.getGenericParameterTypes()
• Method.getParameterTypes()

getReturnType

public static Type getReturnType(Method method)

获取方法的返回值类型 获取方法的GenericReturnType

Parameters:

method - 方法

Returns:

Type，可能为null

See Also:

• Method.getGenericReturnType()
• Method.getReturnType()

getReturnClass

public static Class<?> getReturnClass(Method method)

解析方法的返回类型类列表

Parameters:

method - 方法

Returns:

返回值类型的类

See Also:

• Method.getGenericReturnType()
• Method.getReturnType()

getTypeArgument

public static Type getTypeArgument(Type type)

获得给定类的第一个泛型参数

Parameters:

type - 被检查的类型，必须是已经确定泛型类型的类型

Returns:

Type，可能为null

getTypeArgument

public static Type getTypeArgument(Type type,
 int index)

获得给定类的泛型参数

Parameters:

type - 被检查的类型，必须是已经确定泛型类型的类

index - 泛型类型的索引号，即第几个泛型类型

Returns:

Type

getTypeArguments

public static Type[] getTypeArguments(Type type)

获得指定类型中所有泛型参数类型，例如：

 class A<T>
 class B extends A<String>
 

通过此方法，传入B.class即可得到String

Parameters:

type - 指定类型

Returns:

所有泛型参数类型

getTypeArguments

public static Map<TypeVariable<?>,Type> getTypeArguments(ParameterizedType type)

检索此参数化类型的所有类型参数，包括所有者层次结构参数

Parameters:

type - 指定要从中获取参数的主题参数化类型

Returns:

带有类型参数的Map.

getTypeArguments

public static Map<TypeVariable<?>,Type> getTypeArguments(Type type,
 Class<?> toClass)

获取基于子类型的类/接口的类型参数

Parameters:

type - 用于确定toClass的类型参数的类型

toClass - 类型参数将根据子类型type确定的类

Returns:

带有类型参数的Map

getTypeArguments

public static Map<TypeVariable<?>,Type> getTypeArguments(Type type,
 Class<?> toClass,
 Map<TypeVariable<?>,Type> subtypeVarAssigns)

在toClass的上下文中返回type的类型参数的映射

Parameters:

type - 问题类型

toClass - 类

subtypeVarAssigns - 带有类型变量的映射

Returns:

带有类型参数的Map

getTypeArguments

public static Map<TypeVariable<?>,Type> getTypeArguments(Class<?> cls,
 Class<?> toClass,
 Map<TypeVariable<?>,Type> subtypeVarAssigns)

在toClass的上下文中返回类的类型参数的映射

Parameters:

cls - 要确定类型参数的类

toClass - 上下文类

subtypeVarAssigns - 带有类型变量的映射

Returns:

带有类型参数的Map

getTypeArguments

public static Map<TypeVariable<?>,Type> getTypeArguments(ParameterizedType parameterizedType,
 Class<?> toClass,
 Map<TypeVariable<?>,Type> subtypeVarAssigns)

在toClass的上下文中返回参数化类型的类型参数的映射

Parameters:

parameterizedType - 参数化类型

toClass - 类

subtypeVarAssigns - 带有类型变量的映射

Returns:

带有类型参数的Map

getClosestParentType

public static Type getClosestParentType(Class<?> cls,
 Class<?> superClass)

获取与superClass 指定的超类最接近的父类

Parameters:

cls - 类

superClass - 超类

Returns:

父类型

toParameterizedType

public static ParameterizedType toParameterizedType(Type type)

将Type 转换为ParameterizedType ParameterizedType用于获取当前类或父类中泛型参数化后的类型 一般用于获取泛型参数具体的参数类型，例如：

 class A<T>
 class B extends A<String>
 

通过此方法，传入B.class即可得到BParameterizedType，从而获取到String

Parameters:

type - Type

Returns:

ParameterizedType

toParameterizedType

public static ParameterizedType toParameterizedType(Type type,
 int interfaceIndex)

将Type 转换为ParameterizedType ParameterizedType用于获取当前类或父类中泛型参数化后的类型 一般用于获取泛型参数具体的参数类型，例如：

   class A<T>
   class B extends A<String>;
 

通过此方法，传入B.class即可得到B对应的ParameterizedType，从而获取到String

Parameters:

type - Type

interfaceIndex - 实现的第几个接口

Returns:

ParameterizedType

getGenerics

public static ParameterizedType[] getGenerics(Class<?> clazz)

获取指定类所有泛型父类和泛型接口

• 指定类及其所有的泛型父类
• 指定类实现的直接泛型接口

Parameters:

clazz - 类

Returns:

泛型父类或接口数组

hasTypeVariable

public static boolean hasTypeVariable(Type... types)

指定泛型数组中是否含有泛型变量

Parameters:

types - 泛型数组

Returns:

是否含有泛型变量

getTypeMap

public static Map<Type,Type> getTypeMap(Class<?> clazz)

获取泛型变量和泛型实际类型的对应关系Map 例如：

     E    java.lang.Integer
 

Parameters:

clazz - 被解析的包含泛型参数的类

Returns:

泛型对应关系Map

getActualType

public static Type getActualType(Type type,
 Field field)

获得泛型字段对应的泛型实际类型，如果此变量没有对应的实际类型，返回null

Parameters:

type - 实际类型明确的类

field - 字段

Returns:

实际类型，可能为Class等

getActualType

public static Type getActualType(Type type,
 Type typeVariable)

获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理：

     1. 泛型化对象，类似于Map<User, Key<Long>>
     2. 泛型变量，类似于T
 

Parameters:

type - 类

typeVariable - 泛型变量，例如T等

Returns:

实际类型，可能为Class等

getActualType

public static Type getActualType(Type type,
 TypeVariable<?> typeVariable)

获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回typeVariable

Parameters:

type - 类

typeVariable - 泛型变量

Returns:

实际类型，可能为Class等

getActualType

public static Type getActualType(Type type,
 ParameterizedType parameterizedType)

获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理复杂的泛型化对象，类似于Map<User, Key<Long>>

Parameters:

type - 类

parameterizedType - 泛型变量，例如List<T>等

Returns:

实际类型，可能为Class等

getActualTypes

public static Type[] getActualTypes(Type type,
 Type... typeVariables)

获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null

Parameters:

type - 类

typeVariables - 泛型变量数组，例如T等

Returns:

实际类型数组，可能为Class等

getImplicitBounds

public static Type[] getImplicitBounds(TypeVariable<?> typeVariable)

如果TypeVariable.getBounds()返回一个空数组, 则返回一个包含Object 唯一类型的数组. 否则返回TypeVariable.getBounds() 传递给normalizeUpperBounds(java.lang.reflect.Type[])的结果

Parameters:

typeVariable - 类型变量

Returns:

包含类型变量边界的非空数组.

getImplicitUpperBounds

public static Type[] getImplicitUpperBounds(WildcardType wildcardType)

如果WildcardType.getUpperBounds()返回一个空数组， 则返回一个包含Object唯一值的数组否则， 它将返回传递给normalizeUpperBounds(java.lang.reflect.Type[])的 WildcardType.getUpperBounds()的结果

Parameters:

wildcardType - 通配符类型

Returns:

包含通配符类型下界的非空数组.

normalizeUpperBounds

public static Type[] normalizeUpperBounds(Type[] bounds)

该方法在类型变量类型和通配符类型中去除冗余的上界类型

Parameters:

bounds - 表示WildcardType或 TypeVariable的上界的类型数组.

Returns:

包含来自bounds的值减去冗余类型的数组.