使用swagger自动生成文档

后端的同学肯定会经常碰到这样的需求：这个接口开发完了，但是前端和测试不知道怎么联调和测试，你写一个文档给他们吧，这种要求实在是很细碎，有没有一种方法能自动生成文档从而减少沟通时间呢？
swagger是一个开源的组件，可以自动帮你生成接口文档，下面是具体的代码，

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket capitalApi() {

        List<ResponseMessage> responseMessageArrayList = Lists.newArrayList(
                new ResponseMessageBuilder()
                        .code(400)
                        .message("Bad Request")
                        .responseModel(new ModelRef(Response.class.getSimpleName()))
                        .build(),
                new ResponseMessageBuilder()
                        .code(500)
                        .message("Internal Server Error")
                        .responseModel(new ModelRef(Response.class.getSimpleName()))
                        .build()
        );
        return new Docket(DocumentationType.S