SpringBoot结合Swagger2自动生成api文档的方法

  <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>

@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();
  }
}

@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;
}

@restcontroller
@api(description = "用户管理")
@requestmapping(value = "/hello",produces = application_json_value)
public class usercontroller {

  list<user>lists=new arraylist<>();

  @getmapping(value ="getalluser" )
  @apioperation(value = "用户列表",notes = "查询所有已注册过的用户详细信息")
  public list<user> getalluser()
  {
  lists.add(new user("wen","999"));
  lists.add(new user(2,"qian","666"));
  return lists;
  }
}

 @postmapping(value = "adduser")
  public user adduser(user user)
  {
    return user;
  }

@apimodelproperty(value = "用户id")
  private integer id;
  @apimodelproperty(value = "用户名")
  private string username;
  @apimodelproperty(value = "密码")
  private string password;

@apimodelproperty(hidden = true)

  @getmapping(value = "getuserbyid/{id}")
  public user getuserbyid(@apiparam(value = "用户id")@pathvariable(value = "id")string id)
  {
    return new user(id,"步惊云","passwordjava");
  }

<!--国际化操作：选择中文版 -->
 <script src='webjars/springfox-swagger-ui/lang/translator.js' type='text/javascript'></script>
 <script src='webjars/springfox-swagger-ui/lang/zh-cn.js' type='text/javascript'></script>