Java多米诺记忆游戏：修复比较与状态问题解析

问题剖析：为何多米诺牌无法正确揭示与游戏不结束

在构建Java多米诺记忆游戏时，开发者常会遇到两个关键挑战：

1. 对象比较不准确： 游戏未能正确识别两个多米诺牌是否匹配。原始代码中，MemoryLane类的guess方法使用了board[i] == board[k]进行比较。在Java中，==运算符对于对象类型而言，比较的是两个引用是否指向内存中的同一个对象实例，而不是它们的内容（即多米诺牌的顶部和底部数字）是否相同。这导致即使两个多米诺牌的数字完全一致，但只要它们是不同的对象实例，==比较就会返回false。
2. 牌面状态未更新： 即使玩家猜测正确，对应的多米诺牌也没有保持揭示状态。Domino类提供了setRevealed(boolean revealed)方法来控制牌的显示状态，但MemoryLane类的guess方法在判断匹配成功后，并没有调用此方法来更新多米诺牌的revealed属性。这直接导致了MemoryLane的toString()方法在渲染棋盘时，无法根据isRevealed()的返回值正确显示已匹配的牌。

这两个问题共同导致了游戏无法按照预期进行：牌面无法保持揭示，并且由于gameOver()方法依赖于所有牌都被揭示的计数，游戏也永远无法判断为结束。

解决方案一：正确重写 equals() 与 hashCode() 方法

要解决对象比较不准确的问题，我们需要在Domino类中重写equals()方法。Java的Object类默认的equals()方法行为与==运算符相同，即比较内存地址。为了实现基于内容的比较，我们必须提供自定义的逻辑。

当重写equals()方法时，强烈建议同时重写hashCode()方法。这是Java契约的一部分：如果两个对象根据equals()方法是相等的，那么它们的hashCode()方法必须产生相同的整数结果。违反这一契约会导致在使用基于哈希的集合（如HashMap、HashSet）时出现不可预测的行为。

以下是Domino类中equals()和hashCode()的正确实现：

public class Domino {
    private int top, bottom;
    private boolean revealed;

    public Domino(int x, int y) {
        // 确保top <= bottom，使(x,y)和(y,x)被视为同一个多米诺牌
        if (x > y) {
            top = y;
            bottom = x;
        } else {
            top = x;
            bottom = y;
        }
    }

    public int getTop() {
        return top;
    }

    public int getBottom() {
        return bottom;
    }

    public boolean isRevealed() {
        return revealed; // 简化逻辑，直接返回revealed
    }

    public void setRevealed(boolean revealed) {
        this.revealed = revealed;
    }

    @Override
    public int hashCode() {
        int hash = 7;
        // 使用top和bottom的值计算哈希码
        hash = 59 * hash + this.getTop();
        hash = 59 * hash + this.getBottom();
        return hash;
    }

    @Override
    public boolean equals(Object obj) {
        // 1. 检查是否是同一个对象引用
        if (this == obj) {
            return true;
        }
        // 2. 检查传入对象是否为null或类型不匹配
        if (!(obj instanceof Domino)) {
            return false;
        }
        // 3. 类型转换
        final Domino other = (Domino) obj;
        // 4. 比较关键属性
        if (this.getTop() != other.getTop()) {
            return false;
        }
        if (this.getBottom() != other.getBottom()) {
            return false;
        }
        return true; // 所有属性都匹配，则认为相等
    }
}

注意事项：

• 在equals方法中，我们首先检查对象引用是否相同，然后检查类型兼容性，最后才比较关键属性（top和bottom）。
• hashCode的实现确保了如果两个Domino对象在逻辑上相等（即top和bottom值相同），它们会产生相同的哈希码。

解决方案二：在游戏逻辑中更新多米诺牌的揭示状态

解决了对象比较问题后，下一步是在MemoryLane类的guess方法中，当玩家猜对时，更新相应多米诺牌的revealed状态。

修改MemoryLane类的guess方法如下：

import java.util.Arrays;
import java.util.Random;

public class MemoryLane {
    private Domino[] board;

    // ... (构造函数和shuffle方法保持不变) ...

    public boolean guess(int i, int k) {
        // 使用重写后的equals方法进行对象内容比较
        if (board[i].equals(board[k])) {
            // 如果匹配，设置这两个多米诺牌为已揭示
            board[i].setRevealed(true);
            board[k].setRevealed(true);
            return true;
        }
        return false;
    }

    // ... (peek, gameOver, toString 方法保持不变) ...
}

通过在guess方法中调用board[i].setRevealed(true)和board[k].setRevealed(true)，我们确保了当两个多米诺牌匹配时，它们的revealed状态被正确更新。

确保游戏结束机制正常运作

MemoryLane类中的gameOver()方法负责判断游戏是否结束，它通过遍历board数组，统计所有已揭示的多米诺牌数量，并与棋盘总长度进行比较。

public boolean gameOver() {
    int count = 0;
    for(int i = 0; i < board.length; i++) {
        if(board[i].isRevealed()) { // 检查每个多米诺牌的揭示状态
            count ++;
        }
    }
    return (count == board.length); // 如果所有牌都已揭示，则游戏结束
}

由于我们已经在guess方法中正确地更新了匹配多米诺牌的revealed状态，isRevealed()方法现在将返回正确的值。这意味着gameOver()方法将能够准确地追踪游戏进度，并在所有多米诺牌都被揭示时，正确地将游戏标记为结束。

总结与最佳实践

本次问题修复强调了Java面向对象编程中的几个核心概念：

1. 对象比较的语义： 理解==运算符和equals()方法在对象比较上的区别至关重要。对于自定义类，如果需要基于对象内容进行比较，必须重写equals()方法。
2. equals()与hashCode()的契约： 当重写equals()时，务必同时重写hashCode()，以保证哈希集合（如HashMap、HashSet）的正确性和性能。
3. 对象状态管理： 确保在业务逻辑中，当对象的状态发生变化时，及时调用相应的setter方法来更新其内部属性。这是实现正确游戏逻辑和UI反馈的基础。

通过正确实现这些原则，我们不仅修复了多米诺记忆游戏的显示和结束问题，也提升了代码的健壮性和可维护性。在未来的Java开发中，牢记这些最佳实践将有助于避免类似的常见错误。