使用事件、接口与监听器实现模块间松耦合通信，提升系统可维护性与扩展性。通过观察者模式定义事件、监听器及事件分发器，实现模块异步通信；订单模块依赖积分服务接口而非实现，遵循依赖倒置原则；Spring项目可利用@EventListener与ApplicationEventPublisher简化事件处理，支持事务与异步监听；小型项目可自建事件总线，中大型项目推荐Spring Event框架；需关注异常处理、事件版本控制与监听器生命周期管理。
在Java项目中，当系统模块逐渐增多，模块间直接调用会导致高度耦合，难以维护。合理的跨模块通信机制能提升系统的可扩展性和可维护性。事件、接口与监听器是实现松耦合通信的核心手段。以下是几种常见且实用的设计方式。
使用观察者模式：事件与监听器
观察者模式是实现模块间异步通信的经典方案。一个模块发出事件，其他模块通过注册监听器接收并处理该事件。
设计思路：
- 定义通用事件基类，携带必要的上下文信息。
- 创建监听器接口，声明处理方法。
- 由事件分发器统一管理监听器注册与事件通知。
// 事件类
class UserCreatedEvent {
private String userId;
public UserCreatedEvent(String userId) {
this.userId = userId;
}
public String getUserId() { return userId; }
}
// 监听器接口
interface EventListener<T> {
void onEvent(T event);
}
// 事件分发器
class EventBus {
private Map<Class, List<EventListener>> listeners = new HashMap<>();
public <T> void register(Class<T> eventType, EventListener<T> listener) {
listeners.computeIfAbsent(eventType, k -> new ArrayList<>()).add(listener);
}
public <T> void dispatch(T event) {
Class type = event.getClass();
if (listeners.containsKey(type)) {
for (EventListener listener : listeners.get(type)) {
listener.onEvent(event);
}
}
}
}
模块A在创建用户后发布UserCreatedEvent，模块B注册了对应监听器，自动执行发送欢迎邮件等操作。两者无需直接依赖。
立即学习“Java免费学习笔记（深入）”；
通过接口解耦：依赖倒置原则
当模块之间需要同步交互但不能硬编码依赖时，可以通过接口实现解耦。高层模块定义接口，低层模块实现，或通过服务发现机制动态绑定。
关键点：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 通信接口由核心模块或公共模块定义。
- 实现类由具体业务模块提供。
- 通过Spring的@Autowired或ServiceLoader加载实现。
订单模块需要调用积分服务，但不想依赖具体实现。可在公共模块定义：
public interface PointService {
void addPoints(String userId, int points);
}
积分模块实现该接口，订单模块仅依赖接口。运行时由框架注入具体实例，实现模块分离。
结合事件总线框架（如Spring Event）
在Spring项目中，可直接使用@EventListener和ApplicationEvent简化事件通信。
优势：
- 无需手动管理监听器注册。
- 支持事务事件（如
@TransactionalEventListener）。 - 天然集成IoC容器，便于依赖注入。
// 定义事件
public class OrderPaidEvent {
private String orderId;
public OrderPaidEvent(String orderId) {
this.orderId = orderId;
}
// getter...
}
// 发布事件
@Service
public class OrderService {
@Autowired
private ApplicationEventPublisher publisher;
public void payOrder(String orderId) {
// 处理支付逻辑
publisher.publishEvent(new OrderPaidEvent(orderId));
}
}
// 监听事件
@Component
public class RewardListener {
@EventListener
public void handleOrderPaid(OrderPaidEvent event) {
System.out.println("发放奖励: " + event.getOrderId());
}
}
这种方式适合Spring生态项目，开发效率高，结构清晰。
选择建议与注意事项
根据项目规模和技术栈合理选择通信方式：
- 小型项目可手写简单事件总线，避免引入过多框架。
- 中大型Spring项目推荐使用Spring Event，集成度高。
- 接口方式适用于需要强契约的同步调用场景。
- 注意事件监听的异常处理，避免阻塞主流程。
- 异步监听可通过
@Async实现，提升响应速度。
基本上就这些。关键是让模块之间通过协议而非实现交互，保持独立演进能力。不复杂但容易忽略的是事件的版本控制和监听器的生命周期管理。
