WebService 功能测试 - 图文

WebService 功能测试

作者：冰雪

摘要：由于WebService的平台无关性，使用越来越多，所以对WebService的测试也越来越受关注，本文整理了WebService的功能测试方法，包括编码方式和工具方式。

关键词：WebService测试

1、WebService简述

WebService是一种革命性的分布式计算技术，本质上就是服务提供方发布一些服务（实现一定功能的函数接口）到网络上，服务使用方如果使用到该服务的功能，直接在网络上调用服务接口就可以了，无需自己重新开发。

那么，服务使用方（我们称之为客户端）是如何使用服务方发布（我们称之为服务端）的WebService服务的呢？这里简要介绍：WebService发布后，其服务是封装在一个wsdl(Web Service Description Language，Web服务描述语言)文件中，客户端发请求主要是向发布好的wsdl地址以SOAP方式发请求，调用过程如下：

服务端生成服务描述文件，以供客户端获取。

客户端取得服务端的服务描述文件，解析该文件从而获得服务端的服务信息以及调用方式。

客户端指定调用方法和参数，生成恰当的SOAP请求消息，发往服务端，并等待服务端返回的SOAP回应消息。

服务端接收客户端发来的SOAP请求消息，解析其中的方法调用和参数格式。并根据wsdl的描述，完成指定功能，将返回值放入SOAP回应消息返回给用户。 客户端解析得到的返回值。

使用WebService的优点是一次开发多次使用，且由于WebService的平台无关性特性，使用越来越多，所以对WebService的测试也就显得越来越重要。

2、WebService功能测试方法

WebService测试最基本的是功能测试，即验证功能的正确性。另外由于服务发布后会由多个客户端进行调用使用，所以性能测试也是一个重要测试内容。

本文只涉及了功能测试部分。功能测试分为编码方式（通过编码测试接口的正确性）和工具方式（通过测试工具测试接口的正确性）。

对于编码方式：WebService常用的框架有axis、xfier、cxf等，对应的有相应的测试方法。

对于工具方式，商用的就不考虑了，免费的工具中有TestMaker（较复杂，需要学习java和Python，学习曲线长）、WebInject（需要懂得soap原理，开发人员用得多）、WSCaller（工具过于简单，只能进行简单的功能测试）、soapUI开源版本（该工具由Java语言开发，有Eclipse插件。脚本语言Groovy是类Java的轻量级脚本语言。组织目录由TestSuit和TestCase构成）。其中的soapUI使用较多，尤其是对懂得Java的人来说上手较快。本文只对soapUI工具测试WebService的方式进行介绍。

3、编码方式

针对WebService常用的框架axis、xfire、cxf，该部分描述了4种WebService功能测试方法及其具体步骤。

使用的开发和测试环境是eclipse3.6.2。

具体步骤中使用了一个HelloWorld的例子进行说明，其中包含两个接口： public interface HelloWorldService{

public String sayHello(String name); public String sayWords(String?words); }

函数功能如下：

Public class HelloWorldServiceImpl implements HelloWorldService{

Public String sayHello(String name){ String words = “Hello,World!”; If(StringUtils.hasText(name)){ Words+=””+name;

}

System.out.println(words); Return words; }

Public String sayWords(String?words){ String theWords = “Hello,”; If(words!=null){

theWords+=StringUtils.join(words); } Else{

theWords+=”nothing to say”;

}

System.out.println(theWords); Return null; } }

3.1 使用Axis测试接口（wsdl服务地址）

该部分使用wsdl的服务地址进行测试。 注：axis包，是个WebService的工具。 官方地址：http://ws.apache.org/axis/

3.1.1 导入相应的包

需要导入的包如下14个：

Activemq-4.0-M3.jar Axiom-api-1.2.7.jar Axiom-impl-1.2.7.jar Axis-1.4.jar Axis2-1.4.jar

Commons-httpcliect-3.1-rcl.jar Data-management-cli-1.2.2-app.jar

Dspace-lni-client-1.5.1-jar-with-dependencies.jar Jsr173_1.0_api.jar Neethi-2.0.1.jar

Openejb-itests-standalone-client-3.1.jar Woden-api-1.0M8.jar Wsdl4j-1.6.2.jar Xmlschema-1.4.1.jar

