阐明 - 如何在生成的REST文档中显示媒体类型？

Question

我已经使用声明成功地为我的端点创建了文档。这是从终点的样本：

@Produces("application/json") 
public class Messages { 
    ..... 
    @DocumentationExample("provide an example") 
    @Consumes("application/json") 
    @GET 
    Message createMessage (Message input) { 
    .... store the message, validate, etc. 
    } 
    .... 
} 

的Message在JAX-WS通过Jackson映射，并且具有这样的结构：

@XmlRootType 
public class Message { 
    .. 
} 

尽管这适用于字正腔圆，我无法看到无论是文档中的任何地方都有@Produces和@Consumes。是否有可能以某种方式“标记”域类 - 不是通过@XmlRootElement，而是通过一些外部配置文件？我并不热衷于仅仅为了发音而改变域名（即使注释涉及到）。

我也看不到@DocumentationExample注释（或例如指定的值）。是否可以提供多个示例？

谢谢。

Answer 1

这已经被修复了。最新的Enunciate版本是1.27。