Java记账系统实战：从零开始构建你的个人财务管家188

在数字化的今天，个人财务管理变得越来越重要。无论是为了追踪日常开销、规划储蓄，还是仅仅想了解钱都花到哪里去了，一个高效的记账系统都能提供巨大帮助。作为一名专业的程序员，我们不仅可以利用现有的记账软件，更可以亲手打造一个符合自己需求的记账系统。本文将以Java语言为核心，从零开始，详细讲解如何构建一个功能完善的个人记账系统，包括核心概念、代码实现、数据持久化以及未来的功能拓展。

一、记账系统的核心概念与设计

构建任何系统，首先需要明确其核心业务逻辑和数据模型。一个基础的记账系统至少包含以下几个核心概念：
账户 (Account)： 存储资金的地方，如银行卡、现金、支付宝、微信钱包等。每个账户应有名称和当前余额。
交易 (Transaction)： 资金流动的具体记录。它包括交易日期、金额、类型（收入/支出/转账）、描述、所属分类、以及涉及的账户。
交易类型 (TransactionType)： 用于区分交易的性质，例如收入 (INCOME)、支出 (EXPENSE)、转账 (TRANSFER)。
分类 (Category)： 用于归类交易，便于统计分析，如餐饮、交通、工资、理财等。

基于这些概念，我们可以设计出以下Java类来表示它们：

1.1 `TransactionType` 枚举

用枚举来表示交易类型是最清晰和安全的方式。package ;
public enum TransactionType {
INCOME("收入"),
EXPENSE("支出"),
TRANSFER("转账");
private final String description;
TransactionType(String description) {
= description;
}
public String getDescription() {
return description;
}
}

1.3 `Account` 类

账户类包含名称和余额。考虑到金额计算的精确性，我们使用 `BigDecimal` 而不是 `double` 或 `float`。package ;
import ;
import ;
import ;
public class Account implements Serializable {
private static final long serialVersionUID = 1L;
private String name;
private BigDecimal balance;
public Account(String name, BigDecimal initialBalance) {
= name;
= initialBalance;
}
public String getName() {
return name;
}
public void setName(String name) {
= name;
}
public BigDecimal getBalance() {
return balance;
}
// 更新余额的方法
public void deposit(BigDecimal amount) {
= (amount);
}
public void withdraw(BigDecimal amount) {
= (amount);
}
@Override
public String toString() {
return "账户名: " + name + ", 余额: " + ();
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != ()) return false;
Account account = (Account) o;
return ();
}
@Override
public int hashCode() {
return (name);
}
}

1.4 `Transaction` 类

交易类是记账的核心，记录了所有交易的详细信息。package ;
import ;
import ;
import ;
import ; // 用于生成唯一ID
public class Transaction implements Serializable {
private static final long serialVersionUID = 1L;
private String id; // 唯一ID
private LocalDate date;
private BigDecimal amount;
private TransactionType type;
private String description;
private Category category;
private Account account; // 涉及的账户
private Account targetAccount; // 如果是转账，目标账户
public Transaction(LocalDate date, BigDecimal amount, TransactionType type,
String description, Category category, Account account) {
= ().toString();
= date;
= amount;
= type;
= description;
= category;
= account;
}
// 转账专用构造器
public Transaction(LocalDate date, BigDecimal amount, TransactionType type,
String description, Account sourceAccount, Account targetAccount) {
this(date, amount, type, description, new Category("转账"), sourceAccount); // 转账也给一个默认分类
= targetAccount;
}
// Getters for all fields
public String getId() { return id; }
public LocalDate getDate() { return date; }
public BigDecimal getAmount() { return amount; }
public TransactionType getType() { return type; }
public String getDescription() { return description; }
public Category getCategory() { return category; }
public Account getAccount() { return account; }
public Account getTargetAccount() { return targetAccount; }
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
("ID: ").append((0, 8)).append("...").append("");
(" 日期: ").append(date).append("");
(" 类型: ").append(()).append("");
(" 金额: ").append(()).append("");
(" 描述: ").append(description).append("");
(" 分类: ").append(()).append("");
(" 账户: ").append(()).append("");
if (type == && targetAccount != null) {
(" 目标账户: ").append(()).append("");
}
return ();
}
}

