第二十八条：利用有限通配符提升API的灵活性

一、实例（一）

我们有一个Stack类

public Stack{
    //有如下方法
    public void put(E data);
    public E pop();
}

我们想增加能够将容器中的所有数据存储到栈中的方法： putAll(Iterator  iterator)

Stack类的完整实现：

public class GenericsStack {
	private static final int DEFAULT_SIZE = 16;
	//该行出现了错误，无法创建泛型数组
	private Object[] objects = new Object[DEFAULT_SIZE];

	private int count = 0;
	
	public void put(E obj){
		expandArray();
		objects[count] = obj;
		++count;
	}

	private void expandArray(){
		if(count == objects.length){
			//扩充容量
			objects = Arrays.copyOf(objects, 2*count);
		}
	}
	
	public E pop(){
		//首先判断是否数组为空
		if (!isEmpty()){
			@SuppressWarnings("unchecked")
			E obj = (E)objects[count];
			--count;
			return obj;
		}
		return null;
		
	}

	
	private boolean isEmpty(){
		if (count == 0){
			return true;
		}
		else {
			return false;
		}
	}
	//获取迭代器
	public void putAll(Iterator iterator){
		while(iterator.hasNext()){
			E e = iterator.next();
			put(e);
		}
	}
}

使用：

		List numbers = new ArrayList(); 
		GenericsStack stack = new GenericsStack();
		stack.putAll(numbers.iterator());

既然是Number的栈，那么应该可以存储Number的子类，Integer才是。没错使用Stack的put(E data)方法确实可以。

那么表示putAll(Iterator iterator)应该也能接收List的迭代器然后遍历Integer才是，因为Stack能够存储Integer。

但是由于泛型的不可变性，Iterator ！= Iterator，也就是说

List numbers = new ArrayList(); 
GenericsStack stack = new GenericsStack();
stack.putAll(numbers.iterator());//存入了Iterator，是会报错的

是错误的。那么显然这个方法是不完整的。

那么怎么能够让putAll(Iterator iterator)接收Iterator呢？

将输入参数中的Iterator 修改成 Iterator 表示：接收的参数扩展为E及其的子类。

public void putAll(Iterator iterator)

因为Integer是Number的子类，所以成立，这就不会报错了。

二、实例（二）

既然我们有了让容器的数据，全部放到Stack中的方法，那么应该还有一个能够让Stack类内的数据全部放到容器中的方法。

	public void popAll(Collection collection){
		E data = pop();
		if (data != null){
			collection.add(data);
		}
	}

然后我们来调用这个方法

		//使用正确
		Collection collection = new ArrayList();
		stack.popAll(collection);
		//使用错误
		Collection