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

/** 
* 類(lèi)說(shuō)明 :自定義swagger配置信息
*/
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    @Bean
     public Docket creatApi(){
     return new Docket(DocumentationType.SWAGGER_2)
      .apiInfo(apiInfo())
      .select() //選擇哪些路徑和api會(huì)生成document
      .apis(RequestHandlerSelectors.basePackage("com.zwp.controller"))//controller路徑
      //.apis(RequestHandlerSelectors.any())   //對(duì)所有api進(jìn)行監(jiān)控
      .paths(PathSelectors.any())  //對(duì)所有路徑進(jìn)行監(jiān)控
      .build();
     }
    
    //接口文檔的一些基本信息
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("springmvc+swagger整合")//文檔主標(biāo)題
                .description("test接口文檔")//文檔描述
                .version("1.0.0")//API的版本
                .termsOfServiceUrl("###")
                .license("LICENSE")
                .licenseUrl("###")
                .build();
    }
}

<!-- 使用注解驅(qū)動(dòng)：自動(dòng)配置處理器映射器與處理器適配器 -->
<mvc:annotation-driven />
<!-- 注解方式：自動(dòng)掃描該包 -->
<context:component-scan base-package="com.zwp.config" />

<mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/" />
<mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/" />

//在類(lèi)上面加@Api注解，表明該controller類(lèi)需要被swagger自動(dòng)生成文檔
@Api(tags="UserController",description="user的控制層")
@Controller
@RequestMapping("/user")
public class UserController {
    
    @Autowired
    private UserService userService;
 
     //在方法上面添加@ApiOperation注解，表明該方法需要被swagger自動(dòng)生成文檔
    @ApiOperation(httpMethod="GET",value="接口標(biāo)題:獲取用戶(hù)信息",notes="接口的notes說(shuō)明：需要user的id")
    @RequestMapping(value="/getUserById/{userId}",method=RequestMethod.GET)
    public @ResponseBody User getUserById(@PathVariable Integer userId){
        return userService.getUserById(userId);
    }
    
}

@Api(value="用戶(hù)controller",tags={"用戶(hù)操作接口"})
@RestController
public class UserController {
 
}

@Api(value="用戶(hù)controller",tags={"用戶(hù)操作接口"})
@RestController
public class UserController {
     @ApiOperation(value="獲取用戶(hù)信息",tags={"獲取用戶(hù)信息copy"},notes="注意問(wèn)題點(diǎn)")
     @GetMapping("/getUserInfo")
     public User getUserInfo(@ApiParam(name="id",value="用戶(hù)id",required=true) Long id,@ApiParam(name="username",value="用戶(hù)名") String username) {
     // userService可忽略，是業(yè)務(wù)邏輯
      User user = userService.getUserInfo();
 
      return user;
  }
}

@ApiModel(value="user對(duì)象",description="用戶(hù)對(duì)象user")
public class User implements Serializable{
    private static final long serialVersionUID = 1L;
     @ApiModelProperty(value="用戶(hù)名",name="username",example="xingguo")
     private String username;
     @ApiModelProperty(value="狀態(tài)",name="state",required=true)
      private Integer state;
      private String password;
      private String nickName;
      private Integer isDeleted;
 
      @ApiModelProperty(value="id數(shù)組",hidden=true)
      private String[] ids;
      private List<String> idList;
}

  @ApiOperation("更改用戶(hù)信息")
  @PostMapping("/updateUserInfo")
  public int updateUserInfo(@RequestBody @ApiParam(name="用戶(hù)對(duì)象",value="傳入json格式",required=true) User user){
 
     int num = userService.updateUserInfo(user);
     return num;
  }

  @ApiOperation("查詢(xún)測(cè)試")
  @GetMapping("select")
  //@ApiImplicitParam(name="name",value="用戶(hù)名",dataType="String", paramType = "query")
  @ApiImplicitParams({
  @ApiImplicitParam(name="name",value="用戶(hù)名",dataType="string", paramType = "query",example="xingguo"),
  @ApiImplicitParam(name="id",value="用戶(hù)id",dataType="long", paramType = "query")})
  public void select(){
 
  }

    @ApiOperation("信息軟刪除")
    @ApiResponses({ @ApiResponse(code = CommonStatus.OK, message = "操作成功"),
            @ApiResponse(code = CommonStatus.EXCEPTION, message = "服務(wù)器內(nèi)部異常"),
            @ApiResponse(code = CommonStatus.FORBIDDEN, message = "權(quán)限不足") })
    @ApiImplicitParams({ @ApiImplicitParam(paramType = "query", dataType = "Long", name = "id", value = "信息id", required = true) })
    @RequestMapping(value = "/remove.json", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
    public RestfulProtocol remove(Long id) {