除了 @Produces 注释之外，Jersey (JAX-RS) 如何知道将 POJO 视为特定的 mime 类型？

Question

我看到很多 Jersey 的例子，看起来像这样：

public class ItemResource {

    @GET
    @Path("/items")
    @Produces({"text/xml", "application/json"})
    public List<Item> getItems() {
        List<Item> items = new ArrayList<Item>();

        Item item = new Item();
        item.setItemName("My Item Name!");
        items.add(item);

        return items;
    }
}

但是我在剖析 Item 时遇到了麻烦，以及 Jersey 如何知道如何将 Item 转换为 XML 或 JSON。我见过一些非常基本的示例，它们仅返回构造的 HTML 或 XML 的字符串，这对我来说更有意义，但我错过了下一步。我查看了这些示例，其中一个很突出（json-from-jaxb 示例），因为该对象标有这些类型的注释：

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "", propOrder = {
    "flight"
})
@XmlRootElement(name = "flights")

我正在寻找逐步涵盖此“翻译”的教程，或此处解释如何将 POJO 转换为特定 mime 类型的输出。谢谢！

Answer 1

这里有两件事在起作用。首先，@Produces 注释中的媒体类型用于内容协商。将客户端发送的 Accept 标头值中的媒体类型与 @Produces 注释中的媒体类型进行比较，并选择最合适的一种。假设您的示例中是 text/xml。

当构造响应主体时，Jersey 内部尝试找到一个可以将 Item 对象转换为 text/xml 的 MessageBodyWriter。通常程序员会提供这些“映射器”类，但对于 XML 和 JSON，为了方便起见，Jersey 已经内置了 MessageBodyReaders。

这就是为什么看起来好像发生了某种魔法。

扬