View source for Swordfish Documentation: Generating Dynamic WSDL

==Generating Dynamic WSDL==
This section contains instructions on implementing the dynamic WSDL generation feature.<br/>

==Prerequisites==
Eclipse Galileo M7 build or later.
The examples described here are based on Eclipse Galileo M7.

==About Dynamic WSDL Generation==
This feature allows users to access dynamically generated WSDLs for JAX-WS endpoints deployed within the Swordfish.<BR/>
Consider this example:<BR/>
The jaxws endpoint is deployed with the descriptor:
<pre>
 <jaxws:endpoint id="bookingService"
	                implementor="org.eclipse.swordfish.samples.cxf.BookingServiceImpl"
	                address="nmr:BookingService"/> 
</pre>
The http endpoint is used to access the jax-ws service externally:
<pre>
   <http:endpoint                  
                 endpoint="httpConsumerEndpoint"                 
                 service="httpConsumerEndpoint"
                 targetService="swordfishCxf:BookingServiceImpl"
                 soap="true"
                 role="consumer"                  
                 locationURI="http://0.0.0.0:8192/cxfsample/"
                 defaultMep="http://www.w3.org/2004/08/wsdl/in-out" />
 </pre>
The HTTP endpoint points to <tt>swordfishCxf:BookingServiceImpl</tt> service and it is managed and deployed by the JBI ServiceMix HTTP binding component. 
The problem is that there is no default mechanism to access the dynamically generated booking service WSDL document via the HTTP Endpoint facilities. The [https://dev.eclipse.org/svnroot/rt/org.eclipse.swordfish/trunk/org.eclipse.swordfish.plugins.ws.wsdlgenerator| org.eclipse.swordfish.plugins.ws.wsdlgenerator] project was created  to solve
these partictular problems.<br>
The project:
<ol>
<li> Tracks all deployed HTTP endpoints
<li> Searches for the targeted JAX-WS services. <br>
NOTE: The HTTP endpoint's deployment descriptor should contain  <tt>targetService</tt> or <tt>targetEndpoint</tt> or targetInterface attributes, otherwise the WSDL generator will not be able the find the corresponding JAX-WS service
<li> Generates the WSDL for the service and injects it in the HTTP endpoint.
</ol>
To leverage the use of the Swordfish Dynamic WSDL Generation feature, the org.eclipse.swordfish.plugins.ws.wsdlgenerator project should be added to the target platform.
To access the generated WSDL document for the HTTP endpoint just add the "?wsdl" to the locationURI. For example, httpConsumerEndpoint publishes its wsdl document to the address
http://localhost:8192/cxfsample/?wsdl

--------------

[[Swordfish_Documentation |Swordfish Documentation Home]] <br/>
[[Swordfish | Swordfish Wiki Home]] <br/>