RESTful API - 序列化与“解析”

Question

我目前正在使用 Jersey 为一个旧的、相当复杂的系统开发一个 Java 中的 RESTful API。我们希望支持两种形式的输入 - JSON 和 XML。

此时，我正在考虑两种实现 API 的方法 - 第一种是创建一系列带注释的 POJO，传入的请求可以映射到这些 POJO。

第二种是将任何 XML 请求转换为 JSON 并手动解析 JSON。

就我个人而言，目前第二种方式对我来说似乎更灵活，特别是因为系统中的一些对象非常复杂。

基本上我想知道我应该考虑的第一个选项是否有任何好处（或第二个选项的缺点）？

编辑：为了详细说明一下，就我而言，有大量的类在这个阶段无法注释（这个应用程序已经积极开发了十多年）。如果我要走 POJO 路线，我将不得不创建一大堆新的“序列化”对象，其目的基本上只是在 XML/JSON 之间进行序列化。

这些类需要进行管理，以便与实际模型类（其中可能有多个代表同一对象）保持同步，这就是为什么我考虑使用“手动”方法。

如果这是一个新项目，我肯定会考虑使用注释，但鉴于目前的情况，我不确定这是否是最佳选择。

Answer 1

第一种方法的优点和第二种方法的缺点都是，使用第一种方法只需要做很少的工作。带有 JAXB 注释的 POJO 绝对是使用 Jersey 的最佳选择，除非您无法让它工作——就像您无法让它代表您想要的 XML/JSON。不过，一般来说，您几乎免费获得 XML 和 JSON 输入和输出。

Answer 2

注意：我是 EclipseLink JAXB (MOXy) JAXB 2 的领导者和成员(JSR-222)专家组。

我目前正在 Java 中使用 Jersey 开发 RESTful API
旧的、相当复杂的系统。我们希望支持两种形式
输入 - JSON 和 XML。

JAX-RS 实现可以轻松实现同时接收 XML 和 JSON 消息的服务：

@PUT
@Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
public void put(Customer) {
    ...
}

默认情况下，Jersey 使用带有 Jettison 的 JAXB 实现来将对象与 JSON 相互转换：

• http://blog.bdoughan.com/2011/04/jaxb-and-json-via-jettison.html
• http://blog.bdoughan.com/2011/04/jaxb-and-json-via-jettison-namespace.html

MOXy 使用 JAXB 运行时和注释支持本机 XML 和 JSON 绑定。这意味着您可以使用相同的元数据将对象映射到 XML 和 JSON：

• http://blog.bdoughan.com/2011/08/binding-to-json-xml-geocode-example.html

详细说明一下，就我而言，有大量的类
现阶段无法进行注释（此应用程序已积极
开发了十多年）。

如果您的类无法修改以添加注释，那么您可以使用 MOXy 的 XML 元数据文档。下面是如何通过 JAX-RS ContextResolver 在 Jersey 中利用此元数据的示例：

• http://blog.bdoughan.com/2011/04/moxys-xml-metadata-in-jax-rs-service.html