java泛型代码编写

java泛型代码编写

泛型的由来

我们先看下面这段代码:

List list = new ArrayList();
list.add(24);  //向集合中添加一个 Integer 类型的数据
list.add("Tom");    //向集合中添加一个 String 类型的数据
 
for(int i = 0 ; i < list.size() ; i++){
    Object obj = list.get(i);  //注意这里每个类型都是 Object
    System.out.println(obj);
}
 
//如果我们遍历的时候就想得到自己想要的数据类型
for(int i = 0 ; i < list.size() ; i++){
    String obj = (String) list.get(i);  //在取 Integer 的时候会报类型转换错误
    System.out.println(obj);
}

 报错信息如下:

  也就是 集合中第二个数据是 Integer,但是我们取出来的时候将其转换为 String 了,所以报错。

  那么这个如何解决呢?

  ①、我们在遍历的时候,根据每个数据的类型判断,然后进行强转。

那么我们说这个集合只有两条数据,我们可以进行判断强转,如果数据有成千上万条呢,我们都通过这样判断强转肯定不可取

  ②、在往集合中加入数据的时候,我们就做好限制,比如这个集合只能添加 String 类型的;下一个集合只能添加 Integer 类型的,那么我们在取数据的时候,由于前面已经限制了该集合的数据类型,那么就很好强转了。

  这第二种解决办法,也就是我们这篇文章讲的 泛型

  泛型是Java SE 1.5的新特性,泛型的本质是参数化类型,也就是说所操作的数据类型被指定为一个参数。这种参数类型可以用在类、接口和方法的创建中,分别称为泛型类、泛型接口、泛型方法。

  在Java SE 1.5之前,没有泛型的情况的下,通过对类型Object的引用来实现参数的“任意化”,“任意化”带来的缺点是要做显式的强制类型转换,而这种转换是要求开发者对实际参数类型可以预知的情况下进行的。对于强制类型转换错误的情况,编译器可能不提示错误,在运行的时候才出现异常,这是一个安全隐患。

 

什么是泛型

在讲解什么是泛型之前,我们先观察Java标准库提供的ArrayList,它可以看作“可变长度”的数组,因为用起来比数组更方便。

实际上ArrayList内部就是一个Object[]数组,配合存储一个当前分配的长度,就可以充当“可变数组”:

public class ArrayList {
    private Object[] array;
    private int size;
    public void add(Object e) {...}
    public void remove(int index) {...}
    public Object get(int index) {...}
}

如果用上述ArrayList存储String类型,会有这么几个缺点:

  • 需要强制转型;

  • 不方便,易出错。

例如,代码必须这么写:

ArrayList list = new ArrayList();
list.add("Hello");
// 获取到Object,必须强制转型为String:
String first = (String) list.get(0);

很容易出现ClassCastException,因为容易“误转型”:

list.add(new Integer(123));
// ERROR: ClassCastException:
String second = (String) list.get(1);

要解决上述问题,我们可以为String单独编写一种ArrayList

public class StringArrayList {
    private String[] array;
    private int size;
    public void add(String e) {...}
    public void remove(int index) {...}
    public String get(int index) {...}
}

这样一来,存入的必须是String,取出的也一定是String,不需要强制转型,因为编译器会强制检查放入的类型:

StringArrayList list = new StringArrayList();
list.add("Hello");
String first = list.get(0);
// 编译错误: 不允许放入非String类型:
list.add(new Integer(123));

问题暂时解决。

然而,新的问题是,如果要存储Integer,还需要为Integer单独编写一种ArrayList

public class IntegerArrayList {
    private Integer[] array;
    private int size;
    public void add(Integer e) {...}
    public void remove(int index) {...}
    public Integer get(int index) {...}
}

实际上,还需要为其他所有class单独编写一种ArrayList

  • LongArrayList
  • DoubleArrayList
  • PersonArrayList
  • ...

这是不可能的,JDK的class就有上千个,而且它还不知道其他人编写的class。

为了解决新的问题,我们必须把ArrayList变成一种模板:ArrayList,代码如下:

public class ArrayList {
    private T[] array;
    private int size;
    public void add(T e) {...}
    public void remove(int index) {...}
    public T get(int index) {...}
}

T可以是任何class。这样一来,我们就实现了:编写一次模版,可以创建任意类型的ArrayList

// 创建可以存储String的ArrayList:
ArrayList strList = new ArrayList();
// 创建可以存储Float的ArrayList:
ArrayList floatList = new ArrayList();
// 创建可以存储Person的ArrayList:
ArrayList personList = new ArrayList();

因此,泛型就是定义一种模板,例如ArrayList,然后在代码中为用到的类创建对应的ArrayList<类型>

ArrayList strList = new ArrayList();

由编译器针对类型作检查:

strList.add("hello"); // OK
String s = strList.get(0); // OK
strList.add(new Integer(123)); // compile error!
Integer n = strList.get(0); // compile error!

这样一来,既实现了编写一次,万能匹配,又通过编译器保证了类型安全:这就是泛型。

向上转型

在Java标准库中的ArrayList实现了List接口,它可以向上转型为List

public class ArrayList implements List {
    ...
}

List list = new ArrayList();

即类型ArrayList可以向上转型为List

