JAXB 绑定文件：XmlAdapters 和包名称

Question

我有一个像这样的绑定文件

<jxb:bindings version="2.0" xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <jxb:bindings schemaLocation="example.xsd" node="/xs:schema">
    <jxb:schemaBindings>
        <jxb:package name="example" />
    </jxb:schemaBindings>
    <jxb:globalBindings>
        <jxb:javaType name="java.util.Calendar" xmlType="xs:dateTime"
            parseMethod="javax.xml.bind.DatatypeConverter.parseDateTime"
            printMethod="javax.xml.bind.DatatypeConverter.printDateTime" />
        <jxb:javaType name="java.util.Calendar" xmlType="xs:date"
            parseMethod="javax.xml.bind.DatatypeConverter.parseDate"
            printMethod="javax.xml.bind.DatatypeConverter.printDate" />
        <jxb:javaType name="java.util.Calendar" xmlType="xs:time"
            parseMethod="javax.xml.bind.DatatypeConverter.parseTime"
            printMethod="javax.xml.bind.DatatypeConverter.printTime" />
    </jxb:globalBindings>

  </jxb:bindings>
</jxb:bindings>

架构类是在“example”中生成的（正确），但 XmlAdapters 在“org.w3._2001.xmlschema”中生成（错误）。我该如何解决这个问题？

Answer 1

对于 Apache CXF 用户，最简洁的方法是使用 wsdl2java 提供的 -p 选项。

-p [wsdl-namespace=]包名称

指定零个或多个用于生成的代码的包名称。
（可选）指定 WSDL 命名空间来封装名称映射。

在我们的例子中

-p http://www.w3.org/2001/XMLSchema=org.acme.foo

如果您使用 cxf-codegen-plugin，则只需添加另一对 ;。

<plugin>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-codegen-plugin</artifactId>
    <version>${cxf.version}</version>
        [...]
    <extraarg>-p</extraarg>
    <extraarg>http://www.w3.org/2001/XMLSchema=org.acme.foo</extraarg>
        [...]
</plugin>

不需要 targetNamespace 指向保留的 XSD 命名空间，也不需要包罗万象的 jaxb 包绑定。

Answer 2

使用 GlobalBinding 的更好方法是指定显式适配器，而不是使用此解析/打印对。例如，不要使用以下内容： 相反

<jaxb:javaType name="java.lang.Long" xmlType="xs:long"
                      parseMethod="com.mypackage.myclass.parseLong"
                  printMethod="com.mypackage.myclass.print"/>

，您应该：

<xjc:javaType name="java.lang.Long" xmlType="xs:long"
                  adapter="com.mypackage.LongAdapter"/>

记住为 xjc 添加命名空间：

xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
          jxb:extensionBindingPrefixes="xjc"

LongAdapter 类将如下所示：

public class LongAdapter
extends XmlAdapter<String, Long>
{


public Long unmarshal(String value) {
    return your_util_class.parseLong(value);
}

public String marshal(Long value) {
    return your_util_class.print(value);
}

}

这样，由于您显式指定了适配器类，因此 jaxb 将不会使用默认包生成默认适配器名称 org.w3._2001.xmlschema。

避免使用默认包名称 org.w3._2001.xmlschema 非常重要。举一个例子，如果您有一个项目 A 和一个项目 B，并且它们都有一些架构和绑定。在旧的方式中，它们都生成具有完全相同的完整限定名称的适配器，例如org.w3._2001.xmlschema.Adapter1。然而，这个适配器可能适用于项目 A 中的 Long 和项目 B 中的 Integer。然后，假设您有一个同时使用 A 和 B 的下游项目 C。现在问题变得很严重。如果 C 需要使用 Adapter1，您无法预测所使用的适配器是来自 A（Long）还是 B（Integer）。然后，您的应用程序 C 在某些时候可能工作正常，但在其他情况下可能会以奇怪的方式失败。如果发生这种情况，类型异常将类似于：

org.w3._2001.xmlschema.Adapter1 is not applicable to the field type java.lang.Double...

即使理论是正确的，当我在我的环境中使用 maven-jaxb2-plugin 尝试时，Roy Truelove 提到的解决方案似乎不起作用。

Answer 3

此处创建 org.w3._2001.xmlschema 包是因为 XJC 必须生成一个扩展 javax.xml.bind.annotation.adapters.XmlAdapter 的类，而该类又扩展了调用您的解析/打印静态方法。由于某种原因，它将它们放入这个包中，而不是放在更有用的地方。

您还没有说明您使用哪个 JAXB 实现，但 JAXB RI 对 javaType 绑定自定义进行了扩展，它允许您直接指定 XmlAdapter 的子类，而不是直接指定 XmlAdapter 的子类。 parseMethod/printMethod 对。这样就无需生成合成的 XmlAdapter 桥接类。有关如何执行此操作的信息，请参阅 RI 文档。

我想 EclipseLink/Moxy 有类似的东西，但我不确定 Java6 附带的 XJC 是否有能力（Sun 在将其引入 JRE 时似乎已经从 RI 中删除了一半有用的东西） 。

Answer 4

我也遇到了这个问题，使用 this< 解决了它/a>.

基本前提是您在 XJC 编译中包含一个包含以下内容的架构：

<schema xmlns="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://www.w3.org/2001/XMLSchema"
  xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
  jaxb:version="2.0">
  <annotation><appinfo>
    <jaxb:schemaBindings>
      <jaxb:package name="org.acme.foo"/>
    </jaxb:schemaBindings>
  </appinfo></annotation>
</schema>

然后将包名称调整为您想要放置生成的适配器的位置。 XJC 将相信此模式是 W3C XML 模式本身的模式集的一部分，并将尊重其中的绑定。

Answer 5

使用常见数据类型的内置转换器。

<jxb:javaType name="java.lang.Integer" xmlType="xs:integer"              
parseMethod="javax.xml.bind.DatatypeConverter.parseInt"                  
printMethod="javax.xml.bind.DatatypeConverter.printInt" />