还在对“单接口实现”乐此不疲?你也许是在耍流氓~
代码评审时,我又一次看到了这种熟悉的味道:
public interface UserService {
UserDTO getById(Long id);
void save(UserSaveCmd cmd);
void changeStatus(Long id, Integer status);
}
@Service
public class UserServiceImpl implements UserService {
@Override
public UserDTO getById(Long id) { ... }
@Override
public void save(UserSaveCmd cmd) { ... }
@Override
public void changeStatus(Long id, Integer status) { ... }
}
我翻了一下这个项目,这种"一个接口配一个实现类"的组合,一共有 87 处。
我挨个点进去看 UserService、OrderService、ContractService、MerchantService……没有一个接口有第二个实现。
这就是今天想聊的事:单接口实现(一个 interface 只有一个 impl),在绝大多数业务系统里,不是设计优雅,是自我感动。
一、先把话说清楚:interface 到底是用来干嘛的
Java 里引入 interface,核心价值就三条:
- 多态——同一个契约,多个实现,运行时切换
- 解耦边界——跨模块/跨团队协定时,接口是契约
- 框架需要——JDK 动态代理、SPI、Spring AOP 等场景要求接口存在
注意第一条是最核心的。一个接口从头到尾只有一个实现,多态这条直接从根上就没了;第二条在垂直分工的业务系统里也基本用不上(Controller 到 DAO 都是同一个人写);第三条只有真正被框架代理时才成立,而 Spring 现在默认 CGLIB 代理具体类,也不需要接口。
三条价值全部落空,你还留着它,图什么?
二、单接口实现的真实代价
代价一:文件数翻倍,改一处要动两处
加一个方法:
// 1. 先在接口加签名
public interface UserService {
UserDTO getById(Long id);
void freeze(Long id); // ← 新增
}
// 2. 再去实现类加实现
@Service
public class UserServiceImpl implements UserService {
@Override
public void freeze(Long id) { ... }
}
删一个方法、改个参数名、加个 @Valid 注解——每一次都要在两个文件之间来回横跳。87 个接口 × 平均 5 个方法,光是"同步修改"这个动作,团队一年要做几千次。
代价二:代码追溯多一跳
Controller 里看到这段:
@RestController
public class UserController {
@Resource
private UserService userService;
@PostMapping("/freeze")
public void freeze(@RequestParam Long id) {
userService.freeze(id);
}
}
你想看 freeze 的实现,得先跳到 UserService 接口,再点 "Go to Implementation" 跳到 UserServiceImpl。IDEA 救得了你一次两次,救不了你一天几十次。
调试时更难受——断点打在接口方法上, IDEA 会告诉你"这个方法没有实现代码",你得手动找到那个 Impl 再打一次。
代价三:"未来可能有多实现"是个伪命题
我听过最多的辩护是:
"现在虽然只有一个实现,但未来可能有多个,先留个接口方便扩展。"
兄弟,未来是哪个未来?
- 用户服务的第二个实现是什么?
UserServiceImpl2? - 订单服务的第二个实现是什么?
OrderServiceImplForTest?
业务 Service 的多实现概率,其实极低。真正会多实现的场景就那么几类:
- 支付通道(支付宝/微信/银联)
- 短信/邮件/推送(阿里云/腾讯云/极光)
- 存储策略(本地/OSS/S3)
- 风控规则(规则A/规则B/规则C)
这些一开始就知道会有多个,接口该建。而 UserService、OrderService、ContractService 这种领域实体服务,十有八九一辈子就一个实现。
为了那"十之一二"的可能性,给"十之八九"全部上了接口——这不是前瞻,这是焦虑。
代价四:测试收益是幻觉
"有接口才好 mock" —— 这话在 2015 年成立,现在不成立。
// 没有接口,Mockito 照样 mock 具体类
@SpringBootTest
class OrderServiceTest {
@MockBean
private UserService userService; // 直接 mock 具体类,不需要接口
@Autowired
private OrderService orderService;
@Test
void testCreateOrder() {
given(userService.getById(1L)).willReturn(new UserDTO());
orderService.create(...);
}
}
Mockito 从 2.x 开始就能 mock 具体类、final 类(开启 inline mock maker 后 final 也行)。"为了测试才建接口"这个理由,早就过期了。
三、重构前后对比
重构前(单接口实现,样板代码)
// UserService.java
public interface UserService {
UserDTO getById(Long id);
void save(UserSaveCmd cmd);
void changeStatus(Long id, Integer status);
void freeze(Long id);
void unfreeze(Long id);
}
// UserServiceImpl.java
@Service
public class UserServiceImpl implements UserService {
@Resource private UserMapper userMapper;
@Override public UserDTO getById(Long id) { ... }
@Override public void save(UserSaveCmd cmd) { ... }
@Override public void changeStatus(Long id, Integer s) { ... }
@Override public void freeze(Long id) { ... }
@Override public void unfreeze(Long id) { ... }
}
// Controller
@Resource private UserService userService;
文件数:2。方法签名重复:5 处。跳转次数:2 次。
重构后(直接具体类)
// UserService.java(只有一个文件)
@Service
public class UserService {
@Resource private UserMapper userMapper;
public UserDTO getById(Long id) { ... }
public void save(UserSaveCmd cmd) { ... }
public void changeStatus(Long id, Integer s) { ... }
public void freeze(Long id) { ... }
public void unfreeze(Long id) { ... }
}
// Controller
@Resource private UserService userService; // 注入具体类,Spring 完全支持
文件数:1。方法签名重复:0。跳转次数:1 次。
四、Spring 代理实测:没有接口,一切正常
很多人担心:"去掉接口,Spring 的 @Transactional、@Cacheable、AOP 还能生效吗?"
答案是:能,而且 Spring Boot 2.x 之后默认就这么干的。
一个最简单的 Spring Boot 项目,没有任何接口,只有具体类。定义一个 UserService 具体类,加上 @Transactional 和 @Cacheable 注解,然后在任意地方打印 userService.getClass(),输出如下:
class com.example.demo.service.UserService$$EnhancerBySpringCGLIB$$xxxx
看到 CGLIB 字样了吗?Spring 自动用 CGLIB 创建了具体类的子类代理,事务、缓存、AOP 全部挂在这个代理上。整个过程不需要任何接口。
对比一下:如果非要用接口,代理类型会变成:
class com.sun.proxy.$ProxyXX // JDK 动态代理
两种代理都能正常工作,区别只是:
- JDK 动态代理:必须基于接口,只能代理接口中的方法
- CGLIB 动态代理:基于类,可以代理所有
public方法(包括 final 方法除外)
Spring Boot 从 2.0 开始,spring.aop.proxy-target-class=true 是默认值,也就是说默认就用 CGLIB 代理具体类。你写接口反而要多写一层 Impl,换来的是 JDK 代理——但 JDK 代理的功能 CGLIB 全都有,还不需要接口。
那为什么还有人坚持要接口?历史原因:Spring 早期版本默认用 JDK 动态代理,那时没有接口就无法实现事务/AOP。但那是 2013 年以前的事了。现在的 Spring Boot 项目,你完全可以不写接口,把精力留给真正的业务逻辑。
如果你还不放心,可以做一个实验:把项目里所有 XxxService 接口 + XxxServiceImpl 合并成一个 XxxService 具体类,跑一遍全部测试用例——结果应该全部通过。如果有个别失败,要么是因为用了 JDK 代理的特定行为(极少见),要么是你的代码本来就有问题。
五、不要一棍子打死~~~ 那什么时候得有interface接口?
不是要一棍子打死所有接口。下面这几种场景,接口必须留,而且是核心设计:
场景一:确实多实现(策略/通道)
public interface PaymentService {
PayResult pay(PayCmd cmd);
String channel();
}
@Component
public class AlipayService implements PaymentService { ... }
@Component
public class WechatPayService implements PaymentService { ... }
// 运行时按 channel 选实现
@Service
public class PaymentRouter {
@Resource private List<PaymentService> services;
public PayResult route(PayCmd cmd) {
return services.stream()
.filter(s -> s.channel().equals(cmd.getChannel()))
.findFirst()
.orElseThrow()
.pay(cmd);
}
}
这种从第一天就知道会有 N 个实现的,接口是灵魂,必须建。
场景二:跨模块/跨团队契约
比如你做一个二方库 risk-sdk 给其他业务线用,对外暴露 RiskChecker 接口——这时候接口是公开契约,别人可能自己写实现插进来。留。
场景三:SPI / 插件扩展点
Dubbo、Spring Factories、自定义 SPI 机制要求的扩展点,本来就是"未来会有第三方实现",留。
场景四:框架强制要求
少数老项目用 JDK 动态代理(@Transactional 走 ProxyFactory 默认模式),或者某些 RPC 框架要求接口先行——这种是被框架绑架,留着无妨,但要知道为什么留。
除此之外的一个 interface 一个 impl,都值得拷问一句:你凭什么存在?
六、一句收口
interface 是为多态而生,不是为"看起来规范"而生。
一个接口从头到尾只有一个实现,还铺得到处都是——这不叫面向接口编程,这叫用接口的壳,干着具体类的活,还多付了一倍的文件税。
DIP(依赖倒置)是好原则,但好原则用错了地方就是负担。抽象要付代价,代价要换回价值。换不回价值的抽象,就是耍流氓。
下次再想顺手敲一个 XxxService 接口 + XxxServiceImpl 实现之前,先问自己一句:
第二个实现,是谁?答不上来,就别建了。
💬 你们项目里有多少个"单接口实现"?评论区报个数,看看谁更惨。
觉得说到痛处了,点个「在看」。
当看到一些不好的代码时,会发现我还算优秀;当看到优秀的代码时,也才意识到持续学习的重要!--buguge
本文来自博客园,转载请注明原文链接:https://www.cnblogs.com/buguge/p/23727428
浙公网安备 33010602011771号