【Java】 Swagger 自定义输出文档

　　Swagger 作为 Java 开发中常用的接口文档生成组件，绝大部分情况下都可以满足我们的业务需求。但有些时候依然有些不足，比如针对系统中某些特殊接口需要作出一些增强。

　　我自己在使用 Swagger 时候遇到需要将 base_path 消除并直接拼接到接口路径上的情形。一共寻找到两种方式：

　　　　1. 重写 Swagger2Controller ，并将转发到 tomcat 容器中的请求转发至重写后的 Swagger2Controller 中。

　　　　2. 使用切面，将即将序列化的 swagger 对象做定制化更改增强。

　　第一个方案卡在请求转发到重写后的控制器。应用的 Web 容器与 Swagger 的 Web容器并不相通，试了很久也没有实现。最终决定更换赛道，采用第二种方案。

　　第二种方案可以指定切入点为 springfox.documentation.spring.web.json.JsonSerializer.toJson ，此方法在 “ /v2/api-docs ” 路径响应完毕并将 Swagger 对象转为 Json 对象时使用。

　　具体切面代码如下：

@Aspect
@Component
@AllArgsConstructor
public class SwaggerAspect {
    @Around("execution(* springfox.documentation.spring.web.json.JsonSerializer.toJson(..))")
    public Object switchDataSource(ProceedingJoinPoint joinPoint) throws Throwable {
        Object[] args = joinPoint.getArgs();
        if (ArrayUtils.isEmpty(args)) {
            return joinPoint.proceed(args);
        }
        Object swaggerObject = args[0];
        if(swaggerObject instanceof Swagger){
            Swagger swagger = (Swagger) swaggerObject;
            String basePath = swagger.getBasePath();
            swagger.setBasePath("/");
            Map<String, Path> paths = swagger.getPaths();
            Map<String, Path> newPaths = new HashMap<>();
            for (Map.Entry<String, Path> entry : paths.entrySet()) {
                String newPath = basePath + entry.getKey();
                newPaths.put(newPath, entry.getValue());
            }
            swagger.setPaths(newPaths);
        }
        args[0] = swaggerObject;
        return joinPoint.proceed(args);
    }
}