Generate readable html docs from WSDLs. Fork which adds descriptions/comments support among othe little things
Java FreeMarker Other
Clone or download
Pull request Compare This branch is 10 commits ahead, 6 commits behind chenjianjx:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
src
.gitignore
README.md
pom.xml
test-cases.md

README.md

This project is a fork of https://github.com/chenjianjx/wsdl2html (started after closed PR: https://github.com/chenjianjx/wsdl2html/pull/9)

This fork might be useful for you if you use JAX-WS as it autoincludes descriptions in generated html based on your javadoc classes. If you include the comments directly in the WSDL this approach is not useful for you.

Besides it has some minor changes:

  • Methods are ordered alphabetically so that order does not change each time you use wsdl2html.
  • Template style changes using width better.
  • Removed "require" field as it's not autogenerated. I don't want to change the html manually at all, everything needs to be in the code.

wsdl2html

Converts WSDLs to html documents which are readable by everybody.

Online version: http://www.wsdl2html.com

Example:

v3-sample

Check the full html here.

How to run

Run online

Run online if your WSDL has been hosted on a public site. Do it here: http://www.wsdl2html.com.

Run as a command line tool

mvn package 
cd target 
unzip target/wsdl2html-some-version-jarset.zip -d /path/to/your/dir

# Go to the direction of extraction and you will see an executable file. Run it like, 

./wsdl2html.sh http://.../some?wsdl /path/to/your/html/directory  # or wsdl2html.bat for windows

Run it inside your application

In your pom.xml, add the following:

	<repositories>
		<repository>
			<id>jitpack.io</id>
			<url>https://jitpack.io</url>
		</repository>
		...
	</repositories>


	<dependencies>
		<dependency>
			<groupId>com.github.chenjianjx</groupId>
			<artifactId>wsdl2html</artifactId>
			<version>3.0.2</version>
		</dependency>
		...
	</dependencies>	
//if you call this method in your code, make sure the jdk version you used to run your code is 
// no lower than that of the jdk used by your "wsimport" to run in shell

String html = org.jaxws.wsdl2html.service.Wsdl2Html.generateHtml(wsdlUrl);