本文指导开发者在面向领域建模的前提下，合理设计 swing 桌面应用的 uml 序列图：优先刻画业务逻辑交互（customer、account、transaction 等核心类），而非 ui 组件细节；必要时可分层补充 ui 层序列图，但须严格分离关注点。
本文指导开发者在面向领域建模的前提下，合理设计 swing 桌面应用的 uml 序列图：优先刻画业务逻辑交互（customer、account、transaction 等核心类），而非 ui 组件细节；必要时可分层补充 ui 层序列图，但须严格分离关注点。
在为 Java Swing ATM 系统绘制序列图（Sequence Diagram）时，关键不在于“能否画出所有类”，而在于明确建模意图。UML 序列图本质是一种沟通工具——它服务于特定目标：验证业务流程正确性、辅助团队理解协作契约、或指导模块接口设计。因此，是否包含 Swing 组件（如 JFrame、JButton、ActionListener）不应由技术栈决定，而应由抽象层级与受众需求决定。
✅ 推荐实践：分层建模，主次分明
我们强烈建议采用双层序列图策略：
-
领域层序列图（主图，必选）
聚焦 Customer、Account、Transaction、ATM、Admin 五类之间的职责协作，完全忽略 UI 和数据库实现细节。例如，“客户取款”流程应表达为：- Customer.login() → ATM.authenticate()
- ATM.withdraw(amount) → Account.withdraw(amount)
- Account.withdraw() → Transaction.create() → Transaction.generateReceipt()
此图清晰传达业务规则流（如“余额不足则拒绝”“交易成功后生成 PDF 回执”），是架构评审与测试用例设计的核心依据。
Java注释规范Skills下载当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
UI 交互层序列图（可选，按需拆分）
若需说明 Swing 事件驱动机制（如按钮点击如何触发业务逻辑），可单独绘制一张轻量级图，仅包含关键 UI 类与门面（Facade）对象：[ATMLoginFrame] → [LoginController] : actionPerformed(e) [LoginController] → [ATM] : authenticate(accountNo, pin) [ATM] → [Customer] : login() [Customer] → [ATM] : return success/fail [LoginController] → [ATMLoginFrame] : updateStatus("Login successful")注意：此处 LoginController 是典型的薄胶合层（thin adapter），不包含业务逻辑，仅负责 Swing 事件→领域方法的翻译。避免将 JTextField、JPasswordField 等组件作为生命线——它们属于实现细节，会严重降低图的可读性与可维护性。
立即学习“Java免费学习笔记（深入）”；
⚠️ 关键注意事项
- 禁止混合抽象层级：不要在同一张图中同时出现 JButton 和 Transaction.generateReceipt()。这违反了“单一关注点”原则，导致图既无法验证业务逻辑，也无法指导 UI 实现。
- 生命线命名规范：使用类名（如 Customer）而非实例名（如 customer1），除非需强调多实例协作（如多个 Account 同时操作同一 ATM）。
-
数据库交互的表达方式：MySQL 操作不应以 Connection 或 PreparedStatement 形式出现。统一用 > 标注的虚线异步消息表示，例如：
Account.withdraw() → > : UPDATE accounts SET balance = ? WHERE id = ? - 警惕“Swing 特定陷阱”：Swing 的事件调度线程（EDT）虽重要，但不属于序列图范畴。线程安全问题应在设计文档或代码注释中说明，而非污染交互逻辑图。
? 总结：三句原则
- 目的先行：画图前先问——这张图给谁看？解决什么问题？（架构师看领域流，前端开发者看事件绑定？）
- 层级隔离：领域逻辑图 ≠ UI 控制流图 ≠ 数据访问图。每张图只讲一个故事。
- 简洁即力量：删除所有不改变消息语义的中间对象（如 SwingUtilities.invokeLater() 包装器）。真正的价值永远在 what happens，而非 how it’s scheduled。
通过这种结构化、意图驱动的方式，你的序列图将真正成为 Swing 应用开发中的设计资产，而非文档负担。
