CXF框架的使用,利用cxf开发webservice(六) |
您所在的位置:网站首页 › 怎么生成cxf格式 › CXF框架的使用,利用cxf开发webservice(六) |
Apache CXF = Celtix + XFire,Apache CXF 的前身叫 Apache CeltiXfire,现在已经正式更名为 Apache CXF 了,以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华,提供了对 JAX-WS 全面的支持,并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持,并且可以根据实际项目的需要,采用代码优先(Code First)或者 WSDL 优先(WSDL First)来轻松地实现 Web Services 的发布和使用。目前它仍只是 Apache 的一个孵化项目。 Apache CXF 是一个开源的 Services 框架,CXF 帮助您利用 Frontend 编程 API 来构建和开发 Services ,像 JAX-WS 。这些 Services 可以支持多种协议,比如:SOAP、XML/HTTP、RESTful HTTP 或者 CORBA ,并且可以在多种传输协议上运行,比如:HTTP、JMS 或者 JBI,CXF 大大简化了 Services 的创建,同时它继承了 XFire 传统,一样可以天然地和 Spring 进行无缝集成。 功能特性CXF 包含了大量的功能特性,但是主要集中在以下几个方面: 支持 Web Services 标准:CXF 支持多种 Web Services 标准,包含 SOAP、Basic Profile、WS-Addressing、WS-Policy、WS-ReliableMessaging 和 WS-Security。 Frontends:CXF 支持多种“Frontend”编程模型,CXF 实现了 JAX-WS API (遵循 JAX-WS 2.0 TCK 版本),它也包含一个“simple frontend”允许客户端和 EndPoint 的创建,而不需要 Annotation 注解。CXF 既支持 WSDL 优先开发,也支持从 Java 的代码优先开发模式。 容易使用: CXF 设计得更加直观与容易使用。有大量简单的 API 用来快速地构建代码优先的 Services,各种 Maven 的插件也使集成更加容易,支持 JAX-WS API ,支持 Spring 2.0 更加简化的 XML 配置方式,等等。 支持二进制和遗留协议:CXF 的设计是一种可插拨的架构,既可以支持 XML ,也可以支持非 XML 的类型绑定,比如:JSON 和 CORBA。 项目目标下面列出了来自 Apache 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; 多种传输方式、Bindings、Data Bindings 和 Format 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 和固定记录长度。 灵活部署 轻量级容器:可在 Tomcat 或基于 Spring 的容器中部署 Services; 集成 JBI:可以在如 ServiceMix, OpenESB or Petals 等等的 JBI 容器中将它部署为一个服务引擎; 集成 SCA:可以部署在如 Tuscany 之类的 SCA 容器中; 集成 J2EE:可以在 J2EE 应用服务器中部署 Services,比如:Geronimo、JOnAS、JBoss、WebSphere Application Server 和 WebLogic Application Server,以及 Jetty 和 Tomcat; 独立的 Java 客户端/服务器。 支持多种编程语言 全面支持 JAX-WS 2.0 客户端/服务器编程模型; 支持 JAX-WS 2.0 synchronous、asynchronous 和 one-way API's; 支持 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 ; 代码生成 Java to WSDL; WSDL to Java; XSD to WSDL; WSDL to XML; WSDL to SOAP; WSDL to Service;
CXF 安装包 下载及目录结构 CXF 框架目前的最新版本是 2.0.2,可以访问 Apache 站点(链接请见 参考资源)下载 CXF 框架的安装包,下载时请选择“二进制发布包(Binary distribution)”,当然如果您有兴趣也可以下载相应版本的“源代码发布包(Source distribution)”。 下载完成后,将下载的文件解压缩到任意的文件夹中,比如:C:/Java/CXF,在后面的章节中使用 %CXF_HOME% 表示 CXF 框架的存放目录,解压缩后形成的文件目录结构按名称排序如下: 图 1、Apache CXF 发行包的目录结构示意图文件目录结构及相关文件的详细说明: bin(目录)bin 目录中是 CXF 框架中所提供的代码生成、校验、管理控制台工具: Java to WSDL : java2wsdl CXF Management Console Tool : mc WSDL to Java : wsdl2java WSDL to Service : wsdl2service WSDL to SOAP : wsdl2soap WSDL to XML : wsdl2xml WSDL Validation : wsdlvalidator XSD to WSDL : xsd2wsdl
2. CXF的安装和配置: 直接解压到某个盘下就可以使用:
环境变量: • JAVA_HOME, • CXF_HOME • Path = %JAVA_HOME%\bin;%CXF_HOME%\bin; • CLASSPATH=.;%CXF_HOME%\lib\cxf-manifest.jar 2.2cxf创建一个java工程 2.2.1 服务端程序: (1)创建一个java工程 (2)将第一天查询天气信息的代码拷贝到这个项目中,例如代码:
(3)导入jar包(目录下全部的jar包) (4)CXF是面向接口的编程,创建接口WeatherServerInterface
(5)创建类WeatherServer实现以上的接口
(6)创建QueryWebxmlClient调用网络天气预报的服务 (7)Result的javabean对象,返回封装的结果集
(8)使用JaxWsServerFactoryBean发布CXF的服务端
附录: 服务器端发布的类 l ServerFactoryBean l JaxWsServerFactoryBean(建议使用) 2个对象,都可以发布服务端,但是我们建议使用JaxWsServerFactoryBean,因为它生成的wsdl文件更加规范。 服务器端的拦截器: // 输入拦截器 jaxWsServerFactoryBean.getInInterceptors().add(new LoggingInInterceptor()); // 输出拦截器 jaxWsServerFactoryBean.getOutInterceptors().add(new LoggingOutInterceptor()); 目的是用来输出响应的头部信息,可以看到soap协议的格式(http请求+Xml数据): 例如: Soap1.1: ID: 10 Address: http://127.0.0.1:9999/weather Encoding: UTF-8 Http-Method: POST Content-Type: text/xml; charset=UTF-8 Headers: {Accept=[text/xml, multipart/related], connection=[keep-alive], Content-Length=[218], content-type=[text/xml; charset=UTF-8], Host=[127.0.0.1:9999], SOAPAction=[""], User-Agent=[JAX-WS RI 2.2.4-b01]} Payload:
北京
Soap1.2: ID: 2 Address: http://127.0.0.1:9999/weather Encoding: UTF-8 Http-Method: POST Content-Type: application/soap+xml; charset=utf-8;action="" Headers: {Accept=[application/soap+xml, multipart/related], connection=[keep-alive], Content-Length=[216], content-type=[application/soap+xml; charset=utf-8;action=""], Host=[127.0.0.1:9999], User-Agent=[JAX-WS RI 2.2.4-b01]} Payload: 北京 (9)发布后,在浏览器下输入:http://127.0.0.1:9999/weather?wsdl访问使用说明书
(1)创建一个java工程 (2)使用wsimport生成客户端代码: (3)客户端代码测试:
2.4 客户端程序(使用CXF) 使用CXF的wsdl2java工具,它的功能就如同wsimport一样,可以生成一堆客户端调用的代码。 在命令行执行: wsdl2java –d . http://127.0.0.1:9999/weather?wsdl 这里注意: 生成后WeatherService报错: 原因是cxf需要JAX-WS API 2.2,而jdk6的jax-ws是2.1 版本,需要 wsdl2java 使用“-frontend jaxws21“,或者如果使用jdk1.7就不用加frontend 即如下: wsdl2java –d . –frontedn jaxws21 http://localhost:12345/weather?wsdl
(1)创建java工程 (2)使用wsdl2java生成客户端代码,并拷贝到项目中 (3)客户端测试代码:
(1)客户端测试代码
(1)导入CXF的jar包 (2)测试代码:
这里:大家把服务端的接口和实现类上的@bindingType改成SOAP12HTTP_BINDING看看会有什么变化
可以通过拦截器看到Soap1.1和Soap1.2之前的区别。
|
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |