I have a Java web service and want to document the public API so the documentation is able to be browsed from the web from the same URL as the web service. How is this usually done?
A:
There is no standard way of doing so. The WSDL is not humanly readable, and the page listing - if any - the possible WSDL's is automatically generated.
You will need to investigate how the web service layer you have chosen, do it, and see if there is any way to "hook into" that mechanism.
Thorbjørn Ravn Andersen
2010-08-02 15:24:09
I was kind of hoping for something like the .Net feature where you could annotate your web service class and it would automatically create a webpage for the webservice at the root with the annotations.I am just going to generate a javadoc and post that.
Kenoyer130
2010-08-02 19:23:16
+1
A:
There is wsdldocumentation tag:
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Your Documentation</wsdl:documentation>
YoK
2010-08-02 15:47:02