核心是父类用public final void settle()固化清算流程顺序,子类仅通过protected abstract方法实现差异步骤(如loadentries、reconcile),并用protected钩子方法(如generatereport、archivelog)选择性扩展,默认实现+可覆盖,异常与日志由父类统一兜底。

要在父类中固化清算主流程并让子类只定制关键环节,核心是把“不变的顺序”锁死在 final 方法里,把“变的逻辑”拆成抽象方法或钩子,不许子类碰骨架,只许填空。
主流程必须封装在 final 模板方法中
清算这类强顺序操作,比如“校验账期 → 加载待清数据 → 执行冲正 → 生成对账单 → 归档日志”,每一步都有依赖关系。父类要定义一个 public final void settle() 方法,按此顺序调用各步骤。这个方法不能被子类重写——否则就可能跳过校验、提前归档,破坏一致性。
- Java/C# 中必须声明为 public final,不可省略 final
- Python 虽无语法限制,但需用 _settle 命名 + docstring 明确标注“禁止重写”,并通过单元测试断言流程完整性
- 模板方法内部不写业务逻辑,只做调度:settle() → validatePeriod() → loadEntries() → reconcile() → generateReport() → archiveLog()
强制子类实现的核心差异点设为 abstract
哪些步骤一定不同?比如“加载待清数据”的来源(数据库/文件/API)、“执行冲正”的规则(按金额扣减/按笔数冻结/按权重分摊)。这些没有通用默认值,必须由子类明确提供。
- 声明为 protected abstract void loadEntries() 和 protected abstract void reconcile()
- 避免写成空 protected 方法——那会导致运行时 NullPointerException 或静默跳过,编译期无法捕获
- 如果某子类只需微调加载方式(如加租户过滤),可额外提供 protected void applyTenantFilter() 钩子,而非动 loadEntries()
可选扩展点用带默认实现的钩子方法
有些环节多数场景一致,少数需要干预。例如生成对账单,默认导出 Excel;但风控清算需额外生成 JSON 并发给审计系统。
- 定义 protected void generateReport(),默认写 Excel 文件
- 子类可选择性 @Override,替换为自定义逻辑,不影响其他步骤
- 类似地,protected void archiveLog() 默认写本地磁盘,合规子类可覆盖为加密上传至对象存储
- 钩子方法体内不要做耗时操作(如网络调用),除非整个模板已设计为异步模式
异常与上下文处理需在父类统一兜底
清算出错不能半途而废,也不能让子类各自 try/catch 破坏流程可控性。
- 每个抽象步骤调用都应包裹在 try/catch 中,失败时记录错误码+快照,再决定是否中断后续(如校验失败必须终止,冲正失败可标记后继续)
- 允许子类传入 ErrorHandler 或 Callback
实例,在构造时注入,避免硬编码策略 - 日志钩子 logBeforeStep() 和 logAfterStep() 应接收上下文对象,方便子类提取 traceId、账期、批次号等字段脱敏打印