特别注意:不能把ArrayList向上转型为ArrayListList

这是为什么呢?假设ArrayList可以向上转型为ArrayList,观察一下代码:

// 创建ArrayList类型:
ArrayList integerList = new ArrayList();
// 添加一个Integer:
integerList.add(new Integer(123));
// “向上转型”为ArrayList:
ArrayList numberList = integerList;
// 添加一个Float,因为Float也是Number:
numberList.add(new Float(12.34));
// 从ArrayList获取索引为1的元素(即添加的Float):
Integer n = integerList.get(1); // ClassCastException!

我们把一个ArrayList转型为ArrayList类型后,这个ArrayList就可以接受Float类型,因为FloatNumber的子类。但是,ArrayList实际上和ArrayList是同一个对象,也就是ArrayList类型,它不可能接受Float类型, 所以在获取Integer的时候将产生ClassCastException

实际上,编译器为了避免这种错误,根本就不允许把ArrayList转型为ArrayList

 ArrayList和ArrayList两者完全没有继承关系。

泛型就是编写模板代码来适应任意类型;

泛型的好处是使用时不必对类型进行强制转换,它通过编译器对类型进行检查;

注意泛型的继承关系:可以把ArrayList向上转型为ListT不能变!),但不能把ArrayList向上转型为ArrayListT不能变成父类)。

 

泛型的基本用法

对于上面的问题我们只需要将上述代码的 List list = new ArrayList()  改为   List list = new ArrayList();

 List list = new ArrayList();
//list.add(22);  //向集合中添加一个 Integer 类型的数据时,编译器会报错
list.add("Bob");  //向集合中添加一个 String 类型的数据
list.add("Tom");    //向集合中添加一个 String 类型的数据
 
//如果我们遍历的时候就想得到自己想要的数据类型
for(int i = 0 ; i < list.size() ; i++){
    String obj = list.get(i);  //这里就不需要强转了,前面添加的是什么类型,这里获取的就是什么类型
    System.out.println(obj);
}           

泛型是在编译阶段有效

List list1 = new ArrayList();
List list2 = new ArrayList();
Class c1 = list1.getClass();
Class c2 = list2.getClass();
System.out.println(c1==c2); //true   

  上述代码,由于我们知道反射是在运行时阶段,c1==c2为 true,说明了编译之后的 class 文件中是不包含任意的泛型信息的。如果不信,我们可以看 class 文件的反编译信息

java.util.List list1 = new ArrayList();
java.util.List list2 = new ArrayList();
Class c1 = list1.getClass();
Class c2 = list2.getClass();
System.out.println(c1.equals(c2));

  我们可以看到 反编译之后的 list1和 list2完全一样。

  结论:Java 泛型只在编译阶段有效,即在编译过程中,程序会正确的检验泛型结果。而编译成功后,class 文件是不包含任何泛型信息的

泛型类和泛型方法

public class Box {
    private T box;
    public T getBox(T t){
        this.box = t;
        return t;
    }
    public void getType(){
        System.out.println("T的实际类型为:"+box.getClass().getName());
    }
     
    public static void main(String[] args) {
        Box box = new Box();
        System.out.println(box.getBox(1));
        box.getType();
         
        System.out.println(box.getBox("Tom"));
        box.getType();
    }
 
}

输出结果为:

1
T的实际类型为:java.lang.Integer
Tom T的实际类型为:java.lang.String

泛型通配符

  在泛型中,我们可以用 ? 来代替任意类型

public List wildCard(List list){
     
    return list;
}
 
public static void main(String[] args) {
    GenericTest gt = new GenericTest();
    //构造一个 Interger 类型的集合
    List integer = new ArrayList();
    integer.add(1);
    System.out.println(gt.wildCard(integer));
    //构造一个 String 类型的集合
    List str = new ArrayList();
    gt.wildCard(str);
    //构造一个 Object 类型的集合
    List obj = new ArrayList();
    obj.add(1);
    obj.add("a");
    System.out.println(gt.wildCard(obj));
    //构造一个 任意类型的 集合,这和 List 存放数据没啥区别
    List list = new ArrayList();
    gt.wildCard(list);
     
} 
  

泛型的上限和下限

  ①、上限: 语法(? extends className),即只能为 className 或 className 的子类

//通配符的下限,只能是 Number 或 Number的子类
    public List wildCard(List list){
         
        return list;
    }
 
    public static void main(String[] args) {
        GenericTest gt = new GenericTest();
        //构造一个 Interger 类型的集合
        List integer = new ArrayList();
        integer.add(1);
        System.out.println(gt.wildCard(integer));
        //构造一个 String 类型的集合
        List str = new ArrayList();
        //gt.wildCard(str);   //编译报错
        //构造一个 Object 类型的集合
        List obj = new ArrayList();
        obj.add(1);
        obj.add("a");
        //System.out.println(gt.wildCard(obj)); //编译报错
         
    } 
  

 ①、下限: 语法(? super className),即只能为 className 或 className 的父

