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,但这不能解决问题。



