如何覆盖Swagger的默认生成头值？

Question

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    private static final Set<String> DEFAULT_PRODUCES_AND_CONSUMES = ImmutableSet.of(
            "application/json"
    );

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .produces(DEFAULT_PRODUCES_AND_CONSUMES)
                .consumes(DEFAULT_PRODUCES_AND_CONSUMES);
    }
}

@Consumes(MediaType.APPLICATION_JSON)
@Api(value = "/transform", protocols = "http, https")
@RequestMapping(value = "/transform")
public interface ApiEndpoint {

    @POST
    @RequestMapping(value = "/text", method = RequestMethod.POST)
    @ApiOperation(value = "Transform to plain text", produces = MediaType.TEXT_PLAIN)
    @CrossOrigin
    String transformToText(@RequestBody TransformRequest transformRequest) throws Exception;
}

现在，我希望这个endpoint生成内容类型仅为纯文本的响应，但是SwaggerConfig添加了application/json选项作为默认选项。因此，为了正确使用这个endpoint，我需要每次都将响应内容类型从application/json更改为text/plain，考虑到这个endpoint是用于测试的，这会非常快。是否有一种方法可以重写SwaggerConfig或添加一个参数，使text/plain成为唯一的选项，或者至少将text/plain设置为仅此endpoint的默认选项？

Answer 1

您只需在requestMapping注释中定义响应内容类型。

也就是，

 @RequestMapping(value = "/text", method = RequestMethod.POST)

将被，

 @RequestMapping(value = "/text", method = RequestMethod.POST, produces="text/plain")

@PostMapping(value = "/text", produces="text/plain")