//通配符的上限,只能是 Number 或 Number的父类
    public List wildCard(List list){
         
        return list;
    }
 
    public static void main(String[] args) {
        GenericTest gt = new GenericTest();
        //构造一个 Interger 类型的集合
        List integer = new ArrayList();
        integer.add(1);
        //System.out.println(gt.wildCard(integer));  //编译报错
        //构造一个 String 类型的集合
        List str = new ArrayList();
        //gt.wildCard(str);   //编译报错
        //构造一个 Object 类型的集合
        List obj = new ArrayList();
        obj.add(1);
        obj.add("a");
        System.out.println(gt.wildCard(obj));
    } 
  

泛型的注意事项

  4.1、不能用基本类型来定义泛型,如 int、float

List list = new ArrayList(); //不能用 int 这样的基本类型定义泛型

关于这一点很好想明白,因为 集合中只能存放引用类型的数据,即使你存入基本类型的,Java还是会通过自动拆箱和自动装箱机制将其转换为引用类型

 4.2、如果使用 ? 接收泛型对象时,则不能设置被泛型指定的内容

List list = new ArrayList<>();
        list.add("aa");  //错误,无法设置

   4.3、泛型方法的定义与其所在的类是否是泛型类是没有任何关系的,所在的类可以是泛型类,也可以不是泛型类

   4.4、泛型类没有继承关系,即String 为 Object 类型的子类,则 List 是 List 的子类这句话是错误的

  原因:假设上面那句话是正确的,那么由于泛型的产生机制就是放什么类型的数据进去,取出来的就是什么类型,而不用进行类型转换,这里把 String 类型的数据放入Object 类型的泛型集合中,那么取出来的应该就是 String类型的数据,而实际上取出来的是 Object 类型的数据,这与泛型的产生机制相违背,故不成立!

 

使用泛型

使用ArrayList时,如果不定义泛型类型时,泛型类型实际上就是Object

// 编译器警告:
List list = new ArrayList();
list.add("Hello");
list.add("World");
String first = (String) list.get(0);
String second = (String) list.get(1);

此时,只能把当作Object使用,没有发挥泛型的优势。

当我们定义泛型类型后,List的泛型接口变为强类型List

// 无编译器警告:
List list = new ArrayList();
list.add("Hello");
list.add("World");
// 无强制转型:
String first = list.get(0);
String second = list.get(1);

当我们定义泛型类型后,List的泛型接口变为强类型List

List list = new ArrayList();
list.add(new Integer(123));
list.add(new Double(12.34));
Number first = list.get(0);
Number second = list.get(1);

编译器如果能自动推断出泛型类型,就可以省略后面的泛型类型。例如,对于下面的代码:

List list = new ArrayList();

编译器看到泛型类型List就可以自动推断出后面的ArrayList的泛型类型必须是ArrayList,因此,可以把代码简写为:

// 可以省略后面的Number,编译器可以自动推断泛型类型:
List list = new ArrayList<>();

泛型接口

除了ArrayList使用了泛型,还可以在接口中使用泛型。例如,Arrays.sort(Object[])可以对任意数组进行排序,但待排序的元素必须实现Comparable这个泛型接口:

public interface Comparable {
    /**
     * 返回-1: 当前实例比参数o小
     * 返回0: 当前实例与参数o相等
     * 返回1: 当前实例比参数o大
     */
    int compareTo(T o);
}

可以直接对String数组进行排序:

        String[] ss = new String[] { "Orange", "Apple", "Pear" };
        Arrays.sort(ss);
        System.out.println(Arrays.toString(ss));

这是因为String本身已经实现了Comparable接口。如果换成我们自定义的Person类型试试:

class Person {
    String name;
    int score;
    Person(String name, int score) {
        this.name = name;
        this.score = score;
    }
    public String toString() {
        return this.name + "," + this.score;
    }
}
     
       Person[] ps = new Person[] {
            new Person("Bob", 61),
            new Person("Alice", 88),
            new Person("Lily", 75),
        };
        Arrays.sort(ps);
        System.out.println(Arrays.toString(ps));

运行程序,我们会得到ClassCastException,即无法将Person转型为Comparable。我们修改代码,让Person实现Comparable接口:

import java.util.Arrays;

public class Main {
    public static void main(String[] args) {
        Person[] ps = new Person[] {
            new Person("Bob", 61),
            new Person("Alice", 88),
            new Person("Lily", 75),
        };
        Arrays.sort(ps);
        System.out.println(Arrays.toString(ps));
    }
}

class Person implements Comparable {
    String name;
    int score;
    Person(String name, int score) {
        this.name = name;
        this.score = score;
    }
    public int compareTo(Person other) {
        return this.name.compareTo(other.name);
    }
    public String toString() {
        return this.name + "," + this.score;
    }
}

运行上述代码,可以正确实现按name进行排序。

也可以修改比较逻辑,例如,按score从高到低排序。请自行修改测试。

使用泛型时,把泛型参数替换为需要的class类型,例如:ArrayListArrayList等;

可以省略编译器能自动推断出的类型,例如:List list = new ArrayList<>();

不指定泛型参数类型时,编译器会给出警告,且只能将视为Object类型;

可以在接口中定义泛型类型,实现此接口的类必须实现正确的泛型类型。

 

编写泛型

编写泛型类比普通类要复杂。通常来说,泛型类一般用在集合类中,例如ArrayList,我们很少需要编写泛型类。

如果我们确实需要编写一个泛型类,那么,应该如何编写它?

可以按照以下步骤来编写一个泛型类。

