本文围绕 Java 泛型类从入门到实战：完整教程与案例解析 的主题，系统梳理泛型类的原理、应用场景以及实战案例，帮助读者从零开始掌握泛型类的设计与实现技巧。覆盖从基本概念到实战场景的完整路径，适合初学者和具备一定 Java 基础的开发者。
1. 泛型类入门概念
1.1 泛型的基本定义
泛型是 Java 为了提高代码复用性与类型安全性而引入的机制，通过在类、接口和方法中引入类型参数来实现对多种数据类型的泛化处理。
在使用泛型前，代码往往需要进行大量的类型强制转换，这会带来潜在的类型安全问题。引入泛型后，编译阶段就能进行类型检查，减少运行时错误，提升代码的健壮性。
// 一个简单的泛型类示例
public class Box<T> {private T value;public Box(T value) {this.value = value;}public T getValue() {return value;}public void setValue(T value) {this.value = value;}
}
占位符 T 在实例化时被具体类型所替代，例如 Box<Integer>，Box<String> 等，通过泛型实现对不同类型的统一处理。
1.2 泛型在类和接口中的应用
类和接口可以定义一个或多个类型参数，从而将数据类型的不同情况统一到一个模板中。
在使用时，可以通过尖括号指定具体的类型参数，也可以借助通配符实现更灵活的类型关系。
// 泛型接口示例
public interface Repository<E, ID> {void save(E entity);E findById(ID id);
}// 实现类
public class InMemoryRepository<E, ID> implements Repository<E, ID> {// 实现细节略
}
1.3 为什么使用泛型
泛型提高代码复用性，同一个类或方法可以处理不同的数据类型，减少重复代码。
它还提供编译期的类型安全，能够在代码编译阶段发现类型错误，降低运行时异常的概率。
public class Pair<K, V> {private K key;private V value;public Pair(K key, V value) { this.key = key; this.value = value; }public K getKey() { return key; }public V getValue() { return value; }
}
2. 泛型类的核心特性与约束
2.1 泛型类的声明与实例化
在声明类时使用类型参数，实例化时再指定具体类型，以确保所有成员的类型一致性。
通过底层的类型擦除机制，运行时不会知晓具体的泛型类型，但编译期会进行严格检查，确保类型安全。
Box<Integer> intBox = new Box<>(123);
Box<String> strBox = new Box<>("hello");
2.2 泛型的边界约束
通配符和边界用于限制可接受的类型范围，例如 使用 <? extends Number> 可以接受 Number 及其子类类型，实现协变读取。
另一方面，使用 <? super T> 可以接受 T 及其父类类型，实现逆变写入的场景。
public void processList(List<? extends Number> numbers) {for (Number n : numbers) {System.out.println(n.doubleValue());}
}
3. 泛型方法与实战技巧
3.1 泛型方法的定义
在非泛型类或泛型类中，可以独立定义类型参数，使用 <T> 放在方法返回值前来声明泛型方法。
泛型方法的类型参数与所在类的泛型参数是独立的，两者可以并存并相互独立。
public class Utils {public static <T> void printArray(T[] arr) {for (T t : arr) {System.out.print(t + " ");}System.out.println();}
}
3.2 使用泛型类构建常用集合容器
结合 Java 集合框架，使用泛型容器可以显著提升代码自文档性和类型安全性，减少显式类型转换。
示例展示了如何将自定义泛型类整合进集合操作中，实现简单的类型保护。
import java.util.ArrayList;
import java.util.List;List<Box<Integer>> boxes = new ArrayList<>();
boxes.add(new Box<>(1));
boxes.add(new Box<>(2));
4. Java 泛型类的案例解析
4.1 案例：通用缓存容器 Cache<K, V>
设计一个简单的缓存容器，支持键值对的存取、容量控制以及简单的淘汰策略，同时保持对键和值的类型安全。
核心原则是将数据结构的行为与类型参数解耦，避免在使用端进行强制类型转换，从而避免 ClassCastException。
import java.util.HashMap;
import java.util.Map;public class Cache<K, V> {private final Map<K, V> map = new HashMap<>();private final int capacity;public Cache(int capacity) {this.capacity = capacity;}public void put(K key, V value) {if (map.size() >= capacity) {// 简单的淘汰策略：移除一个任意键值对K firstKey = map.keySet().iterator().next();map.remove(firstKey);}map.put(key, value);}public V get(K key) {return map.get(key);}
}
4.2 案例：泛型实用工具类
提供一个实用工具类，帮助对泛型集合执行常见操作，如比较、排序或转换，通过泛型方法提高可复用性。
示例中，泛型方法实现了对可比较对象的比较逻辑，且对类型参数进行约束。
public class Comparators {public static <T extends Comparable<T>> int compare(T a, T b) {return a.compareTo(b);}
}
