web九大组件之---HandlerAdapter适配器模式实践源码分析【享学Spring MVC】

每篇一句

每当你把事情往外推的时候,你也是在把机会往外推

前言

如果说理解了HandlerMapping相当于掌握了Spring MVC的1/3,那么若你继续理解了HandlerAdapter(以及它的相关组件),那几乎可以说你就理解了它剩下的2/3了。

个人夸张划分,不喜勿喷

HandlerAdapter的作用:因为Spring MVC中的Handler可以是多种/4种形式,但是Servlet需要的处理方法的结构却是固定的,都是以requestresponse为方法入参,那么如何让固定的Servlet处理方法调用灵活的Handler来进行处理呢?这就是HandlerAdapter要做的事情–> 适配。

它的作用是:根据 Handler 来找到支持它的 HandlerAdapter,通过 HandlerAdapter 执行这个 Handler 得到 ModelAndView 对象。

适配器模式简介

假如你有现在存在一个类的接口方法,但是这个接口不太符合你的预期(方法签名对应不上),如果要用他就需要在他的源码上进行一些修改,显然这个不可行。
这时还有一种方案:你可以做一个适配器,在不修改原来这个接口源码的情况下,在适配器上对这个接口进行运用,使得适配器符合你的接口规范

其实生活上适配器有大量的应用,最为常见的就是电源适配器吧~

适配器模式(Adapter Pattern):把一个类的接口变换成客户所期待的另一种接口, Adapter模式使原本因接口不匹配(或者不兼容)而无法在一起工作的两个类能够在一起工作。
适配器模式又称为转换器模式、变压器模式、包装(Wrapper)器模式(把已有的一些类包装起来,使之能有满足需要的接口)。

以下情况可以使用适配器模式

  • 你想使用一个已经存在的类,而它的接口不符合你的需求(但你又不能修改器源码)
  • 你想创建一个可以复用的类,该类可以与其他不相关的类或不可预见的类(即那些接口可能不一定兼容的类)协同工作

HandlerAdapter就是利用适配器模式的一个实现,它在Spring MVC体系中的地位举足轻重。


HandlerAdapter

中文释义:Handler的适配器。JavaDoc解释为:MVC框架SPI,允许核心MVC工作流的参数化。
它必须为每个Handler程序都准备一个对应的适配器来处理请求,有了这个SPI接口,它能够让DispatcherServlet无限的扩展:能够兼容一切的Handler处理器类型。

DispatcherServlet就是通过这个接口来访问handler的,而不是直接去访问真正的实际的处理器,这样做的好处是大大的:

  1. 处理器程序允许是任意的Object
  2. 集成第三方请求处理器的时候,本处代码也无需修改

此接口不适用于应用程序开发人员。对于想要开发自己的web工作流的处理程序来说(或者你想进行深度定制),那就用它吧。

为何需要使用HandlerAdapter适配?

Spring MVCHandlerController接口,HttpRequestHandler,Servlet、@RequestMapping)有四种表现形式,在Handler不确定是什么方式的时候(可能是方法、也可能是类),适配器这种设计模式就能模糊掉具体的实现,从而就能提供统一访问接口。

public interface HandlerAdapter {

	// 判断当前的这个HandlerAdapter  是否 支持给与的handler
	// 因为一般来说:每个适配器只能作用于一种处理器(你总不能把手机适配器拿去用于电脑吧)
	boolean supports(Object handler);
	
	// 核心方法:利用 Handler 处理请求,然后返回一个ModelAndView 
	// DispatcherServlet最终就是调用此方法,来返回一个ModelAndView的~
	@Nullable
	ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception;
	// 同HttpServlet 的 getLastModified方法
	// Can simply return -1 if there's no support in the handler class.
	long getLastModified(HttpServletRequest request, Object handler);

}
HandlerAdapter.supports()

HandlerAdapter.supports()方法的主要作用在于判断当前的HandlerAdapter是否能够支持当前的handler的适配。这里的handler是由HandlerExecutionChain HandlerMapping.getHandler(HttpServletRequest)方法获取到的。从这里可以看出:

  • HandlerMapping的作用主要是根据request请求匹配/映射上能够处理当前request的handler
  • HandlerAdapter的作用在于将request中的各个属性,如request param适配为handler能够处理的形式
    - 参数绑定、数据校验、内容协商…几乎所有的web层问题都在在这里完成的。