首先,按照某种类型,例如:String,来编写类:

public class Pair {
    private String first;
    private String last;
    public Pair(String first, String last) {
        this.first = first;
        this.last = last;
    }
    public String getFirst() {
        return first;
    }
    public String getLast() {
        return last;
    }
}

然后,标记所有的特定类型,这里是String

public class Pair {
    private String first;
    private String last;
    public Pair(String first, String last) {
        this.first = first;
        this.last = last;
    }
    public String getFirst() {
        return first;
    }
    public String getLast() {
        return last;
    }
}

最后,把特定类型String替换为T,并申明

public class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
}

熟练后即可直接从T开始编写。

静态方法

编写泛型类时,要特别注意,泛型类型不能用于静态方法。例如:

public class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() { ... }
    public T getLast() { ... }

    // 对静态方法使用:
    public static Pair create(T first, T last) {
        return new Pair(first, last);
    }
}

上述代码会导致编译错误,我们无法在静态方法create()的方法参数和返回类型上使用泛型类型T

有些同学在网上搜索发现,可以在static修饰符后面加一个,编译就能通过:

public class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() { ... }
    public T getLast() { ... }

    // 可以编译通过:
    public static  Pair create(T first, T last) {
        return new Pair(first, last);
    }
}

但实际上,这个Pair类型的已经没有任何关系了。

对于静态方法,我们可以单独改写为“泛型”方法,只需要使用另一个类型即可。对于上面的create()静态方法,我们应该把它改为另一种泛型类型,例如,

public class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() { ... }
    public T getLast() { ... }

    // 静态泛型方法应该使用其他类型区分:
    public static  Pair create(K first, K last) {
        return new Pair(first, last);
    }
}

这样才能清楚地将静态方法的泛型类型和实例类型的泛型类型区分开。

多个泛型类型

泛型还可以定义多种类型。例如,我们希望Pair不总是存储两个类型一样的对象,就可以使用类型

public class Pair {
    private T first;
    private K last;
    public Pair(T first, K last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() { ... }
    public K getLast() { ... }
}

使用的时候,需要指出两种类型:

Pair p = new Pair<>("test", 123);

Java标准库的Map就是使用两种泛型类型的例子。它对Key使用一种类型,对Value使用另一种类型。

编写泛型时,需要定义泛型类型

静态方法不能引用泛型类型,必须定义其他类型(例如)来实现静态泛型方法;

泛型可以同时定义多种类型,例如Map

 

擦拭法

泛型是一种类似”模板代码“的技术,不同语言的泛型实现方式不一定相同。

Java语言的泛型实现方式是擦拭法(Type Erasure)。

所谓擦拭法是指,虚拟机对泛型其实一无所知,所有的工作都是编译器做的。

例如,我们编写了一个泛型类Pair,这是编译器看到的代码:

public class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
}

而虚拟机根本不知道泛型。这是虚拟机执行的代码:

public class Pair {
    private Object first;
    private Object last;
    public Pair(Object first, Object last) {
        this.first = first;
        this.last = last;
    }
    public Object getFirst() {
        return first;
    }
    public Object getLast() {
        return last;
    }
}

因此,Java使用擦拭法实现泛型,导致了:

  • 编译器把类型视为Object
  • 编译器根据实现安全的强制转型。

使用泛型的时候,我们编写的代码也是编译器看到的代码:

Pair p = new Pair<>("Hello", "world");
String first = p.getFirst();
String last = p.getLast();

而虚拟机执行的代码并没有泛型:

Pair p = new Pair("Hello", "world");
String first = (String) p.getFirst();
String last = (String) p.getLast();

所以,Java的泛型是由编译器在编译时实行的,编译器内部永远把所有类型T视为Object处理,但是,在需要转型的时候,编译器会根据T的类型自动为我们实行安全地强制转型。

了解了Java泛型的实现方式——擦拭法,我们就知道了Java泛型的局限:

局限一:不能是基本类型,例如int,因为实际类型是ObjectObject类型无法持有基本类型:

Pair p = new Pair<>(1, 2); // compile error!

局限二:无法取得带泛型的Class。观察以下代码:

class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
}
        Pair p1 = new Pair<>("Hello", "world");
        Pair p2 = new Pair<>(123, 456);
        Class c1 = p1.getClass();
        Class c2 = p2.getClass();
        System.out.println(c1==c2); // true
        System.out.println(c1==Pair.class); // true

因为TObject,我们对PairPair类型获取Class时,获取到的是同一个Class,也就是Pair类的Class

换句话说,所有泛型实例,无论T的类型是什么,getClass()返回同一个Class实例,因为编译后它们全部都是Pair

局限三:无法判断带泛型的Class

Pair p = new Pair<>(123, 456);
// Compile error:
if (p instanceof Pair.class) {
}

原因和前面一样,并不存在Pair.class,而是只有唯一的Pair.class

局限四:不能实例化T类型:

public class Pair {
    private T first;
    private T last;
    public Pair() {
        // Compile error:
        first = new T();
        last = new T();
    }
}

上述代码无法通过编译,因为构造方法的两行语句:

first = new T();
last = new T();

擦拭后实际上变成了:

first = new Object();
last = new Object();

