/**
 * 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<RequestHandlerProvider> handlerProviders;
}

@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<DocumentationPlugin> 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());
            }
        }
    }
}