首页 > 其他 > 详细

Swagger2在线文档生成官方配置

时间:2019-11-05 16:44:33      阅读:172      评论:0      收藏:0      [点我收藏+]

Swagger2依赖

<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.7.0</version>
</dependency>

在使用时,发现2.7.2的比较好用,2.2.2的可能报错

 

配置文件

 

@Configuration
@EnableSwagger2 //开启在线文档
public class SwaggerConfig {
    //1.声明api 文档的属性 构建起
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("springboot使用在线文档构建RestFul风格Api")
                .description("bug猿")
                .termsOfServiceUrl("http://cnblogs.com/")
                .contact("java").version("1.0").build();
    }
    //2配置核心配置信息
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select().apis(RequestHandlerSelectors.basePackage("com.offcn.springbootdemo.controller"))
                .paths(PathSelectors.any()).build();
    }
}

 修改Controller增加文档注释

 @PutMapping("/{id}")
        @ApiOperation(value = "更新指定id用户信息",notes = "根据id更新用户信息")
        @ApiImplicitParams({
                @ApiImplicitParam(name = "id",value = "用户id",required = true,dataType = "Long"),
                @ApiImplicitParam(name = "user",value = "用户详细实体user",required = true,dataType = "User")
        })
        public String updateUser(@PathVariable("id") Long id,User user) {
            for (User user2 : listUser) {
                if(user2.getId()==id) {
                    user2.setName(user.getName());
                    user2.setAge(user.getAge());
                }
            }
            return "success";
        }

//删除指定id用户
        @DeleteMapping("/{id}")
        @ApiOperation(value="删除指定id用户信息",notes = "根据id删除")
        @ApiImplicitParam(name="id",value = "用户id",required = true,dataType = "Long")

        public String deleteUser(@PathVariable("id") Long id) {
            listUser.remove(getUser(id));
            return "success";

        }
    }

最后访问地址:http://localhost:8080/swagger-ui.html

 

技术分享图片

 

 技术分享图片

 

 

Swagger2在线文档生成官方配置

原文:https://www.cnblogs.com/proyuan/p/11797719.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!