Где вы должны поместить документацию XSD для того, чтобы JAXB мог подобрать их и поместить в Javadoc?

Question

Я разрабатываю контракт для первого веб-сервиса и хочу включить в схему соответствующую документацию, чтобы она была как можно более информативной.

Как лучше размещать аннотации и документацию XSD таким образом, чтобы JAXB собирал их и включал в сгенерированные файлы Java как Javadoc? Я заметил, что некоторые элементы и перечисление получают документацию, но некоторые нет. Есть ли какое-то определенное место, где я должен разместить их после каждого элемента, определения сложного типа или операции WSDL, чтобы он описывал каждый класс, элемент или метод?

Answer 1

Возможно, не совсем то, что вы просите, но один из способов добавить Java Docs в сгенерированные источники JAXB - это использовать элемент <javadoc> в файле привязок JAXB.

Полный ответ можно найти здесь:

Как сделать сгенерированные классы содержащими Javadoc из документации XML-схемы