泛型方法的返回类型由声明与参数/返回值使用共同决定，常见为T或List等，依赖实参或Class推断具体类型；需避免无意义声明或强制转型。

泛型方法的返回类型不是“指定”出来的，而是通过方法签名中的 声明 + 参数/返回值使用位置共同决定的。关键在于：返回类型本身是泛型类型参数（如 T、List），而具体是什么类型，由调用时传入的实参或显式传入的 Class 类型令牌来确定。

返回值用泛型类型参数（最常见）

这是最标准、最安全的方式：返回类型直接写成 T、Optional、List 等，让编译器在调用时推断 T 的实际类型。

• 写法示例：public T getValue(String key) 或 public List parseList(String json, Class elementType)
• 调用时自动推断：比如 String s = getValue("name")，编译器就知道此处 T 是 String；List users = parseList(json, User.class)，T 就是 User
• 注意：仅靠返回值类型无法完成推断（Java 不支持仅凭返回值反推泛型）。必须有参数参与（如传 Class）或上下文明确（如赋值给 String 变量）

用 Class 显式传递类型信息（强类型转换保障）

当方法内部需要做类型转换（比如 JSON 反序列化、反射创建对象），光靠 不够，必须接收一个 Class 实参——它就是运行时的“类型证据”。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

• 写法示例：public T fromJson(String json, Class clazz)
• 为什么需要它：clazz 不仅用于编译期泛型绑定，更在运行时告诉 Jackson/Gson “你得把我转成 User，不是 Object”
• 调用必须带类型：User u = fromJson(json, User.class) —— 这里 User.class 同时满足：1）告诉编译器 T = User；2）提供运行时类型信息

返回值带类型约束（extends / super）

用 extends 限定泛型上界，可让返回值具备特定能力（比如能调用 toString()、实现某个接口）；用 super 较少用于返回值，多见于参数。

• 上界示例：public T getDisplayText() → 返回值一定是 String、StringBuilder 等，可安全调用 length()
• 接口约束示例：public byte[] serialize(T obj) → 确保传入对象可序列化，返回值仍是 T，但方法逻辑更安全
• 注意：约束不改变推断逻辑，只是增加编译期检查，防止传入非法类型

避免常见误区

有些写法看似“指定”，实则无效或危险：

• ❌ public String getValue() { return (String) obj; } —— 这不是泛型方法，是强制转型，运行时可能 ClassCastException
• ❌ public String getValue() { ... } —— T 完全没在返回值或参数中出现，编译器无法推断，形同虚设
• ❌ public T getValue() { return (T) new Object(); } —— 擦除后是 return (Object)，返回 String 会失败，属于不安全的泛型