这样一来,创建new Pair()和创建new Pair()就全部成了Object,显然编译器要阻止这种类型不对的代码。

要实例化T类型,我们必须借助额外的Class参数:

public class Pair {
    private T first;
    private T last;
    public Pair(Class clazz) {
        first = clazz.newInstance();
        last = clazz.newInstance();
    }
}

上述代码借助Class参数并通过反射来实例化T类型,使用的时候,也必须传入Class。例如:

Pair pair = new Pair<>(String.class);

因为传入了Class的实例,所以我们借助String.class就可以实例化String类型。

不恰当的覆写方法

有些时候,一个看似正确定义的方法会无法通过编译。例如:

public class Pair {
    public boolean equals(T t) {
        return this == t;
    }
}

这是因为,定义的equals(T t)方法实际上会被擦拭成equals(Object t),而这个方法是继承自Object的,编译器会阻止一个实际上会变成覆写的泛型方法定义。

换个方法名,避开与Object.equals(Object)的冲突就可以成功编译:

public class Pair {
    public boolean same(T t) {
        return this == t;
    }
}

泛型继承

一个类可以继承自一个泛型类。例如:父类的类型是Pair,子类的类型是IntPair,可以这么继承:

public class IntPair extends Pair {
}

使用的时候,因为子类IntPair并没有泛型类型,所以,正常使用即可:

IntPair ip = new IntPair(1, 2);

前面讲了,我们无法获取PairT类型,即给定一个变量Pair p,无法从p中获取到Integer类型。

但是,在父类是泛型类型的情况下,编译器就必须把类型T(对IntPair来说,也就是Integer类型)保存到子类的class文件中,不然编译器就不知道IntPair只能存取Integer这种类型。

在继承了泛型类型的情况下,子类可以获取父类的泛型类型。例如:IntPair可以获取到父类的泛型类型Integer。获取父类的泛型类型代码比较复杂:

        Class clazz = IntPair.class;
        Type t = clazz.getGenericSuperclass();
        if (t instanceof ParameterizedType) {
            ParameterizedType pt = (ParameterizedType) t;
            Type[] types = pt.getActualTypeArguments(); // 可能有多个泛型类型
            Type firstType = types[0]; // 取第一个泛型类型
            Class typeClass = (Class) firstType;
            System.out.println(typeClass); // Integer
        }
class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
}

class IntPair extends Pair {
    public IntPair(Integer first, Integer last) {
        super(first, last);
    }
}

因为Java引入了泛型,所以,只用Class来标识类型已经不够了。实际上,Java的类型系统结构如下:

                      ┌────┐
                      │Type│
                      └────┘
                         ▲
                         │
   ┌────────────┬────────┴─────────┬───────────────┐
   │            │                  │               │
┌─────┐┌─────────────────┐┌────────────────┐┌────────────┐
│Class││ParameterizedType││GenericArrayType││WildcardType│
└─────┘└─────────────────┘└────────────────┘└────────────┘

Java的泛型是采用擦拭法实现的;

擦拭法决定了泛型

  • 不能是基本类型,例如:int
  • 不能获取带泛型类型的Class,例如:Pair.class
  • 不能判断带泛型类型的类型,例如:x instanceof Pair
  • 不能实例化T类型,例如:new T()

泛型方法要防止重复定义方法,例如:public boolean equals(T obj)

子类可以获取父类的泛型类型

 

extends通配符

我们前面已经讲到了泛型的继承关系:Pair不是Pair的子类。

假设我们定义了Pair

public class Pair { ... }

然后,我们又针对Pair类型写了一个静态方法,它接收的参数类型是Pair

public class PairHelper {
    static int add(Pair p) {
        Number first = p.getFirst();
        Number last = p.getLast();
        return first.intValue() + last.intValue();
    }
}

上述代码是可以正常编译的。使用的时候,我们传入:

int sum = PairHelper.add(new Pair(1, 2));

注意:传入的类型是Pair,实际参数类型是(Integer, Integer)

既然实际参数是Integer类型,试试传入Pair

    public static void main(String[] args) {
        Pair p = new Pair<>(123, 456);
        int n = add(p);
        System.out.println(n);
    }

    static int add(Pair p) {
        Number first = p.getFirst();
        Number last = p.getLast();
        return first.intValue() + last.intValue();
    }
class Pair {
    private T first;
    private T last;
    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }
    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
}

直接运行,会得到一个编译错误:

incompatible types: Pair cannot be converted to Pair

原因很明显,因为Pair不是Pair的子类,因此,add(Pair)不接受参数类型Pair

但是从add()方法的代码可知,传入Pair是完全符合内部代码的类型规范,因为语句:

Number first = p.getFirst();
Number last = p.getLast();

实际类型是Integer,引用类型是Number,没有问题。问题在于方法参数类型定死了只能传入Pair

有没有办法使得方法参数接受Pair?办法是有的,这就是使用Pair使得方法接收所有泛型类型为NumberNumber子类的Pair类型。我们把代码改写如下:

    public static void main(String[] args) {
        Pair p = new Pair<>(123, 456);
        int n = add(p);
        System.out.println(n);
    }

    static int add(Pair p) {
        Number first = p.getFirst();
        Number last = p.getLast();
        return first.intValue() + last.intValue();
    }