二、记账系统核心逻辑实现 (`Ledger` 服务类)

有了数据模型，我们需要一个服务类来管理账户和交易，提供添加、查询、更新等操作。我们将其命名为 `Ledger` (账本)。package ;
import ;
import ;
import ;
import ;
import .*;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
public class Ledger implements Serializable {
private static final long serialVersionUID = 1L;
private List<Account> accounts;
private List<Transaction> transactions;
private List<Category> categories; // 预设或用户自定义分类
public Ledger() {
= new ArrayList<>();
= new ArrayList<>();
= new ArrayList<>();
// 初始化一些默认分类
initDefaultCategories();
}
private void initDefaultCategories() {
(new Category("餐饮"));
(new Category("交通"));
(new Category("购物"));
(new Category("住房"));
(new Category("娱乐"));
(new Category("工资"));
(new Category("理财"));
(new Category("其他收入"));
(new Category("其他支出"));
(new Category("转账")); // 确保转账分类存在
}
// region 账户管理
public void addAccount(Account account) {
if (!(account)) {
(account);
("账户 " + () + " 添加成功，初始余额: " + ().toPlainString());
} else {
("账户 " + () + " 已存在。");
}
}
public List<Account> getAllAccounts() {
return new ArrayList<>(accounts); // 返回副本防止外部修改
}
public Optional<Account> getAccountByName(String name) {
return ()
.filter(a -> ().equalsIgnoreCase(name))
.findFirst();
}
public void removeAccount(String name) {
Optional<Account> accountOptional = getAccountByName(name);
if (()) {
Account accountToRemove = ();
// 在移除账户前，检查是否有与该账户相关的交易
boolean hasTransactions = ()
.anyMatch(t -> ().equals(accountToRemove) ||
(() == && () != null && ().equals(accountToRemove)));
if (hasTransactions) {
("无法删除账户 " + name + "，因为存在相关交易记录。请先删除相关交易。");
} else {
(accountToRemove);
("账户 " + name + " 已成功删除。");
}
} else {
("账户 " + name + " 不存在。");
}
}
// endregion
// region 交易管理
public void addTransaction(Transaction transaction) {
// 确保交易金额为正数
if (().compareTo() <= 0) {
("交易金额必须大于零。");
return;
}
Account primaryAccount = ();
if (primaryAccount == null) {
("主要交易账户不能为空。");
return;
}
// 确保账户存在于我们的管理列表中
Optional<Account> managedPrimaryAccount = getAccountByName(());
if (!()) {
("错误：账户 " + () + " 不存在。请先创建该账户。");
return;
}
switch (()) {
case INCOME:
().deposit(());
break;
case EXPENSE:
if (().getBalance().compareTo(()) < 0) {
("余额不足，无法完成支出交易。");
return;
}
().withdraw(());
break;
case TRANSFER:
Account targetAccount = ();
if (targetAccount == null) {
("转账交易需要指定目标账户。");
return;
}
Optional<Account> managedTargetAccount = getAccountByName(());
if (!()) {
("错误：目标账户 " + () + " 不存在。");
return;
}
if (().getBalance().compareTo(()) < 0) {
("余额不足，无法完成转账交易。");
return;
}
().withdraw(());
().deposit(());
break;
}
(transaction);
("交易添加成功！");
}
public List<Transaction> getAllTransactions() {
return new ArrayList<>(transactions);
}
// 根据账户获取交易记录
public List<Transaction> getTransactionsByAccount(String accountName) {
return ()
.filter(t -> ().getName().equalsIgnoreCase(accountName) ||
(() == && () != null && ().getName().equalsIgnoreCase(accountName)))
.collect(());
}
// 根据日期范围获取交易记录
public List<Transaction> getTransactionsByDateRange(LocalDate startDate, LocalDate endDate) {
return ()
.filter(t -> (().isAfter(startDate) || ().isEqual(startDate)) &&
(().isBefore(endDate) || ().isEqual(endDate)))
.collect(());
}
// 根据分类获取交易记录
public List<Transaction> getTransactionsByCategory(String categoryName) {
return ()
.filter(t -> ().getName().equalsIgnoreCase(categoryName))
.collect(());
}
// endregion
// region 分类管理
public void addCategory(String categoryName) {
Category newCategory = new Category(categoryName);
if (!(newCategory)) {
(newCategory);
("分类 '" + categoryName + "' 添加成功。");
} else {
("分类 '" + categoryName + "' 已存在。");
}
}
public List<Category> getAllCategories() {
return new ArrayList<>(categories);
}
public Optional<Category> getCategoryByName(String name) {
return ()
.filter(c -> ().equalsIgnoreCase(name))
.findFirst();
}
// endregion
// region 数据持久化 (使用Java的序列化机制)
private static final String DATA_FILE = "";
public void saveData() {
try (ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream(DATA_FILE))) {
(this);
("数据已保存到 " + DATA_FILE);
} catch (IOException e) {
("保存数据失败: " + ());
}
}
public static Ledger loadData() {
try (ObjectInputStream ois = new ObjectInputStream(new FileInputStream(DATA_FILE))) {
("正在从 " + DATA_FILE + " 加载数据...");
Ledger ledger = (Ledger) ();
("数据加载成功！");
return ledger;
} catch (FileNotFoundException e) {
("数据文件 " + DATA_FILE + " 不存在，将创建新的账本。");
return new Ledger();
} catch (IOException | ClassNotFoundException e) {
("加载数据失败: " + ());
return new Ledger(); // 加载失败时创建新账本
}
}
// endregion
}

