尝鲜刚发布的 SpringFox 3.0.0，以前造的轮子可以不用了...

<dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-swagger2</artifactId>    <version>3.0.0</version>    <scope>compile</scope></dependency><dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-swagger-ui</artifactId>    <version>3.0.0</version>    <scope>compile</scope></dependency>

<dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-boot-starter</artifactId>    <version>3.0.0</version><dependency>

@EnableOpenApi@SpringBootApplicationpublic class DemoApplication {
    public static void main(String[] args) {        SpringApplication.run(DemoApplication.class, args);    }
}

@Api(tags="用户管理")@RestControllerpublic class UserController {
    @ApiOperation("创建用户")    @PostMapping("/users")    public User create(@RequestBody @Valid User user) {        return user;    }
    @ApiOperation("用户详情")    @GetMapping("/users/{id}")    public User findById(@PathVariable Long id) {        return new User("bbb", 21, "上海", "aaa@bbb.com");    }
    @ApiOperation("用户列表")    @GetMapping("/users")    public List<User> list(@ApiParam("查看第几页") @RequestParam int pageIndex,                           @ApiParam("每页多少条") @RequestParam int pageSize) {        List<User> result = new ArrayList<>();        result.add(new User("aaa", 50, "北京", "aaa@ccc.com"));        result.add(new User("bbb", 21, "广州", "aaa@ddd.com"));        return result;    }
    @ApiIgnore    @DeleteMapping("/users/{id}")    public String deleteById(@PathVariable Long id) {        return "delete user : " + id;    }
}
@Data@NoArgsConstructor@AllArgsConstructor@ApiModel("用户基本信息")public class User {
    @ApiModelProperty("姓名")    @Size(max = 20)    private String name;    @ApiModelProperty("年龄")    @Max(150)    @Min(1)    private Integer age;    @NotNull    private String address;    @Pattern(regexp = "^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\\.[a-zA-Z0-9_-]+)+$")    private String email;
}