users@jax-rpc.java.net

Generating JavaDoc comments on WSDL generated sources

From: Vishal Goenka <vgoenka_at_CAMPUSPIPELINE.COM>
Date: Wed, 16 Oct 2002 11:51:23 -0600

Are there any plans to use the "wsdl:documentation" element in WSDL files
to automatically populate the JavaDoc for the generated Source Java files.
This is important for the service definition as well as Java types
as mapped from their corresponding XML counterparts.

Is anyone doing that at all? Axis, .NET, etc. Is there a schema defined for
allowing meaningful WSDL documentation that can be mapped to JavaDoc
elements such as @param, @exception etc.

The "wsdl:documentation" element as per WSDL schema,
http://schemas.xmlsoap.org/wsdl/ allows any custom elements/attributes to be
defined as child elements of the "documentation" node, so it seems there
would be an effort to define standard documentation schema for use in
generating documents across different programming languages.

Any thoughts?

--Vishal