三、构建交互式命令行应用 (`Main` 类)

现在我们有了核心业务逻辑，接下来创建一个 `Main` 类，提供一个简单的命令行界面，让用户能够与记账系统进行交互。package ;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
import ;
public class Main {
private static Ledger ledger;
private static Scanner scanner = new Scanner();
public static void main(String[] args) {
ledger = (); // 尝试加载数据，如果不存在则创建新账本
displayMenu();
}
private static void displayMenu() {
int choice;
do {
("--- 个人记账系统 ---");
("1. 添加账户");
("2. 查看所有账户及余额");
("3. 记录交易");
("4. 查看所有交易记录");
("5. 按账户查看交易");
("6. 按分类查看交易");
("7. 添加自定义分类");
("8. 查看所有分类");
("9. 删除账户");
("0. 退出并保存");
("请选择操作 (0-9): ");
try {
choice = (());
switch (choice) {
case 1: addAccount(); break;
case 2: viewAllAccounts(); break;
case 3: recordTransaction(); break;
case 4: viewAllTransactions(); break;
case 5: viewTransactionsByAccount(); break;
case 6: viewTransactionsByCategory(); break;
case 7: addCustomCategory(); break;
case 8: viewAllCategories(); break;
case 9: removeAccount(); break;
case 0:
();
("感谢使用，再见！");
break;
default: ("无效的选择，请重新输入。");
}
} catch (NumberFormatException e) {
("输入错误：请输入数字。");
choice = -1; // 保持循环
}
} while (choice != 0);
();
}
private static void addAccount() {
("请输入账户名称: ");
String name = ();
("请输入初始余额: ");
BigDecimal initialBalance = readBigDecimalInput();
if (initialBalance == null) return;
(new Account(name, initialBalance));
}
private static void viewAllAccounts() {
List<Account> accounts = ();
if (()) {
("暂无账户。");
return;
}
("--- 所有账户及余额 ---");
(::println);
}
private static void recordTransaction() {
("--- 记录交易 ---");
("请输入交易日期 (YYYY-MM-DD): ");
LocalDate date = readDateInput();
if (date == null) return;
("请输入交易金额: ");
BigDecimal amount = readBigDecimalInput();
if (amount == null) return;
("请选择交易类型:");
("1. 收入");
("2. 支出");
("3. 转账");
("选择 (1-3): ");
int typeChoice = readIntInput();
if (typeChoice == -1) return;
TransactionType type;
switch (typeChoice) {
case 1: type = ; break;
case 2: type = ; break;
case 3: type = ; break;
default:
("无效的交易类型选择。");
return;
}
("请输入交易描述: ");
String description = ();
Account primaryAccount = selectAccount("请选择交易账户: ");
if (primaryAccount == null) return;
Transaction newTransaction;
if (type == ) {
Account targetAccount = selectAccount("请选择目标账户: ");
if (targetAccount == null) return;
if ((targetAccount)) {
("源账户和目标账户不能相同。");
return;
}
newTransaction = new Transaction(date, amount, type, description, primaryAccount, targetAccount);
} else {
Category category = selectCategory("请选择交易分类: ");
if (category == null) return;
newTransaction = new Transaction(date, amount, type, description, category, primaryAccount);
}
(newTransaction);
}
private static void viewAllTransactions() {
List<Transaction> transactions = ();
if (()) {
("暂无交易记录。");
return;
}
("--- 所有交易记录 ---");
(::println);
}
private static void viewTransactionsByAccount() {
Account account = selectAccount("请输入要查询的账户名称: ");
if (account == null) return;
List<Transaction> transactions = (());
if (()) {
("账户 '" + () + "' 暂无交易记录。");
return;
}
("--- 账户 '" + () + "' 的交易记录 ---");
(::println);
}
private static void viewTransactionsByCategory() {
Category category = selectCategory("请输入要查询的分类名称: ");
if (category == null) return;
List<Transaction> transactions = (());
if (()) {
("分类 '" + () + "' 暂无交易记录。");
return;
}
("--- 分类 '" + () + "' 的交易记录 ---");
(::println);
}
private static void addCustomCategory() {
("请输入新的分类名称: ");
String categoryName = ();
(categoryName);
}
private static void viewAllCategories() {
List<Category> categories = ();
if (()) {
("暂无分类。");
return;
}
("--- 所有分类 ---");
(::println);
}
private static void removeAccount() {
("请输入要删除的账户名称: ");
String accountName = ();
(accountName);
}
// Helper methods for input
private static BigDecimal readBigDecimalInput() {
try {
return new BigDecimal(());
} catch (NumberFormatException e) {
("输入错误：请输入有效的数字金额。");
return null;
}
}
private static LocalDate readDateInput() {
try {
return (());
} catch (DateTimeParseException e) {
("输入错误：日期格式不正确，请使用 YYYY-MM-DD 格式。");
return null;
}
}
private static int readIntInput() {
try {
return (());
} catch (NumberFormatException e) {
("输入错误：请输入数字。");
return -1;
}
}
private static Account selectAccount(String prompt) {
List<Account> accounts = ();
if (()) {
("目前没有可用的账户，请先添加账户。");
return null;
}
(prompt);
for (int i = 0; i < (); i++) {
((i + 1) + ". " + (i).getName());
}
("请选择账户 (输入序号): ");
int choice = readIntInput();
if (choice > 0 && choice <= ()) {
return (choice - 1);
} else {
("无效的账户选择。");
return null;
}
}
private static Category selectCategory(String prompt) {
List<Category> categories = ();
if (()) {
("目前没有可用的分类，请先添加分类。");
return null;
}
(prompt);
for (int i = 0; i < (); i++) {
((i + 1) + ". " + (i).getName());
}
("请选择分类 (输入序号): ");
int choice = readIntInput();
if (choice > 0 && choice <= ()) {
return (choice - 1);
} else {
("无效的分类选择。");
return null;
}
}
}

