Apache cxf 学习笔记Word格式文档下载.docx

1、3.1 cxf如何生成客户端 163.2 cxf会用到的注解 （还未完善） 17导语：该文档主要讲解CXF的实践例子，包括纯CXF和Spring集成的两个例子。理论方面的知识还有待各位的完善。1 CXF简介本章主要简介CXF的理论知识。1.1 CXF概述CXF 是Celtix + Xfire的结合体，Apache CXF 的前身叫 Apache CeltiXfire，现在已经正式更名为 Apache CXF 了。CXF 继承了 Celtix 和 XFire 两大开源项目的精华，提供了对 JAX-WS 全面的支持，并且提供了多种 Binding 、DataBinding、Transport 以及

2、各种 Format 的支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用。Apache CXF已经是一个正式的Apache顶级项目。 1.2 CXF支持1.2.1 协议标准CXF支持多种协议标准：JAX-WS、 JAX-WSA、JSR-181 和 SAAJ；支持 SOAP 1.1、1.2、WS-I BasicProfile、WS-Security、WS-Addressing、WS-RM 和 WS-Policy；支持 WSDL 1.1 、2.0；支持 MTOM；1.2.2 传输方式

3、CXF支持多种协议传输方式：Bindings：SOAP、REST/HTTP；Data Bndings：目前支持 JAXB 2.0、Aegis 两种，默认是 JAXB 2.0。XMLBeans、Castor 和 JiBX 数据绑定方式将在 CXF 2.1 版本中得到支持；格式（Format）：XML、JSON；传输方式：HTTP、Servlet、JMS 和 Jabber；可扩展 API ：允许为 CXF 增加其它的 Bindings，以能够支持其它的消息格式，比如：CSV 和固定记录长度。1.3 CXF特点1.3.1 灵活部署轻量级容器：可在 Tomcat 或基于 Spring 的容器中部署 S

4、ervices；集成 JBI：可以在如 ServiceMix, OpenESB or Petals 等等的 JBI 容器中将它部署为一个服务引擎；集成 SCA：可以部署在如 Tuscany 之类的 SCA 容器中；集成 J2EE：可以在 J2EE 应用服务器中部署 Services，比如：Geronimo、JOnAS、JBoss、WebSphere Application Server 和 WebLogic Application Server，以及 Jetty 和 Tomcat；独立的 Java 客户端服务器。1.3.2 支持多种编程语言全面支持 JAX-WS 2.0 客户端服务器编程模型；

5、支持 JAX-WS 2.0 synchronous、asynchronous 和 one-way APIs；支持 JAX-WS 2.0 Dynamic Invocation Interface （DII） API；支持 wrapped and non-wrapped 风格；支持 XML messaging API；支持 JavaScript 和 ECMAScript 4 XML （E4X） ，客户端与服务端均支持；通过 Yoko 支持 CORBA；通过 Tuscany 支持 SCA；通过 ServiceMix 支持 JBI ；1.3.3 代码生成Java to WSDL；WSDL to Jav

6、a；XSD to WSDL；WSDL to XML；WSDL to SOAP；WSDL to Service；1.4 CXF环境要求CXF 框架是一种基于 Servlet 技术的 SOA 应用开发框架，要正常运行CXF，除了 CXF 框架本身之外，还需要 JDK 和 Servlet 容器的支持。2 实践讲解本章讲解使用CXF框架发布Web Services服务的两个例子。2.1 CXF 开发例子讲解使用CXF框架发布Web Services的例子。2.1.1 步骤图2.1.2 步骤详解下载CXF最新发布包下载地址http:/cxf.apache.org/download.html创建一个Web

