web services - How to document a metro based JAX-WS application -
i've developed jax-ws web services using metro implementation.
now want add these web services somehow documentation. metro, itself, generates "simple" doc html file, includes location of wsdl , more.
so i've been doing research , i've found enunciate, helps generate documentation , web services' client(s) in several programming languages (which reeaaally helpful). i'm interested in generation of documentation, time being. can see supports apache cxf, jax-ws, jax-rs doesn't support metro, or haven't been able find plugin.
so, able generate documentation web services?
is there other tool generate documentation of jax-ws application (metro based)?
thank in advance
enunciate have found indeed powerful, goes beyond documenting service. however, if searching documentation, there neat tool our team using quite time - tomi vanek's wsdl viewer.
it simple use, attach provided .xsl file in addition existing .wsdl file, enhance .wsdl file line
<?xml-stylesheet type="text/xsl" href="wsdl-viewer.xsl"?>
and open .wsdl file in browser. see this: (just prepared demo :))
some remarks:
- adding documentation .wsdl file performed
<wsdl:documentation>
tags - you able open such .wsdl file in modern browsers except chrome, due fact chrome blocks xsl transform on local file
hth.
Comments
Post a Comment