Хотите добавить документацию XSD в сгенерированный Javadoc pojo JIBX

Question

Любые идеи о том, как включить содержимое xsd: annotation и xsd: документации, определенное в схеме как javadoc в сгенерированном pojo с использованием jibx ???

Пока я только получаю фрагмент схемы поверх класса, но не могу увидеть документацию по аннотации для схемы.

спасибо за ваше время.

Answer 1

JiBX делает автоматически включает xsd: содержимое документации в сгенерированный исходный код, который в конечном итоге окажется в вашем javadocs.
Для хорошего примера взгляните на схему opentravel.org, которая включена в библиотеку схем JiBX.
Вот определение схемы opentravel для сообщения «ping»: http://opentravel.org/2011B/OTA_PingRQ.xsd.
Теперь загрузите и разархивируйте javadoc.jar для сгенерированного кода из maven central: http://search.maven.org/#search%7Cga%7C1%7Cfc%3Aorg.jibx.schema.org.opentravel._2011B.ping.PingRQ
Обратите внимание, как документация xsd: красиво отображается в javadoc.
Надеюсь, этот пример поможет!
Дон Корли
JiBX участник

Answer 2

Вы, похоже, испытываете неожиданное поведение, если только отсутствие подробностей в вашем вопросе не отбросило этот ответ ... Если вы все еще в затруднительном положении после попытки устранения неполадок, как описано ниже, лучше всего было бы обновить ваш запрос с дополнительной информацией, такой как фрагмент XSD, показывающий настройку, версии, которые вы используете (Java, JiBX), и командную строку, которую вы используете для своей утилиты codegen.

Начните с просмотра настроек документации; убедитесь, что опция import-docs , которая отвечает за "Преобразовать аннотации xs: документации в определении схемы в Javadocs в сгенерированном [...]" , не установлено в ложь. Значение по умолчанию - true, поэтому оно должно работать ...

Проверьте, что с точки зрения командной строки вы не переопределяете это. В качестве альтернативы, вы можете убедиться, что установлено явно (см. this ).