这样一来,给方法传入Pair类型时,它符合参数Pair类型。这种使用的泛型定义称之为上界通配符(Upper Bounds Wildcards),即把泛型类型T的上界限定在Number了。

除了可以传入Pair类型,我们还可以传入Pair类型,Pair类型等等,因为DoubleBigDecimal都是Number的子类。

如果我们考察对Pair类型调用getFirst()方法,实际的方法签名变成了:

 getFirst();

即返回值是NumberNumber的子类,因此,可以安全赋值给Number类型的变量:

Number x = p.getFirst();

然后,我们不可预测实际类型就是Integer,例如,下面的代码是无法通过编译的:

Integer x = p.getFirst();

这是因为实际的返回类型可能是Integer,也可能是Double或者其他类型,编译器只能确定类型一定是Number的子类(包括Number类型本身),但具体类型无法确定。

我们再来考察一下Pairset方法:

    public static void main(String[] args) {
        Pair p = new Pair<>(123, 456);
        int n = add(p);
        System.out.println(n);
    }

    static int add(Pair p) {
        Number first = p.getFirst();
        Number last = p.getLast();
        p.setFirst(new Integer(first.intValue() + 100));
        p.setLast(new Integer(last.intValue() + 100));
        return p.getFirst().intValue() + p.getFirst().intValue();
    }
class Pair {
    private T first;
    private T last;

    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }

    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
    public void setFirst(T first) {
        this.first = first;
    }
    public void setLast(T last) {
        this.last = last;
    }
}

不出意外,我们会得到一个编译错误:

incompatible types: Integer cannot be converted to CAP#1
where CAP#1 is a fresh type-variable:
    CAP#1 extends Number from capture of ? extends Number

编译错误发生在p.setFirst()传入的参数是Integer类型。有些童鞋会问了,既然p的定义是Pair,那么setFirst(? extends Number)为什么不能传入Integer

原因还在于擦拭法。如果我们传入的pPair,显然它满足参数定义Pair,然而,PairsetFirst()显然无法接受Integer类型。

这就是通配符的一个重要限制:方法参数签名setFirst(? extends Number)无法传递任何Number类型给setFirst(? extends Number)

这里唯一的例外是可以给方法参数传入null

p.setFirst(null); // ok, 但是后面会抛出NullPointerException
p.getFirst().intValue(); // NullPointerException

extends通配符的作用

如果我们考察Java标准库的java.util.List接口,它实现的是一个类似“可变数组”的列表,主要功能包括:

public interface List {
    int size(); // 获取个数
    T get(int index); // 根据索引获取指定元素
    void add(T t); // 添加一个新元素
    void remove(T t); // 删除一个已有元素
}

现在,让我们定义一个方法来处理列表的每个元素:

