应按使用者和使用场景拆分接口:谁在用、为什么用,识别方法调用不重叠、未被调用超40%、测试中大量mock等信号;按业务角色(如userauthenticator)而非crud命名;用组合代替全能接口继承;老接口迁移需渐进式三步走。

直接拆:按谁在用、为什么用,把一个大接口切分成几个小接口,每个只管一类事。不是为了拆而拆,而是让实现类不再写一堆 throw new UnsupportedOperationException() 或空方法。
从使用方视角识别该拆哪儿
别盯着接口里有多少方法,先看谁在调它、用了哪些方法:
- 如果两个模块调同一个接口,但用的方法完全不重叠(比如订单服务只用
createOrder()和cancelOrder(),报表服务只用exportAsCsv()和getSummary()),这就是明确的拆分信号 - IDE 提示“此方法从未被调用”超过 40%,尤其集中在某几个方法上,说明这些方法对当前使用者是冗余的
- 写单元测试时,要 mock 十几个方法,却只验证其中两三个——其他都是摆设,该拎出去了
按业务角色而不是技术动作来命名和划分
避免按“增删改查”这种通用动词起名(如 UserCRUDService),容易越堆越大。换成真实场景中的角色:
-
UserAuthenticator:只含login()、validateToken()、refreshToken() -
UserAdminOperator:只含freezeUser()、approveProfile()、exportUsersToExcel() -
InviteCodeManager:只含generateCode()、verifyCode()、revokeCode()
这样每个接口职责清晰,Java 客户端注入时也一目了然——需要登录就注入 UserAuthenticator,不需要管冻结或发邀请码。
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
用组合代替“全能接口继承”
别让一个类去实现 Readable + Writable + Exportable + Notifiable 四个接口,尤其是当它只用前两个。正确做法是:
- 保留核心读取接口
UserRepository(只有findById()、findAll()) - 写操作交给单独的
UserWriter(save()、delete()) - 导出功能由
UserExporter承担(exportToCsv()、exportToPdf()) - 通知逻辑不固化进接口,改用事件发布(如
ApplicationEventPublisher)或回调参数传入
这样新增需求(比如加个“归档”功能)只需定义新接口 UserArchiver,不影响已有模块。
老接口迁移要渐进,不破兼容
已有项目不能一刀切替换,推荐三步走:
- 先新增一批小接口,并让新代码优先使用它们
- 原大接口标记为
@Deprecated,但继续保留实现,内部委托给新接口 - 等所有调用方都迁完,再删除旧接口——期间零编译错误、零运行时中断
例如原 UserService 可改为:
public class UserServiceImpl implements UserService, UserAuthenticator, UserAdminOperator {
private final UserAuthenticator auth;
private final UserAdminOperator admin;
// 构造注入新接口实现
public UserServiceImpl(UserAuthenticator auth, UserAdminOperator admin) {
this.auth = auth;
this.admin = admin;
}
@Override
public void login(String user) { auth.login(user); }
@Override
public void freezeUser(Long id) { admin.freezeUser(id); }
// ……其他方法同理委托
}Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










