Be sure the “Export runtime libraries to WEB-INF/lib at deployment time” is checked. This will make sure the Apache CXF jars are copied into the web project when you deploy the application. 
Download Tomcat 6.X or greater and set it in your preferences:
Now that we should have all the tools we need, let’s start the fun part of developing our service.
In this example, I’m assuming that I’m starting with a WSDL and going to generate the code for my service from that. The steps we will follow are:
Create a Dynamic Web Project for our generated code.
Copy the WSDL into our web project.
Generate the JAX-WS code from the WSDL.
Deploy our application to Tomcat.
Test with SOAP UI.
I’ve got a simple WSDL that is a spell checking web service. It allows you to pass in some text and then in the response it will identify any misspelled words and also give you suggestions for correct spellings. We won’t code this functionality, but that’s the WSDL and operation we are working with.
So, let’s do it!
1) Create a Dynamic Web Project and use the CXF Web Services Project v2.5 Configuration.
Edit the source folder locations to match Maven standards (src/main/java)
Update Content directory to match maven standards(webapp instead of WebContent)
Choose the CXF 2.0.13 runtime.
2) Copy wsdl under the WEB-INF folder into a wsdl folder(you’ll have to create the WSDL folder):
3) Right click on the WSDL and choose Web Services->Generate Java Bean Skeleton:
Adjust the Web Services Runtime to be Apache CXF 2.X:
You can adjust the package name if you want: This should be the package name of where the service class will reside, not the request/response objects.
Next window is for the WSDL2Java and XJC binding(request/response) JAX-B bindings. (leave the defaults)
What’s Generated :
This updates the web.xml to define a CXFServlet that will receive the incoming web service request. Also, the web.xml is updated to configure spring with the beans.xml. (NOTE: that in Websphere there is no need for any special servlet definitions. In WAS, the container scans for the JAX-WS annotations and automatically exposes your services based on the annotations alone.)
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>spell-check-ws</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<servlet>
<description>Apache CXF Endpoint</description>
<display-name>cxf</display-name>
<servlet-name>cxf</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>cxf</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>60</session-timeout>
</session-config>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/beans.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
</web-app>
The beans.xml is autogenerated and is what links the web service to the implemenation class.
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">
<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
<jaxws:endpoint xmlns:tns="http://ws.cdyne.com/" id="checksoap"
implementor="com.cdyne.ws.CheckSoapImpl" wsdlLocation="WEB-INF/wsdl/spellCheck.wsdl"
endpointName="tns:checkSoap" serviceName="tns:check" address="/checkSoap">
<jaxws:features>
<bean class="org.apache.cxf.feature.LoggingFeature" />
</jaxws:features>
</jaxws:endpoint>
</beans>
It even generates an implementation of the service:
@javax.jws.WebService(
serviceName = "check",
portName = "checkSoap",
targetNamespace = "http://ws.cdyne.com/",
wsdlLocation = "http://ws.cdyne.com/SpellChecker/check.asmx?wsdl",
endpointInterface = "com.cdyne.ws.CheckSoap")
public class CheckSoapImpl implements CheckSoap {
private static final Logger LOG = Logger.getLogger(CheckSoapImpl.class.getName());
/* (non-Javadoc)
* @see com.cdyne.ws.CheckSoap#checkTextBody(java.lang.String bodyText ,)java.lang.String licenseKey )*
*/
public com.cdyne.ws.DocumentSummary checkTextBody(java.lang.String bodyText,java.lang.String licenseKey) {
LOG.info("Executing operation checkTextBody");
System.out.println(bodyText);
System.out.println(licenseKey);
try {
com.cdyne.ws.DocumentSummary _return = new com.cdyne.ws.DocumentSummary();
java.util.List<com.cdyne.ws.Words> _returnMisspelledWord = new java.util.ArrayList<com.cdyne.ws.Words>();
com.cdyne.ws.Words _returnMisspelledWordVal1 = new com.cdyne.ws.Words();
java.util.List<java.lang.String> _returnMisspelledWordVal1Suggestions = new java.util.ArrayList<java.lang.String>();
_returnMisspelledWordVal1.getSuggestions().addAll(_returnMisspelledWordVal1Suggestions);
_returnMisspelledWordVal1.setWord("Word-206675031");
_returnMisspelledWordVal1.setSuggestionCount(969026437);
_returnMisspelledWord.add(_returnMisspelledWordVal1);
_return.getMisspelledWord().addAll(_returnMisspelledWord);
_return.setVer("Ver-644250047");
_return.setBody("Body-2010852480");
_return.setMisspelledWordCount(-774292127);
return _return;
} catch (Exception ex) {
ex.printStackTrace();
throw new RuntimeException(ex);
}
}
}
4) Deploying:
Add the project to your Tomcat server:
Then after publishing and restarting the server:
This shows the available services. If you click on the link after “WSDL:” it will show you the WSDL (NOTE: the text is not the actual link) Clicking on the text takes you to:
Notice the service portion of the WSDL is updated with the endpoint address for your server:
- <wsdl:service name="check">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">This engine makes spelling suggestions for text.<br><br><b>See it working at</b>: <a href="http://www.cdyne.com/SpellChecker" target="_blank">http://www.cdyne.com/SpellChecker</a></wsdl:documentation>
- <wsdl:port binding="tns:checkSoap" name="checkSoap">
<soap:address location="http://localhost:8080/spell-check-ws/services/checkSoap" />
</wsdl:port>
</wsdl:service>
5) Testing with SOAP UI.
You can use the WSDL location above to create your SOAP UI project.
Soap UI will generate a sample request, then you just have to fill in the values.
My sample request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.cdyne.com/">
<soapenv:Header/>
<soapenv:Body>
<ws:CheckTextBody>
<!--Optional:-->
<ws:BodyText>My poorly speeleed body.</ws:BodyText>
<!--Optional:-->
<ws:LicenseKey>key123</ws:LicenseKey>
</ws:CheckTextBody>
</soapenv:Body>
</soapenv:Envelope>
And my response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<CheckTextBodyResponse xmlns="http://ws.cdyne.com/">
<DocumentSummary>
<MisspelledWord>
<word>Word-857902635</word>
<SuggestionCount>-850205234</SuggestionCount>
</MisspelledWord>
<ver>Ver-1888918001</ver>
<body>Body1625834665</body>
<MisspelledWordCount>-686503157</MisspelledWordCount>
</DocumentSummary>
</CheckTextBodyResponse>
</soap:Body>
</soap:Envelope>
The service worked and I didn’t touch a line of code!!!
The logs show the incoming and outgoing messages:
Hope this helps someone!
