从 XJC 输出中省略 @XmlSeeAlso

Question

目前我正忙于一个使用 XML 消息传递的项目。我有一个通用模式，其中包含抽象类型和一些可重用的类型定义和元素。对于我正在处理的每种消息，都有一个单独的模式（具有不同的目标命名空间）来导入通用模式。换句话说，它是一个两级层次结构。很简单。

这些模式中的每一个都用于生成 Java 类。每个模式对应一个包。代码生成由 Maven JAXB 2.1 插件处理。当我使用代码时，我为每种消息类型创建一个单独的 JAXBContext。 JAXBContext 是使用通用模式的包名称和特定消息类型的包名称创建的，因此上下文应该只看到它必须处理的那些类。

令我惊讶的是，我注意到当我将 XML 文档解组到 beans，然后将它们编组回 XML 时，每个消息类型（= 模式目标名称空间）都有名称空间声明。想知道 JAXB 如何在上下文范围内获取该信息，我发现一些 @XmlSeeAlso 注释被放置在一些抽象类定义上。这会导致 JAXB 寻找有关目标包之外的类的信息。

有什么方法可以避免生成 @XmlSeeAlso 注释吗？环顾四周，我发现这是 JAXB 2.1 的新功能。我可以切换到 2.0 的 XJC 插件，但我不确定这是否会产生不需要的副作用。另外，我希望将来继续关注新的 JAXB 版本。不需要的命名空间声明不是问题（XML 仍然有效），但一旦添加更多消息类型就会造成混乱。另外，这清楚地表明我的 JAXB 上下文加载的类比我想象的要多，并且基本上是彼此重复的。我可以使用一个包含所有内容的上下文，但我已经围绕这种分离构建了自己的 API。

感谢您的阅读和提供的任何答案。

Answer 1

使用父模式和子模式的单独编译。

如果单独编译父架构（不在上下文中包含子架构），则 @XmlSeeAlso 注释和 {@link ChildType} 将仅引用该架构中的 JAXB 类和它的父母。这实现了父/子模式的清晰分离。

使用maven-jaxb2-plugin，这可以通过限制包含的模式来实现。假设您在文件夹 src/xsd 中有架构 A.xsd 和 B.xsd，其中 B.xsd 导入A.xsd 具有不同的命名空间。要仅生成父级 (​​A.xsd)，请使用以下配置：

<plugin>
  <groupId>org.jvnet.jaxb2.maven2</groupId>
  <artifactId>maven-jaxb2-plugin</artifactId>
  <version>0.8.2</version>
  <executions>
    <execution>
      <goals>
        <goal>generate</goal>
      </goals>
      <configuration>
        <schemaDirectory>${project.basedir}/src/xsd</schemaDirectory>
        <schemaIncludes>
          <include>A.xsd</include>
        </schemaIncludes>
        <episode>true</episode>
      </configuration>
    </execution>
  </executions>
</plugin>

这将为 A.xsd 生成 JAXB 类，而不引用子架构中的元素 B.xsd。

因为true，它还会生成一个META-INF/sun-jaxb.episode文件，您可以在< a href="http://weblogs.java.net/blog/kohsuke/archive/2006/09/separate_compil.html" rel="nofollow">生成子模式。

或者，当您生成子模式时（同样，对每个模式使用单独的编译），如果您不想采用这种方式，则可以删除父包。您可以使用 maven-clean-plugin 或 maven-antrun-plugin 删除子代的额外父包。我在episodes方面遇到了一些麻烦 - 为孩子们生成了一个额外的 ObjectFactory 类 - 所以我使用这种方式来实现我想要的结构。

另一件需要注意的事情是 JAXBElement 引用。如果您进行单独的编译，XJC 将不知道可能的替换组（如果我没有记错的话......），并且可能只生成 ParentType 引用。因此，如果您需要 JAXBElement 引用，请将 属性添加到该引用的架构或绑定中。

Answer 2

我有同样的问题，我认为没有一个简单的答案。我找到了 com.sun.tools.xjc.generator.bean.BeanGenerator 类的源代码，该类似乎负责生成 java 源代码（jaxb-xjc-2.1.4.jar）。从第 496 行开始的代码如下所示：

     if(model.options.target.isLaterThan(SpecVersion.V2_1)) {
        // @XmlSeeAlso
        Iterator<CClassInfo> subclasses = cc.target.listSubclasses();
        if(subclasses.hasNext()) {
            XmlSeeAlsoWriter saw = cc.implClass.annotate2(XmlSeeAlsoWriter.class);
            while (subclasses.hasNext()) {
                CClassInfo s = subclasses.next();
                saw.value(getClazz(s).implRef);
            }
        }
    }

XMLSeeAlso 注释似乎是硬编码的，并且不是可选的或可配置的（至少对于 JAXB 2.1.4 而言）。