自定义Java泛型类的核心是将类型作为可配置参数,实现多类型适配与编译期类型安全;单类型(如Box<T>)、双类型(如Pair<K,V>)、带边界(<T extends Number>)及通配符配合使用,均需紧扣业务角色与职责。

定义自定义 Java 泛型类,核心是把“类型”当作可配置的参数,让同一套逻辑适配多种数据类型,同时在编译期就守住类型安全。多类型参数不是堆砌符号,而是按业务角色分层建模——比如
单类型泛型类:最简起点,聚焦类型占位
从一个 Box
- 类声明写 class Box<T>,T 是类型变量,代表将来传入的具体引用类型(如 String、Integer)
- 成员变量用 T 声明:private T data;;方法签名也用 T:public void set(T value)、public T get()
- 实例化时必须指定真实类型:Box<String> box = new Box<>();,此时 set() 只接受 String,get() 返回 String,无需强转
- 避免用 Box<Object> 替代 —— 它失去类型约束,退化为原始集合的老问题
双类型泛型类:建立结构关系,如键值或输入输出
当逻辑天然涉及两个角色,例如缓存、映射或转换器,就用两个类型参数:
- 声明为 class Pair<K, V> 或 class Converter<T, R>,K/V 和 T/R 不是随意命名,而是体现语义(Key/Value,Source/Result)
- 内部可组合使用:private K key; + private V value;;或 public R convert(T input)
- 实例化时需同时指定:Pair<String, Integer> p = new Pair<>();、Converter<String, Boolean> c = new Converter<>();
- 两个参数可独立加界:<K extends CharSequence, V extends Number>,确保 K 支持 charAt()、V 支持 doubleValue()
带边界约束的泛型类:收窄能力,释放共通操作
仅靠
立即学习“Java免费学习笔记(深入)”;
- <T extends Number>:T 可以是 Integer、Double 等,因此可在类内放心调用 t.doubleValue() 或 t.intValue()
- <T extends Comparable<T>>:表示 T 必须能自己比较,于是可实现排序逻辑:if (a.compareTo(b) > 0) { ... }
- 多个上界用 & 连接:<T extends Runnable & Cloneable>,表示 T 必须同时实现两个接口
- 注意:super 不能用于类声明的类型参数,只适用于通配符(如方法参数中 Collection<? super T>)
配合通配符提升复用性:让泛型类“对外更柔,对内更刚”
泛型类自身类型固定,但它的方法参数或返回值可以更灵活,这时通配符就派上用场:
- 方法接收任意子类型集合:void printAll(List<? extends Number> list),可传 List<Integer> 或 List<BigDecimal>,但不能往里 add(只读安全)
- 方法接收能容纳目标类型的集合:void addZero(Collection<? super Integer> coll),可传 Collection<Number> 或 Collection<Object>,保证 Integer 能安全写入
- 完全未知类型用 ?,仅限调用 size()、isEmpty()、clear() 这类不依赖具体类型的方法
- 通配符只用于变量、参数、返回值,不能用于类定义(class Box<?> 是非法的)
多类型参数不是炫技,而是对业务抽象的自然反映。从 Box


















