Как документировать приложение JAX-WS на основе метро

Question

Я разработал некоторые веб-службы JAX-WS, используя реализацию Metro.

Теперь то, что я хочу добавить к этим веб-сервисам, - это документация. Metro, сам, генерирует вам «простой» doc html-файл, который включает в себя расположение WSDL и нечто большее.

Итак, я занимаюсь некоторыми исследованиями, и я нашел Enunciate, что поможет вам создать документацию и клиентские приложения ваших веб-сервисов на нескольких языках программирования (что полезно для повторного использования). Но пока меня интересует только генерация документации. Я вижу, что поддерживает Apache CXF, JAX-WS, JAX-RS, но не поддерживает Metro, или мне не удалось найти плагин.

Итак, смогу ли я создавать документацию для своих веб-сервисов?

Есть ли другой инструмент для создания документации по приложению JAX-WS (на основе метро)?

Спасибо заранее

Answer 1

излагают, что вы нашли это действительно мощный, выходит за рамки не только документирование службы. Однако, если вы просто ищете документацию, есть простой инструмент, который наша команда использует в течение довольно долгого времени - WSDL viewer Томи Ванека.

Он очень прост в использовании, просто с подключением уже предоставили файл .xsl в дополнение к существующему .wsdl файла, повысить .wsdl файл с линией

<?xml-stylesheet type="text/xsl" href="wsdl-viewer.xsl"?> 

, а затем открыть файл .wsdl в браузере. Вы увидите что-то вроде этого: (только подготовили демо :))

Некоторые замечания:

• добавления документации .wsdl файл выполняется с <wsdl:documentation> тегов
• вы будете способный открывать такой файл .wsdl во всех современных браузерах, кроме Chrome, из-за того, что Chrome blocks XSL transform on a local file

HTH.