HandlerAdapter.handle()

执行真正开发者开发的处理方法的地方。Spring MVC自动帮我们完成数据绑定、视图渲染等等一切周边工作~

HandlerAdapter.getLastModified()

获取当前请求的最后更改时间,主要用于供给浏览器判断当前请求是否修改过,从而判断是否可以直接使用之前缓存的结果

它的继承树:
在这里插入图片描述

从实现类的个数上看是不是很熟悉:4个,刚好对应着我们Handler内置的那四种实现方式~

由简到繁,逐个分析:

SimpleControllerHandlerAdapter

适配org.springframework.web.servlet.mvc.Controller这种Handler。它是一个非常古老的适配器(几乎已弃用状态):

Controller它没有对参数的自动封装、校验等一系列高级功能,但是它保留有对ModelAndView的处理能力,这是区别Servlet这种处理器的地方。

// 适配`org.springframework.web.servlet.mvc.Controller`这种Handler
public class SimpleControllerHandlerAdapter implements HandlerAdapter {

	@Override
	public boolean supports(Object handler) {
		return (handler instanceof Controller);
	}
	// 最终执行逻辑的还是Handler啊~~~~
	@Override
	@Nullable
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler)
			throws Exception {
		return ((Controller) handler).handleRequest(request, response);
	}
	
	// 此处注意:若处理器实现了`LastModified`接口,那就委托给它了
	// 否则返回-1  表示不要缓存~
	@Override
	public long getLastModified(HttpServletRequest request, Object handler) {
		if (handler instanceof LastModified) {
			return ((LastModified) handler).getLastModified(request);
		}
		return -1L;
	}

}

源码非常之简单,因为它直接处理的就是源生的HttpServletRequestHttpServletResponse,所以它和Servlet容器是强绑定的。无数据自动封装、校验等一系列高级功能,所以实际应用中此种方式很少被使用。

画外音:Spring5.0后的WebFlux基于Reactive模式是不支持这种Handler的~

HttpRequestHandlerAdapter

适配org.springframework.web.HttpRequestHandler这种Handler。它比Controller方式还源生:

// @since 2.0
public class HttpRequestHandlerAdapter implements HandlerAdapter {

	@Override
	public boolean supports(Object handler) {
		return (handler instanceof HttpRequestHandler);
	}

	@Override
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {\
		((HttpRequestHandler) handler).handleRequest(request, response);
		return null;
	}

	@Override
	public long getLastModified(HttpServletRequest request, Object handler) {
		if (handler instanceof LastModified) {
			return ((LastModified) handler).getLastModified(request);
		}
		return -1L;
	}

}

和上面的唯一不同是:return null。那是因为HttpRequestHandler#handleRequest()它没有返回值(全靠开发者自己写response),而Controller最起码来说还有ModelView自动渲染的能力嘛~

SimpleServletHandlerAdapter

适配javax.servlet.Servlet这种Handler。

public class SimpleServletHandlerAdapter implements HandlerAdapter {

	@Override
	public boolean supports(Object handler) {
		return (handler instanceof Servlet);
	}

	@Override
	@Nullable
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
		((Servlet) handler).service(request, response);
		return null;
	}

	@Override
	public long getLastModified(HttpServletRequest request, Object handler) {
		return -1;
	}

}

javax.servlet.Servlet的处理方式几乎同HttpRequestHandler,都是对源生请求进行直接处理。它的特殊之处在于:Spring MVC默认并不向容器注册这种HandlerAdapter,若需要使用是需要调用者手动给注册这个BeanServlet这种Handler才能正常使用的~

AbstractHandlerMethodAdapter

从命名中其实就可以看出端倪,它主要是支持到了org.springframework.web.method.HandlerMethod这种处理器,显然这种处理器也是我们最最最最为常用的

// @since 3.1 @RequestMapping注解是Spring2.5出现的
// 注意:它实现了Ordered接口
public abstract class AbstractHandlerMethodAdapter extends WebContentGenerator implements HandlerAdapter, Ordered {
	
