Head First WebService with CXF

1. Download apache cxf :  http://people.apache.org/dist/incubator/cxf/2.0.4-incubator/apache-cxf-2.0.4-incubator.zip
    Download Spring:   http://www.springsource.org/download

2. Server side:
    WEB-INF/web.xml   -- web description

1. <?xml version="1.0" encoding="UTF-8"?>
2. <web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
3.     <context-param>
4.     <param-name>contextConfigLocation</param-name>
5.     <param-value>WEB-INF/spring.xml</param-value>
6.     </context-param>
7.     
8.     <listener>
9.     <listener-class>
10.         org.springframework.web.context.ContextLoaderListener
11.     </listener-class>
12.     </listener>
13.     
14.     <servlet>
15.     <servlet-name>CXFServlet</servlet-name>
16.     <servlet-class>
17.         org.apache.cxf.transport.servlet.CXFServlet
18.     </servlet-class>
19.     <load-on-startup>1</load-on-startup>
20.     </servlet>
21.     
22.     
23.     <servlet-mapping>
24.     <servlet-name>CXFServlet</servlet-name>
25.     <url-pattern>/services/*</url-pattern>
26.     </servlet-mapping>
27. </web-app>

    WEB-INF/spring.xml 

1. <?xml version="1.0"?>
3. <beans xmlns="http://www.springframework.org/schema/beans"
4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5. xmlns:jaxws="http://cxf.apache.org/jaxws"
6. xsi:schemaLocation="
7. http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
8. http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">
10. <import resource="classpath:META-INF/cxf/cxf.xml" />
11. <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
12. <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
16. <bean id="sample" class="jax.ws.test.WebServiceSampleImpl">
17. </bean>
20. <jaxws:endpoint id="sampleEndPoint" implementor="#sample" address="/WebServiceSample" />
23. </beans>

   
    web service interface WebServiceSample.java

1. package jax.ws.test;
3. import javax.jws.WebService;
5. /**
6.  * 
7.  * @author kaven
8.  *
9.  */
10. @WebService 
11. public interface WebServiceSample {
12.     String say(String hello); 
13. }

  
     web  service impl WebServiceSampleImpl.java

1. package jax.ws.test;
3. import javax.jws.WebService;
6. @WebService(endpointInterface = "jax.ws.test.WebServiceSample")
7. public class WebServiceSampleImpl implements WebServiceSample {
9.     public String say(String hello) {
10.         System.out.println("Hello " + hello);
11.         return "Hi buddy " + hello;
12.     }
14. }

    ant build file : build.xml

1. <?xml version="1.0" encoding="ISO-8859-1"?>
2. <project default="war" basedir=".">
3.     
4.     <property name="dir.warroot"  value="build/jaxWsTest.war"/>
5.     <property name="dir.lib" value="WebContent/WEB-INF/lib" />
6.     <!-- change this to your deploy directory -->
   
7.     <property name="dir.jboss.delopy"   value="/Users/kaven/Kaven/Resource/JBoss/jboss-4.2.3.GA/server/default/deploy"/>
8.     
9.     <path id="build.classpath">
10.         <fileset dir="${dir.lib}">
11.             <include name="*.jar"/>
12.         </fileset>
13.     <pathelement location="dest"/>
14.   </path>
15.     
16.     <target name="clean">
17.         <delete dir="build"/>
18.     </target>
20.     <target name="build" depends="clean">
21.         <mkdir dir="build"/>
22.         <mkdir dir="build/classes"/>
23.         <javac srcdir="src" destdir="build/classes" classpathref="build.classpath">
24.         </javac>
25.     </target>
26.     
27.     <target name="war" depends="build">
28.         <mkdir dir="${dir.warroot}"/>
29.         <mkdir dir="${dir.warroot}/WEB-INF"/>
30.         <mkdir dir="${dir.warroot}/WEB-INF/classes"/>
31.         <copy todir="${dir.warroot}/WEB-INF/classes">
32.             <fileset dir="build/classes"/>
33.         </copy>
34.         <copy todir="${dir.warroot}/WEB-INF">
35.             <fileset dir="WebContent/WEB-INF"/>
36.         </copy>
37.     </target>
38.     
39.     <target name="deploy" depends="war">
40.         <copy todir="${dir.jboss.delopy}/jaxWsTest.war">
41.             <fileset dir="${dir.warroot}">
42.                 <include name="**/*"/>
43.             </fileset>
44.         </copy>         
45.     </target>
46. </project>

run ant deploy,the webservice will be deployed in your web container.

browser:  http://127.0.0.1:8080/jaxWsTest/services/WebServiceSample?wsdl
if you see the wsdl file means the webservice is deployed successfully

3. client side:
    There are many ways to access webservice,for instance.
    I.  WSDL2Java generated Client
    II. JAX-WS Proxy
    III. JAX-WS Dispatch APIs
    To make it simple,we use Proxy to invoke webservice
    WebServiceClient.java

1. package jax.ws.test.client;
3. import java.net.MalformedURLException;
4. import java.net.URL;
6. import javax.xml.namespace.QName;
7. import javax.xml.ws.Service;
9. import jax.ws.test.WebServiceSample;
11. public class WebServiceClient {
13.     public static void main(String[] args) throws MalformedURLException {
14.         URL wsdlURL = new URL("http://127.0.0.1:8080/jaxWsTest/services/WebServiceSample?wsdl");
15.         QName SERVICE_NAME = new QName("http://test.ws.jax/", "WebServiceSampleImplService");
16.         Service service = Service.create(wsdlURL, SERVICE_NAME);
17.         WebServiceSample client = service.getPort(WebServiceSample.class);
18.         String result = client.say("kaven");    
19.         System.out.println("Response from server : "+result);
20.     }
21. }

   4. Advanced Tech
        I. Configure the client invoking ConnectionTimeout and ReceiveTimeout

1.         Client client = (Client) ClientProxy.getClient(port);
2.         HTTPConduit http = (HTTPConduit) client.getConduit();
4.         HTTPClientPolicy httpClientPolicy = new HTTPClientPolicy();
6.         httpClientPolicy.setConnectionTimeout(300);  // set ConnectionTimeout
   
7.         httpClientPolicy.setAllowChunking(false);
8.         httpClientPolicy.setReceiveTimeout(3200);  // set ReceiveTimeout
   
10.         http.setClient(httpClientPolicy);

       more info refer to :http://cwiki.apache.org/CXF20DOC/client-http-transport-including-ssl-support.html
  
        II.  那么多的jar包，是不是很晕呢， 刚才花了几个小时，终于找到了Java客户端调用CXF Web-Service最小Jar包子集。
              

  

                               图中所示的都是必要的，缺一不可，如果是standalone那么jboss下的两个必要的，如果在Jboss container中，可以不要                        III. Asynchronous WebService Calling