Создать XML-схему с документацией

Question

Есть ли способ создать XML-схему (xsd) с документацией (<xsd:annotation> / <xsd:documentation>) из комментариев javadoc в классах?Я знаю, что возможно обратное (т.е. генерация классов с комментариями javadoc от xsd с комментариями).

Пожалуйста, совет.

Answer 1

При использовании API JAXBContext.generateSchema (SchemaOutputResolver) невозможно включить комментарии Javadoc в Javadocразделы.Причина этого в том, что нет никакого 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 по умолчанию.