How to generate documentation for xsd schema based on java-doc?

Question

Java

To generate xsd schema for soap, jax-b is used. because every time the circuit is generated from scratch the question arose. Is it possible to customize the xsd documentation generation based on the java documentation available in the class?

Answer 1

This can be done, but the classic JavaDoc will not work. Here is the approach that I have successfully applied in my projects. You just need to add the necessary annotations, and deal with non-standard versions of libraries. After that, I generate WSDL like this:

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

webservice.SomeService has @WebService and @WSDLDocumentation annotations and request and response classes are annotated with @Documentation annotation