首先在pom.xml中添加如下依赖,其它web,lombok等依赖自行添加

    
            io.springfox
            springfox-swagger2
            2.7.0
        

        
            io.springfox
            springfox-swagger-ui
            2.7.0

SwaggerConfig.java是swagger2的配置类

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("cn.niit.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Spring Boot中使用Swagger2")
                .description("首次尝试自动生成api文档为后期的前后端分离开发做准备")
                .termsOfServiceUrl("https://www.jianshu.com/u/2f60beddf923")
                .contact("WEN")
                .version("1.0")
                .build();
    }
}

实体类User.java

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    public User(String userName, String password) {
        this.userName = userName;
        this.password = password;
    }

    private Integer id;
    private String userName;
    private String password;
}

新建一个控制类UserController.java，类下有个方法getAllUser

@RestController
@Api(description = "用户管理")
@RequestMapping(value = "/hello",produces = APPLICATION_JSON_VALUE)
public class UserController {

    Listlists=new ArrayList<>();

    @GetMapping(value ="getAllUser" )
    @ApiOperation(value = "用户列表",notes = "查询所有已注册过的用户详细信息")
    public List getAllUser()
    {
    lists.add(new User("wen","999"));
    lists.add(new User(2,"qian","666"));
    return lists;
    }
}

点击localhost:8888/swagger-ui.html(我在application.propertise中的server.port=8888)

在类中再添加一个方法addUser

 @PostMapping(value = "addUser")
    public User addUser(User user)
    {
        return user;
    }

实体类User.java的属性上添加如下注解

@ApiModelProperty(value = "用户ID")
    private Integer id;
    @ApiModelProperty(value = "用户名")
    private String userName;
    @ApiModelProperty(value = "密码")
    private String password;

创建用户时有些字段我们并不需要，可以加入如下注解

    @ApiModelProperty(hidden = true)

在类中再添加一个根据用户id查询用户的方法

    @GetMapping(value = "getUserById/{id}")
    public User getUserById(@ApiParam(value = "用户ID")@PathVariable(value = "id")String id)
    {
        return new User(id,"步惊云","passwordjava");
    }