7、工程引入CXF jar包把前面下载的CXF包解压，进入lib目录。把所有jar包拷贝到刚创建的Web工程的lib目录。配置CXFServlet打开web.xml配置CXF的接入Servlet。样例如下： CXFServlet org.apache.cxf.transport.servlet.CXFServlet 1/servletservlet-mappingurl-pattern/cxftest/*/servlet-mapping编写待发布的接口下面编写一个简单的登录接口。import javax.jws.WebService;WebServicepublic interface Login

8、 String login（String name, String password）;编写接口的实现类WebService（endpointInterface = com.test.service.cxf.Login, serviceName = Login）public class LoginImpl implements Login public String login（String name, String password） String result = 登录CXF 服务端成功!; if （!cxf.equalsIgnoreCase（name） | !.equalsIgnoreC

9、ase（password） result = 用户名或密码不正确，请重新登录! return result; 编写发布服务类import javax.servlet.ServletException;import javax.servlet.http.HttpServlet;import org.apache.cxf.jaxws.JaxWsServerFactoryBean;public class InitServlet extends HttpServlet Override public void init（） throws ServletException LoginImpl logi

10、nImpl = new LoginImpl（）; JaxWsServerFactoryBean jwpFactory = new JaxWsServerFactoryBean（）; jwpFactory.setAddress（/Login）; jwpFactory.setServiceClass（LoginImpl.class）; jwpFactory.setServiceBean（loginImpl）; jwpFactory.create（）; 配置启动发布服务类前面我们把发布服务的类实现在一个Servlet里，所以把该类配置到web.xml里这样启动工程时就会发布Web Services。

11、发布工程并启动获取发布的WSDL访问发布的工程再拼加上CXF监听路径。如：/localhost:8080/StudyCXF/cxftest/Login?wsdl生成客户端代码查看 附录3.1 如何生成客户端代码。然后把生成的客户端代码放到客户端工程。提示： 从生成的客户端代码中会有很多实际上我们用不到的源文件，可根据实际情况进行清理，这里只需要Login.java。编写客户端调用代码客户端一般是其它的系统，这里只讲解客户端在调用服务端的代码编写。import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;public class CXFClient pu

12、blic static void main（String args） JaxWsProxyFactoryBean jwpFactory = new JaxWsProxyFactoryBean（）; jwpFactory .setAddress（wsdl jwpFactory.setServiceClass（Login.class）; Login login = （Login） jwpFactory.create（）; String result = login.login（, System.out.println（登录结果： + result）;2.2 CXF与Spring集成例子讲解CXF与

13、Spring集成发布Web Services的例子。2.2.1 步骤图2.2.2 步骤详解配置web.xml打开web.xml配置CXF的接入Servlet，和Spring的接入Listener。context-paramparam-namecontextConfigLocationparam-valueWEB-INF/conf/beans.xml/context-paramlistenerlistener-classorg.springframework.web.context.ContextLoaderListener/listenerbeans.xml是Spring的配置文件，请根据实际

14、情况配置所在路径。后面配置服务端是在该文件里配置。下面编写一个简单的订单接口。import javax.jws.WebParam;public interface OrderProcess String processOrder（WebParam（name = Order） Order order）;更多的注解描述请查看 附录3.2 。com.test.service.springOrderProcesspublic class OrderProcessImpl implements OrderProcess public String processOrder（Order order） St

15、ring userName = order.getUserName（）; return userName + 您好：订单处理成功，生成的订单号是：88888888配置服务端编辑beans.xml文件，配置服务端接口类。!-jaxws:endpoint id=orderProcess implementor=com.test.service.spring.OrderProcessImpl address=/OrderProcess / -server id=test address=serviceBeanbean class=/bean/jaxws:server这里给出二种发布服务端接口的方式，

16、随便哪一种都可以8080/StudyCXFSpring/cxftest/OrderProcess?客户端工程应该也是一个引入了CXF集成Spring包的工程，创建步骤同服务端工程。 从生成的客户端代码中会有很多实际上我们用不到的源文件，可根据实际情况进行清理，这里只需要Order.java，OrderProcess.java配置客户端在客户端工程中找到Spring的配置文件并配置如下内容。bean id=client class=com.test.service.spring.OrderProcess factory-bean=clientFactory factory-method=crea

17、teorg.apache.cxf.jaxws.JaxWsProxyFactoryBeanproperty name=serviceClass value=/propertyaddress value=8080/StudyCXFSpring/cxftest/OrderProcessimport org.springframework.context.support.FileSystemXmlApplicationContext; FileSystemXmlApplicationContext context = new FileSystemXmlApplicationContext（ WebRo

18、ot/WEB-INF/conf/client-bean.xml OrderProcess orderProcess = （OrderProcess） context.getBean（ Order order = new Order（）; order.setUserName（yihuajun String result = orderProcess.processOrder（order）; System.out.println（result）;3 附录3.1 cxf如何生成客户端 dos命令下进入cxf解压目录的bin路径 ，输入如下命令：wsdl2java -d src -client8060

19、/soa/services/otherTrackedVehicleSoapService?wsdl2java在cxf包中的bin路径下另外里面的src为生成代码存放路径，src必须手动创建。使用cxf wsdl2java或javax wsimport工具的时候，可能会遇到关于生成的Response类文件名冲突的问题WSDLToJavaError:ThrownbyJAXB:Aclass/interfacewiththesamenameXXX*isalreadyinuse.Useaclasscustomizationtoresolvethisconflict.目前可选择的方案：1.使用-autoNameResolution自动处理wsdl2java -autoNameResolution http:orwsimport -p com.test.client -keepwsdl-B-XautoNameResolution3.2 cxf会用到的注解 （还未完善）