抽象类与接口应职责分离:抽象类定义身份与共性骨架,接口定义能力契约;接口聚焦单一正交行为、禁止掺杂实现,抽象类封装同源类状态与模板流程;组合使用时命名体现分层,文档须明确分工意图。

抽象类和接口协同定义规范,核心是把“谁是什么”和“谁能做什么”彻底分开:抽象类管身份与骨架,接口管能力与契约。分工明确的关键不在语法能不能写,而在语义清不清、职责撞不撞、扩展稳不稳。
接口只声明能力,不掺杂实现细节
接口应聚焦一个稳定、正交的行为维度,比如 PaymentClient 只暴露 pay() 和 refund(),不出现重试、签名、序列化等接入逻辑。它代表系统对外的承诺,一旦发布就尽量不动方法签名。
- 所有服务入口(如 OrderService)、回调通知(如 NotificationHandler)、数据转换(如 Serializer
)优先定义为接口 - 跨领域能力(日志、审计、加解密)统一抽成接口,不同模块可自由实现,互不耦合
- 一个实体需组合多种能力(如订单既要可审计、又要可导出),必须用接口——Java 不支持多继承,但支持多实现
抽象类封装同源类的共性骨架
抽象类适合收拢天然属于同一类事物的通用状态、初始化流程和模板方法。例如 PDFExporter 和 ExcelExporter 共享 fileName、outputStream、prepare → execute → cleanup 流程,就该由 AbstractExporter 承担。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
- 提供构造器,强制子类传入必要依赖(如
Config或Executor) - 用模板方法固化流程,如
generate()定义骨架,留出fetchData()和formatResult()由子类定制 - 用
protected final字段共享状态(如连接池、监控上下文),避免重复初始化
组合使用时,命名与结构要体现职责分离
客户端类应 extends 抽象类 + implements 多个接口,命名上就要反映这种分层:比如 RedisCacheClient 继承 AbstractCacheClient,同时实现 CacheClient、HealthCheckable、MetricsReportable。
立即学习“Java免费学习笔记(深入)”;
- 顶层接口(如 CacheClient)只声明
get()、put()、evict(),供上层调用和测试桩使用 - 抽象实现类(如 AbstractRedisCacheClient)封装连接池管理、序列化、重试、埋点等通用逻辑
- 具体子类(如 DefaultRedisCacheClient)只专注差异化实现,不重复处理共性问题
文档和注释要同步体现分工意图
光代码分得清不够,团队协作靠的是显性共识。在接口类的 Javadoc 中强调“这是能力契约,修改需评估下游影响”;在抽象类注释里写明“这是接入骨架,新增字段或模板步骤需检查所有子类兼容性”。
- 接口方法名用动宾短语(如
sendNotification()、validateOrder()),突出行为意图 - 抽象类中的模板方法用
doXxx()命名(如doRequest()、postprocess()),表明这是子类可定制的钩子 - 所有公共 API 的变更,必须同步更新对应接口/抽象类的变更日志和升级指南

















