Java中实现货币类加法操作的指南与实践

import java.util.Objects; // 用于hashCode和equals
// import java.util.Scanner; // 如果需要从Scanner构造，可以引入

class Money {
    private int cents;
    private int dollars;

    // 默认构造函数
    public Money() {
        this(0, 0);
    }

    // 带参数的构造函数，并进行规范化
    public Money(int dollars, int cents) {
        this.dollars = dollars;
        this.cents = cents;
        normalize(); // 确保初始值符合规范
    }

    // 辅助方法：规范化美分值，确保其在[0, 99]范围内
    private void normalize() {
        if (this.cents >= 100) {
            this.dollars += this.cents / 100; // 将溢出的美分转换为美元
            this.cents %= 100; // 保留剩余的美分
        }
        // 如果需要支持负数金额，这里还需要处理 this.cents < 0 的情况
        // 例如：
        // while (this.cents < 0) {
        //     this.cents += 100;
        //     this.dollars--;
        // }
    }

    // 重写toString方法，用于友好的字符串表示
    @Override
    public String toString() {
        return "$" + dollars + "." + String.format("%02d", cents); // 格式化美分，确保总是两位数
    }

    // 重写equals方法，用于比较两个Money对象的值是否相等
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Money money = (Money) o;
        return cents == money.cents && dollars == money.dollars;
    }

    // 重写hashCode方法，与equals方法同步，用于哈希集合等场景
    @Override
    public int hashCode() {
        return Objects.hash(cents, dollars);
    }

    // 其他方法（例如从Scanner读取的构造函数，此处省略以保持焦点）
    /*
    public Money(Scanner sc) {
        String token = sc.next();
        int dot = token.indexOf(".");
        this.cents = Integer.parseInt(token.substring(dot + 1));
        this.dollars = Integer.parseInt(token.substring(1, dot));
        normalize(); // 确保从输入解析的值也符合规范
    }
    */
}

// 接续Money类定义
class Money {
    // ... (现有字段、构造函数、toString、equals、hashCode和normalize方法) ...

    /**
     * 实现货币加法方法。
     * 该方法会修改当前Money对象（接收者）的状态，并返回自身。
     *
     * @param other 另一个Money对象，其值将被加到当前对象上。
     * @return 修改后的当前Money对象。
     * @throws IllegalArgumentException 如果other参数为null。
     */
    public Money add(Money other) {
        if (other == null) {
            throw new IllegalArgumentException("Cannot add a null Money object.");
        }

        this.cents += other.cents;     // 累加美分
        this.dollars += other.dollars; // 累加美元
        normalize();                    // 规范化美分值

        return this; // 返回当前对象
    }
}

// 接续Money类定义
class Money {
    // ... (现有字段、构造函数、toString、equals、hashCode和normalize方法) ...

    /**
     * 实现不可变货币加法方法。
     * 该方法不会修改当前Money对象，而是返回一个包含加法结果的新Money对象。
     *
     * @param other 另一个Money对象，其值将被加到当前对象上。
     * @return 一个新的Money对象，表示加法结果。
     * @throws IllegalArgumentException 如果other参数为null。
     */
    public Money addImmutable(Money other) {
        if (other == null) {
            throw new IllegalArgumentException("Cannot add a null Money object.");
        }
        int resultDollars = this.dollars + other.dollars;
        int resultCents = this.cents + other.cents;

        // 规范化结果
        resultDollars += resultCents / 100;
        resultCents %= 100;

        return new Money(resultDollars, resultCents); // 返回一个新的Money对象