当前位置: 代码网 > it编程>编程语言>Java > Java 泛型通配符 <? extends> vs <? super> 实战场景

Java 泛型通配符 <? extends> vs <? super> 实战场景

2025年12月23日 Java 我要评论
一、引言泛型通配符是 java 泛型的核心特性,但其<? extends>和<? super>的用法常让开发者混淆 —— 用错会导致编译报错(如 &ld

一、引言

泛型通配符是 java 泛型的核心特性,但其<? extends><? super>的用法常让开发者混淆 —— 用错会导致编译报错(如 “无法添加元素”“类型转换异常”),或隐藏逻辑隐患。实际开发中,集合传参、工具类设计、框架 api 调用都离不开这两个通配符。本文基于 java 17+,通过 “原理拆解 + 实战场景” 讲清两者差异,帮你快速掌握 “什么时候用 extends,什么时候用 super”。

二、核心知识点解析

1. 泛型通配符基础概念

泛型通配符(wildcard):用?表示未知的泛型类型,用于限制泛型的取值范围,增强代码灵活性(java 5 引入,java 17 + 优化了编译时类型检查精度)。

  • <? extends t>:上界通配符,限制泛型类型 “必须是 t 或 t 的子类”(如<? extends number>可匹配integerdoublenumber);
  • <? super t>:下界通配符,限制泛型类型 “必须是 t 或 t 的父类”(如<? super integer>可匹配integernumberobject)。

2. 核心原则:pecs 法则(producer extends, consumer super)

这是区分两者的关键法则,由 java 官方推荐:

  • producer(生产者):仅提供数据(取元素),不接收数据(存元素)→ 用<? extends t>;例:从集合中读取数据统计总和,集合是 “数据生产者”;
  • consumer(消费者):仅接收数据(存元素),不提供数据(或仅取 object 类型数据)→ 用<? super t>;例:向集合中添加数据,集合是 “数据消费者”。

3. 读写权限差异(java 17 + 编译检查)

通配符类型读取数据(取)写入数据(存)
<? extends t>可读取为 t 类型(安全)禁止写入(除 null 外),编译报错
<? super t>仅可读取为 object 类型(不安全)可写入 t 或 t 的子类(安全)

三、实战案例

场景 1:基础场景 —— 集合读写操作对比(java 17+)

示例 1:<? extends>读取数据(生产者场景)

// java 17+支持
import java.util.arraylist;
import java.util.list;
 
public class extendsdemo {
    // 统计数字集合的总和(仅读取,生产者)
    public static double sum(list<? extends number> numberlist) {
        double total = 0.0;
        for (number num : numberlist) {
            total += num.doublevalue(); // 读取为number类型,安全
        }
        // numberlist.add(10); // 编译报错:<? extends number> 禁止添加元素
        return total;
    }
 
    public static void main(string[] args) {
        list<integer> intlist = new arraylist<>();
        intlist.add(10);
        intlist.add(20);
        
        list<double> doublelist = new arraylist<>();
        doublelist.add(3.14);
        doublelist.add(6.28);
        
        // 支持integer、double等number子类集合
        //http://fycj.tm66d.cn 
        system.out.println("整数列表总和:" + sum(intlist)); // 输出30.0
        system.out.println("小数列表总和:" + sum(doublelist)); // 输出9.42
    }
 
}

示例 2:<? super>写入数据(消费者场景)

// java 17+支持
import java.util.arraylist;
import java.util.list;
 
public class superdemo {
    // 向集合中添加整数(仅写入,消费者)
    public static void addintegers(list<? super integer> integerlist) {
        integerlist.add(10); // 可添加integer类型
        integerlist.add(20); // 可添加integer子类(此处无子类,直接加integer)
        // integerlist.add(3.14); // 编译报错:double不是integer的子类
        
        // 读取时仅能转为object
        for (object obj : integerlist) {
            system.out.println("元素:" + obj);
        }
    }
 
    public static void main(string[] args) {
        list<integer> intlist = new arraylist<>();
        list<number> numberlist = new arraylist<>();
        list<object> objlist = new arraylist<>();
        
        // 支持integer、number、object等父类集合
        addintegers(intlist); // 输出:10、20
        addintegers(numberlist); // 输出:10、20
        addintegers(objlist); // 输出:10、20
    }
}

场景 2:进阶场景 —— 框架工具类设计(模拟 collections.addall)

java 17 + 的collections.addall方法底层使用<? super t>,支持向父类集合添加子类元素,我们模拟其核心逻辑:

// java 17+支持
import java.util.collection;
import java.util.list;
 
public class collectionutils {
    /**
     * 批量添加元素到集合(消费者场景,用<? super t>)
     * @param dest 目标集合(接收元素)
     * @param elements 待添加元素(t或t的子类)
     */
    @safevarargs
    public static <t> boolean addall(collection<? super t> dest, t... elements) {
        boolean modified = false;
        for (t elem : elements) {
            modified |= dest.add(elem); // 写入安全,编译通过
        }
        return modified;
    }
 
    public static void main(string[] args) {
        list<number> numberlist = new arraylist<>();
        integer[] ints = {1, 2, 3};
        double[] doubles = {4.0, 5.0};
        
        // 向number集合添加integer、double(number的子类)
        addall(numberlist, ints); 
        addall(numberlist, doubles);
        
        system.out.println(numberlist); // 输出:[1, 2, 3, 4.0, 5.0]
    }
}

场景 3:综合场景 —— 泛型方法的读写结合

// java 17+支持
import java.util.list;
 
public class genericcombinationdemo {
    /**
     * 从源集合读取数据(extends),写入目标集合(super)
     * @param source 源集合(生产者)
     * @param dest 目标集合(消费者)
     */
    public static <t> void copy(list<? extends t> source, list<? super t> dest) {
        for (t elem : source) {
            dest.add(elem); // 源集合取t类型,目标集合存t类型,双向安全
        }
    }
 
    public static void main(string[] args) {
        list<integer> intsource = list.of(1, 2, 3); // java 9+ list.of(),java 17+兼容
        list<number> numberdest = new arraylist<>();
        list<object> objdest = new arraylist<>();
        
        // 从integer集合复制到number、object集合
        copy(intsource, numberdest);
        copy(intsource, objdest);
        
        system.out.println(numberdest); // 输出:[1, 2, 3]
        system.out.println(objdest); // 输出:[1, 2, 3]
    }
}

四、易错点与避坑指南

易错点 1:用<? extends t>尝试添加元素

错误代码

list<? extends number> list = new arraylist<integer>();
list.add(10); // 编译报错:the method add(capture#1-of ? extends number) is undefined for the type list<capture#1-of ? extends number>

正确代码

list<number> list = new arraylist<integer>(); // 直接用具体类型接收,或用<? super t>
list.add(10);

原因分析<? extends number> 可能是list<integer>list<double>,若允许添加integer,当集合实际是list<double>时会导致类型不匹配,java 17 + 编译时直接禁止该操作(除list.add(null)外,null 是所有类型的实例)。

易错点 2:用<? super t>读取数据并强转

错误代码

list<? super integer> list = new arraylist<number>();
list.add(10);
integer num = (integer) list.get(0); // 编译警告,运行时可能报错

正确代码

list<? super integer> list = new arraylist<number>();
list.add(10);
object obj = list.get(0); // 仅能安全转为object
if (obj instanceof integer) {
    integer num = (integer) obj; // 加类型判断,避免强转异常
}

原因分析<? super integer> 可能是list<number>list<object>get(0)返回的是object类型,直接强转integer可能因集合中存在其他类型元素(如double)导致classcastexception

易错点 3:过度使用通配符,降低代码可读性

错误代码

// 无需通配符,直接用具体泛型即可
public static void process(list<? extends object> list) {
    // 逻辑...
}

正确代码

public static void process(list<object> list) {
    // 逻辑...
}

原因分析<? extends object> 等价于?,但语义不清晰,且无法添加任何非 null 元素;若业务允许所有类型,直接用list<object>更直观,且支持添加任意元素。

易错点 4:泛型数组与通配符混用错误

错误代码

list<? extends number>[] arr = new list<integer>[10]; 
// 编译报错:generic array creation 

正确代码

list<? extends number>[] arr = new list[10]; // 用原始类型数组(不推荐)
// 或优先用集合替代数组:
list<list<? extends number>> list = new arraylist<>();

原因分析:java 不允许创建泛型数组(如list<integer>[]),通配符泛型数组也不例外,避免数组协变导致的类型安全问题(java 17 + 仍严格限制该语法)。

易错点 5:方法返回值使用通配符

错误代码

// 返回值用通配符,调用方需额外处理类型,体验差
public static list<? extends number> createlist() {
    return new arraylist<integer>();
}

正确代码

// 直接返回具体泛型类型,或用泛型方法
public static list<integer> createlist() {
    return new arraylist<integer>();
}
// 或支持多种类型:
public static <t extends number> list<t> createlist(class<t> clazz) {
    return new arraylist<>();
}

原因分析:返回值用通配符会增加调用方的使用成本(需强制类型转换或类型判断),且无法充分利用泛型的类型安全特性,除非确需返回多种不确定类型,否则优先用具体泛型或泛型方法。

五、总结与扩展

本文核心是掌握 pecs 法则:生产者用<? extends t>(读数据),消费者用<? super t>(写数据),读写结合时两者搭配使用。java 17 + 对泛型通配符的编译检查更严格,能提前规避多数类型错误。扩展方向:1. 学习泛型上限(<t extends number>)与上界通配符的区别;2. 研究 java 21 新特性 “泛型模式匹配” 对通配符的优化;3. 分析 spring、mybatis 等框架中通配符的应用场景(如parameterizedtype处理)。

面试高频提问

  1. 泛型通配符<? extends><? super>的核心区别是什么?pecs 法则的含义?
  2. 为什么<? extends t>不能添加元素,而<? super t>可以?
  3. 方法参数用list<t>list<? extends t>有什么区别?
  4. 如何安全地从<? super t>集合中读取t类型元素?

到此这篇关于java 泛型通配符 <? extends> vs <? super> 实战场景的文章就介绍到这了,更多相关java 泛型通配符 内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com