Skip to content

Generate readable html docs from WSDLs. Fork which adds descriptions/comments support among othe little things

Notifications You must be signed in to change notification settings

ivmos/wsdl2html_ivmos

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This project is a fork of https://github.com/chenjianjx/wsdl2html (started after closed PR: chenjianjx#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); 

About

Generate readable html docs from WSDLs. Fork which adds descriptions/comments support among othe little things

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 91.5%
  • FreeMarker 7.9%
  • Other 0.6%