使用文档生成XML Schema

Question

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

请建议。

Answer 1

使用JAXBContext.generateSchema(SchemaOutputResolver) API，Javadoc评论无法包含在＆lt; xsd：documentation＆gt;中部分。原因是没有任何API可用于内省Java类/字段/属性以获取注释中的信息。

Answer 2

当javadoc不起作用时：注释怎么样（像@XmlDocumentation（lang =“en”content =“...”））？

Answer 3

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

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

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