Spring Boot 项目中使用Swagger2的示例

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

import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import springfox.documentation.builders.ApiInfoBuilder;import springfox.documentation.builders.PathSelectors;import springfox.documentation.builders.RequestHandlerSelectors;import springfox.documentation.service.ApiInfo;import springfox.documentation.spi.DocumentationType;import springfox.documentation.spring.web.plugins.Docket;import springfox.documentation.swagger2.annotations.EnableSwagger2;@Configuration@EnableSwagger2public class Swagger2 {  @Bean  public Docket createRestApi() {    return new Docket(DocumentationType.SWAGGER_2)        .apiInfo(apiInfo())        .select()        .apis(RequestHandlerSelectors.basePackage("你自己的外部接口包名称"))        .paths(PathSelectors.any())        .build();  }  private ApiInfo apiInfo() {    return new ApiInfoBuilder()        .title("词网Neo4j RESTful APIs")        .description("The Neo4j RESTful APIs description/")        .termsOfServiceUrl("")        .contact("李庆海")        .version("5.0")        .build();  }}

import io.swagger.annotations.Api;import io.swagger.annotations.ApiOperation;import io.swagger.annotations.ApiParam;/** * 系统用户Controller *  * @author 李庆海 * */@Api(value = "系统用户接口", tags = "系统管理")@RestController@RequestMapping("/v3/edu/users")public class UserController {  @Autowired  private UserService userService;  /**   * 添加用户，注册   *    * @param loginName   *      登录账号   * @param userName   *      用户名称   * @param password   *      登录密码   * @param roleId   *      用户角色   * @return   * @throws ResourceExistsException   */  @ApiOperation(value = "添加用户")  @PostMapping("/")  public JsonResult create(      @ApiParam(name = "loginName", value = "登录账号", required = true) @RequestParam(required = true) @RequestBody String loginName,      @ApiParam(name = "userName", value = "用户名称", required = true) @RequestParam(required = true) @RequestBody String userName,      @ApiParam(name = "password", value = "登录密码", required = true) @RequestParam(required = true) @RequestBody String password,      @ApiParam(name = "roleId", value = "用户角色编号", required = true) @RequestParam(required = true) @RequestBody String roleId)      throws ResourceExistsException {    boolean exists = this.userService.exists(loginName);    if (exists) {      throw new ResourceExistsException(loginName);    }    User user = userService.create(loginName, password, userName, roleId);    return new JsonResult(user);  }}