本文详细指导如何在java中为一个自定义的`money`类实现一个健壮的`add`方法，以实现两个货币对象的加法运算。重点讲解了如何正确处理美分（cents）的溢出逻辑，确保货币金额始终保持有效表示，并讨论了在方法设计中关于对象可变性的重要考量。
在面向对象编程中，处理货币金额是一项常见任务。一个设计良好的Money类不仅需要存储美元和美分，还应提供可靠的算术运算方法。本文将以一个Java Money类为例，详细阐述如何实现其add方法，确保货币加法运算的准确性和健壮性。
1. Money类基础结构概述
一个基本的Money类通常包含两个私有字段：dollars（美元）和cents（美分）。关键在于，cents字段应始终保持在一个有效范围内，通常是[0, 99]。这意味着每当美分累加到100或更多时，就需要将溢出的部分转换为美元。
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(); // 确保从输入解析的值也符合规范
}
*/
}2. add方法的核心逻辑实现
add方法的目标是将另一个Money对象的值加到当前对象（接收者）上。实现这个方法需要考虑以下几个关键步骤：
2.1 空值（null）参数检查
在执行任何加法操作之前，必须检查传入的other对象是否为null。如果为null，尝试访问其字段会导致NullPointerException。通常，这种情况下可以选择抛出IllegalArgumentException或返回当前对象而不做任何修改。
立即学习“Java免费学习笔记（深入）”；
2.2 基本加法运算
首先，将other对象的dollars和cents分别累加到当前对象的dollars和cents上。
2.3 美分溢出处理与规范化
这是实现货币加法最关键的一步。由于cents必须保持在[0, 99]的范围内，累加后如果this.cents达到或超过100，就需要进行规范化。这意味着将多余的美分转换为美元，并更新this.cents为剩余的美分。前面定义的normalize()辅助方法正是为此目的而设计。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
2.4 返回值设计
在许多情况下，add方法被设计为修改当前对象（接收者）的状态，并返回对当前对象的引用（this），这使得方法可以链式调用。
结合以上步骤，add方法的实现如下：
// 接续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; // 返回当前对象
}
}3. 设计考量与注意事项
在实现Money类的算术运算时，有几个重要的设计决策和注意事项需要考虑。
3.1 对象的可变性 (Mutability)
上述add方法的实现使得Money对象是可变的（Mutable），即调用add方法会改变对象自身的内部状态。
- 优点: 性能上可能更高效，因为它避免了创建新对象的开销。
-
缺点:
- 线程安全问题: 在多线程环境中，如果多个线程同时修改同一个Money对象，可能会导致数据不一致。
- 副作用: 方法调用会改变对象状态，可能导致难以追踪的副作用，尤其是在复杂系统中。
- 不可预测性: 当一个Money对象被多个引用共享时，通过其中一个引用对其进行修改，会影响所有引用。
替代方案：实现不可变（Immutable）的add方法
为了避免可变性带来的问题，可以设计一个返回新Money对象的add方法，而不修改当前对象。这种方法被称为不可变操作。
// 接续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对象 
