Spring MVC注解Controller源码流程解析--映射建立

Posted 大忽悠爱忽悠

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Spring MVC注解Controller源码流程解析--映射建立相关的知识,希望对你有一定的参考价值。

Spring MVC注解Controller源码流程解析--映射建立


本篇为spring mvc源码解析高级篇,其中关于DispathcerServlet的前置知识块,建议大家先通过我的spring源码专栏学习一下:

Spring源码研读专栏


引言

DispatcherServlet通过SPI机制来加载默认提供的相关组件,而SPI的核心就在于DispathcerServlet.properties文件:


该文件内部列举了各个组件会提供哪些默认实现,使用这些默认实现的前提是,DispathcerServlet在初始化各个组件时,并没有在当前容器内发现各个组件已有的实现。

Controller的寻找是通过HandlerMapping完成的,而调用则是通过HandlerAdaptor完成的。

对于注解版本Controller寻找是通过RequestMappingHandlerMapping完成的,RequestMappingHandlerMapping主要负责在自身初始化阶段搜寻出当前容器内所有可用Controller实现,然后建立相关映射关系; 在请求到来时,再通过这些映射关系寻找到对应处理方法后返回。

对于注解版本的Controller请求处理方法调用是通过RequestMappingHandlerAdapter完成的,RequestMappingHandlerAdapter负责拿到RequestMappingHandlerMapping返回的方法后,进行一系列处理后,调用目标方法处理请求,这一系列处理包括: 数据绑定和数据校验,返回值处理等等…

整个注解版本Controller源码解析流程较为繁琐,但是大体上还是分为两个阶段:

  1. 映射建立
  2. 处理请求

因此,本节先分析前半部分,即RequestMappingHandlerMapping是如何建立映射关系的


类图分析

再正式讲解流程前,先来对RequestMappingHandlerMapping的类图进行分析,建立一个大局观念:

  • AbstractHandlerMapping: 提供基础设施支持,例如: 路径解析,拦截器,跨域。 规定了根据request得到handler的模板方法处理流程getHandler,具体如何根据request寻找到某个handler,则是由子类实现。
  • AbstractHandlerMethodMapping: 囊括了对注解Controller寻找,建立映射和根据request找到对应handler的流程支持,核心在于建立Reuqest和HandlerMethod的映射关系,将识别处理器方法和建立映射的任务交给子类实现。
  • RequestMappingHandlerMapping: 核心在于解析处理器方法和对应Controller上@RequestMapping注解,然后合并生成一个RequestMappingInfo作为映射的关键一环返回。

映射建立

Reuqest和HandlerMethod的映射的建立过程由AbstractHandlerMethodMapping实现的初始化回调接口afterPropertiesSet完成:

	public void afterPropertiesSet() 
		initHandlerMethods();
	

initHandlerMethods是映射建立的入口,我们需要深入其中:

	protected void initHandlerMethods() 
	    //getCandidateBeanNames可以简单的理解为是获取当前容器内部的所有bean实例
		for (String beanName : getCandidateBeanNames()) 
		        ...
		        //需要判断当前bean是不是我们需要的候选bean,如果是就进行处理
				processCandidateBean(beanName);
		
		//简单的日志记录
		handlerMethodsInitialized(getHandlerMethods());
	

processCandidateBean是核心方法,该方法内部完成了bean的筛选和对某个Controller内部所有handlerMethod的探测。

	protected void processCandidateBean(String beanName) 
		Class<?> beanType = null;
		//获取当前bean类型
		beanType = obtainApplicationContext().getType(beanName);
	    ..
	    //默认AbstractHandlerMethodMapping是不提供对处理器的识别的,具体如何识别某个bean是不是handler,是由子类决定的
	    //这里是AbstractHandlerMethodMapping实现的,筛选规则如下:
	    //检验当前bean上是否存在Controller或者RequestMapping注解
		if (beanType != null && isHandler(beanType)) 
		    //如果当前bean是一个handler,那么需要探测出该handler内部所有handlerMethod实现
			detectHandlerMethods(beanName);
		
	

