首先我们下载cxf的jar包,我这里下载的是apache-cxf-3.0.4这个版本,目前最新的。
下载地址:http://cxf.apache.org/download.html
Eclipse里面新建一个Java project,在工程中引入需要的jar:
这些包里面包含了jetty的包,是为了本地做测试用,在用到tomcat等服务器的时候,可以不用。
其他的包包含的内容有:cxf拦截器需要用到的包,rest服务需要用到的包。
总之,根据需要自己添加。jar没有问题后,进行代码编写:
1、编写一个业务接口:
package com.dqjb.ws; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.jws.WebService; import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter; import com.dqjb.util.TaskAdapter; import com.dqjb.vo.Task; import com.dqjb.vo.User; @WebService public interface HelloWorld { String sayHi(String context); }
接口里面有一个带参的sayHi方法,需要客户端传一参数,服务端返回这个参数,这里有一个注解:
@WebService
它是Java里面的一个接口,意思是一个Java类实现一个Web服务,或Java接口定义Web服务接口
定义接口以后,我们再定义一个实现类:
package com.dqjb.ws.imlp; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.jws.WebService; import com.dqjb.vo.Task; import com.dqjb.vo.User; import com.dqjb.ws.HelloWorld; @WebService(endpointInterface="com.dqjb.ws.HelloWorld",serviceName="HelloWorldWS") public class HelloWorldImpl implements HelloWorld { @Override public String sayHi(String context) { return context; } }
实现类里面我们返回输入的内容,同时,我们也用到了webservice标记:
@WebService(endpointInterface="com.dqjb.ws.HelloWorld",serviceName="HelloWorldWS")
其中
endpointInterface指的是接口完整路径,
serviceName指的是服务名
接下来,我们再main方法中发布一个接口:
package com.dqjb.ws; import javax.xml.ws.Endpoint; import com.dqjb.ws.imlp.HelloWorldImpl; public class WsPublishSample { public static void main(String[] args) { HelloWorld helloWorld = new HelloWorldImpl(); Endpoint.publish("http://10.114.73.30:8080/helloWorld", helloWorld); } }
发布完成后,我们在地址后面加上?wsdl,在浏览器中访问这个服务:
当我们看到浏览器能成功访问,说明这个非常简单的服务已经发布成功了!
补充知识点:
上述例子简单滴传递了基本数据类型,cxf方法参数及返回值可以是基本数据类型,javabean对象已经复合类型,在cxf老版本中像Map,List等复合类型的返回值直接处理不了,需要用@XmlJavaTypeAdapter转化器进行类型转型,这种方式可以参考http://www.cnblogs.com/holbrook/archive/2012/12/15/2818833.html
这篇文章。新版本的处理方式显得更为简单,在处理Map,list等时,可以将转变为它的具体实现,如HashMap,ArrayList :
@XmlJavaTypeAdapter(TaskAdapter.class)Map<String, Task> getAllTasks(); HashMap<String, Task> getAllTasks2();