四、数据持久化与功能拓展

4.1 数据持久化

当前的代码使用了Java的内置序列化机制将 `Ledger` 对象完整地写入文件 (``)。这种方式简单易用，适合小型应用。在 `Ledger` 类中，`saveData()` 和 `loadData()` 方法负责这一任务。

优点： 实现简单，无需额外依赖。

缺点：

数据文件可读性差，难以直接编辑。
当对象结构发生变化时，可能导致旧数据文件无法兼容。
不适合大数据量或高并发场景。

对于更复杂的应用，可以考虑以下持久化方案：
CSV/JSON 文件： 将数据序列化成文本格式（如CSV或JSON）。这会增加读写逻辑的复杂度，但文件可读性强，方便与其他工具集成。Java有Jackson (JSON) 或 OpenCSV (CSV) 等库来简化操作。
关系型数据库 (如SQLite, H2, MySQL)： 这是企业级应用的首选。通过JDBC连接数据库，将账户、交易、分类等分别存储在不同的表中。SQLite是轻量级的嵌入式数据库，非常适合本地桌面应用。H2也是一个纯Java的嵌入式数据库。这将大大提升数据的管理能力、查询效率和可维护性。
对象数据库 (如MongoDB, Neo4j)： 对于非结构化或半结构化数据，对象数据库可能更合适。但在记账这种结构化数据场景下，关系型数据库通常更优。

