如何使生成的类包含XML Schema文档中的Javadoc

Question

我目前正在使用在大多数类型和元素上具有<xsd:annotation>/
的XML模式<xsd:documentation>。当我从此XML模式生成Java
Bean时，这些Bean的Javadoc仅包含一些有关类型/元素的允许内容的通用生成信息。

我想<xsd:documentation>在相关位置查看标记的内容（例如，complextType的标记的内容应显示在代表该complexType的类的Javadoc中）。

有什么办法可以做到这一点？

编辑 ：此XML Schema将在具有JAX-WS的WSDL中使用，因此此标记也可能适用。

编辑2 ：我读过有关<jxb:javadoc>。据我了解，我可以在一个单独的JAXB绑定文件中或直接在XML
Schema中指定它。那几乎可以解决我的问题。但是我宁愿使用现有的<xsd:documentation>标签，因为Javadoc不是文档的主要目标（它主要是关于数据结构的信息，而不是有关从中生成的Java
Bean的信息），并且允许非JAXB工具以如下方式访问信息：好。同时提供文档<jxb:javadoc>和xsd:documentation>“感觉”都是错误的，因为我没有充分的理由来复制数据（和工作）。

编辑3
：感谢Pascal的回答，我意识到我已经有了一半解决方案：<xsd:documentation>的complexTypes写入其Javadoc的开头！问题仍然是
只有 该complexTypeS用于和simpleTypeS（这也可导致在一个类）和元素仍然Javadoc的更小。

Answer 1

xsd:documentation除非 且仅当 它是复杂类型时，我才能永远不能将其放置在java源代码中。元素，简单类型等的文档将被忽略。

因此，我最终使用jxb:javadoc。为此，请xmlns:jxb="http://java.sun.com/xml/ns/jaxb"在您的<xsd:schema>元素中包含的定义。

向<xsd:complexType>或<xsd: element>或添加孩子<xsd:attribute>：

<xsd:annotation><xsd:appinfo><jxb:XXX><jxb:javadoc>
  This is my comment for a class/property
</jxb:javadoc></jxb:XXX></xsd:appinfo></xsd:annotation>

其中XXX是“类”或“属性”。

对于包裹，您可以写一个孩子 xsd:schema

<xsd:annotation><xsd:appinfo><jxb:schemaBindings><jxb:package name="com.acme"><jxb:javadoc>
  This is my comment for a package
</jxb:javadoc></jxb:package></jxb:schemaBindings></xsd:appinfo></xsd:annotation>

编写HTML文档时需要使用方括号括起来 <![CDATA[ --- ]]>

（编辑：在写我的答案时，问题已由OP进行了编辑，因此我正在相应地对其进行更新）

就我而言，javadoc是唯一的目标，因此可以接受使用jxb:javadoc。但是您的更新非常合理，实际上，我完全同意您的看法。可悲的是，我从未找到适合您所描述情况的理想解决方案（因此，我将非常仔细地关注这个问题）。也许您可以使用xframe之类的东西来从中生成文档xsd:documentation，但这不能解决问题。