使用 JAXB 进行灵活编组

Question

我希望有一种灵活的方式来编组对象。单个对象的详细版本和多个对象版本的不太详细版本。

例如，考虑我的部门模型：

GET /locations/1:

  <location id='1'>
    <link rel="self" href="http://example.com/locations/1"/>
    <link rel="parent" href="http://example.com/serviceareas/1"/>
    <name>location 01</name>
    <departments>
      <department id='1'>
        <link rel="self" href="http://example.com/departments/1"/>
        <name>department 01</name>
      </department>
      <department id='2'>
        <link rel="self" href="http://example.com/departments/2"/>
        <name>department 02</name>
      </department>
      <department id='3'>
        <link rel="self" href="http://example.com/departments/3"/>
        <name>department 03</name>
      </department>
    </departments>
  </location>

GET /department/1:

<department id='1'>
  <link rel="self" href="http://example.com/departments/1"/>
  <link rel="parent" href="http://example.com/locations/1"/>
  <name>department 01</name>
  <abbr>dept 01</abbr>
  ....
  <specialty>critical care</specialty>
</department>

有没有办法做到这一点？我需要有单独的实体对象吗？一个引用表进行 CRUD 操作，另一个引用列表？

Answer 1

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

您的问题被标记为 EclipseLink，如果您使用 EclipseLink JAXB (MOXy)，您可以利用外部绑定文档将第二个映射应用到 Department< /代码> 类。

---

ContextResolver

在 JAX-RS 环境中，您可以通过 ContextResolver 利用 MOXy 的外部绑定文档：

import java.io.*;
import java.util.*;     
import javax.ws.rs.Produces;
import javax.ws.rs.ext.*;
import javax.xml.bind.*;
import org.eclipse.persistence.jaxb.JAXBContextFactory;

@Provider
@Produces({"application/xml", "application/json"})
public class DepartmentContextResolver implements ContextResolver<JAXBContext> {

    private JAXBContext jc;

    public DepartmentContextResolver() {
        try {
            Map<String, Object> props = new HashMap<String, Object>(1);
            props.put(JAXBContextFactory.ECLIPSELINK_OXM_XML_KEY, "example/bindings.xml");
            jc = JAXBContext.newInstance(new Class[] {Department.class} , props);
        } catch(JAXBException e) {
            throw new RuntimeException(e);
        } 
    }

    public JAXBContext getContext(Class<?> clazz) {
        if(Department.class == clazz) {
            return jc;
        }
        return null;
    }


} 

了解更多信息

• http://blog.bdoughan.com/2011/04/moxys-xml-metadata-in-jax-rs-service.html
• http://blog.bdoughan.com/2010/08/creating-restful-web-service-part-35.html

---

外部绑定文档

默认 MOXy 的外部绑定文档用于增强带注释的模型，但如果您设置 xml-mapping-metadata-complete 标志，它将完全覆盖注释，从而允许您应用完全不同的映射：

<xml-bindings
    xmlns="http://www.eclipse.org/eclipselink/xsds/persistence/oxm"
    package-name="example"
    xml-mapping-metadata-complete="true">
    ...
</xml-bindings>

了解更多信息

• http://blog.bdoughan.com/2011/09/mapping-objects-to-multiple-xml-schemas.html
• http://blog.bdoughan.com/2010/12/extending- jaxb-representing-annotations.html

更新

此更新是为了解决您在评论中提出的一些问题：

1.每个 ContentResolver 应该/可以有自己的绑定文件吗？

是的，每个 ContextResolver 都应该有自己的绑定文件。引入新的 ContextResolver 的主要原因是表示辅助映射。

2.我可以为每个 ContentResolver 提供多个（这将为我提供同一类的多个渲染，创建某种“视图”），也许在构造函数中指定其位置？

对于单个 ContextResolver，您可以跨多个绑定文件表达元数据，但它们将被组合成一组映射。这意味着单个 ContentResolver 不能拥有单个类的多个视图。单独的 ContextResolver 用于表示辅助映射。

3.绑定文件应该驻留在哪里？

我建议从类路径加载元数据文件。

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

4.我可以看到如何在资源的 GET 方法中轻松指定 ContentResolver，但是如果该对象嵌入到另一个 (JPA) 对象中，该怎么做？在嵌入对象的 getter/setter 中？

您的 JAX-RS 实现应该选择您的 ContextResolver，因为它是用 @Provider 注释的。用于类的 ContextResolver 取决于您如何实现 getContext 方法：

public JAXBContext getContext(Class<?> clazz) {
    if(Customer.class == clazz) {
        return jc;
    }
    return null;
}

Answer 2

这是另一个想法。可能是一个坏主意，但有点简单。

class Department {

    @XmlElement(required = true)
    public Link getSelf() {
        return self;
    }

    @XmlElement(required = false) // default
    public Link getParent() {
        if (verbose) {
            return parent;
        }
        return null;
    }

    @XmlElement(required = false) // default
    public String getSpecialty() {
        if (verbose) {
            return specialty;
        }
        return null;
    }

    @XmlTransient
    private boolean verbose;
}