handlerMethod才是处理请求的终点,因此我们需要探测当前handler内部有哪些handlerMethod,并且建立好相关映射关系:

	protected void detectHandlerMethods(Object handler) 
	    //先获取到当前handler的type
		Class<?> handlerType = (handler instanceof String ?
				obtainApplicationContext().getType((String) handler) : handler.getClass());
                                    
		if (handlerType != null) 
		    //如果当前handler是被cglib代理过的对象,那么需要获取当前代理对象的superClass
		    //因为这才是目标handler的类型
			Class<?> userType = ClassUtils.getUserClass(handlerType);
			//MethodIntrospector类主要提供对方法的筛选和通用处理封装
			//这里selectMethods就是筛选出当前handler内部所有符合要求的handlerMethod
			Map<Method, T> methods = MethodIntrospector.selectMethods(userType,
			        //筛选出某个handlerMethod,利用注册的回调接口生成映射关系
					(MethodIntrospector.MetadataLookup<T>) method -> 
						try 
							return getMappingForMethod(method, userType);
						
						catch (Throwable ex) 
							throw new IllegalStateException("Invalid mapping on handler class [" +
									userType.getName() + "]: " + method, ex);
						
					);
			... 
			methods.forEach((method, mapping) -> 
			    //对jdk动态代理的情况进行处理--一般情况下可以忽略,因此controller层一般都是采用cglib代理
				Method invocableMethod = AopUtils.selectInvocableMethod(method, userType);
				//注册
				registerHandlerMethod(handler, invocableMethod, mapping);
			);
		
	

MethodIntrospector.selectMethods作用可以简单看做是遍历handler类内部所有方法,包括其父类和实现接口里面的所有方法,然后交给注册进来的回调接口进行处理,回调接口的返回值作为生成的映射信息,如果返回值不为空,就和当前method组成一条记录,放入map中; 遍历完所有方法后,返回该map集合。

selectMethods完成方法筛选的关键就在于目标方法经过回调接口处理过后,返回值是否为空,如果为空,说明当前方法需要被过滤掉

所以,上面注册的回调接口中的getMappingForMethod方法才是我们需要关注的重点,该方法完成了对当前method信息的提取,最终组装返回一个请求映射信息。

和上面识别handler一样,具体是如何完成对method解析的过程,也是由RequestMappingHandlerMapping子类实现的。


解析handlerMethod

	protected RequestMappingInfo getMappingForMethod(Method method, Class<?> handlerType) 
	   //根据当前方法,创建一个请求映射信息
		RequestMappingInfo info = createRequestMappingInfo(method);
		//如果当前方法并没有标注@RequestMapping等注解,那么也就不是一个handlerMethod,那么就返回null
		//该方法就会在selectMethods中被过滤掉
		if (info != null) 
		    //当前handlerMethod属于的handler上是否也存在@RequestMapping注解,如果存在就解析
			RequestMappingInfo typeInfo = createRequestMappingInfo(handlerType);
			if (typeInfo != null) 
			//如果handler上确实存在,那么就需要将方法上的@RequestMapping注解和类上的@RequestMapping注解注解进行合并
				info = typeInfo.combine(info);
			
			//关于前缀的问题,下一节会展开讲,这里先跳过
			String prefix = getPathPrefix(handlerType);
			if (prefix != null) 
				info = RequestMappingInfo.paths(prefix).options(this.config).build().combine(info);
			
		
		return info;
	

createRequestMappingInfo方法会对传入的AnnotatedElement上的RequestMapping注解进行解析,然后生成RequestMappingInfo返回。

AnnotatedElement是JDK反射包提供的顶层接口,实现了该接口的元素,都是可以标注注解的元素,例如: Class,Method,Parameter等都实现了该接口

	private RequestMappingInfo createRequestMappingInfo(AnnotatedElement element) 
	//拿到当前元素上的注解信息
		RequestMapping requestMapping = AnnotatedElementUtils.findMergedAnnotation(element, RequestMapping.class);
		//用户可以实现相关方法来创建自定义的请求匹配条件
		RequestCondition<?> condition = (element instanceof Class ?
				getCustomTypeCondition((Class<?>) element) : getCustomMethodCondition((Method) element));
		return (requestMapping != null ?
		  //如果存在注解,就创建对应的RequestMappingInfo
		  createRequestMappingInfo(requestMapping, condition) : null);
	

