Экспорт комментариев исходного кода в WSDL с использованием CXF и maven? - PullRequest
1 голос
/ 25 ноября 2011

Как видно из заголовка: возможно ли экспортировать мои комментарии javadoc для параметров метода веб-службы в wsdl?Мы используем CXF и цель java2ws с maven для генерации wsdl из исходного кода.

1 Ответ

2 голосов
/ 16 декабря 2011

Вы можете использовать аннотацию @WSDLDocumentationCollection, чтобы прикрепить несколько аннотаций @WSDLDocumentation к одному методу (с различными местами размещения), но вы не можете использовать это, чтобы пойти намного глубже, чем размещение документации по отдельным операциям порта, потому что этогде это перестает быть проблемой WSDL и становится проблемой XSD.Документация XSD будет обрабатываться аннотацией на уровне JAXB, за исключением того, что такой аннотации не существует;сгенерированная схема не будет содержать <xs:documentation> элементов.(Когда начинается с из схемы, комментарии документации могут быть сгенерированы как Javadoc, но обратное направление не происходит, поскольку комментарии Javadoc не сохраняются в файлах классов Java.)

...