接口定义能力契约,抽象类封装共性实现——接口聚焦正交职责与行为承诺,命名体现能力(如retryable);抽象类提供模板骨架与共享状态,强制依赖注入与流程约束;二者组合使用实现“是什么”与“能做什么”的分离。

接口定义“能做什么”,抽象类封装“怎么实现”——这是架构设计的底层分工,不是语法选择题,而是业务语义的表达。
接口:划清能力边界,只承诺行为
接口是系统对外的契约,一旦发布就应尽量稳定。它不关心你怎么干,只规定你必须提供哪些能力。
- 命名体现职责,用 able、Client、Handler 结尾,如 Retryable、NotificationHandler、MetricsClient
- 每个接口聚焦一个正交能力维度,比如 PaymentClient 只暴露
pay()和refund(),不掺杂签名、重试、序列化等接入细节 - 方法名用动宾短语,如
sendEmail()、validateInput();参数优先用不可变对象或更小粒度的接口(如OrderRequest而非Map<string object></string>) - JDK 8+ 的
default方法仅用于无状态通用逻辑(如空值校验、简单转换),复杂流程仍交给抽象类
抽象类:固化接入骨架,收拢共性逻辑
抽象类是同源类的“半成品图纸”,它把初始化、配置加载、模板调用、工具依赖等共性逻辑打包,强制子类走统一路径。
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
- 提供带参构造器,强制传入必要依赖(如
HttpClient、Config),避免子类自行 new 或用静态单例 - 用
protected final字段保存共享状态(如baseUrl、signer),子类可读不可覆写 - 采用模板方法模式组织流程,例如
execute(Req req)内部调用preprocess()→doRequest()(抽象)→postprocess(),只让子类补关键环节 - 适合场景:多个实现天然属于同一类事物(如
PDFExporter、ExcelExporter),共享字段、资源和流程
组合使用:分层协作,各司其职
真实客户端不是“选接口 or 抽象类”,而是“extends 抽象类 + implements 多个接口”,体现“是什么”和“能做什么”的分离。
- 顶层接口(如 CacheClient)只声明
get()、put()等契约,供上层调用与测试桩使用 - 抽象实现类(如 AbstractRedisCacheClient)封装连接池、序列化、重试、埋点等通用功能
- 具体类(如 ClusterRedisCacheClient)专注适配差异点:节点发现、路由策略、故障转移
- 能力可叠加:一个支付客户端可同时
implements PaymentClient, Refundable, AsyncCapable,按需组合
命名与文档:让契约一眼可读
命名是架构的第一层文档。接口名强调能力,抽象类名强调身份或领域归属。
- 接口命名示例:Searchable、Exportable、Auditable
- 抽象类命名示例:BasePaymentClient、AbstractReportGenerator、AbstractWechatClient
- 所有抽象方法必须有 Javadoc,说明“为什么必须实现”,而非“怎么实现”。例如:
/** 返回用于生成签名的密钥对,不可为空 */
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