RequestMappingInfo可以看出,就是@RequestMapping注解对应信息的实体载体。

	protected RequestMappingInfo createRequestMappingInfo(
			RequestMapping requestMapping, @Nullable RequestCondition<?> customCondition) 

		RequestMappingInfo.Builder builder = RequestMappingInfo
		        //requestMapping注解中的path属性会经过EL解析器解析,也就是我们在路径中可以通过el表达式获取上下文中的值
		        //例如: $user.dir
				.paths(resolveEmbeddedValuesInPatterns(requestMapping.path()))
				//通过请求访问限制匹配
				.methods(requestMapping.method())
				//通过请求参数中必须携带某个请求参数进行限制匹配
				.params(requestMapping.params())
				//通过请求头中必须携带某个请求头进行限制匹配
				.headers(requestMapping.headers())
				//通过限制请求头中的content-type来进行限制匹配
				.consumes(requestMapping.consumes())
				//规定响应的content-type类型
				.produces(requestMapping.produces())
				.mappingName(requestMapping.name());
	     //是否存在用户自定义匹配限制	
		if (customCondition != null) 
			builder.customCondition(customCondition);
		
		//构建RequestMappingInfo后返回
		return builder.options(this.config).build();
	

@RequestMapping注解中各个属性含义详解如下:

// @since 2.5 用于将Web请求映射到具有灵活方法签名的请求处理类中的方法的注释  Both Spring MVC and `Spring WebFlux` support this annotation
// @Mapping这个注解是@since 3.0  但它目前还只有这个地方使用到了~~~ 我感觉是多余的
@Target(ElementType.METHOD, ElementType.TYPE) // 能够用到类上和方法上
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping 

	//给这个Mapping取一个名字。若不填写,就用HandlerMethodMappingNamingStrategy去按规则生成
	String name() default "";

	// 路径  数组形式  可以写多个。  一般都是按照Ant风格进行书写~
	@AliasFor("path")
	String[] value() default ;
	@AliasFor("value")
	String[] path() default ;
	
	// 请求方法:GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE
	// 显然可以指定多个方法。如果不指定,表示适配所有方法类型~~
	// 同时还有类似的枚举类:org.springframework.http.HttpMethod
	RequestMethod[] method() default ;
	
	// 指定request中必须包含某些参数值时,才让该方法处理
	// 使用 params 元素,你可以让多个处理方法处理到同一个URL 的请求, 而这些请求的参数是不一样的
	// 如:@RequestMapping(value = "/fetch", params = "personId=10" 和 @RequestMapping(value = "/fetch", params = "personId=20"
	// 这两个方法都处理请求`/fetch`,但是参数不一样,进入的方法也不一样~~~~
	// 支持!myParam和myParam!=myValue这种~~~
	String[] params() default ;

	// 指定request中必须包含某些指定的header值,才能让该方法处理请求
	// @RequestMapping(value = "/head", headers = "content-type=text/plain"
	String[] headers() default ;

	// 指定处理请求request的**提交内容类型**(Content-Type),例如application/json、text/html
	// 相当于只有指定的这些Content-Type的才处理 
	// @RequestMapping(value = "/cons", consumes = "application/json", "application/XML"
	// 不指定表示处理所有~~  取值参见枚举类:org.springframework.http.MediaType
	// 它可以使用!text/plain形如这样非的表达方式
	String[] consumes() default ;
	// 指定返回的内容类型,返回的内容类型必须是request请求头(Accept)中所包含的类型
	// 仅当request请求头中的(Accept)类型中包含该指定类型才返回;
	// 参见枚举类:org.springframework.http.MediaType
	// 它可以使用!text/plain形如这样非的表达方式
	String[] produces() default ;



Spring4.3之后提供了组合注解5枚:

@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
@PatchMapping

