生成带有文档的 XML Schema

【问题标题】：Generate XML Schema with documentation生成带有文档的 XML Schema
【发布时间】：2011-03-09 11:12:58
【问题描述】：

有没有办法从类中的 javadoc cmets 生成带有文档 (<xsd:annotation> / <xsd:documentation>) 的 XML Schema(xsd)？我知道相反的情况是可能的（即从 xsd 和 cmets 生成带有 javadoc cmets 的类）。

请指教。

【问题讨论】：

【解决方案1】：

使用JAXBContext.generateSchema(SchemaOutputResolver) API 不可能将Javadoc cmets 包含在部分中。原因是没有任何 API 可用于自省 Java 类/字段/属性以获取 cmets 中的信息。

【讨论】：

【解决方案2】：

当 javadoc 不起作用时：注释如何（类似于 @XmlDocumentation(lang="en" content="...")）？

【讨论】：

【解决方案3】：

是的，现在可以使用 jaxb2-maven-plugin

但建议使用 XmlType 注释，对我而言，javadocs 仅在我不使用此注释的属性名称时才起作用。我认为是默认 javadoc 渲染器的错误。

【讨论】：