14.2　CardCollection

14.2　CardCollection

下面是 CardCollection 类的初始定义，它用的是 ArrayList 而不是基本数组类型：

public class CardCollection {
    private String label;
    private ArrayList<Card> cards;
    public CardCollection(String label) {
        this.label = label;
        this.cards = new ArrayList<Card>();
    }
}

声明 ArrayList 时，需要在尖括号（<>）中指定它将包含的对象的类型。上述声明指出 cards 是一个包含 Card 对象的 ArrayList。

构造函数接受一个字符串实参，并将其赋给实例变量 label；它还将 cards 初始化为一个空的 ArrayList。

ArrayList 提供了方法 add，用于在集合中添加元素。我们给 CardCollection 添加一个执行这种任务的方法：

public void addCard(Card card) {
    this.cards.add(card);
}

在本书前面，为方便识别属性，我们显式地使用了 this。在 addCard 和其他实例方法中，不使用关键字 this 也可访问实例变量，因此从现在开始，我们将省略 this：

public void addCard(Card card) {
    cards.add(card);
}

我们还需要提供将扑克牌从集合中删除的功能。下面的方法接受一个索引，删除指定位置的扑克牌，并将后面的扑克牌前移，以填补留下的空缺：

public Card popCard(int i) {
    return cards.remove(i);
}

从一副洗好的牌中发牌时，发哪张牌无所谓，但效率最高的做法是先发最后的牌，这样就不用移动余下的牌了。下面是被重载的方法 popCard 的版本之一，它删除并返回最后一张牌：

public Card popCard() {
    int i = size() - 1;
    return popCard(i);
}

注意，popCard 调用了 CardCollection 的方法 size，这个方法转而调用了 ArrayList 的方法 size：

public int size() {
    return cards.size();
}

出于方便考虑，CardCollection 还提供了方法 empty，它在 size 为 0 时返回 true：

public boolean empty() {
    return cards.size() == 0;
}

像 addCard、popCard 和 size 这样只是调用另一个方法，而本身所做不多的方法被称为包装器方法（wrapper method）。我们将用这些包装器方法来实现一些更重要的方法，如 deal：

public void deal(CardCollection that, int n) {
    for (int i = 0; i < n; i++) {
        Card card = popCard();
        that.addCard(card);
    }
}

方法 deal 将扑克牌从当前集合（this）中删除，并将其加入到通过参数（that）指定的集合中。第二个形参 n 指定要发多少张牌。

访问 ArrayList 的元素时，不能使用数组运算符 []，而必须使用方法 get 和 set。下面是一个调用 get 的包装器方法：

public Card getCard(int i) {
    return cards.get(i);
}

方法 last 获取最后一张牌，但不删除：

public Card last() {
    int i = size() - 1;
    return cards.get(i);
}

为对修改扑克牌集合的方式进行控制，我们没有提供调用 set 的包装器方法。在我们提供的方法中，只有两个版本的 popCard 以及下述版本的 swapCards 是非纯方法：

public void swapCards(int i, int j) {
    Card temp = cards.get(i);
    cards.set(i, cards.get(j));
    cards.set(j, temp);
}

我们用 swapCards 实现 shuffle，这在 13.2 节中讨论过：

public void shuffle() {
    Random random = new Random();
    for (int i = size() - 1; i > 0; i--) {
        int j = random.nextInt(i);
        swapCards(i, j);
    }
}

ArrayList 还提供了这里没有使用的其他方法。要了解这些方法，可查阅相关的文档；而要查找这些文档，可在网上搜索 Java ArrayList。

14.2 CardCollection