4.2 功能拓展

目前的记账系统已经具备了基本的记账、查询功能，但作为一名专业的程序员，我们知道这只是开始。可以考虑以下功能拓展，使系统更加强大：
更详细的报表和统计：

按月/按年统计收入支出。
支出分类排行榜。
账户余额变化趋势图（需要整合图表库或导出数据到Excel）。
资产总览：所有账户余额的总和。

预算管理：

为每个分类设置月度预算，并实时跟踪预算使用情况。
超出预算提醒。

周期性交易：

设置每月固定发生的收入（如工资）或支出（如房租、水电费），系统自动生成交易。

搜索与过滤：

按描述关键字搜索交易。
组合条件过滤交易（日期范围、金额范围、账户、分类等）。

命令行参数优化：

使用 Apache Commons CLI 等库来处理更复杂的命令行参数。

图形用户界面 (GUI)：

使用 Swing, JavaFX, 或结合Web技术 (如Spring Boot + Thymeleaf/React) 来构建更友好的图形界面。这将大大提升用户体验。

数据导入/导出：

从银行账单或Excel文件导入交易数据。
导出数据到CSV或Excel，便于进一步分析。

多用户支持：

引入用户认证和权限管理，支持多个用户独立记账。

五、总结

通过本文，我们从零开始，使用Java语言构建了一个具备基础功能的命令行个人记账系统。我们定义了核心数据模型 (`Account`, `Transaction`, `Category`, `TransactionType`)，实现了业务逻辑 (`Ledger` 服务类)，并提供了简单的用户交互界面 (`Main` 类)。此外，我们还探讨了数据持久化的多种方案，并展望了未来可能的功能拓展。

这个项目不仅帮助我们巩固了Java面向对象编程的基础知识，如类、对象、枚举、集合、日期API和异常处理，还锻炼了系统设计和模块化编程的能力。记账系统作为一个常见的应用场景，其设计理念和实现方法在许多其他业务系统中也具有普适性。希望本文能为您在Java编程实践和个人项目开发中提供有价值的参考。

2025-11-11

上一篇：Java转义字符深度解析：从基础用法到高级应用与文本块新特性

下一篇：Java深入解析：的奥秘与标准输出流PrintStream的艺术实践