核心概念

        Java 泛型是 Java SE 1.5 引入的一项重要特性，它的核心思想是 参数化类型（Parameterized Types），即通过将数据类型作为参数传递给类、接口或方法，使代码能够灵活地处理多种类型，同时保证类型安全性。

---

一、基本语法

1. 泛型类/接口

        在类名后添加类型参数 <T>，T 是占位符（可以是任意标识符）,声明后类的占位符会被替换成对应类型

public class Box<T> {private T content;public void setContent(T content) { this.content = content; }public T getContent() { return content; }
}// 使用
Box<String> stringBox = new Box<>();
stringBox.setContent("Hello");
String value = stringBox.getContent(); // 无需强制转换

2.泛型接口

public interface ITest<T> {void show(T t);
}public class TestImpl implements ITest<String> {@Overridepublic void show(String t) {System.out.println(t);}
}

3.泛型方法

• 作为传参：在方法返回类型前声明类型参数 <T>：

//   修饰符  <T>  返回值类型 方法名(T 变量名){
public <T> void printArray(T[] array) {for (T element : array) {System.out.println(element);}
}// 调用时可显式指定类型或由编译器推断
printArray(new Integer[]{1, 2, 3});

• 作为返回值：使用 Class<T> 参数传递类型信息

public <T> T convert(Object input, Class<T> targetType) {if (targetType == String.class) {return targetType.cast(input.toString()); // 转成 String} else if (targetType == Integer.class) {return targetType.cast(Integer.parseInt(input.toString())); // 转成 Integer}throw new IllegalArgumentException("不支持的类型: " + targetType);
}//调用
String strResult = convert(123, String.class);       // 返回 "123"（String 类型）
Integer intResult = convert("456", Integer.class);   // 返回 456（Integer 类型）

---

二、泛型通配符<?>

1. 无界通配符 <?>

• 作为传参：表示接受任何类型

public void processList(List<?> list) {for (Object elem : list) { /* ... */ }
}

• 作为返回值：表示返回任何类型

    public List<?> getData() {List<Food> resultList = new ArrayList<>();return resultList;}

2. 上界通配符 <? extends T>

        接受 T 或其子类（适合读取数据）：

public double sum(List<? extends Number> list) {double sum = 0.0;for (Number num : list) { sum += num.doubleValue(); }return sum;
}

3. 下界通配符 <? super T>

        接受 T 或其父类（适合写入数据）：

public void addNumbers(List<? super Integer> list) {list.add(1);list.add(2);
}

4. PECS 原则（Producer-Extends, Consumer-Super）

• 生产者（Producer）：提供数据时用 extends（如 List<? extends T>）
• 消费者（Consumer）：消费数据时用 super（如 List<? super T>）

---

三、实际应用场景

1. REST API 响应封装

public class ApiResponse<T> {private int code;private String message;private T data; // 泛型数据// 构造方法和Getter/Setterpublic static <T> ApiResponse<T> success(T data) {ApiResponse<T> response = new ApiResponse<>();response.setCode(200);response.setData(data);return response;}
}// 使用
ApiResponse<User> userResponse = ApiResponse.success(user);
ApiResponse<List<Product>> productResponse = ApiResponse.success(products);

2.Java 的集合框架（如 ArrayList<T>, HashMap<K,V>）

List<String> names = new ArrayList<>();
names.add("Alice");
String name = names.get(0); // 不需要强制转换

3.工具类方法

        泛型方法可用于编写通用的工具类，例如排序、查找等。

public static <T extends Comparable<T>> T max(T a, T b) {return a.compareTo(b) > 0 ? a : b;
}