按日期分组计算每日收支余额方法

本文详解如何基于已按日期分组的 Transaction 列表，使用 Java Stream 精确汇总每组中的收入与支出金额，并计算净余额，避免手动循环累加错误。

本文详解如何基于已按日期分组的 Transaction 列表，使用 Java Stream 精确汇总每组中的收入与支出金额，并计算净余额，避免手动循环累加错误。

在构建个人财务类应用时，一个常见需求是：将用户所有交易按日期聚合后，为每个日期动态计算「当日总收入 − 当日总支出」所得的净余额（即“剩余金额”）。您已在控制器中完成了按日期分组（TransactionGroup），但手动遍历求和易出错、逻辑冗余且难以维护。下面提供一套简洁、健壮、可复用的解决方案。

✅ 核心思路：流式分类聚合 + 类型安全计算

关键不在于“逐个判断再累加”，而在于利用 Stream API 对同一日期内的交易进行类型筛选与数值聚合。假设当前处理的是某个 TransactionGroup transGroup，其包含某一天的所有交易记录，推荐采用如下三步法：

LocalDate date = transGroup.getDate();
List<Transaction> transactions = transGroup.getTransactions();

// 1️⃣ 汇总当日所有 income 类型交易的 amount（自动跳过 null）
double totalIncome = transactions.stream()
    .filter(t -> "INCOME".equalsIgnoreCase(t.getTransactionType().name())) // 推荐用 enum name() 而非 getDisplayName()
    .mapToDouble(Transaction::getAmount)
    .sum();

// 2️⃣ 汇总当日所有 expense 类型交易的 amount
double totalExpense = transactions.stream()
    .filter(t -> "EXPENSE".equalsIgnoreCase(t.getTransactionType().name()))
    .mapToDouble(Transaction::getAmount)
    .sum();

// 3️⃣ 计算净余额（可正可负）
double dailyBalance = totalIncome - totalExpense;

System.out.printf("? %s | ? 收入: %.2f | ? 支出: %.2f | ⚖️ 结余: %.2f%n", 
    date, totalIncome, totalExpense, dailyBalance);

? 为什么推荐 t.getTransactionType().name()？
您的 TransactionType 是 @Enumerated(EnumType.STRING)，数据库存储的是 "INCOME"/"EXPENSE" 字符串。直接比对 name() 更可靠、性能更高，且避免因 getDisplayName() 实现变更（如返回中文）导致逻辑断裂。

✅ 集成到现有控制器（优化版）

将上述逻辑嵌入您的 getUserTransactions 方法中，为每个 TransactionGroup 添加 dailyBalance 属性，便于前端展示：

// 在循环处理 transactionByDate 前，先扩展 TransactionGroup 类（或使用 DTO）
public class TransactionGroup {
    private LocalDate date;
    private List<Transaction> transactions;
    private double dailyBalance; // 新增字段

    // ... getter/setter
    public void calculateDailyBalance() {
        double income = this.transactions.stream()
            .filter(t -> "INCOME".equalsIgnoreCase(t.getTransactionType().name()))
            .mapToDouble(Transaction::getAmount)
            .sum();
        double expense = this.transactions.stream()
            .filter(t -> "EXPENSE".equalsIgnoreCase(t.getTransactionType().name()))
            .mapToDouble(Transaction::getAmount)
            .sum();
        this.dailyBalance = income - expense;
    }
}

然后在控制器中调用：

for (Transaction t : transactions) {
    if (!currDate.isEqual(t.getDate())) {
        transGroup.setDate(currDate);
        transGroup.setTransactions(transOnSingleDate);
        transGroup.calculateDailyBalance(); // ? 关键：自动计算结余
        transactionByDate.add(transGroup);

        transGroup = new TransactionGroup();
        transOnSingleDate = new ArrayList<>();
    }
    transOnSingleDate.add(t);
    currDate = t.getDate();
}
// 处理最后一组
transGroup.setDate(currDate);
transGroup.setTransactions(transOnSingleDate);
transGroup.calculateDailyBalance(); // ? 不要遗漏！
transactionByDate.add(transGroup);

最后，在 Thymeleaf 模板中即可直接使用：

<div th:each="group : ${transactionGroup}">
  <h3 th:text="|? ${#temporals.format(group.date, 'dd/MM/yyyy')} (结余: $${group.dailyBalance})|"></h3>
  <ul>
    <li th:each="t : ${group.transactions}" 
        th:text="|• ${t.transactionType} — $${t.amount} ${t.note}|"></li>
  </ul>
</div>

⚠️ 注意事项与最佳实践

• 空值防护：Transaction::getAmount 返回 Double，mapToDouble() 会自动将 null 视为 0.0，无需额外判空（JDK 8+ 行为）；但若业务要求严格校验，可在 filter 中补充 .filter(t -> t.getAmount() != null)。
• 精度问题：金融场景慎用 double。如需高精度，请改用 BigDecimal 并配合 Stream.reduce()，例如：

  BigDecimal income = transactions.stream()
      .filter(t -> "INCOME".equals(t.getTransactionType().name()))
      .map(t -> Optional.ofNullable(t.getAmount()).map(BigDecimal::valueOf).orElse(BigDecimal.ZERO))
      .reduce(BigDecimal.ZERO, BigDecimal::add);

• 性能提示：当前逻辑在内存中完成聚合，适用于中等数据量（单日 ≤ 数百笔）。若单日交易超千笔，建议将聚合逻辑下推至数据库（如 JPQL SUM(CASE WHEN ...)），减少网络与 JVM 开销。
• 枚举一致性：确保 TransactionType 的 name() 与数据库存储值完全一致（全大写），避免大小写敏感导致漏匹配。

通过以上重构，您不仅解决了“如何正确求和并相减”的技术问题，更建立了清晰、可测试、易扩展的财务计算模型——这是构建可信财务功能的坚实基础。