springfox源码_springfox 源码分析(七) 文档初始化
时间:2019-5-23 20:12:04
地点:家中
通过前面几篇文章对springfox的介绍,以及我们的学习准备工作,这篇我们将正式来探索springfox是如何初始化的
我们在学算法的时候,其中一个算法是快速排序,而快速排序讲究的是如果给定一个集合的元素<2,那其实就不用排序了,那就是最快的,取集合中任意元素M,然后,比M小的,排左边,比M大的排右边,这样只需要排2次(递归调用最小次数),这其中用到了分而治之的思想,这种思想我们在工作中也很适用,就拿学习源码来说吧,将一个看似很难的源码,分解成若干小块,每一个小块都逐一研究攻破,因为你不可能所有的都不懂,随着研究的过程中,自信心的增长,整个部分的源码最后你就会把他吃透.
项目结构
在这之前,我们先来看一下springfox的项目分层结构:
这是springfox 2.9.2版本的源码结构,主要包含了6个模块:
springfox-core:springfox的核心包,里面基本封装的是一些实体类,core模块大量的运用了设计模式中的Builder构造器
springfox-schema:一系列方法实现类
springfox-spi:一系列的Plugin接口声明
springfox-spring-web:针对spring-web模块的核心操作,springfox的初始化代码也在此模块中
springfox-swagger2:对外使用类,注解,包括我们熟知的@EnableSwagger2注解
springfox-swagger-common:springfox的功能模块代码,Plugin接口的实现
启动类
启动类就是springfox的开始,从前面的篇幅我们也发现了,springfox没有给我们任何有益的提示,告诉我们他的启动类是那个,是具体在何时初始化的
当然我也是很茫然,一个偶然的机会,只是在代码中多瞟了一眼,我突然就发现了她,她就如太阳一样,温暖着我的心,令我为止动容,她就是springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.java
至于是如何发现她的,你们各自体会吧…
首先来看DocumentationPluginsBootstrapper.java的部分源码:
/**
* After an application context refresh, builds and executes all DocumentationConfigurer instances found in the
* application context.
*
* If no instances DocumentationConfigurer are found a default one is created and executed.
*/
@Component
public class DocumentationPluginsBootstrapper implements SmartLifecycle {
private static final Logger log = LoggerFactory.getLogger(DocumentationPluginsBootstrapper.class);
private static final String SPRINGFOX_DOCUMENTATION_AUTO_STARTUP = "springfox.documentation.auto-startup";
//插件管理类,提供了一些列的Swagger相关参数的插件
private final DocumentationPluginsManager documentationPluginsManager;
//所有的请求接口结果
/***
* springfox.documentation.spring.web.plugins
*/
private final List handlerProviders;
}
因为DocumentationPluginsBootstrapper类实现了Spring的SmartLifecycle接口,而我们都知道,在Spring的应用程序中,实现此接口后,并且通过@Component注入到容器的bean,在Spring容器初始化完成后,都会执行这个接口的start()方法.
既然是Spring容器初始化完成后执行的操作,我想那就是springfox的初始化操作,没错了(PS:因为我也再找不到其他的启动类了。。。)。
来看start方法
@Override
public void start() {
if (initialized.compareAndSet(false, true)) {
log.info("Context refreshed");
//此处拿到DocumentationPlugin插件
//因为Docket类是实现了DocumentationPlugin,我们在程序外部通过@Bean注解注入到Spring容器中,所以此处DocumentationPlugin的实例对象是Docket对象
//一个Docket代表的一个分组,多个则是多个文档分组
//调用guava的排序规则,根据groupName排序
//思考:在重构Swagger-ui的过程中,会有需求能否提供默认的排序规则,因为groupName排序对用户来说太死板,可以提供一个order参数值来进行默认排序,这样对用户更友好
List plugins = pluginOrdering()
.sortedCopy(documentationPluginsManager.documentationPlugins());
log.info("Found {} custom documentation plugin(s)", plugins.size());
//遍历Docket对象
for (DocumentationPlugin each : plugins) {
//获取文档类型,一般都是Swagger_2
DocumentationType documentationType = each.getDocumentationType();
if (each.isEnabled()) {
//如果启用,则开始扫描生成文档
scanDocumentation(buildContext(each));
} else {
log.info("Skipping initializing disabled plugin bean {} v{}",
documentationType.getName(), documentationType.getVersion());
}
}
}
}
从代码中,我们看到:
首先获取DocumentationPlugin的实现类列表,而DocumentaionPlugin我们在前面的章节也介绍过,他只有一个实现类,那就是Docket,而Docket类正是我们在使用Springfox的时候,通过编写SwaggerConfiguration配置文件,通过@Bean注解注入的对象,此处DocumentationPlugin的集合实际拿到的就是List实例集合,我们在外部创建几个Docket,此处就会有几个DocumentationPlugin
通过循环外部创建的Docket实体bean,最终转换为Documentation文档对象
我们找到了springfox的初始化方法,接下来,针对Springfox的各个操作步骤,我们逐一分析.
springfox源码_springfox 源码分析(七) 文档初始化相关推荐
- 草帽船长(梦想海贼王)全套源码:客户端+服务端+资源+文档
草帽船长(梦想海贼王)全套源码:客户端+服务端+资源+文档 ,需要帮助搭建联系QQ 2805477110 下载地址:http://www.51xyyx.com/2705.html 梦想海贼王全套源码, ...
- java计算机毕业设计中医药科普网站源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计中医药科普网站源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计中医药科普网站源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构:B/S架构 ...
- java计算机毕业设计智慧后勤系统源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计智慧后勤系统源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计智慧后勤系统源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构:B/S架构 开 ...
- java计算机毕业设计中药材电子商务平台源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计中药材电子商务平台源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计中药材电子商务平台源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构:B ...
- java计算机毕业设计智友少儿编程学习平台源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计智友少儿编程学习平台源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计智友少儿编程学习平台源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构 ...
- java计算机毕业设计智能旅游电子票务系统演示录像2020源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计智能旅游电子票务系统演示录像2020源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计智能旅游电子票务系统演示录像2020源码+mysql数据库+系统+部署+l ...
- java计算机毕业设计智慧门诊综合管理系统源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计智慧门诊综合管理系统源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计智慧门诊综合管理系统源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构 ...
- java计算机毕业设计智慧校园学生选宿系统源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计智慧校园学生选宿系统源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计智慧校园学生选宿系统源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构 ...
- java计算机毕业设计智能医技预约系统源码+mysql数据库+系统+部署+lw文档
java计算机毕业设计智能医技预约系统源码+mysql数据库+系统+部署+lw文档 java计算机毕业设计智能医技预约系统源码+mysql数据库+系统+部署+lw文档 本源码技术栈: 项目架构:B/S ...
最新文章
- 干货! AI 推断解决方案栈 Vitis AI 全流程独家解析
- 传孙正义领投滴滴无人车3亿美元新融资,此前软银宣布出售阿里股份等资产
- JavaScript学习笔记(1)
- 知乎:学计算机的女生都怎么样了?
- CBOW模型的学习、Trainer类的实现
- 正确加载 Javascript 和 CSS 到 WordPress
- 一文梳理序列化推荐算法模型进展
- jsmin 使用方法
- Proj.4 API 中文参考
- 组成原理说明------地址对齐
- APISpace 银行卡二要素API
- 【历史上的今天】9 月 3 日:谷歌发布 Android 10;微软收购诺基亚;eBay 诞生
- dede服务器建站_「建站篇」如何将本地搭建的织梦站点上传到服务器空间?
- 【HTML】HTML网页设计-----游戏网页设计
- 2020年度个税汇算清缴怎么办理?直接上干货!
- 华为鸿蒙战略发布会内容,万物互联!华为鸿蒙发布会带来无限可能
- OR-Tools:6-路由问题(Routing)车辆路线,旅行商问题TSP
- 《机器学习实战》学习笔记(三):决策树
- 基于深度学习的信息隐藏技术的研究总结(一)
- monaco-editor(code编辑器插件)使用及常用配置与方法