Java与C#平台通信 WCF CXF SOAP.docx

1、Java与C#平台通信 WCF CXF SOAP问题提出 : 采用的方案 : Java 和 C# 的互操作性 , 采用基于 Soap 的通信协议 基于 C# 平台的 SOA 框架 -WCF 简介 什么是 WCF 根据微软官方的解释， WCF 是使用托管代码建立和运行面向服务 (Service Oriented) 应用程序的统一框架。它使得开发者能够建立一个跨平台的、安全、可信赖、事务性的解决方案，且能与已有系统兼容协作。 WCF 是微软分布 式应用程序开发的集大成者，它整合了 .Net 平台下所有的和分布式系统有关的技术，例如 .Net Remoting 、 ASMX 、 WSE 和 MSMQ

2、 。以通信 (Communiation) 范围而论，它可以跨进程、跨机器、跨子网、企业网乃至于 Internet ；以宿主程序而论，可以以 ASP.NET ， EXE ， WPF ， Windows Forms ， NT Service ， COM+ 作为宿主 (Host) 。 WCF 可以支持的协议包括 TCP ， HTTP ，跨进程以及自定义，安全模式则包括 SAML ， Kerberos ， X509 ，用户 / 密码，自定义等多种标准与模式。 WCF 平台搭建 JAVA 调用 WCF DynamicClientFactory dcf = DynamicClientFactory.new

