Apache CXF Webservice入门

wangyan188

　　1.步骤一览
　　关于CXF的介绍请移步官网、百科，这里仅供初次使用者入门。
　　
　　
　　2.步骤详情
　　2.1.环境准备
　　apache-cxf-3.0.0.zip下载
　　jdk1.7.0_51
　　Eclipse4.3.0
　　Tomcat v7.0 Server
　　
　　2.2.创建服务端
　　2.2.1.新建Dynamic web project如下

　　默认的eclipse编译输出目录：build\classes,这里就不作修改了，如下：

　　生成web.xml选项还是选上吧，免的自己还要创建文件，默认生成的主要就是welcome-file-list,其实也没太多用处


　　2.2.2.引入cxf相应jar文件
　　将下载的apache-cxf-3.0.0.zip解压，目录结构如下

　　将lib文件夹下的所有文件拷贝到工程中（有些非核心jar是不需要的，根据实际工程删减），项目结构如下：

　　2.2.3.创建服务接口

　　ICxfTest内容如下：

package com.ibugs.service;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
@WebService
public interface ICxfTest {
@WebMethod
String hi(@WebParam(name="name") String name);
}　　与一般接口不同，在ICxfTest接口中引入了三个注解：@WebService,@WebMethod,@WebParam
　　@WebService 标记在接口上表示此接口为WebService服务
　　@WebMethod 表示为WebService方法
　　@WebParam 则表示参数重命名
　　这样一个WebService接口就定义好了
　　2.2.4.接口实现

　　代码和一般实现没什么区别，如下


package com.ibugs.service;
public class CxfTest implements ICxfTest {
@Override
public String hi(String name) {
return "hi " + (name != null?  name : "Everyone" );
}
}　　2.2.5.配置servlet
　　修改web.xml文件，增加servlet



CxfServlet
org.apache.cxf.transport.servlet.CXFServlet
1


CxfServlet
/webservice/*
　　2.2.6.cxf-servlet.xml
　　解压目录\apache-cxf-3.0.0\samples\wsdl_first\src\main\webapp\WEB-INF中复制文件cxf-servlet.xml到/CxfService/WebContent/WEB-INF
　　修改代码：






　　主要是配置jaxws:endpoint，定义了一个webservice，implementor是webservice的处理类，值定义在中指定的id，具体实现在class属性中配置；address是访问路径
　　2.2.7.tomcat发布
　　发布过程与一般web工程没有任何区别，访问路径localhost：8080/CxfService/webservice

　　点击相应的链接：

　　至此服务端部署完成
　　2.3.客户端
　　2.3.1.生成存根stub
　　CXF提供 了wsdl2java.bat工具,在解压目录\apache-cxf-3.0.0\bin下，为了使用方便可以将其加入到计算机环境变量Path中

　　相应的参数如上，这里将生成的代码放到D:\stub目录下，最后一个参数则是服务端提供的超链接

　　可以用参数-p自己定义包名，默认和服务器所在包名相同，生成的代码D:\stub\com\ibugs\service如下:

　　2.3.2.客户端项目
　　新建项目：com.ibugs.service包下放自动生成文件,

　　调用webservice，新建ClientTest类代码如下：


package com.ibugs.client;
import com.ibugs.service.CxfTestService;
import com.ibugs.service.ICxfTest;
public class ClientTest {
static CxfTestService cxfTestService = new CxfTestService();
static ICxfTest cxfTestPort = cxfTestService.getCxfTestPort();
public static void main(String[] args){
System.out.println(cxfTestPort.hi("ibugs"));
}
}　　其中cxfTestService为客户端下webservice服务的一个view，而cxfTestPort为其中的一个Proxy。调用的时候通过代理cxfTestPort就可以调用webService的方法cxfTestPort.hi("ibugs")了。这里大家也可以通过Spring依赖注入的方式创建对象就不在此展开了