类型令牌（typetoken）是利用匿名子类保留泛型信息的运行时快照，通过反射提取父类signature中的实际类型参数，用于绕过java泛型擦除限制，常见于gson反序列化等场景。
Java 中泛型在编译后会被擦除（Type Erasure），导致运行时无法获取真实的泛型类型信息。类型令牌（Type Token）是一种常用技巧，通过保留类型信息的“运行时快照”，绕过擦除限制，常用于 JSON 反序列化、依赖注入、集合类型检查等场景。
什么是类型令牌（TypeToken）
类型令牌本质是一个匿名子类的 Class 或 Type 对象，利用 Java 泛型在继承关系中**部分保留类型参数**的特性：当写 new TypeToken<list>>() {}</list> 时，匿名子类的父类签名中仍包含完整的 List<string></string>，JVM 会将其记录在字节码的 Signature 属性中，从而可在运行时通过反射提取。
用 Gson 的 TypeToken 解决反序列化问题
Gson 自带 com.google.gson.reflect.TypeToken，是最典型的使用示例：
- 直接用
TypeToken.getParameterized(...)构造带泛型的类型：
// 反序列化 List
Type userListType = new TypeToken>()
{}.getType();
List
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 嵌套泛型也支持，比如
Map<string list>></string>：
// 注意：必须用匿名子类方式，不能写 TypeToken
Type mapType = new TypeToken {}.getType();
Map
自己实现轻量级 TypeToken（理解原理）
不依赖 Gson 时，可手写一个最小可用版本：
- 核心是捕获构造时的泛型父类信息：
public class TypeToken
private final Type type;
public TypeToken() {
Type superclass = getClass().getGenericSuperclass();
if (superclass instanceof ParameterizedType) {
type = ((ParameterizedType) superclass).getActualTypeArguments()[0];
} else {
throw new IllegalArgumentException("TypeToken must be created as TypeToken
}
}
public Type getType() { return type; }
}
- 使用方式一致：
TypeToken<list>> token = new TypeToken<list>>() {};</list></list> - 注意：必须用匿名子类，否则
getClass().getGenericSuperclass()拿不到泛型参数
注意事项和常见坑
不能用于局部变量或方法泛型推断：类型令牌只对编译期已知、且出现在类继承结构中的泛型有效。例如下面写法无效：
-
<t> void parse(T t) { new TypeToken<t>() {}; }</t></t>→ 编译报错，T 是类型变量，无法在运行时确定 -
TypeToken>或通配符类型无法可靠捕获，应避免 - Android 上 ProGuard 可能移除
Signature属性，需保留-keepattributes Signature - Java 12+ 引入了
java.lang.reflect.TypeReference（仍在孵化），但尚未替代 TypeToken
类型令牌不是万能的魔法，它只是把编译期已知的泛型“固化”为运行时可查的对象——关键在于泛型声明必须出现在类字面量层级，而非变量或方法签名中。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