	// 唯一构造函数。传的false表示:忽略掉supportedMethods这个属性
	// 默认它的值是GET、POST、HEAD(见WebContentGenerator)
	public AbstractHandlerMethodAdapter() {
		// no restriction of HTTP methods by default
		super(false);
	}

	// 只处理HandlerMethod 类型的处理器。抽象方法supportsInternal默认返回true
	// 是流出的钩子可以给你自己扩展的
	@Override
	public final boolean supports(Object handler) {
		return (handler instanceof HandlerMethod && supportsInternal((HandlerMethod) handler));
	}

	// 抽象方法交给子类handleInternal去实现
	@Override
	@Nullable
	public final ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
		return handleInternal(request, response, (HandlerMethod) handler);
	}
	...
}

它有个大名鼎鼎的子类:RequestMappingHandlerAdapter。此子类已经把HandlerMethod的实现精确到了@RequestMapping注解方案。这个HandlerAdapter可谓是Spring MVC的精华之所在,只要理解了它以及它的相关组件,就基本可以自信地说自己掌握了Spring MVC

因为这部分内容过于复杂繁多,因此我撰了专文来描述它,详情请点击这里

DispatcherServlet#doDispatch分发流程

主要看看DispatcherServlet是如何使用HandlerAdapter的。

DispatcherServlet:
	protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
		...
		//1、根据URL(当然不一定非得是URL)匹配到一个处理器
		mappedHandler = getHandler(processedRequest);
		if (mappedHandler == null) {
			// 若匹配不到Handler处理器,就404了
			noHandlerFound(processedRequest, response);
			return;
		}

		//2、从Chain里拿出Handler(注意是Object类型哦~ )然后找到属于它的适配器
		HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());
		...
		//3、执行作用在此Handler上的所有拦截器的Pre方法
		if (!mappedHandler.applyPreHandle(processedRequest, response)) {
			return;
		}
		//4、真正执行handle方法(也就是你自己书写的逻辑方法),得到一个ModelAndView
		mv = ha.handle(processedRequest, response, mappedHandler.getHandler());

		//5、视图渲染
		applyDefaultViewName(processedRequest, mv);
		//6、执行拦截器的post方法(可见它是视图渲染完成了才会执行的哦~)
		mappedHandler.applyPostHandle(processedRequest, response, mv);
		...
		//7、执行拦截器的afterCompletion方法(不管抛出与否)
	}

从执行步骤中可以看到:HandlerAdapter对于执行流程的通用性起到了非常重要的作用,它能把任何一个处理器(Object)都适配成一个HandlerAdapter,从而可以做统一的流程处理,这也是为何DispatcherServlet它能作为其它web处理框架的分发器的原因(因为它没有耦合具体的处理器,你完全可以自己去实现)~

相关阅读

web九大组件之—RequestMappingHandlerAdapter详尽解析【享学Spring MVC】

总结

本文介绍Spring MVC在处理请求时使用的适配器模式实践HandlerAdapter,感受到了它对DispatcherServlet的重要性。适配器模式在基础框架设计中属常用的一种方式,比如Spring AOP中也有用到,具体请理解我上面说的两个使用场景。
本文留下一个最最最为重要的子类RequestMappingHandlerAdapter没有放在本文讲述,只因为它过于重要和复杂,请务必出门左拐详细了解下它,传送门在此


关注A哥

Author A哥(YourBatman)
个人站点 www.yourbatman.cn
E-mail yourbatman@qq.com
微 信 fsx641385712
活跃平台
公众号 BAT的乌托邦(ID:BAT-utopia)
知识星球 BAT的乌托邦
每日文章推荐 每日文章推荐

BAT的乌托邦

YourBatman CSDN认证博客专家 博客专家 专栏创作者 BAT的乌托邦
也许当我老了,也一样写代码。不为别的,只为爱好
公众号:BAT的乌托邦
亦可在这里和我交流:https://www.yourbatman.cn
©️2020 CSDN 皮肤主题: 代码科技 设计师: Amelia_0503 返回首页
实付0元
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值