consumes 与 headers 区别:

  • consumes produces params headers四个属性都是用来缩小请求范围。
  • consumes只能指定 content-Type 的内容类型,但是headers可以指定所有。

所以可以认为:headers是更为强大的(所有需要指定key和value嘛),而consumes和produces是专用的,头的key是固定的,所以只需要写value值即可,使用起来也更加的方便~。

推荐一个类:org.springframework.http.HttpHeaders,它里面有常量:几乎所有的请求头的key,以及我们可以很方便的构建一个HttpHeader,平时可以作为参考使用


合并定义

	protected RequestMappingInfo getMappingForMethod(Method method, Class<?> handlerType) 
	   //根据当前方法,创建一个请求映射信息
		RequestMappingInfo info = createRequestMappingInfo(method);
		//如果当前方法并没有标注@RequestMapping等注解,那么也就不是一个handlerMethod,那么就返回null
		//该方法就会在selectMethods中被过滤掉
		if (info != null) 
		    //当前handlerMethod属于的handler上是否也存在@RequestMapping注解,如果存在就解析
			RequestMappingInfo typeInfo = createRequestMappingInfo(handlerType);
			if (typeInfo != null) 
			//如果handler上确实存在,那么就需要将方法上的@RequestMapping注解和类上的@RequestMapping注解注解进行合并
				info = typeInfo.combine(info);
			
			...
		
		return info;
	

如果当前handleMethod对应的Handler上也存在@RequestMapping注解,那么就需要将类上的提供的@RequestMapping注解信息,与当前类内部所有handlerMethod提供的@RequestMapping注解信息进行合并,具体合并规则如下:

  • 请求路径就是拼接:
@RequestMapping("/admin")
@RestController
public class AdminController 
    @PostMapping("/login")
    public Result login()
        ...
    

HandlerMethod这里对应的就是login方法,而Handler对应的就是AdminController,此时合并完之后,得到的RequestMappingInfo 中的path路径为/admin/login。

  • 其他属性就是简单的合并



注册HandlerMethod

	protected void detectHandlerMethods(Object handler) 
	    //先获取到当前handler的type
		Class<?> handlerType = (handler instanceof String ?
				obtainApplicationContext().getType((String) handler) : handler.getClass());
                                    
		if (handlerType != null) 
		    //如果当前handler是被cglib代理过的对象,那么需要获取当前代理对象的superClass
		    //因为这才是目标handler的类型
			Class<?> userType = ClassUtils.getUserClass(handlerType);
			//MethodIntrospector类主要提供对方法的筛选和通用处理封装
			//这里selectMethods就是筛选出当前handler内部所有符合要求的handlerMethod
			Map<Method, T> methods = MethodIntrospector.selectMethods(userType,
			        //筛选出某个handlerMethod,利用注册的回调接口生成映射关系
					(MethodIntrospector.MetadataLookup<T>) method -> 
						try 
							return getMappingForMethod(method, userType);
						
						catch (Throwable ex) 
							throw new IllegalStateException("Invalid mapping on handler class [" +
									userType.getName() + "]: " + method, ex);
						
					);
			... 
			methods.forEach((method, mapping) -> 
			    //对jdk动态代理的情况进行处理--一般情况下可以忽略,因此controller层一般都是采用cglib代理
				Method invocableMethod = AopUtils.selectInvocableMethod(method, userType);
				//注册
				registerHandlerMethod(handler, invocableMethod, mapping);
			);
		
	

MethodIntrospector.selectMethods通过getMappingForMethod回调接口筛选出相关方法,并且建立好Method和对应RequestMappingInfo 映射关系后,返回了一个map集合,下面就是需要将这些映射关系进行注册。


子类RequestMappingHandlerMapping重写了父类的registerHandlerMethod方法,主要提供了对ConsumesCondition扩展点的支持:

	@Override
	protected void registerHandlerMethod(Object handler, Method method, RequestMappingInfo mapping) 
		super.registerHandlerMethod(handler, method, mapping);
		updateConsumesCondition(mapping, method);
	