3.1.2 编写测试代码

Helloworld的测试代码如下：

Package com.ruijie.samples.helloworld;（包名可以任意取） Import org.apache.axis.client.Call; Import org.apache.axis.cliect.Service; Import javax.xml.namespace.Qname;

Public staic void main(String[] args){ Try{

String endpoint =

http://localhost:8089/HelloWorldServiceComponent/HelloWodldService; Service service = new Service();

Call call = (Call)service.createCall();

Call.setTargeEndpointAddress(new java.net.URL(endpoind));

Call.setOperationName(new

Qname(“http://HelloWorldService.sca.helloworld.samples.ruijie.com/”,”sayHello”));

Strings ret =(String)call.invoke(new Object[] {“aaa”}); System.out.println(“Sent ‘aaa’,got””+ret+””); }

Catch(Exception e){

System.err.println(e.toSting()); } }

或者：

Package com.ruijie.samples.helloworld;（包名可以任意取） Import org.apache.axis.client.Call; Import org.apache.axis.cliect.Service; Import javax.xml.namespace.Qname;

Import javax.xml.rpc.ServiceException;

Import java.net.MalformedURLException; Import java.rmi.RemoteException; Public static void main(String[] args) throws RemoteException,ServiceException,MalformedURLException{ Service service = new Service();

Call call = (Call)service.createCall(); Call.setTargetEndpointAddress(new

java.net.URL(“http://localhost:8089/HelloWorldServiceComponent/HelloWodldService;”)) Call.setOperationName(new

Qname(“http://HelloWorldService.sca.helloworld.samples.ruijie.com/”,”sayHello”)) Call.setUseSOAPAction(true);

Call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);

Call.setSOAPActionURI(“http://HelloWorldService.sca.helloworld.samples.ruijie.com/”,”sayHello”);

String k = (String)call.invoke(new Object[]{});//因为返回值是String类型，所以这里调用的返回值也是String类型

System.out.println(“>>>”+k);//返回值输出 }

3.2 使用Xfire测试接口（wsdl文件）

前置：创建测试工程。New-project-Dynamic Web Project

3.2.1 导入相应的包

需要导入的包如下6个： Xfire-call-1.2.6.jar Spring-core-2.0-rc2.jar

Commons-httpclient-3.1-rc1.jar Data-management-cli-1.2.2-app.jar

Dspace-lni-client-1.5.1-jar-with-dependencies.jar XmlSchema-1.4.1.jar

3.2.2将wsdl文件导入到工程的src目录下 3.2.3 编写测试代码

Helloworld的测试代码如下：

Package com.ruijie.samples.helloworld;（包名可以任意取） Import org.codehaus.xfire.client.Client;

Import org.springframework.core.io.ClassPathResource; Import org.springframework.core.io.Resource;

Public class WebServiceClientTest{

Public static void main(string[] args) throws Exception{

WebServiceClientTest test = new WebServiceClientTest(); Test.testClient(); }

Public void testClient() throws Exception{

String wsdl = “HelloWorldService.wsdl”;//对应的WSDL文件 Resource resource = new ClassPathResource(wsdl);

Client client = new Client(resource.getInputStream(),null);//根据WSDL创建客户实例

Object[] objArray = new Object[1];

objArray[0] = “tianXX”;//调用特定的Web Service方法 Object[] results = client.invoke(“sayHello”,objArray); System.out.println(“result:”+results[0]); } }

3.3 使用Cxf的java2wsdl工具测试接口

该部分描述了使用cxf的java2wsdl工具（命令行方式）测试webservice接口步骤。3.3.1 下载安装JDK并配置环境变量

也可直接使用开发环境eclipse的jdk。

3.3.1.1 打开下载地址

地址：（略）

3.3.1.2 下载、安装JDK

版本：jdk-6u7-windows-i586-p.exe

点击运行安装，选择默认安装目录：C:\\Program Files\\Java\\jdk1.6.0_07

3.3.1.3 配置环境变量

JAVA_HOME= C:\\Program Files\\Java\\jdk1.6.0_07 CLASSPATH=.; C:\\Program Files\\Java\\jdk1.6.0_07\\lib\\tools.jar; Files\\Java\\jdk1.6.0_07\\lib\\dt.jar; C:\\Program Files\\Java\\jdk1.6.0_07\\bin; Path= C:\\Program Files\\Java\\jdk1.6.0_07\\bin;（这个放到path的开头）

C:\\Program

3.3.1.4 验证安装

写一个简单的java程序来验证是否已安装成功： Public class hello{

Pubilc static static void main(String args[]){ System.out.println(“Hello”);

} }

将程序保存为文件名为hello.java的文件。

打开命令提示符窗口，进入到hello.java所在目录，键入下面的命令： Javac hello.java Java hello

此时若打印出来hello则安装成功，若没有打印出这句话，仔细检查以上配置是否正确。

3.3.2 下载配置cxf

3.3.2.1 打开下载地址

地址：（略）

3.3.2.2 下载cxf

版本：apache-cxf-2.4.0.zip

3.3.2.3 解压缩

解压缩到一个目录，我的目录是：G:\\apache-cxf-2.4.0

3.3.2.4 配置环境变量

配置环境变量%CXF_HOME%=G:\\apache-cxf-2.4.0（以我的目录为例）并在PATH后加上：%CXF_HOME%\\bin

3.3.2.5 验证安装

打开cmd，进入G:\\apache-cxf-2.4.0\\bin目录，运行wsdl2java命令可成功。 注：Win7下转换目录需要输入/d参数，如cd /d g:\\apache-cxf-2.4.0\\bin

3.3.3 使用wsdl2java工具

Wsdl2java –d G:\\src –client -d 生成文件存放到哪里 -client 生成客户端类

3.3.4 测试代码编写

A、到eclipse中建立一个工程

B、将上一章节3中使用wsdl2java工具生成的代码拷贝到工程目录中，或直接用工具生成代码到工程中。

C、下载需要的jar包，导入到工程中。 包下载地址：（略）

方法：运行wsdl2java工具自动生成的client（此时服务需要处于可访问状态，可通过访问wsdl验证是否可访问），按照错误提示导入需要的包，直到client可运行成功，说明需要的包已经导入完全。

其中一个提示没有告诉具体的错误原因：No method error：com.sun.cml.bind.api.JAXBRIContext.Instance。需要下载jaxb-impl-2.1.13.jar（即最新的包），若没有最新的，2.1.8也可以，但是早期版本不支持，比如2.0.1就不可以。

我导入的包是下面12个（工程右键选择Properties-Java Build Path-Add External JARS或者直接导入到工程相应目录下——工程名 \\WebContent\\WEB-INF\\lib）：

Axis2-jws-api-1.4.1.jar Axis2-saaj-1.2.jar Axis2-saaj-api-1.3.jar Commons-logging-1.1.1.jar Jaxb-api-2.1.jar Jaxb-impl-2.1.8.jar Jaxb-xjc-2.1.7.jar Jaxws-api-2.1.1-1.jar Jaxws-rt-2.1.4.jar

Ow2-bundles-externals-jaxb2-1.0.9.jar Streambuffer-0.8.jar Wstx-asl-3.1.1.jar

D、编辑修改client代码，进行接口测试。（使用Junit即可）

3.4 Dynamic Client

Cxf也提供了一个不需要显性的生成java stub，参考网址：（略）

Wsdl2java静态方式调用和动态方式调用的区别：如果自己用java调用，那就自己生成stub，然后来调用；如果用Dynamic的话，其实也是Cxf帮你后台生成而已。

3.4.1 导入相应的包

需要导入的包如下14个： Commons-logging-1.1.1.jar Cxf-bundle-2.1.3.jar

Geronimo-activation_1.1_spec-1.0.2.jar Geronimo-annotation_1.0_spec-1.1.1.jar Geronimo-javamail_1.4_spec-1.5.jar Geronimo-stax-api_1.0_spec-1.0.1.jar Jaxb-api-2.1.jar Jaxb-impl-2.1.8.jar Jaxb-xjc-2.1.8.jar Neethi-2.0.4.jar Wsdl4j-1.6.2.jar Wstx-asl-3.2.7.jar Xml-resolver-1.2.jar xmlSchema-1.4.2.jar 注：

JDK版本1.5 TOMCAT版本5.X

上述条件必须有，否则会在客户端提示包错误。

还有要特别注意在JDK（公供程序出问题时参考（本示例未做该项处理））

\\%JAVA_HOME%\\jre\\lib\\endorsed 目录或者 %tomcat_home%\\common\\endorsed 目录下必须要用到两个包：

Jaxb-api-2.1.jar Jaxws-api-2.1.jar 否则会提示错误：（错误提示内容略）。

3.4.2 编写测试代码

Package dynamicSample;

Import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory; Import org.apache.cxf.endpoint.Client; Public class SampleTest{

Public static void main(String[] args) throws Exception{

SampleTest test = new SampleTest(); Test.testClient(); }

public void testClient() throws Exception{

JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance(); //Client client = dcf.createClient(“HelloWorldService.wsdl”); org.apache.cxf.endpoint.Client client = dcf.createClient(“http://localhost:8089/HelloWorldServiceComponent/HelloWorldService?wsdl”);

Object[] res = client.invoke(“sayHello”,”tianXX”);

System.out.println(“Response:”+res[0]); } }

4、工具soapUI方式

下面以测试服务HelloWorldService为例，详细说明使用工具soapUI进行WebService功能测试的操作步骤。

4.1 将WebService导入工程

A、单击‘File’->‘New soapUIProject’，如下图：

B、在弹出的对话框中输入待测试的ws信息，然后点击[OK]到下一步： Project Name:HelloWorldService Inital WSDL/WADL：

http://192.168.197.69:8089/HelloWorldServiceComponent/HelloWorldService?wsdl Create Requests：选中 Create TestSuite：选中 Relative Paths：选中

C、保存project

4.2 创建初始的TestSuit和TestCase

A、生成初始的测试用例

选择One TestCase for each Operation：每个接口创建一个用例

选择Create new empty requests：创建一个空的请求 Operation：选择待测试的方式

选择Generates a default LoadTest for each created TestCase：每个用例生成一个负载测试（为后面性能测试做准备）

B、生成TestSuite

这里可根据习惯更改TestSuite的名称，如TestSuite：HelloWorldService。 C、在soapUI的左侧生成如下目录

4.3 设置TestCase的参数

A、创建项目的时候我们选择了Create sample requests for all operations，所以每个接口方法都会自动创建一个请求，如下图：

B、双击它就可以打开编辑面板，左边是请求内容，右边是响应内容。

打问号的地方是需要输入的参数，我们可以输入任意参数，这里输入tianxx，见下图：

4.4 执行TestCase

单击执行按钮执行，右侧Response页面查看结果。

根据反馈的结果判断请求是否发送成功（输入了参数tianxx，返回了结果Hello,World!tianxx）。

4.5 设置断言

为在测试中不用人为的进行接口功能是否正确的判断，因此加入断言Assertions。可由程序直接对返回结果进行判断。点击下图中绿色执行按钮后面的“+”来增加断言。

在弹出的“Secect Assertion”对话框中，选择“Contains”的断言，确定后弹出“Contains Assertion”对话框，在Content中填入内容，此处是表示返回的结果报文里应包含的字段，我们输入“Hello,World!tianxx”，点击OK。插入断言后，程序会在运行用例时，自动帮我们校验返回的结果报文是否包含“Hello,World!tianxx”内容。

工具下方的结果输出区域显示运行结果如下：

运行失败，因为实际结果应该是“Hello,”和“World!”之间应该有个空格，我们修改（双击Contains - FAILED）断言，在两个单词之间增加个空格，再次运行，结果如下：

4.6 执行TestSuit

可以一次执行一个或多个TestSuit。使用脚本语言Groovy控制。

5、总结

5.1 测试方法对比分析

编码方式适合做复杂的功能测试，根据难易程度，方法的使用顺序推荐：url方式、wsdl文件方式、wsdl2java方式（动态、静态）。

5.2 后记

本文算是对自己前段工作做的一个笔记或叫总结，不对的地方还请不吝赐教。

本文来源：https://www.bwwdw.com/article/vvaa.html