springboot2.x集成swagger2（笔记）

GitHub地址：
https://github.com/dyc87112/spring-boot-starter-swagger

1、在pom.xml中导入swagger2的依赖

 <dependency>
<groupId>com.spring4all</groupId>
<artifactId>swagger-spring-boot-starter</artifactId>
<version>1.7.1.RELEASE</version>
</dependency>

说明：

从1.6.0开始，我们按Spring Boot官方建议修改了artifactId为swagger-spring-boot-starter，1.6.0之前的版本不做修改，依然为使用spring-boot-starter-swagger !**
从2.0.0开始，不再需要手工添加@EnableSwagger2Doc来启动Swagger配置

2、开启swagger2的功能

@SpringBootApplication
@EnableSwagger2Doc
public class MybatisPlusTestApplication {
public static void main(String[] args) {
SpringApplication.run(MybatisPlusTestApplication.class, args);
}
}

3、参数配置

springfox.documentation.enabled=true
#是否启用swagger，默认：true
swagger.title=spring-boot-starter-swagger
#标题
swagger.description=Starter for swagger 2.x
#描述
swagger.version=1.4.0.RELEASE
#版本
swagger.license=Apache License, Version 2.0
#许可证
swagger.licenseUrl=https://www.apache.org/licenses/LICENSE-2.0.html
#服务条款URL
swagger.termsOfServiceUrl=https://github.com/dyc87112/spring-boot-starter-swagger
#服务条款URL
swagger.contact.name=didi
#服务条款URL
swagger.contact.url=http://blog.didispace.com
#维护人URL
swagger.contact.email=dyc87112@qq.com
#维护人URL
swagger.base-package=com.didispace
#swagger扫描的基础包，默认：全扫描
swagger.base-path=/**
#需要处理的基础URL规则，默认：/**
swagger.exclude-path=/error, /ops/**
#需要处理的基础URL规则，默认：/**

4、常用注解

@Api
作用在controller类上面。

@RestController
@RequestMapping("/user")
@Api(tags = "用户管理")
public class UserController {

@ApiOperation
作用在controller方法上面，描述方法作用。

@GetMapping("{id}")
@ApiOperation(value = "查询用户", notes = "根据用户ID查询用户信息", response = User.class)
public User getUser(@PathVariable("id") String id) {

@ApiParam
作用在controller上面，对请求参数说明。

@GetMapping("{id}")
public User getUser(@PathVariable("id") @ApiParam(name = "id", value = "用户ID", required = true) String id) {

@ApiResponse
作用在controller上面，方法返回描述

@GetMapping("{id}")
@ApiResponse(code = 200, response = User.class, message = "用户信息对象")
public User getUser(@PathVariable("id") String id) {

@ApiResponses
作用在controller上面，对返回参数参数描述

@ApiImplicitParam
作用在controller上面，对单个请求参数描述

@GetMapping("{id}")
@ApiImplicitParam(name = "id",value = "用户ID",dataType = "String",paramType = "path",required = true)
public User getUser(@PathVariable("id") @ApiParam(name = "id", value = "用户ID", required = true) String id) {

@ApiModel
作用在javaBan类上面，对类进行描述

@ApiModel(description = "用户实体类")
public class User implements Serializable {

@ApiModelProperty
做用在javaBean属性上面，对熟悉进行描述

@ApiModelProperty(value = "用户ID")
@TableId(type = IdType.AUTO)
private Long id;

@ResponseHeader
作用在controller上面，对响应头描述

controller类

package com.example.mybatisplustest.controller;
import com.example.mybatisplustest.pojo.User;
import com.example.mybatisplustest.server.UsreService;
import io.swagger.annotations.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/user")
@Api(tags = "用户管理")
public class UserController {
@Autowired
private UsreService usreService;
@GetMapping("{id}")
@ApiOperation(value = "查询用户", notes = "根据用户ID查询用户信息", response = User.class)
@ApiImplicitParam(name = "id", value = "用户ID", required = true)
public User getUser(@PathVariable String id) {
return usreService.getById(id);
}
@PostMapping()
@ApiOperation(value = "添加用户", notes = "添加用户信息", response = Boolean.class)
@ApiImplicitParam(name = "user", value = "用户实体类")
public boolean saveUser(@RequestBody User user) {
return usreService.save(user);
}
@PutMapping()
@ApiOperation(value = "修改用户", notes = "修改用户信息", response = Boolean.class)
@ApiImplicitParam(name = "user", value = "用户实体类")
public boolean updateUser(@RequestBody User user) {
System.out.println(user);
return usreService.updateById(user);
}
@DeleteMapping("/{id}")
@ApiOperation(value = "删除用户", notes = "删除用户信息", response = Boolean.class)
@ApiImplicitParam(name = "id", value = "用户ID")
public boolean deleteUser(@PathVariable String id) {
return usreService.removeById(id);
}
}

user类

package com.example.mybatisplustest.pojo;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;
import java.io.Serializable;
import java.util.List;
@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName("user")
@ToString
@ApiModel(description = "用户实体类")
public class User implements Serializable {
@ApiModelProperty(value = "用户ID")
@TableId(type = IdType.AUTO)
private Long id;
@ApiModelProperty(value = "用户姓名")
private String name;
@ApiModelProperty(value = "用户地址集合")
@TableField(exist = false)
private List<Address> addressList;
}

最后

以上就是霸气铃铛为你收集整理的springboot2.x集成swagger2（笔记）的全部内容，希望文章能够帮你解决springboot2.x集成swagger2（笔记）所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。