开发指南040-swagger加header

       swagger可以在线生成接口文档，便于前后端沟通，而且还可以在线调用接口，方便后台调试。但是接口需要经过登录校验，部分接口还需要得到登录token，使用token识别用户身份进行后续操作。这种情况下，都需要接口增加header，好携带认证信息。

        swagger2和swagger3有很大不同，平台选用的是swagger3。网上很多解决方案都是swagger2的，采用时一定看好自己的版本。无论2或3基本都是改配置类：

        第一步 new Docket这里要加上               

                .securitySchemes(securitySchemes())
                .securityContexts(securityContexts());

                其中：

    private List<SecurityScheme> securitySchemes() {
        //设置请求头信息
        List<SecurityScheme> result = new ArrayList<>();
        ApiKey apiKey = new ApiKey("qlm-jwt", "qlm-jwt", "header");
        result.add(apiKey);
        return result;
    }
    private List<SecurityContext> securityContexts() {
        //设置需要登录认证的路径
        List<SecurityContext> result = new ArrayList<>();
        result.add(buildContext("/.*"));
        return result;
    }

         第二步：启动真正的前端进行登录，在application中找到token

         第三步：打开swagger_ui界面，会发现右上角多了个授权的按钮。打开录入上面的token

         第四步：在线测试接口。发现可以通过接口的登录验证了