Swagger JAX-RS APIParam标头数据类型

Question

我正在尝试为标头字段自动生成自定义数据类型。为此，我按如下方式定义标题：

public String foo(
    @ApiParam(value = Documentation.HEADER_SERVICE, required = true)
    @HeaderParam(Services.HEADER_SERVICE)
    Service service) {
    ...
}

但是，生成的swagger文件会导致Service-Header的方案为“string”。现在我明白了，头字段只能是字符串类型，但是我想在文档中包含服务头的（json）结构。

我怎样才能做到这一点？

我也试过@ApiImplicitParam，但是，该方案只包含已定义的字符串，而不是对模型的引用。