阐述文档与Iterable和generics的问题

Question

我正在尝试使用expertion为我的基于Jersey的REST API重新生成文档。碰到一些绊脚石:

@GET
@Produces(MediaType.APPLICATION_JSON)
public Iterable<Project> listAll() {
    ...
}

发音似乎不能插入可重复项。在我的文档中，我只得到“元素:(自定义)”。请注意，项目类型是用@XmlRootElement和@JsonRootType注释的。

同样，对于此代码：

@POST
@Consumes(MediaType.APPLICATION_JSON)
public Response save(final T persistable) {
    ...
}

我为方法参数（注意：T有一个扩展限制）和返回类型（其中响应是：javax.ws.rs.core.响应）获得了“元素：（自定义）”。此外，发音似乎无法计算出返回的媒体类型：它列出了XML、JSON和*（仔细想想，我不确定我到底想要什么，但我知道不是那样的。）

有什么想法吗？

Answer 1

Enunciate使用JAX-RS规范来生成文档。不幸的是，＜code＞Iterable＜/code＞接口不是正式支持的JAX-RS对象类型，所以不知何故，您正在使用自定义消息体编写器将＜code＜Iterable＞序列化为JSON（我想是Jackson？）。

因此，如果您想正式说明您的返回类型，您可以创建一个包装bean，该包装bean可以识别并返回它，而不是Iterable，例如：

@XmlRootElement
public class Projects {
  public Collection<Project> projects;
}