本篇文章將帶你真正的搞定SpringMVC工作原理
作者：Springboot實戰案例錦集
參數解析器的作用就是用來解析通過請求URI找到對應的處理器方法（PackMethodHandler）。也就是從上面PackHandlerMapping類中保存到Map集合中的通過請求的URI找到對應的PackMethodHandler對象。
環境：Spring5.3.23
1. 簡介
在Spring中要定義一個接口是非常的簡單，如下示例：
@RestController
@RequestMapping("/demos")
public class DemoController {
@GetMapping("/index")
public Object index() {
return "index" ;
}
}通過上面的@RestController, @RequestMapping就完成了一個簡單的接口定義。
實際Spring Web底層是做了很多的工作，其核心組件有HandlerMapping, HandlerAdapter, ViewResolver等組件。
- HandlerMapping
根據當前請求的URI，查找對應的Handler，如:HandlerExecutionChain，包裝的HandlerMethod - HandlerAdapter
根據上面的確定的HandlerMethod, 找到能夠處理該Handler的Adapter，進行調用 - ViewResolver
如果返回的ModelAndView對象那么會通過相應的ViewResolver進行渲染輸出
了解了上面的幾個核心組件之后，接下來就是自定義實現上面的核心類，來完成接口的請求處理。
2. 實戰案例
2.1 自定義Endpoint
自定義@PackEndpoint注解，該注解的功能就類似@Controller標記這個類是一個處理器類。
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface PackEndpoint {}參數注解，該注解的作用就類似@RequestParam
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface PackParam {
}2.2 參數封裝對象
該類的作用用來保存方法的參數相關的信息進行封裝，如：參數名稱，參數的類型及對應的方法Method。
public class PackMethodParameter {
// 用來解析接口參數的名稱
private ParameterNameDiscoverer parameterNameDiscoverer = new LocalVariableTableParameterNameDiscoverer() ;
private String name ;
private Executable executable ;
private int parameterIndex ;
private Class<?> type ;
public PackMethodParameter(String name, int parameterIndex, Executable executable) {
this.name = name;
this.parameterIndex = parameterIndex ;
this.executable = executable ;
}
public PackMethodParameter(int parameterIndex, Executable executable, Class<?> type) {
this.parameterIndex = parameterIndex ;
this.executable = executable ;
this.type = type ;
}
public boolean hasParameterAnnotation(Class<? extends Annotation> clazz) {
Method method = (Method) this.executable ;
Parameter[] parameters = method.getParameters() ;
return parameters[this.parameterIndex].isAnnotationPresent(clazz) ;
}
public String getParameterName() {
String[] parameterNames = parameterNameDiscoverer.getParameterNames((Method) this.executable) ;
return parameterNames[this.parameterIndex] ;
}
}2.3 自定義HandlerMapping
自定義實現了SpringMVC標準的HandlerMapping，這樣在DispatcherServlet中才能夠識別。HandlerMapping的作用就是用來匹配一個請求的URI與那個處理器（Controller）進行對應。
public class PackHandlerMapping implements HandlerMapping, InitializingBean, ApplicationContextAware {
private ApplicationContext context;
private Map<String, PackMethodHandler> mapping = new HashMap<>();
@Override
public HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
String requestPath = request.getRequestURI();
Optional<PackMethodHandler> opt = mapping.entrySet().stream().filter(entry -> entry.getKey().equals(requestPath)).findFirst()
.map(Map.Entry::getValue);
if (opt.isPresent()) {
HandlerExecutionChain executionChain = new HandlerExecutionChain(opt.get()) ;
return executionChain ;
}
return null;
}
// Bean初始化時，從容器中查找所有符合條件的Bean對象，即Bean對象上有@PackEndpoint注解
@Override
public void afterPropertiesSet() throws Exception {
String[] beanNames = context.getBeanNamesForType(Object.class) ;
for (String beanName : beanNames) {
Object bean = this.context.getBean(beanName) ;
Class<?> clazz = bean.getClass() ;
// 判斷當前的Bean上是否有PackEndpoint注解，只對有該注解的類進行處理
if (clazz.getAnnotation(PackEndpoint.class) != null) {
RequestMapping clazzMapping = clazz.getAnnotation(RequestMapping.class) ;
String rootPath = clazzMapping.value()[0] ;
if (clazzMapping != null) {
// 遍歷當前類中的所有方法，查找使用了@RequestMapping注解的方法
ReflectionUtils.doWithMethods(clazz, method -> {
RequestMapping nestMapping = AnnotatedElementUtils.findMergedAnnotation(method, RequestMapping.class) ;
if (nestMapping != null) {
String nestPath = nestMapping.value()[0] ;
String path = rootPath + nestPath ;
// 所有信息都封裝到該對象
PackMethodHandler handler = new PackMethodHandler(method, bean) ;
// 將請求的URI及對應的Handler進行對應，這樣就可以通過請求的URI找到對應的處理器方法了
mapping.put(path, handler) ;
}
}) ;
}
}
}
}
@Override
public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
this.context = applicationContext;
}
// 該類的作用：用來記錄接口對應的信息，方法，對應的實例，參數信息
public static class PackMethodHandler {
private Method method;
private Object instance;
private PackMethodParameter[] parameters ;
public Method getMethod() {
return method;
}
public void setMethod(Method method) {
this.method = method;
}
public Object getInstance() {
return instance;
}
public void setInstance(Object instance) {
this.instance = instance;
}
public PackMethodHandler(Method method, Object instance) {
super();
this.method = method;
this.instance = instance;
Parameter[] params = method.getParameters() ;
this.parameters = new PackMethodParameter[params.length] ;
for (int i = 0; i < params.length; i++) {
this.parameters[i] = new PackMethodParameter(i, method, params[i].getType()) ;
}
}
public PackMethodParameter[] getParameter() {
return this.parameters ;
}
}
}2.4 自定義參數解析器
參數解析器的作用就是用來解析通過請求URI找到對應的處理器方法（PackMethodHandler）。也就是從上面PackHandlerMapping類中保存到Map集合中的通過請求的URI找到對應的PackMethodHandler對象。
public interface PackHandlerMethodArgumentResolver {
boolean supportsParameter(PackMethodParameter methodParameter) ;
Object resolveArgument(PackMethodParameter methodParameter, HttpServletRequest request);
}
public class PackParamHandlerMethodArgumentResolver implements PackHandlerMethodArgumentResolver {
@Override
public boolean supportsParameter(PackMethodParameter methodParameter) {
return methodParameter.hasParameterAnnotation(PackParam.class) ;
}
@Override
public Object resolveArgument(PackMethodParameter methodParameter, HttpServletRequest request) {
String name = methodParameter.getParameterName() ;
Object arg = null;
String[] parameterValues = request.getParameterValues(name) ;
if (parameterValues != null) {
arg = parameterValues.length == 1 ? parameterValues[0] : parameterValues ;
}
return arg ;
}
}2.5 自定義HandlerAdapter
自定義實現了SpringMVC標準的HandlerAdatper，這樣在DispatcherServlet中才能夠識別。該類的核心就是用來真正的調用目標方法的（PackMethodHandler）。
public class PackHandlerAdapter implements HandlerAdapter{
@Resource
private ConversionService conversionService ;
private PackParamHandlerMethodArgumentResolver argumentResolver = new PackParamHandlerMethodArgumentResolver() ;
@Override
public boolean supports(Object handler) {
return handler instanceof PackMethodHandler;
}
@Override
public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
PackMethodHandler methodHandler = (PackMethodHandler) handler ;
PackMethodParameter[] parameters = methodHandler.getParameter() ;
Object[] args = new Object[parameters.length] ;
for (int i = 0; i < args.length; i++) {
if (this.argumentResolver.supportsParameter(parameters[i])) {
// 解析對應的方法參數
args[i] = this.argumentResolver.resolveArgument(parameters[i], request) ;
// 類型轉換
args[i] = this.conversionService.convert(args[i], parameters[i].getType()) ;
}
}
// 調用目標方法
Object result = methodHandler.getMethod().invoke(methodHandler.getInstance(), args) ;
// 設置響應header，輸出內容
response.setHeader("Content-Type", "text/plain;charset=utf8") ;
PrintWriter out = response.getWriter() ;
out.write((String) result) ;
out.flush() ;
out.close() ;
return null ;
}
@Override
public long getLastModified(HttpServletRequest request, Object handler) {
return -1 ;
}
}2.6 測試
@PackEndpoint
@RequestMapping("/users")
public class UserController {
@GetMapping("/index")
public Object index(@PackParam Long id, @PackParam String name) {
return "id = " + id + ", name = " + name ;
}
}通過以上的步驟就完成了一個完全自定義SpringMVC核心組件的實現。而這就是底層SpringMVC的核心工作原理。
以上是本篇文章的全部內容，希望對你有幫助。
責任編輯：武曉燕
來源：
Spring全家桶實戰案例源碼