3、Instance(); org.apache.cxf.endpoint.Client client= dcf.createClient(http:/localhost:37563/WebSite4/Service.asmx?wsdl); Object reply = client.invoke(HelloWorld, new Object); System.out.println(Server said: + reply0.toString(); 基于 Java 平台的 SOA 框架 -CXF 简介 详见 : http:/cxf.apache.org/ Apache CXF = Celtix

4、+ 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 CXF 是一个开源的 Service

5、s 框架， CXF 帮助您利用 Frontend 编程 API 来构建和开发 Services ，像 JAX-WS 。这些 Services 可以支持多种协议，比如： SOAP 、 XML/HTTP 、 RESTful HTTP 或者 CORBA ，并且可以在多种传输协议上运行，比如： HTTP 、 JMS 或者 JBI ， CXF 大大简化了 Services 的创建，同时它继承了 XFire 传统，一样可以天然地和 Spring 进行无缝集成。 CXF 平台搭建 从 cxf 官方网站下载最新的发行包 ( 当前为 apache-cxf-2.2.3 版本 ) , 解压目录结构如下所示 : 文件

6、目录结构及相关文件的详细说明： 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 docs （目录） CXF 所有类（ cl

7、ass ）对应的 API 文档，为开发者使用 CXF 完成应用开发提供应有的帮助。 etc （目录） 包含一个基本的 Service 暴露所需要的 web.xml 文件，及其它的配置文件。 lib （目录） lib 目录中包含 CXF 及其运行时所需要的和可选的第三方支持类包（ .jar 文件），可以根据不同项目所需的 CXF 特性选择所需要的支持类包。如果不想一一去区分的话，可以直接在 Web 项目中包含所有的 CXF 及其运行时所需要的第三方支持类包（ .jar 文件）即可。 其中 cxf-2.0.2-incubator.jar 是 CXF 框架的二进制包文件，包含了全部的模块（ modu

8、les ）， cxf-manifest-incubator.jar 是列表清单文件 manifest jar 。 以下的 jar 包是所有 CXF 项目所必需的： cxf.jar commons-logging.jar geronimo-activation.jar (Or the Sun equivalent) geronimo-annotation.jar (Or the Sun equivalent) geronimo-javamail.jar (Or the Sun equivalent) neethi.jar jaxb-api.jar jaxb-impl.jar stax-api.j

9、ar XmlSchema.jar wstx-asl.jar xml-resolver.jar 对于 Java2WSDL 和 WSDL2Java ，除了必需的之外，还需要再增加如下 jar 包： jaxb-xjc.jar veliocity.jar velocity-dep.jar 为了支持 JAX-WS ，除了必需的之外，还需要再增加如下 jar 包： jaxws-api.jar saaj-api.jar saaj-impl.jar asm.jar （可选的，但是可以提升包装类型的性能） 为了支持 XML 配置，除了必需的之外，还需要再增加如下 jar 包： aopalliance.jar s

10、pring-beans.jar spring-context.jar spring-core.jar spring.web.jar 为了独立的 HTTP 服务支持，除了必需的之外，还需要再增加如下 jar 包： geronimo-servlet.jar jetty.jar jetty-sslengine.jar jetty-util.jar sl4j.jar & sl4j-jdk14.jar （可选的，但是可以提升日志 logging ） 为了支持 Aegis ，除了必需的之外，还需要再增加如下 jar 包： jaxen.jar jdom.jar stax-utils.jar 为了支持 WS-

11、Security ，除了必需的之外，还需要再增加如下 jar 包： bcprov-jdk14.jar wss4j.jar xalan.jar xmlsec.jar 为了支持 HTTP Binding ，除了必需的之外，还需要再增加如下 jar 包： jra.jar jettison.jar （仅为 JSON 服务所需的） licenses （目录） 列表了引用第三方 jar 包的相关许可协议。 modules （目录） modules 目录中包含了 CXF 框架根据不同特性分开进行编译的二进制包文件。发布基于 CXF 框架的 Web 项目时，可以选择使用该目录下的所有 .jar 文件，也可以选

12、择 lib 目录中的 cxf-2.2.3.jar 文件。 samples （目录） samples 目录中包含了所有随 CXF 二进制包发布的示例，包含这些示例的源代码和相关 Web 应用配置文件，可以方便地用 Ant 来编译运行测试这些示例，来了解 CXF 的开发和使用的方法。可以通过 samples 目录和它各个子目录下的 README.txt 的文件来详细了解示例的编译与运行的步骤。 DISCLAIMER 由于仍是处于 Apache 孵化状态的项目，这里描述了一些说明。 LICENSE 文件中包含了 CXF 框架的授权协议 Apache License Version 2.0 。 NOT

13、ICE 罗列了 CXF 框架用到的相关第三方组件的授权协议以其它的相关信息。 README 文件中包含了 CXF 框架本身的一些简要说明。 release_notes.txt 包含了 CXF 发布时的一些信息，包括运行时所需要的环境，修复 BUG 的列表等。 CXF 框架支撑环境 CXF 框架是一种基于 Servlet 技术的 SOA 应用开发框架，要正常运行基于 CXF 应用 框架开发的企业应用，除了 CXF 框架本身之外，还需要 JDK 和 Servlet 容器的支持。 JDK 版本选择、下载和安装 CXF 支持非常多的特性，其中不同的特性对 JDK 版本的要求有所不同，但是 JDK 最低

14、的版本是需要选择 JDK 5 或者以上版本。为了运行 CXF 携带的 samples 目录下的所有示例，还需要 Apache Ant 1.6.5 或以上的版本。为了使用 CXF 的 WS-Security 特性，还需要 Bouncy Castle ，并增加到 CLASSPATH 中。 Servlet 容器下载和安装 CXF 是一种基于 Servlet 技术的 SOA 应用开发框架，需要 Servlet 容器的支持。CXF 支持在多种 Servlet 容器中运行，包括 WebSphere 、WebLogic 、Tomcat 、Jetty 等。 开发环境准备 为了方便开发, 采用Myeclipse

15、 作为集成开发环境, 并将cxf 发布包lib 目录下的所有lib 文件加入classpath 中. 接口类创建 在项目的 src 目录中新建一个 ws.cxf 包，并在里面创建接口类 ISurveyService.java ，为了简单示示例起见，仅创建一个方法 public String vote(String username,int point); 这里要注意的是在接口上用 WebService 注解标明这是一个即将暴露为 Web Service 的接口，并将里面的方法都暴露出去。完整的接口代码清单如下： package ws.cxf; import javax.jws.WebServi

16、ce; WebService public interface ISureyService public String vote(String name, int point); 接下来，根据接口的定义，来实现。 package ws.cxf; import javax.jws.WebService ; WebService public class SureyService implements ISureyService public String vote(String name, int point) System. out .println( 感谢您的投票 ); return nam

17、e+point; Spring 配置 在 src 目录中创建 beanRefServer.xml 文件，用来定义 Spring 的 Bean 的配置， CXF 支持 Spring 2.0 Schema 标签配置方式，并且提供快捷暴露 Web Services 的标签。 首先，我们需要引入 Spring 与 CXF 的命名空间（ namespace ），如下： 这样，我们可以使用 Spring 与 CXF 的标签配置了。接着，我们需要引入我们所需要的 CXF 的 Bean 定义文件，如下： 接着定义我们具体实现的 Bean ，这个 Bean 的定义与 Spring 普通的 Bean 定义是一样的

18、： 最后，将定义的 Bean 暴露出去成为 Web Service 服务，通过 CXF 提供的 Schema 标签配置 ，这样定义的配置显得更加简洁与方便，定义如下： 在配置中， serviceClass 的值是接口类的名称， address 为将要暴露出去的 Web Service 访问地址。比如： /SurveyWebService ， 那么客户端消费 Web Service 的地址就会成为 http:/host:port/WebAPPName/SurveyWebService ，与之相应的 WSDL 地址则为： http:/host:port/WebAPPName/SurveyWebSe

19、rvice?wsdl 。 Web 应用配置 由于我们的示例是需要通过 Servlet 容器进行服务暴露，因此需要配置相对应的 web.xml 文件，首先是增加 Spring 的配置文件加载 Listener ，如下： contextConfigLocation /WEB-INF/classes/beanRefServer.xml org.springframework.web.context.ContextLoaderListener 接下来配置 CXF Servlet 的定义，以及它的映射，如下： CXFServlet CXF Servlet org.apache.cxf.transport

20、.servlet.CXFServlet 1 CXFServlet /* 将之映射为 /* 。这样，服务端的代码与配置就全部完成了，接下来就是将应用程序部署到 Web 容器中去，并验证服务是否正常发布。 启动服务 这时开始启动 Tomcat ，在启动的过程中，可以在启动窗口上看到以链接方式部署的应用在启动中会打印出一些相关信息来，最后显示启动成功。 通过访问 http:/localhost:8080/CXF_Spring_Survey/ 可以看到 CXF 暴露的服务链接： 图 7. CXF 暴露的服务链接的内容示意图 可以直接点击进去，或者手工输入 WSDL 的地址进行访问： http:/loc

21、alhost:8080/CXF_Spring_Survey/SurveyWebService?wsdl ，可以看到如下的 WSDL 内容： 图 8. SurveyWebService 的 WSDL 内容示意图 这样，我们可以确定我们的服务真正发布成功了，接下来就可以利用客户端进行消费了。 消费服务 回 到 Eclipse 开发平台，开始编写消费服务相关的代码，首先通过 Spring 与 CXF 的配置来定义 Web Service 的客户端 Bean ，在 src 目录下创建 beanRefClient.xml 配置文件，同样，也需要引入 Spring 与 CXF 命名空间的声明，并引入 CX

22、F 的 Bean 的定义文件，最后通过与服务端配置相对的 CXF 标签 来定义客户端访问服务的声明，完整的定义内容如下： 定义说明： id 为 Spring 定义的 id ，用来在程序里进行获取它的标识， serviceClass 仍是为服务端定义的接口类， address 为完整的 Web Service 地址，这个与服务端的定义不一样。 定义完配置文件，接下来编写访问的具体代码，在 test 目录下创建 ws.cxf.client 包，然后创建 SurveyServiceClient.java ，完整的代码如下： package ws.cxf.client; import org.springframework.context.ApplicationContext; import or