Looks like exactly what I'm looking for... Will try and give feedback.
Thanks ! 2014-02-06 Winnebeck, Jason <[email protected]>: > I use http://enunciate.codehaus.org/ for this task with CXF. Enunciate > takes your Javadocs from classes and properties and builds a website as > well as a fully documented WSDL (SOAP), WADL (REST), and/or XSD as > appropriate. It also understands JAXB and Jackson annotations. > > Enunciate looks a little confusing because in its normal usage it actually > provides the servlet container and implementation for you, so you don't > need any web.xml or anything at all. But since I already had a CXF app, you > can have it just generate the (HTML) documentation and WSDL/XSD with full > documentation from the javadoc, which CXF/JAXB doesn't do. So in my usage I > have: > > API project containing just service interfaces and POJOs (with JAXB/XML > and Jackson/JSON annotations). > Enunciate generates HTML docs in a zip, WSDL, WADL, and XSD. These are > output artifacts from API project. > Server implementation project which makes war using CXF and depends on API > jar, WSDL, and WADL. WSDL/WADL provided to CXF as if I was doing > contract-first development. In this case CXF serves WSDL/WADL and replaces > the endpoint URLs to the proper ones discovered at runtime. > Docs are served by Apache in front of servlet container (but of course > servlet container could also serve static HTML just as easily). > > I won't lie, it was pretty hard for me to get set up, but once I did, I am > loving it because docs come from Javadoc so there is only one place for > documentation in the source and it ends up in 5 places: Javadocs, WSDL, > WADL, XSD, and HTML website. > > Jason > > -----Original Message----- > From: Pascal Leclercq [mailto:[email protected]] > Sent: Thursday, February 06, 2014 8:47 AM > To: [email protected] > Subject: Best way to publish WDSL / SOAP user friendly documentation. > > Hi, > > we do have quite a lot of Webservices and we would like to publish user > friendly infos on each of them. > > > So far, we use ServletController.generateServiceList() but It doesn't > display http://www.w3.org/TR/wsdl#_documentation in the WSDLs. > > > We could customize org.apache.cxf.transport.servlet.ServletController to > display more content (as suggested in an earlier thread) but before doing > so I would like to know if there is a better solution. > > As alternative could be http://code.google.com/p/wsdl-viewer/ but the > project looks like pretty much dead... > > > Any suggestion would be pretty much appreciated. > > Thanks > > -- > Pascal Leclercq > > ---------------------------------------------------------------------- > This email message and any attachments are for the sole use of the > intended recipient(s). Any unauthorized review, use, disclosure or > distribution is prohibited. If you are not the intended recipient, please > contact the sender by reply email and destroy all copies of the original > message and any attachments. > -- Pascal Leclercq
