xsd - ドキュメントを使用してXMLスキーマを生成する

Question

<xsd:annotation> / <xsd:documentation>クラスのjavadocコメントからdocumentation（）を使用してXML Schema（xsd）を生成する方法はありますか？私はその逆が可能であることを知っています（つまり、コメント付きのxsdからのjavadocコメント付きの生成クラス）。

ご意見をお聞かせください。

Answer 1

JAXBContext.generateSchema（SchemaOutputResolver） APIを使用すると、Javadocコメントを<xsd：documentation>セクションに含めることはできません。これは、コメント内の情報を取得するためにJavaクラス/フィールド/プロパティをイントロスペクトするために使用できるAPIがないためです。

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レンダラーのバグだと思います。