int sumOfList(List list) {
    int sum = 0;
    for (int i=0; i

为什么我们定义的方法参数类型是List而不是List?从方法内部代码看,传入List或者List是完全一样的,但是,注意到List的限制:

  • 允许调用get()方法获取Integer的引用;
  • 不允许调用set(? extends Integer)方法并传入任何Integer的引用(null除外)。

因此,方法参数类型List表明了该方法内部只会读取List的元素,不会修改List的元素(因为无法调用add(? extends Integer)remove(? extends Integer)这些方法。换句话说,这是一个对参数List进行只读的方法(恶意调用set(null)除外)。

使用extends限定T类型

在定义泛型类型Pair的时候,也可以使用extends通配符来限定T的类型:

public class Pair { ... }

现在,我们只能定义:

Pair p1 = null;
Pair p2 = new Pair<>(1, 2);
Pair p3 = null;

因为NumberIntegerDouble都符合

Number类型将无法通过编译:

Pair p1 = null; // compile error!
Pair p2 = null; // compile error!
 
  

因为StringObject都不符合,因为它们不是Number类型或Number的子类。

使用类似通配符作为方法参数时表示:

  • 方法内部可以调用获取Number引用的方法,例如:Number n = obj.getFirst();

  • 方法内部无法调用传入Number引用的方法(null除外),例如:obj.setFirst(Number n);

即一句话总结:使用extends通配符表示可以读,不能写。

使用类似定义泛型类时表示:

  • 泛型类型限定为Number以及Number的子类。

 

super通配符

我们前面已经讲到了泛型的继承关系:Pair不是Pair的子类。

考察下面的set方法:

void set(Pair p, Integer first, Integer last) {
    p.setFirst(first);
    p.setLast(last);
}

传入Pair是允许的,但是传入Pair是不允许的。

extends通配符相反,这次,我们希望接受Pair类型,以及PairPair,因为NumberObjectInteger的父类,setFirst(Number)setFirst(Object)实际上允许接受Integer类型。

我们使用super通配符来改写这个方法:

void set(Pair p, Integer first, Integer last) {
    p.setFirst(first);
    p.setLast(last);
}

注意到Pair表示,方法参数接受所有泛型类型为IntegerInteger父类的Pair类型。

下面的代码可以被正常编译:

    public static void main(String[] args) {
        Pair p1 = new Pair<>(12.3, 4.56);
        Pair p2 = new Pair<>(123, 456);
        setSame(p1, 100);
        setSame(p2, 200);
        System.out.println(p1.getFirst() + ", " + p1.getLast());
        System.out.println(p2.getFirst() + ", " + p2.getLast());
    }

    static void setSame(Pair p, Integer n) {
        p.setFirst(n);
        p.setLast(n);
    }
class Pair {
    private T first;
    private T last;

    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }

    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
    public void setFirst(T first) {
        this.first = first;
    }
    public void setLast(T last) {
        this.last = last;
    }
}

考察PairsetFirst()方法,它的方法签名实际上是:

void setFirst(? super Integer);

因此,可以安全地传入Integer类型。

再考察PairgetFirst()方法,它的方法签名实际上是:

? super Integer getFirst();

这里注意到我们无法使用Integer类型来接收getFirst()的返回值,即下面的语句将无法通过编译:

Integer x = p.getFirst();

因为如果传入的实际类型是Pair,编译器无法将Number类型转型为Integer

注意:虽然Number是一个抽象类,我们无法直接实例化它。但是,即便Number不是抽象类,这里仍然无法通过编译。此外,传入Pair类型时,编译器也无法将Object类型转型为Integer

唯一可以接收getFirst()方法返回值的是Object类型:

Object obj = p.getFirst();

因此,使用通配符表示:

  • 允许调用set(? super Integer)方法传入Integer的引用;

  • 不允许调用get()方法获得Integer的引用。

唯一例外是可以获取Object的引用:Object o = p.getFirst()

换句话说,使用通配符作为方法参数,表示方法内部代码对于参数只能写,不能读。

使用super限定T类型

在定义泛型类型Pair的时候,也可以使用super通配符来限定T的类型:

public class Pair { ... }

现在,我们只能定义:

Pair p1 = null;
Pair p2 = new Pair<>(1, 2);
Pair p3 = null;
 
  

因为NumberIntegerObject都符合

Integer类型以及它的子类都将无法通过编译:

Pair p1 = null; // compile error!

对比extends和super通配符

我们再回顾一下extends通配符。作为方法参数,类型和类型的区别在于:

  • 允许调用读方法T get()获取T的引用,但不允许调用写方法set(T)传入T的引用(传入null除外);

  • 允许调用写方法set(T)传入T的引用,但不允许调用读方法T get()获取T的引用(获取Object除外)。

一个是允许读不允许写,另一个是允许写不允许读。

先记住上面的结论,我们来看Java标准库的Collections类定义的copy()方法:

public class Collections {
    // 把src的每个元素复制到dest中:
    public static  void copy(List dest, List src) {
        for (int i=0; i

它的作用是把一个List的每个元素依次添加到另一个List中。它的第一个参数是List,表示目标List,第二个参数List,表示要复制的List。我们可以简单地用for循环实现复制。在for循环中,我们可以看到,对于类型的变量src,我们可以安全地获取类型T的引用,而对于类型的变量dest,我们可以安全地传入T的引用。

这个copy()方法的定义就完美地展示了extendssuper的意图:

  • copy()方法内部不会读取dest,因为不能调用dest.get()来获取T的引用;

  • copy()方法内部也不会修改src,因为不能调用src.add(T)

这是由编译器检查来实现的。如果在方法代码中意外修改了src,或者意外读取了dest,就会导致一个编译错误:

public class Collections {
    // 把src的每个元素复制到dest中:
    public static  void copy(List dest, List src) {
        ...
        T t = dest.get(0); // compile error!
        src.add(t); // compile error!
    }
}

这个copy()方法的另一个好处是可以安全地把一个List添加到List,但是无法反过来添加:

// copy List to List ok:
List numList = ...;
List intList = ...;
Collections.copy(numList, intList);

// ERROR: cannot copy List to List:
Collections.copy(intList, numList);

而这些都是通过superextends通配符,并由编译器强制检查来实现的。

PECS原则

何时使用extends,何时使用super?为了便于记忆,我们可以用PECS原则:Producer Extends Consumer Super。

即:如果需要返回T,它是生产者(Producer),要使用extends通配符;如果需要写入T,它是消费者(Consumer),要使用super通配符。

还是以Collectionscopy()方法为例:

public class Collections {
    public static  void copy(List dest, List src) {
        for (int i=0; i

需要返回Tsrc是生产者,因此声明为List,需要写入Tdest是消费者,因此声明为List

无限定通配符

我们已经讨论了作为方法参数的作用。实际上,Java的泛型还允许使用无限定通配符(Unbounded Wildcard Type),即只定义一个?

void sample(Pair p) {
}

因为通配符既没有extends,也没有super,因此:

  • 不允许调用set(T)方法并传入引用(null除外);
  • 不允许调用T get()方法并获取T引用(只能获取Object引用)。

换句话说,既不能读,也不能写,那只能做一些null判断:

static boolean isNull(Pair p) {
    return p.getFirst() == null || p.getLast() == null;
}

大多数情况下,可以引入泛型参数消除通配符:

static  boolean isNull(Pair p) {
    return p.getFirst() == null || p.getLast() == null;
}

通配符有一个独特的特点,就是:Pair是所有Pair的超类:

    public static void main(String[] args) {
        Pair p = new Pair<>(123, 456);
        Pair p2 = p; // 安全地向上转型
        System.out.println(p2.getFirst() + ", " + p2.getLast());
    }
class Pair {
    private T first;
    private T last;

    public Pair(T first, T last) {
        this.first = first;
        this.last = last;
    }

    public T getFirst() {
        return first;
    }
    public T getLast() {
        return last;
    }
    public void setFirst(T first) {
        this.first = first;
    }
    public void setLast(T last) {
        this.last = last;
    }
}

上述代码是可以正常编译运行的,因为PairPair的子类,可以安全地向上转型。

使用类似通配符作为方法参数时表示:

  • 方法内部可以调用传入Integer引用的方法,例如:obj.setFirst(Integer n);

  • 方法内部无法调用获取Integer引用的方法(Object除外),例如:Integer n = obj.getFirst();

即使用super通配符表示只能写不能读。

使用extendssuper通配符要遵循PECS原则。

使用类似定义泛型类时表示:

  • 泛型类型限定为IntegerInteger的超类。

无限定通配符很少使用,可以用替换,同时它是所有类型的超类。

 

泛型和反射

Java的部分反射API也是泛型。例如:Class就是泛型:

// compile warning:
Class clazz = String.class;
String str = (String) clazz.newInstance();

// no warning:
Class clazz = String.class;
String str = clazz.newInstance();

调用ClassgetSuperclass()方法返回的Class类型是Class

Class sup = String.class.getSuperclass();

构造方法Constructor也是泛型:

Class clazz = Integer.class;
Constructor cons = clazz.getConstructor(int.class);
Integer i = cons.newInstance(123);

我们可以声明带泛型的数组,但不能用new操作符创建带泛型的数组:

Pair[] ps = null; // ok
Pair[] ps = new Pair[2]; // compile error!

必须通过强制转型实现带泛型的数组:

@SuppressWarnings("unchecked")
Pair[] ps = (Pair[]) new Pair[2];

使用泛型数组要特别小心,因为数组实际上在运行期没有泛型,编译器可以强制检查变量ps,因为它的类型是泛型数组。但是,编译器不会检查变量arr,因为它不是泛型数组。因为这两个变量实际上指向同一个数组,所以,操作arr可能导致从ps获取元素时报错,例如,以下代码演示了不安全地使用带泛型的数组:

Pair[] arr = new Pair[2];
Pair[] ps = (Pair[]) arr;

ps[0] = new Pair("a", "b");
arr[1] = new Pair(1, 2);

// ClassCastException:
Pair p = ps[1];
String s = p.getFirst();

要安全地使用泛型数组,必须扔掉arr的引用:

@SuppressWarnings("unchecked")
Pair[] ps = (Pair[]) new Pair[2];

上面的代码中,由于拿不到原始数组的引用,就只能对泛型数组ps进行操作,这种操作就是安全的。

带泛型的数组实际上是编译器的类型擦除:

Pair[] arr = new Pair[2];
Pair[] ps = (Pair[]) arr;

System.out.println(ps.getClass() == Pair[].class); // true

String s1 = (String) arr[0].getFirst();
String s2 = ps[0].getFirst();

所以我们不能直接创建泛型数组T[],因为擦拭后代码变为Object[]

// compile error:
public class Abc {
    T[] createArray() {
        return new T[5];
    }
}

必须借助Class来创建泛型数组:

T[] createArray(Class cls) {
    return (T[]) Array.newInstance(cls, 5);
}

我们还可以利用可变参数创建泛型数组T[]

public class ArrayHelper {
    @SafeVarargs
    static  T[] asArray(T... objs) {
        return objs;
    }
}

String[] ss = ArrayHelper.asArray("a", "b", "c");
Integer[] ns = ArrayHelper.asArray(1, 2, 3);

谨慎使用泛型可变参数

在上面的例子中,我们看到,通过:

static  T[] asArray(T... objs) {
    return objs;
}

似乎可以安全地创建一个泛型数组。但实际上,这种方法非常危险。以下代码来自《Effective Java》的示例:

    public static void main(String[] args) {
        String[] arr = asArray("one", "two", "three");
        System.out.println(Arrays.toString(arr));
        // ClassCastException:
        String[] firstTwo = pickTwo("one", "two", "three");
        System.out.println(Arrays.toString(firstTwo));
    }

    static  K[] pickTwo(K k1, K k2, K k3) {
        return asArray(k1, k2);
    }

    static  T[] asArray(T... objs) {
        return objs;
    }

直接调用asArray(T...)似乎没有问题,但是在另一个方法中,我们返回一个泛型数组就会产生ClassCastException,原因还是因为擦拭法,在pickTwo()方法内部,编译器无法检测K[]的正确类型,因此返回了Object[]

如果仔细观察,可以发现编译器对所有可变泛型参数都会发出警告,除非确认完全没有问题,才可以用@SafeVarargs消除警告。

 如果在方法内部创建了泛型数组,最好不要将它返回给外部使用。

更详细的解释请参考《Effective Java》“Item 32: Combine generics and varargs judiciously”。

部分反射API是泛型,例如:ClassConstructor

可以声明带泛型的数组,但不能直接创建带泛型的数组,必须强制转型;

可以通过Array.newInstance(Class, int)创建T[]数组,需要强制转型;

同时使用泛型和可变参数时需要特别小心。

 

 

 

 

 

你可能感兴趣的:(如何编写,java泛型代码编写)