当前位置：首页 > article >正文

Spring 框架中适配器模式的五大典型应用场景

article 2025/9/15 13:57:39

Spring 框架中适配器模式的应用场景

在 Spring 框架中，适配器模式（Adapter Pattern）被广泛应用于将不同组件的接口转化为统一接口，从而实现组件间的无缝协作。以下是几个典型的应用场景：

1. HandlerAdapter - MVC 请求处理

在 Spring MVC 中，HandlerAdapter 是适配器模式的核心应用，用于将不同类型的处理器（Handler）统一为可执行的接口。

场景说明

Spring MVC 支持多种处理器类型（如 @Controller、HttpRequestHandler、Servlet 等），但 DispatcherServlet 需要以统一方式调用这些处理器。

关键类

HandlerAdapter 接口：定义统一的处理方法。

public interface HandlerAdapter {boolean supports(Object handler);ModelAndView handle(HttpServletRequest request,HttpServletResponse response,Object handler) throws Exception;long getLastModified(HttpServletRequest request, Object handler);}

具体适配器实现：

RequestMappingHandlerAdapter：处理 @Controller 和 @RequestMapping 注解的方法。

SimpleControllerHandlerAdapter：处理实现 Controller 接口的处理器。

HttpRequestHandlerAdapter：处理实现 HttpRequestHandler 的处理器。

工作流程

DispatcherServlet 接收到请求后，找到对应的 Handler。

通过 HandlerAdapter 判断该 Handler 是否被支持。

调用 HandlerAdapter.handle() 方法，统一处理请求。

示例

// DispatcherServlet 中简化的请求处理逻辑HandlerAdapter adapter = getHandlerAdapter(handler);ModelAndView mv = adapter.handle(request, response, handler);

2. MessageListenerAdapter - JMS 消息处理

在 Spring JMS 中，MessageListenerAdapter 将自定义的消息处理方法适配为 JMS 规范的 MessageListener 接口。

场景说明

JMS 要求消息监听器实现 MessageListener 接口，但用户可能希望使用自定义方法名和参数类型处理消息。

关键类

MessageListenerAdapter：实现 MessageListener 接口，并将消息委托给目标方法。

public class MessageListenerAdapter implements MessageListener, SessionAwareMessageListener<Message> {private Object delegate; // 委托对象private String defaultListenerMethod = "handleMessage"; // 默认方法名@Overridepublic void onMessage(Message message, Session session) throws JMSException {// 适配逻辑：将 JMS Message 转换为方法参数并调用目标方法Object convertedMessage = extractMessage(message);invokeListenerMethod(delegate, defaultListenerMethod, new Object[] { convertedMessage });}}

示例配置

@Beanpublic MessageListenerAdapter listenerAdapter(MyMessageHandler handler) {MessageListenerAdapter adapter = new MessageListenerAdapter(handler);adapter.setDefaultListenerMethod("processMessage"); // 指定方法名return adapter;}

3. ApplicationListenerAdapter - 事件监听器适配

在 Spring 事件机制中，ApplicationListenerAdapter 将任意 Bean 的方法适配为事件监听器。

场景说明

用户可能希望使用非 ApplicationListener 实现类的方法来处理事件。

关键类

ApplicationListenerAdapter：实现 ApplicationListener 接口，将事件委托给目标 Bean 的方法。

public class ApplicationListenerAdapter implements ApplicationListener<ApplicationEvent>, Ordered {private final Object delegate; // 委托对象private final Method method; // 目标方法@Overridepublic void onApplicationEvent(ApplicationEvent event) {// 适配逻辑：将事件转换为方法参数并调用if (supportsEvent(event)) {Object[] args = new Object[] { resolveArgument(event) };method.invoke(delegate, args);}}}

示例配置

@Servicepublic class MyService {@EventListener // 方法会被 ApplicationListenerAdapter 适配public void handleEvent(MyEvent event) {// 处理事件}}

4. AsyncTaskExecutorAdapter - 任务执行器适配

在 Spring 异步处理中，AsyncTaskExecutorAdapter 将 JDK 的 Executor 适配为 Spring 的 AsyncTaskExecutor。

场景说明

用户可能已有 JDK 原生的 Executor，但希望在 Spring 环境中使用。

关键类

AsyncTaskExecutorAdapter：实现 AsyncTaskExecutor 接口，委托给 JDK Executor。

public class AsyncTaskExecutorAdapter implements AsyncTaskExecutor {private final Executor concurrentExecutor;@Overridepublic void execute(Runnable task, long startTimeout) {concurrentExecutor.execute(task);}@Overridepublic Future<?> submit(Runnable task) {return concurrentExecutor.submit(task);}// 其他方法...}

5. HandlerInterceptorAdapter - 请求拦截器（已弃用）

在 Spring MVC 中，HandlerInterceptorAdapter 是一个抽象适配器类，用于简化拦截器的实现。

场景说明

Spring 3.2 之前，拦截器需要实现 HandlerInterceptor 接口的所有方法。

关键类

HandlerInterceptorAdapter：提供默认实现，允许子类仅覆盖需要的方法。

public abstract class HandlerInterceptorAdapter implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request,HttpServletResponse response,Object handler) throws Exception {return true; // 默认实现}@Overridepublic void postHandle(HttpServletRequest request,HttpServletResponse response,Object handler,ModelAndView modelAndView) throws Exception {// 空实现}@Overridepublic void afterCompletion(HttpServletRequest request,HttpServletResponse response,Object handler,Exception ex) throws Exception {// 空实现}}

示例

public class MyInterceptor extends HandlerInterceptorAdapter {@Overridepublic boolean preHandle(HttpServletRequest request,HttpServletResponse response,Object handler) {// 只覆盖需要的方法return true;}}