这里,我们先将目光着眼于父类AbstractHandlerMethodMapping提供的registerHandlerMethod实现:

	protected void registerHandlerMethod(Object handler, Method method, T mapping) 
		this.mappingRegistry.register(mapping, handler, method);
	

MappingRegistry映射注册中心

MappingRegistry是AbstractHandlerMethodMapping内部维护的一个映射关系的注册中心:

	class MappingRegistry 
        //保存RequestMappingInfo和MappingRegistration的映射关系
		private final Map<T, MappingRegistration<T>> registry = new HashMap<>();
        //保存请求路径和RequestMappingInfo的映射关系
		private final MultiValueMap<String, T> pathLookup = new LinkedMultiValueMap<>();
        //保存handlerMethodName和handlerMethod的映射关系  
		private final Map<String, List<HandlerMethod>> nameLookup = new ConcurrentHashMap<>();
        //保存handlerMethod和跨域配置的映射关系
		private final Map<HandlerMethod, CorsConfiguration> corsLookup = new ConcurrentHashMap<>();
        //读写锁 
		private final ReentrantReadWriteLock readWriteLock = new ReentrantReadWriteLock();
		
		...

具体注册过程

考虑到并发修改注册中心带来的安全性,这里采用了写锁:

   //mapping就是handlerMethod对应的RequestMappingInfo
   //然后是handler和handlerMethod
   //ps:这里的handlerMethod指的是handler中的处理请求方法
	public void register(T mapping, Object handler, Method method) 
			this.readWriteLock.writeLock().lock();
			try 
			    //对原生处理请求方法进行了一层封装,包装为了一个HandlerMethod 
				HandlerMethod handlerMethod = createHandlerMethod(handler, method);
				//进行映射校验,判断是否存在模糊映射,即一个请求URL可以同时被多个handlerMethod处理
				validateMethodMapping(handlerMethod, mapping);
                //从RequestMappingInfo中获取当前handlerMethod能够处理的请求URL集合
				Set<String> directPaths = AbstractHandlerMethodMapping.this.getDirectPaths(mapping);
				//将请求路径和RequestMappingInfo的映射关系添加到pathLookUp集合中保存
				for (String path : directPaths) 
					this.pathLookup.add(path, mapping);
				
               
                  // 为HandlerMethod的映射分配名称
	              // 默认采用:RequestMappingInfoHandlerMethodMappingNamingStrategy 策略来分配名称
	             // 策略为:@RequestMapping指定了name属性,那就以指定的为准  否则策略为:取出Controller所有的`大写字母` + # + method.getName()
	            // 如:AppoloController#match方法  最终的name为:AC#match 
				String name = null;
				if (getNamingStrategy() != null) 
					name = getNamingStrategy().getName(handlerMethod, mapping);
					addMappingName(name, handlerMethod);
				
                
                //处理方法上的CrossOrigin跨域注解---这个后面讲到跨域问题的时候再说,本文不展开 
				CorsConfiguration corsConfig = initCorsConfiguration(handler, method, mapping);
				if (corsConfig != null) 
					corsConfig.validateAllowCredentials();
					this.corsLookup.put(handlerMethod, corsConfig);
				
                //注册---这里是RequestMappingInfo和封装后的MappingRegistration的映射
				this.registry.put(mapping,
						new MappingRegistration<>(mapping, handlerMethod, directPaths, name, corsConfig != null));
			
			finally 
			    //释放写锁
				this.readWriteLock.writeLock().unlock();
			
		
  • createHandlerMethod
	protected HandlerMethod createHandlerMethod(以上是关于Spring MVC注解Controller源码流程解析--映射建立的主要内容,如果未能解决你的问题,请参考以下文章

Spring MVC注解Controller源码流程解析---请求匹配中的容错处理

Spring MVC注解Controller源码流程解析--HandlerAdapter执行流程--上

spring mvc的RequestMappingHandlerMapping注册HandlerMethod源码分析

Spring MVC注解版本--初识--12

Spring MVC 基础注解之@RequestMapping@Controller

Spring MVC 常用注解@Controller,@RequestMapping,Model和ModelAndView