Spring MVC自定义请求处理器

前言

Spring MVC 的核心是 DispatcherServlet，这个类本质上是一个 HttpServlet，它接管了所有的 HTTP 请求，让开发者专注于 Controller 编写 API 接口。
DispatcherServlet 处理 HTTP 请求的过程可以精简为四步：

1. 通过 HandlerMapping 查找可以处理 HTTP 请求的处理器：Handler
2. 查找可以协调处理器工作的处理器适配器：HandlerAdapter
3. HandlerAdapter 协调 Handler 处理 HTTP 请求，得到 ModelAndView
4. 处理返回结果，渲染视图

通过这四个步骤，引出了 Spring MVC 中三个核心组件：Handler、HandlerMapping、HandlerAdapter。
关于每个类的详细介绍，之后会专门记录，这里大家只需要大概了解即可：

• Handler：请求处理器，可以是任何形式，在 Spring MVC 中用 Object 表示
• HandlerMapping：处理器映射器，说白了就是查找 Handler 用的
• HandlerAdapter：处理器适配器，光有 Handler 还不够，它是个 Object，Spring MVC 不知道怎么让它处理请求，所以还需要有一个协调者来让 Handler 干活

自定义请求处理器

为了让大家更好的理解 Spring MVC 处理 HTTP 请求的大致流程、以及这些组件的作用，我们自定义一个处理器来处理 HTTP 请求。

自定义Handler

前面说过了，在 Spring MVC 中 Handler 可以以任何形式存在，它可以是一个类，也可以是一个方法。这里我们用一个类来表示吧：

public class MyHandler {

	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response) throws IOException {
		response.addHeader(HttpHeaders.CONTENT_TYPE, "text/html");
		response.setCharacterEncoding("utf-8");
		response.getWriter().println("
My Handler Page
");
		response.getWriter().close();
		return null;
	}
}

逻辑很简单，输出一个超级简单的 HTML。

自定义HandlerAdapter

光有 MyHandler 还不够，Spring MVC 又不认识它，没法指挥它干活啊。
所以，我们还需要自定义处理器适配器，协调我们自定义的 MyHandler 干活：

@Component
public class MyHandlerAdapter implements HandlerAdapter {

	// 是否支持给定的handler
	@Override
	public boolean supports(Object handler) {
		// 只要是 MyHandler 就支持
		return handler instanceof MyHandler;
	}

	@Override
	public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
		// 协调MyHandler干活，透传request&response即可
		return ((MyHandler) handler).handle(request, response);
	}

	@Override
	public long getLastModified(HttpServletRequest request, Object handler) {
		return 0;// ignore
	}
}

Tips：自定义的 HandlerAdapter 记得注册到 Spring 容器！

自定义HandlerMapping

最后一步，就是让 Spring MVC 能找到我们自定义的 MyHandler。
所以我们还要自定义一个处理器映射器：MyHandlerMapping，规则很简单，只要请求的 URI 以 “/my-handler” 前缀，我们就把请求交给 MyHandler 处理。

@Component
@Order(-1)
public class MyHandlerMapping implements HandlerMapping {

	@Override
	public HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
		// 只要URI前缀是"/my-handler"就交给MyHandler处理
		if (request.getRequestURI().startsWith("/my-handler")) {
			return new HandlerExecutionChain(new MyHandler());
		}
		return null;
	}
}

试一试

一切就绪，接下来启动 Spring 程序，访问网址：

http://127.0.0.1:8080/my-handler

就可以看到由我们自定义的处理器 MyHandler 输出的页面了：

尾巴

通过分析 DispatcherServlet 处理 HTTP 请求的流程，我们引出了 Spring MVC 至关重要的三个核心组件。现在你应该对这些组件的职责有了更深的认知，同时也清楚它们是如何协作的了。