WebService 功能测试

每一个明天 贡献于2014-07-07

作者 LegendWoo  创建于2012-02-23 08:24:00   修改者LegendWoo  修改于2012-02-24 04:46:00字数9448

文档摘要: 由于WebService的平台无关性,使用越来越多,所以对WebService的测试也越来越受关注,本文整理了WebService的功能测试方法,包括编码方式和工具方式。关键词:WebService测试1、WebService简述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; C:\Program 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的开头) 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 后记 本文算是对自己前段工作做的一个笔记或叫总结,不对的地方还请不吝赐教。

下载文档到电脑,查找使用更方便

文档的实际排版效果,会与网站的显示效果略有不同!!

需要 8 金币 [ 分享文档获得金币 ] 1 人已下载

下载文档