generate wsdl from legacy jax-ws client code - wsdl

Question

it´s possible to generate a WSDL using the JAX-WS client code only?
I have a legacy client code without wsdl inside, just remote wsdl uri, and I need to create mockservices for that client code and I need the WSDL to create this mocks.
Any idea?

Answer 1

For purpose of creating a mock/stub service provider, I believe it is better to download the original WSDL if you can. The risk with generating a WSDL from client generated code is the definite possibility the generated WSDL doesn't exactly match the original, which defeats the purpose of mocking or stubbing.
However, here were the steps I used to generate a WSDL from a generated JAX-WS client. I did have to hand-code an implementation class.
Original WSDL: http://wsf.cdyne.com/WeatherWS/Weather.asmx?WSDL
Generate JAX-WS client:
wsimport -extension -keep http://wsf.cdyne.com/WeatherWS/Weather.asmx?WSDL
This creates the sample JAX-WS client, which includes a generated service endpoint interface (SEI): com.cdyne.ws.weatherws.WeatherSoap
Oddly enough, we need an implementation class to run wsgen to generate a WSDL. I manually created an implementation class, declared it to implement the SEI, then copied all methods from the interface definition and gave each a return null; implementation.
package com.cdyne.ws.weatherws;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.xml.bind.annotation.XmlSeeAlso;
import javax.xml.ws.RequestWrapper;
import javax.xml.ws.ResponseWrapper;
#WebService(name = "WeatherSoap", targetNamespace = "http://ws.cdyne.com/WeatherWS/")
public class WeatherSoapStubImpl implements WeatherSoap {
/**
* Gets Information for each WeatherID
*
* #return
* returns com.cdyne.ws.weatherws.ArrayOfWeatherDescription
*/
#WebMethod(operationName = "GetWeatherInformation", action = "http://ws.cdyne.com/WeatherWS/GetWeatherInformation")
#WebResult(name = "GetWeatherInformationResult", targetNamespace = "http://ws.cdyne.com/WeatherWS/")
#RequestWrapper(localName = "GetWeatherInformation", targetNamespace = "http://ws.cdyne.com/WeatherWS/", className = "com.cdyne.ws.weatherws.GetWeatherInformation")
#ResponseWrapper(localName = "GetWeatherInformationResponse", targetNamespace = "http://ws.cdyne.com/WeatherWS/", className = "com.cdyne.ws.weatherws.GetWeatherInformationResponse")
public ArrayOfWeatherDescription getWeatherInformation() {
return null;
}
/**
* Allows you to get your City Forecast Over the Next 7 Days, which is updated hourly. U.S. Only
*
* #param zip
* #return
* returns com.cdyne.ws.weatherws.ForecastReturn
*/
#WebMethod(operationName = "GetCityForecastByZIP", action = "http://ws.cdyne.com/WeatherWS/GetCityForecastByZIP")
#WebResult(name = "GetCityForecastByZIPResult", targetNamespace = "http://ws.cdyne.com/WeatherWS/")
#RequestWrapper(localName = "GetCityForecastByZIP", targetNamespace = "http://ws.cdyne.com/WeatherWS/", className = "com.cdyne.ws.weatherws.GetCityForecastByZIP")
#ResponseWrapper(localName = "GetCityForecastByZIPResponse", targetNamespace = "http://ws.cdyne.com/WeatherWS/", className = "com.cdyne.ws.weatherws.GetCityForecastByZIPResponse")
public ForecastReturn getCityForecastByZIP(
#WebParam(name = "ZIP", targetNamespace = "http://ws.cdyne.com/WeatherWS/")
String zip) {
return null;
}
/**
* Allows you to get your City's Weather, which is updated hourly. U.S. Only
*
* #param zip
* #return
* returns com.cdyne.ws.weatherws.WeatherReturn
*/
#WebMethod(operationName = "GetCityWeatherByZIP", action = "http://ws.cdyne.com/WeatherWS/GetCityWeatherByZIP")
#WebResult(name = "GetCityWeatherByZIPResult", targetNamespace = "http://ws.cdyne.com/WeatherWS/")
#RequestWrapper(localName = "GetCityWeatherByZIP", targetNamespace = "http://ws.cdyne.com/WeatherWS/", className = "com.cdyne.ws.weatherws.GetCityWeatherByZIP")
#ResponseWrapper(localName = "GetCityWeatherByZIPResponse", targetNamespace = "http://ws.cdyne.com/WeatherWS/", className = "com.cdyne.ws.weatherws.GetCityWeatherByZIPResponse")
public WeatherReturn getCityWeatherByZIP(
#WebParam(name = "ZIP", targetNamespace = "http://ws.cdyne.com/WeatherWS/")
String zip) {
return null;
}
}
Compile the stub implementation class.
javac com/cdyne/ws/weatherws/WeatherSoapStubImpl.java
Generate the WSDL. This is where command line switches can be used to try to get as close as possible to the original.
wsgen -keep -cp . com.cdyne.ws.weatherws.WeatherSoapStubImpl -wsdl:Xsoap1.2 -extension -inlineSchemas
(creates WSDL in current dir):
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- Generated by JAX-WS RI (http://jax-ws.java.net). RI's version is JAX-WS RI 2.2.9-b130926.1035 svn-revision#8c29a9a53251ff741fca1664a8221dc876b2eac8. -->
<definitions targetNamespace="http://ws.cdyne.com/WeatherWS/" name="WeatherSoapStubImplService" xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:tns="http://ws.cdyne.com/WeatherWS/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata">
<types>
<xs:schema elementFormDefault="qualified" version="1.0" targetNamespace="http://ws.cdyne.com/WeatherWS/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="GetCityForecastByZIP" type="tns:GetCityForecastByZIP"/>
<xs:element name="GetCityForecastByZIPResponse" type="tns:GetCityForecastByZIPResponse"/>
<xs:element name="GetCityWeatherByZIP" type="tns:GetCityWeatherByZIP"/>
<xs:element name="GetCityWeatherByZIPResponse" type="tns:GetCityWeatherByZIPResponse"/>
<xs:element name="GetWeatherInformation" type="tns:GetWeatherInformation"/>
<xs:element name="GetWeatherInformationResponse" type="tns:GetWeatherInformationResponse"/>
<xs:complexType name="GetWeatherInformation">
<xs:sequence/>
</xs:complexType>
<xs:complexType name="GetWeatherInformationResponse">
<xs:sequence>
<xs:element name="GetWeatherInformationResult" type="tns:ArrayOfWeatherDescription" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ArrayOfWeatherDescription">
<xs:sequence>
<xs:element name="WeatherDescription" type="tns:WeatherDescription" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="WeatherDescription">
<xs:sequence>
<xs:element name="WeatherID" type="xs:short"/>
<xs:element name="Description" type="xs:string" minOccurs="0"/>
<xs:element name="PictureURL" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="GetCityWeatherByZIP">
<xs:sequence>
<xs:element name="ZIP" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="GetCityWeatherByZIPResponse">
<xs:sequence>
<xs:element name="GetCityWeatherByZIPResult" type="tns:WeatherReturn" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="WeatherReturn">
<xs:sequence>
<xs:element name="Success" type="xs:boolean"/>
<xs:element name="ResponseText" type="xs:string" minOccurs="0"/>
<xs:element name="State" type="xs:string" minOccurs="0"/>
<xs:element name="City" type="xs:string" minOccurs="0"/>
<xs:element name="WeatherStationCity" type="xs:string" minOccurs="0"/>
<xs:element name="WeatherID" type="xs:short"/>
<xs:element name="Description" type="xs:string" minOccurs="0"/>
<xs:element name="Temperature" type="xs:string" minOccurs="0"/>
<xs:element name="RelativeHumidity" type="xs:string" minOccurs="0"/>
<xs:element name="Wind" type="xs:string" minOccurs="0"/>
<xs:element name="Pressure" type="xs:string" minOccurs="0"/>
<xs:element name="Visibility" type="xs:string" minOccurs="0"/>
<xs:element name="WindChill" type="xs:string" minOccurs="0"/>
<xs:element name="Remarks" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="GetCityForecastByZIP">
<xs:sequence>
<xs:element name="ZIP" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="GetCityForecastByZIPResponse">
<xs:sequence>
<xs:element name="GetCityForecastByZIPResult" type="tns:ForecastReturn" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ForecastReturn">
<xs:sequence>
<xs:element name="Success" type="xs:boolean"/>
<xs:element name="ResponseText" type="xs:string" minOccurs="0"/>
<xs:element name="State" type="xs:string" minOccurs="0"/>
<xs:element name="City" type="xs:string" minOccurs="0"/>
<xs:element name="WeatherStationCity" type="xs:string" minOccurs="0"/>
<xs:element name="ForecastResult" type="tns:ArrayOfForecast" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ArrayOfForecast">
<xs:sequence>
<xs:element name="Forecast" type="tns:Forecast" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Forecast">
<xs:sequence>
<xs:element name="Date" type="xs:dateTime"/>
<xs:element name="WeatherID" type="xs:short"/>
<xs:element name="Desciption" type="xs:string" minOccurs="0"/>
<xs:element name="Temperatures" type="tns:temp"/>
<xs:element name="ProbabilityOfPrecipiation" type="tns:POP"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="temp">
<xs:sequence>
<xs:element name="MorningLow" type="xs:string" minOccurs="0"/>
<xs:element name="DaytimeHigh" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="POP">
<xs:sequence>
<xs:element name="Nighttime" type="xs:string" minOccurs="0"/>
<xs:element name="Daytime" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
</types>
<message name="GetWeatherInformation">
<part name="parameters" element="tns:GetWeatherInformation"/>
</message>
<message name="GetWeatherInformationResponse">
<part name="parameters" element="tns:GetWeatherInformationResponse"/>
</message>
<message name="GetCityForecastByZIP">
<part name="parameters" element="tns:GetCityForecastByZIP"/>
</message>
<message name="GetCityForecastByZIPResponse">
<part name="parameters" element="tns:GetCityForecastByZIPResponse"/>
</message>
<message name="GetCityWeatherByZIP">
<part name="parameters" element="tns:GetCityWeatherByZIP"/>
</message>
<message name="GetCityWeatherByZIPResponse">
<part name="parameters" element="tns:GetCityWeatherByZIPResponse"/>
</message>
<portType name="WeatherSoap">
<operation name="GetWeatherInformation">
<input wsam:Action="http://ws.cdyne.com/WeatherWS/GetWeatherInformation" message="tns:GetWeatherInformation"/>
<output wsam:Action="http://ws.cdyne.com/WeatherWS/WeatherSoap/GetWeatherInformationResponse" message="tns:GetWeatherInformationResponse"/>
</operation>
<operation name="GetCityForecastByZIP">
<input wsam:Action="http://ws.cdyne.com/WeatherWS/GetCityForecastByZIP" message="tns:GetCityForecastByZIP"/>
<output wsam:Action="http://ws.cdyne.com/WeatherWS/WeatherSoap/GetCityForecastByZIPResponse" message="tns:GetCityForecastByZIPResponse"/>
</operation>
<operation name="GetCityWeatherByZIP">
<input wsam:Action="http://ws.cdyne.com/WeatherWS/GetCityWeatherByZIP" message="tns:GetCityWeatherByZIP"/>
<output wsam:Action="http://ws.cdyne.com/WeatherWS/WeatherSoap/GetCityWeatherByZIPResponse" message="tns:GetCityWeatherByZIPResponse"/>
</operation>
</portType>
<binding name="WeatherSoapPortBinding" type="tns:WeatherSoap">
<soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
<operation name="GetWeatherInformation">
<soap12:operation soapAction="http://ws.cdyne.com/WeatherWS/GetWeatherInformation"/>
<input>
<soap12:body use="literal"/>
</input>
<output>
<soap12:body use="literal"/>
</output>
</operation>
<operation name="GetCityForecastByZIP">
<soap12:operation soapAction="http://ws.cdyne.com/WeatherWS/GetCityForecastByZIP"/>
<input>
<soap12:body use="literal"/>
</input>
<output>
<soap12:body use="literal"/>
</output>
</operation>
<operation name="GetCityWeatherByZIP">
<soap12:operation soapAction="http://ws.cdyne.com/WeatherWS/GetCityWeatherByZIP"/>
<input>
<soap12:body use="literal"/>
</input>
<output>
<soap12:body use="literal"/>
</output>
</operation>
</binding>
<service name="WeatherSoapStubImplService">
<port name="WeatherSoapPort" binding="tns:WeatherSoapPortBinding">
<soap12:address location="REPLACE_WITH_ACTUAL_URL"/>
</port>
</service>
</definitions>
Create the stub or mock service with tooling such as SOAPUI
With this approach and simple service interface I was able to successfully send SOAP messages with the client to a mock service provider created in SOAPUI created with the generated WSDL.