Как сгенерировать документацию для xsd схемы, на основе java-doc?

Question

[Виктор Потапов]

Для генерации xsd схемы для соапа, используется jax-b. т.к. каждый раз схема генерируется с нуля возник вопрос. возможно ли настроить генерацию документации xsd на основе имеющейся в классе java - документации?

Answer 1

[Владимир Смирнов]

Это можно сделать, но классический JavaDoc не пройдёт. Вот здесь описан подход, который я с успехом применил в своих проектах. Надо только добавить нужные аннотации, и разобраться с нестандартными версиями библиотек. После этого, WSDL генерирую так:

org.apache.cxf.tools.java2ws.JavaToWS.main(new String[]{"-d", "d:\\temp\\gen\\", "-verbose",
//                "-createxsdimports",//раскоментировать если нужно выделить xsd-шки в отдельные файлы
                "-wsdl", "webservice.SomeService"});

webservice.SomeService имеет аннотации @WebService и @WSDLDocumentation, а классы запросов и ответов помечены аннотацией @Documentation

Comments

[Виктор Потапов]

спасибо! похоже это то что нужно