使用文档生成XML架构

Question

有没有办法从类中的javadoc注释生成带有文档(<xsd:annotation> / <xsd:documentation>)的XML Schema(xsd)？我知道相反的情况也是可能的(例如，从带有注释的xsd生成带有javadoc注释的类)。

敬请指教。

Answer 1

使用Javadoc，不可能在部分中包含JAXBContext.generateSchema(SchemaOutputResolver)注释。这是因为没有任何API可用于内省Java类/字段/属性来获取注释中的信息。

Answer 2

当content=不起作用时:使用注解(比如@XmlDocumentation(lang="en“javadoc”...“))怎么样？

Answer 3

是的，现在可以通过jaxb2-maven-plugin实现

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

但是建议使用XmlType注解，对我来说，只有当我不使用这个注解的属性名称时，javadoc才能工作。我认为这是默认的javadoc渲染器的错误。