springboot 2 swagger2配置

pom.xml

        
            io.springfox
            springfox-swagger2
            2.8.0
        
        
            io.springfox
            springfox-swagger-ui
            2.8.0
        

        
            javax.xml.bind
            jaxb-api
        

SwaggerConfig.java

@Configuration 
@EnableSwagger2 
public class SwaggerConfig {
	
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("API")
                .version("1.0")
                .build();
    }

    
}

简单使用

http://localhost:8080/service/swagger-ui.html

@Api(value=ApiTemplate.APP_ROOT_PATH,tags="XX模块")
@RequestMapping(ApiTemplate.V1 + "/users")
@RestController
public class UserController {
	
	@Autowired
	User user;
	
	@ApiOperation("获取所有用户")
	@GetMapping
	public List getUsers() {
		List list = new ArrayList();
		return list;
	}
	
	@ApiOperation("获取某个用户")
	@GetMapping(value = "/{id}")
	public User getUser(@PathVariable Long id) {
		return user;
	}
	
	@ApiOperation("添加用户")
	@PostMapping
	public boolean insertUser(User user) {
		return true;
	}
	
	@ApiOperation(value="修改用户")
	@PutMapping
	@ApiImplicitParams({
	    @ApiImplicitParam(name="id",value="主键",required=true,dataType="int")
	})
	public User updateUser(User user) {
		return user;
	}
	
	@ApiOperation("删除用户")
	@DeleteMapping
	@ApiImplicitParams({
	    @ApiImplicitParam(name="ids",value="主键列表：1,2,3,4,5",required=true)
	})
	public Object deleteUser(Long[] ids) {
		return ids;
	}

@Api 将类标记为Swagger资源。
@ApiImplicitParam 表示API操作中的单个参数。
@ApiImplicitParams 允许多个ApiImplicitParam对象列表的包装器。
@ApiModel 提供有关Swagger型号的其他信息。
@ApiModelProperty 添加和操作模型属性的数据。
@ApiOperation 描述针对特定路径的操作或通常的HTTP方法。
@ApiParam 为操作参数添加额外的元数据。
@ApiResponse 描述操作的可能响应。
@ApiResponses 允许多个ApiResponse对象列表的包装器。
@Authorization 声明在资源或操作上使用授权方案。
@AuthorizationScope 描述OAuth2授权范围。
@ResponseHeader 表示可以作为响应的一部分提供的头。