xsd - 生成带有文档的 XML Schema

Question

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

请指教。

Answer 1

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

Answer 2

When javadoc doesn't work: How about an annotation (something like @XmlDocumentation(lang="en" content="..."))?

Answer 3

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

http://www.mojohaus.org/jaxb2-maven-plugin/Documentation/v2.2/index.html

但建议是使用 XmlType 注释，对我来说，只有当我不使用此注释的属性名称时，javadocs 才有效。我认为是默认 javadoc 渲染器的错误。