这篇文章给大家介绍Swagger扩展开发中任意架构实现Swagger Doc注册的示例分析，内容非常详细，感兴趣的小伙伴们可以参考借鉴，希望对大家能有所帮助。
网站建设哪家好，找创新互联！专注于网页设计、网站建设、微信开发、小程序开发、集团企业网站建设等服务项目。为回馈新老客户创新互联还提供了广陵免费建站欢迎大家使用！
缘起：公司08年以前的老项目，跟着迭代了一个版本，架构太老自己干着也受气。于是提议升级为SpringBoot 这种新的能好受一点。但是老接口太多，老接口是通过自定义实现的Servlet，按照扫描Bean 函数通过反射的方式调用。也不想把所有接口都转为新的，旧接口前端要 Swagger 没办法，硬着头皮上。
查了大量资料，都是 SpringBoot 集成 Swagger，重复、简单技术含量很低，没找到我想要的。
首先把项目一通整合，一通重构支持了 SpringBoot，通过SpringBoot 启动，并且集成了Swagger，新写的RESTAPI 都支持Swagger。现在需要扫描旧接口，生成Swagger。
实现一个Spring ApplicationListener，在Spring ApplicationContext 初始化完成后调用，用于生成旧接口的Swagger 扫描。
@Repository public class SwaggerExtentionSupport implements ApplicationListener{ @Override public void onApplicationEvent(ContextRefreshedEvent event) { // Spring 框架加载完全后，扫描 bean，获取 servlet initSwagger(event.getApplicationContext()); } }
注入 DocumentationCache
@Autowired
DocumentationCache documentationCache;
// Swagger 默认是 Default，就接口我们放到自定义的 group 下
@Value("${swagger.group}")
private String groupName;通过 Debug，发现新实现的SpringBoot接口，构造的如下：
开始扫描接口
private void initSwagger(ApplicationContext context) {
Documentation documentation = documentationCache.documentationByGroup(groupName);
if(documentation == null) {
// 如果 groupName 指定的下没有，则挂载 default 上
documentation = documentationCache.documentationByGroup(Docket.DEFAULT_GROUP_NAME);
}
if (documentation != null) {
// 取得所有的 API 合集
Multimap apiListings = documentation.getApiListings();
Class[] clazzs = ... //Scan Classes
for (Class aClass : clazzs) {
log.info("add swagger bean {}", aClass.getSimpleName());
Method[] servletMethods = aClass.getDeclaredMethods();
for (Method servletMethod : servletMethods) {
String methodName = servletMethod.getName();
// 获得接口名称，必须符合是API接口，且方法是 public
if(validSwagger(methodName) && Modifier.isPublic(servletMethod.getModifiers())) {
// 返回 tags
Set tags = addApi(apiListings, documentation.getBasePath(), name, methodName);
if(!tags.isEmpty()) {
documentation.getTags().addAll(tags);
}
}
}
log.info("swagger apis size: {}", apiListings.size());
}
}
} 把扫描到合法的添加到Swagger
