Swagger2的/v2/api-docs接口是如何对第三方项目暴露的【实现原理】

Swagger2的/v2/api-docs接口是如何对第三方项目暴露的呢？也就是说jar包中如何暴露接口给第三方应用？

答案是：HandlerMapping

swagger2实现了自己的HandlerMapping，在实现类PropertySourcedRequestMappingHandlerMapping中，把/v2/api-docs接口保存到了handlerMethods
集合。然后提供了访问/v2/api-docs接口的方法lookupHandlerMethod(String urlPath, HttpServletRequest request)，这样请求过来的时候，就可以
根据接口路径找到对应的控制器Swagger2Ctroller.class

 

OK，接下来，我们细看。

 

第一步：实现HandlerMapper接口

 

Swagger2的实现类是PropertySourcedRequestMappingHandlerMapping，其实就是HandlerMapping的实现。

PropertySourcedRequestMappingHandlerMapping的核心是2个方法：initHandlerMethods和lookupHandlerMethod

initHandlerMethods：把接口路径和HandlerMethod存放到spring boot webmvc的集合。

lookupHandlerMethod：提供根据接口路径查找处理类controller的功能。

 

package springfox.documentation.spring.web;

import com.google.common.base.Function;
import com.google.common.base.Optional;
import java.lang.reflect.Method;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import org.springframework.core.annotation.AnnotationUtils;
import org.springframework.core.env.Environment;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.HandlerMapping;
import org.springframework.web.servlet.mvc.method.RequestMappingInfo;
import org.springframework.web.servlet.mvc.method.annotatio