WebService服务调用方法介绍
1 背景概述
由于在项目中需要多次调用webservice服务，本文主要总结了一下java调用WebService常见的6种方式，即：四种框架的五种调用方法以及使用AEAI ESB进行调用的方法。
2 预期读者
数通畅联内部员工
广大计算机爱好者
3 名词解释
Web Service也叫XML Web Service： WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求，轻量级的独立的通讯技术。是通过SOAP在Web上提供的软件服务，使用WSDL文件进行说明，并通过UDDI进行注册。
XML：(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络，是Soap的基础。
Soap：(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后，他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范，它可以支持不同的底层接口，像HTTP(S)或者SMTP。
WSDL：(Web Services Description Language) WSDL 文件是一个 XML 文档，用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。
UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前，必须确定这个服务内包含哪些商务方法，找到被调用的接口定义，还要在服务端来编制软件，UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制（标准的XML/HTTP）来发布，编辑，浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据，并且发送到注册中心或者由注册中心来返回需要的数据。
4 实现思路
通过soapUI工具使用四种WebService框架来生成客户端代码进行调用，或者使用Xfire的jar包中的的Client类进行调用，无需生成客户端代码，还可以使用AEAI ESB工具中的soup调用组件进行调用。
5 实现步骤
5.1 工具材料
soapUI-3.6.1：
soapUI是一个开源测试工具，通过soap/http来检查、调用、实现Web Service的功能/负载/符合性测试。该工具既可作为一个单独的测试软件使用，也可利用插件集成到Eclipse，maven2.X，Netbeans 和intellij中使用。
Axis：
axis全称Apache EXtensible Interaction System 即阿帕奇可扩展交互系统。Axis本质上就是一个SOAP引擎，提供创建服务器端、客户端和网关SOAP操作的基本框架。
Axis2:
Axis2是下一代 Apache Axis。Axis2 虽然由 Axis 1.x 处理程序模型提供支持，但它具有更强的灵活性并可扩展到新的体系结构。
Cxf:
Apache CXF = Celtix + XFire，开始叫 Apache CeltiXfire，后来更名为 Apache CXF 了，以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华，提供了对 JAX-WS 全面的支持，并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用。
Xfire:
XFire是新一代的Java Web服务引擎，XFire使得在JavaEE应用中发布Web服务变得轻而易举。
AEAI ESB
企业服务总线（Enterprise Service BUS，ESB)主要作为企业信息系统的“龙骨”来集成各业务系统，实现异构系统的互联互通。沈阳数通畅联软件技术有限公司推出的ESB产品命名为AEAI ESB。
AEAI ESB主要包含三个模块：服务器ESBServer、设计器ESBDesigner、管理控制中心。ESBServer是AEAI ESB的运行环境，基于定制的Tomcat 扩展开发，管理控制中心则是部署在ESBServer的Java Web应用，基于开发平台构建的。ESBDesigner是基于Eclipse Plugin开发的图形化、拖拽式的设计Web服务、消息流程的构建工具。
5.2 前置条件
创建web服务
使用AEAI ESB创建一个简单的接口(具体方法参见AEAI ESB集成平台技术手册5.2.7)：样例中的web服务入参为三个数字，出参为三个数字相加得到的和。
soapUI工具配置
在soapUI中进行相关配置，如图：
在附件中有Apache文件夹，将文件夹放到指定路径下，在如下图进行配置
将四种框架的地址填写进对应的位置，还有jdk的位置，注意Xfire需要ANT的支持。
5.3 方法步骤
5.3.1 Axis框架
在soapUI的菜单栏中选择Tools中的Axis 1.x选项
在（1）处填写需要调用的web服务的URL
在（2）处填写生成的客户端代码的位置
点击（3）处按钮生成客户端代码
在对应的路径下找到代码文件
将代码拷贝到自己新建的 工程目录下
注意：出现缺包的错误时，将Apache中对应框架的文件家中的lib包导入即可，新建一个Test类，其中对应的测试调用代码如下：
| public class Test { public static void main(String[] args)throws Exception { AddAllNum_ServiceLocator locator = new AddAllNum_ServiceLocator(); AddAllNumSoapBindingStub stub = (AddAllNumSoapBindingStub)locator.getAddAllNumPort(); System.out.println(stub.addNum("1", "2", "3")); } } |
运行结果：
5.3.2 Axis2框架
在soapUI的菜单栏中选择Tools中的Axis 2选项，如图：
在（1）处填写调用的接口的URL
在（2）处填写生成代码的位置
在（3）处填写包名
在（4）处注意通过adb模式进行生成
点击（5）处的按钮生成客户端代码
生成出来的代码以及文件都添加到新建的调用服务的工程中
将生成的客户端代码放入到新建的工程中，导入对应框架的包
新建Test类，对应的调用代码如下：
| public class Test { public static void main(String[] args) throws Exception{ AddAllNumStub stub = null; stub = new AddAllNumStub(); AddAllNumStub.AddNum addNum = new AddAllNumStub.AddNum(); addNum.setNum1("1"); addNum.setNum2("2"); addNum.setNum3("3"); System.out.println(stub.addNum(addNum).getResult()); } } |
运行结果：
5.3.3 Cxf框架
在soapUI的菜单栏中选择Tools中的CXF选项，如图：
在（1）处填写需要调用的URL
在（2）处填写生成的代码文件的位置
在（3）处填写代码的包名
点击（4）处的按钮生成客户端代码
将生成的代码放到新建的工程中，导入CXF的包后在AddAllNum_Service.java中出现错误，将出错的地方注释，如图
创建Test类，测试调用接口
对应的测试调用代码如下：
| public class Test { public static void main(String[] args) throws Exception { URL wsdlLocation = new URL("http://localhost:9090/TestWebServices/services/AddAllNum?wsdl"); AddAllNum_Service addAllNum_Service = new AddAllNum_Service(wsdlLocation); AddAllNum addAllNum = addAllNum_Service.getAddAllNumPort(); String result = addAllNum.addNum("2","3","4"); System.out.println(result); } } |
运行结果：
5.3.4 Xfire框架
第一种调用方式：生成客户端代码进行调用
在soapUI的菜单栏中选择Tools中的XFire1.x选项，如图：
在（1）处填入需要调用的web服务的URL
在（2）处填入生成客户端代码的位置
在（3）处填入生成的客户端代码的包名
在（4）处注意需要使用jaxb模式生成
点击（5）处的按钮生成客户端代码
将生成的代码放到到新建工程下，导入Apache文件夹下的xfire-lib目录下的包
创建Test类，对应的调用方法：
| public static void main(String[] args) { AddAllNumClient addAllNumClient = new AddAllNumClient(); String result = addAllNumClient.getAddAllNumPort().addNum("1", "2","2"); System.out.println(result); } |
运行结果：
第二种调用方式：通过WSDl创建一个动态的客户端
新建工程，引入XFire对应的jar包（Apache目录下的xfire-lib目录中的包），注意此时需要在接口服务端的AddNum文件中添加一段代码
| @SOAPBinding(style=Style.RPC) |
重新部署工程，如下：
在新建的工程中的Test类中的调用，如下图：
对应的调用代码，如下：
| public class Test { public static void main(String[] args) throws MalformedURLException, Exception { String url = "http://localhost:9090/TestWebServices/services/AddAllNum?wsdl"; Client client = new Client(new URL(url)); String num1 = "2"; String num2 = "3"; String num3 = "4"; Object[] result = client.invoke("addNum",new Object[]{num1,num2,num3}); System.out.println(result[0]); } } |
运行结果：
5.3.5 Aeai Esb调用
首先在接口工程上右键，设置ESB应用
选择WS引用，将WSDL的地址添加进去，解析名称、生成代理
在MF服务目录下创建http消息流程TestSoupWeb
选择数据适配器
在JavaInvoker1组件中选择扩展代码，如图：
| public void invoke() throws AdapteException{ AddNum addNum = (AddNum) this.xgetVariable("addNum").getValue(); addNum.setNum1("1"); addNum.setNum2("2"); addNum.setNum3("3"); } |
SoapInvoker1组件选择如图：
然后HttpResponse节点选择响应内容如图：
在浏览器调用HttpRequest节点中的URL
运行结果：
6 附件及说明
Apache目录：四种Web服务框架以及Ant工具
WebService目录：Web服务接口
Test目录：文档中涉及的四种框架五种调用的样例客户端工程
Sqls目录：AEAI ESB需要使用的数据库文件
Jdk目录：存放了soapUI配置时需要用到的JDK
WebService服务调用方法介绍文档及相关介质 下载