soapUI使用手册.docx
《soapUI使用手册.docx》由会员分享,可在线阅读,更多相关《soapUI使用手册.docx(39页珍藏版)》请在冰豆网上搜索。
soapUI使用手册
插图目录
1概述
关于本章
本章描述内容如下表所示。
标题
内容
1.1soapUI的作用
介绍soapUI的作用。
1.2soapUI的版本说明
介绍soapUI的版本。
1.3soapUI网站信息
介绍soapUI的下载网址。
1.1soapUI的作用
soapUI是一个简单易用的测试WebService的工具,安装在本地PC(PersonalComputer)机上即可使用。
soapUI通过SOAP(SimpleObjectAccessProtocol)/HTTP(HypertextTransferProtocol)来调用WebService,从而实现对WebService的功能/负载/符合性测试。
该工具既可作为一个桌面应用软件使用,也可利用插件集成到Eclipse中使用。
soapUI在省级VGOP(Value-addedGeneralOperationPlatform)项目中的主要作用如下:
●模拟业务平台服务端接收从省级VGOP发送来的数据
●模拟业务平台客户端向省级VGOP发送数据
1.2soapUI的版本说明
soapUI有普通版本和专业版本。
●普通版本
可以实现一般的功能,不需要申请License即可使用。
本手册以普通版本为例,介绍soapUI的使用方法。
●专业版本
相对于普通版有更多更灵活的测试步骤可以添加。
专业版本需要申请一个免费试用的License才可使用。
试用License的有效期是两周。
License的申请很简单,只需要在“soapUIProLicense”对话框中单击“ApplyforTrial”,然后填上邮箱、姓名和公司名称,一分钟左右邮箱中就能收到试用的License。
但是,一个邮箱地址只能申请一个License,即两周的试用期过后,不能再使用之前申请时使用的License再次申请。
1.3soapUI网站信息
soapUI的网站信息如下:
●soapUI的官方网址为ui.org/
●soapUI的下载地址为ts/soapui
2安装soapUI
关于本章
本章描述内容如下表所示。
标题
内容
2.1准备工作
介绍安装soapUI之前的准备工作。
安装过程
介绍soapUI的安装过程。
2.3启动和关闭soapUI
介绍启动和关闭soapUI的方法。
2.1准备工作
安装JDK
soapUI需要在JDK(JavaDeveloper'sKit)上运行,因此,安装soapUI的本地PC机上必须安装JDK,并配置JDK的环境变量。
检查PC机上是否配置了JDK的环境变量的方法,请参考步骤2~步骤6的操作,检查“JAVA_HOME”变量和“PATH”变量的值是否是正确的JDK的目录。
如果不正确,请重新配置。
请参考如下操作安装及配置JDK:
步骤1获取JDK的安装包或安装目录。
可以从已安装了JDK的PC机上拷贝JDK的安装目录。
如果获取的是JDK的安装包,请在PC机的某个目录下解压。
JDK的版本一定是1.5以上的版本。
步骤2右键单击需要设置环境变量的PC机桌面上的“我的电脑”。
步骤3在快捷菜单中选择“属性”。
系统弹出“系统属性”界面。
步骤4选择“高级”页签。
步骤5单击“高级”页签中的“环境变量”。
系统显示环境变量页面。
步骤6在“XXX的用户变量”区域框新增或修改“JAVA_HOME”变量和“PATH”变量。
“XXX”为PC机的用户名。
如果区域框中已经有“JAVA_HOME”和“PATH”变量,请执行如下操作:
1.选择“PATH”变量。
2.单击该区域框中的“编辑”。
系统弹出“编辑用户变量”对话框。
3.在“变量值”文本框中输入本机的JDK的正确路径。
与其他变量值之间用英文格式的分号(;)分隔开。
“PATH”的值需要包括JDK的bin目录,例如,JDK存放在E盘的tool目录下,则“PATH”的值应该为E:
\tool\jdk_06\bin。
4.选择“JAVA_HOME”变量。
5.单击该区域框中的“编辑”。
6.在“变量值”文本框中输入本机的JDK路径。
“JAVA_HOME”的值不需要包括JDK的bin目录,例如,JDK存放在E盘的tool目录下,则“JAVA_HOME”的值应该为E:
\tool\jdk_06。
如果区域框中没有“JAVA_HOME”和“PATH”变量,请执行如下操作:
7.在“XXX的用户变量”区域框中单击“新建”。
系统弹出“新建用户变量”对话框,如图2-1所示。
图2-1新建用户变量
8.在“变量名”中输入“PATH”,在“变量值”中输入JDK的启动目录。
JDK的启动目录包括bin目录,例如:
E:
\tool\jdk_06\bin。
9.单击“确定”。
系统返回“环境变量”页面。
10.在“XXX的用户变量”区域框中再次单击“新建”。
11.在弹出的“新建用户变量”对话框中的“变量名”中输入“JAVA_HOME”,在“变量值”中输入JDK的存放目录,例如:
E:
\tool\jdk_06。
12.单击“确定”。
步骤7在“环境变量”页面单击“确定”。
系统返回“系统属性”页面。
步骤8单击“确定”,完成环境变量的设置。
----结束
获取soapUI安装包
请从soapUI的下载网址“657327”上下载soapUI的安装包,或者从其他已有soapUI的PC机上拷贝到需要安装的PC机上。
soapUI是绿色软件,如果从其他的PC机上拷贝过来的是已经安装过的soapUI的普通版本,则可以直接使用,不需要再次安装。
2.2安装过程
此处以安装文件为例,介绍soapUI的安装方法。
不同的版本安装界面可能不同,请以实际使用的版本的安装界面为准,此处仅为参考。
步骤1进入本地PC上存放安装文件的目录下。
步骤2双击启动安装。
系统显示如图2-2所示界面。
图2-1Welcome
步骤3单击“Next”。
系统显示如图2-3所示界面。
图2-1LicenseAgreement
步骤4单击“IAgree”。
系统显示如图2-4所示界面。
图2-1ChooseComponents
步骤5保持默认值,单击“Next”。
也可根据需要从“Selectthetypeofinstall:
”中选择要安装的类型。
选择的安装类型不同,则安装的部件会不同。
系统显示如图2-5所示界面。
图2-1ChooseInstallLocation
步骤6单击“Next”。
如果要修改soapUI的安装路径,请单击“
”,重新选择安装路径。
单击“Next”后,系统显示如图2-6所示界面。
图2-1ChooseStartMenuFolder
步骤7单击“Install”,开始安装soapUI。
请等待一分钟左右,安装完后会显示如图2-7所示界面。
图2-1Completing
步骤8单击“Finish”,完成安装。
图2-7中“1”选项是被选中的,因此,在单击“Finish”后,soapUI会被启动。
如果不想在安装完成后启动soapUI,请将“1”选项前的“✓”去掉,然后再单击“Finish”。
----结束
2.3启动和关闭soapUI
2.3.1启动soapUI
●如果是直接从其他PC机上拷贝过来的soapUI,启动方法是:
双击soapUI目录下的bin文件夹中的“”。
●如果是通过执行soapUI的安装文件安装了soapUI,则启动的方法是:
选择“开始>程序>soapUI2.5-beta1>1”。
2.3.2关闭soapUI
直接单击soapUI界面右上角的“
”关闭soapUI,或者选择“File>Exit”退出soapUI。
3soapUI使用方法
关于本章
本章描述内容如下表所示。
标题
内容
3.1soapUI基本操作
介绍soapUI的基本操作。
3.2soapUI的TestSuite功能
介绍soapUI的测试套功能。
3.3soapUI模拟服务端
介绍soapUI模拟服务端的方法。
3.4soapUI模拟客户端
介绍soapUI模拟客户端的方法。
3.1soapUI基本操作
3.1.1创建工程
准备工作
创建工程前,请先准备好需要的WSDL文件,将WSDL文件保存在和soapUI同一台PC机上的某个目录下。
例如:
D:
\wsdl文件。
操作步骤
请参考如下操作步骤在soapUI上创建一个工程。
步骤1单击SoapUi的bin目录下的soapui.bat脚本启动SoapUi。
步骤2右键单击左侧导航树中的“Projects”。
步骤3在弹出的快捷菜单中选择“NewsoapUIProject”,如图3-1所示。
图3-1创建新工程
系统弹出“NewsoapUIProject”对话框,如图3-2所示。
图3-2“NewsoapUIProject”对话框
●在“InitialWSDL/WADL”中选择了某个WSDL文件之后,该参数下面的“CreateRequests”、“CreateTestSuite”和“CreateMockService”会由不可编辑变为可编辑。
●建议“CreateRequests”、“CreateTestSuite”和“CreateMockService”三个选项都选上。
步骤4在“NewsoapUIProject”对话框中输入相关信息。
“CreateRequest”是默认必选项。
●如果仅选择了“CreateRequest”,则在执行完步骤5后,工程创建完成。
●如果选择了“CreateRequest”和“CreateTestSuite”,则需要执行步骤5和步骤6。
●如果选择了“CreateRequest”和“CreateMockService”,则需要执行步骤5和步骤7。
建议“CreateRequest”、“CreateTestSuite”和“CreateMockService”都选上,则需要执行步骤5~步骤7。
步骤5单击“OK”。
步骤6创建测试套。
1.在“GenerateTestSuite”界面单击“OK”,如图3-3中红色框。
图3-1GenerateTestSuite
显示如图3-4所示的输入测试套名称对话框。
图3-2GenerateTestSuite
2.在图3-4所示对话框的文本框中输入测试套的名称,也可保持默认值。
3.单击“确定”。
系统显示“GenerateMockService”对话框。
测试套创建完成。
步骤7创建MockService。
创建MockService之后,导入的WSDL中的操作就可以模拟服务端的功能,供客户端调用。
1.在弹出的“GenerateMockService”界面输入“Path”和“Port”的值,如图3-5所示。
图3-1GenerateMockService
此处请拷贝“Path”的值,在3中输入MockService名称时需要用到,并请记录“Port”的值,在后续调测时需要用到。
●Path
Path的值应与模拟测试时,在基础信息管理界面上配置的业务信息的“业务开通服务URL”或“能力管控服务URL”的值保持一致,如图3-6所示红色框中的内容。
这样VGOP才能将业务请求发到该Path对应模拟的业务平台上。
为了避免在基础信息管理界面上配置的“业务开通服务器URL”或“能力管控服务URL”的值超出基础信息管理界面的显示,在填写“Path”的值时,请不要输入太长的字符串。
图3-2URL
●Port
Port为模拟的业务平台的监听端口号,建议保持默认值。
该值需要与后面模拟测试时在基础信息管理界面上配置平台信息时的“平台URL”里的端口号保持一致,如图3-7所示红色框中的内容。
如果在一个soapUI上模拟多个业务平台时,可以通过修改Port的值来区分不同的业务平台。
图3-3端口号
2.在图3-5所示对话框中单击“OK”。
显示如图3-8所示对话框。
图3-1GenerateMockService
3.在图3-8所示对话框的文本框中MockService的名称。
请保持该处的名称与图3-5中的“Path”的值保持一致。
4.单击“OK”。
系统显示创建的MockService包含的操作信息的界面。
5.单击右上角的“
”关闭MockService操作信息界面。
至此,MockService创建完成,同时,需要调测的功能的整个工程也创建完成,可以在左侧导航树中看到创建好的工程,类似图3-9所示。
图3-1创建好的工程
----结束
3.1.2编辑消息
下面以要编辑“业务订购”工程中的测试套中的subscribeService用例的消息为例,介绍编辑消息的操作步骤。
步骤1单击左侧工程导航栏中的“业务订购”工程前的“
”,展开该工程下的类型信息,例如测试套等。
步骤2单击测试套“OrderServiceHttpBindingTestSuite”前的“
”,展开测试套下的测试用例。
步骤3单击测试用例“subscribeServiceTestCase”前的“
”,展开测试用例下的测试类型。
步骤4单击“TestSteps”前的“
”。
步骤5双击“TestSteps”下的“subscribeService”。
右侧显示“subscribeService”的消息“Request1”,如图3-10所示。
图3-1消息体
步骤6在“Request1”中的“?
”处删掉“?
”,并输入节点的值。
----结束
3.1.3修改消息发送地址
在图3-10中的上方的“
”即是消息发送的地址,即soapUI要将消息发送到的URL地址。
要修改发送地址,请参考如下操作。
步骤1单击消息地址栏。
地址栏列出如图3-11中的蓝色框的信息。
图3-1地址栏操作
步骤2单击图3-11中的“editcurrent..”。
系统显示如图3-12所示对话框。
图3-1Editendpoint
步骤3在“Editendpoint”对话框中输入正确的URL地址。
如果要发送到的地址和soapUI在同一台PC机上,可以保持“localhost”,如果不在同一台PC机上,请将“localhost”修改为实际需要发送到的IP地址。
URL中的端口及端口后的字符串也需要根据实际情况修改。
步骤4修改完毕,单击“确定”。
地址栏显示为修改后的URL地址。
----结束
3.1.4保存工程
保存后的工程的格式为“.xml”格式的文件。
保存所有工程
如果要一次保存soapUI左侧导航树中的所有工程的话,请直接单击工具栏中的“
”。
保存所有工程并退出soapUI
如果要一次保存soapUI左侧导航树中的所有工程,并且退出soapUI的话,请直接单击工具栏中的“
”。
保存单个工程
要保存单击工程时,请右键单击需要保存的工程的名称,在快捷菜单中选择“SaveProject”。
如果要保存的工程之前没有执行过保存操作,则系统会弹出对话框,需要选择工程保存的本地文件夹。
如果要保存的工程之前已经设置过保存路径,则系统会直接保存,不需要重新设置路径。
如果要另存工程,请在快捷菜单中选择“SavaProjectAs”,在系统弹出的对话框中选择保存的路径,单击“保存”即可。
3.1.5删除工程
如果要删除某个工程,请参考如下操作。
步骤1在左侧工程导航栏中右键单击需要删除的工程的名称,例如要删除“测试业务订购”的工程,则右键单击“测试业务订购”。
步骤2在弹出的快捷菜单中选择“Remove”,如图3-13所示。
图3-1Remove
系统弹出如图3-14所示对话框。
图3-2RemoveProject
步骤3根据需要单击“是”或“否”确认是否保存该工程再从soapUI上删除。
如果单击“撤消”,则退出删除工程的操作。
----结束
3.1.6导入工程
如果要导入之前保存过但已经从soapUI的工程导航栏中删除的工程,请操作如下操作。
步骤1单击工具栏中的“
”。
也可以右键单击左侧工程导航栏中的“Projects”,在快捷菜单中选择“ImportProject”。
步骤2在系统弹出的“SelectsoapUiProjectFile”对话框中选择要导入的工程文件(后缀为“.xml”)。
步骤3单击“打开”。
系统弹出“ResolveProject”对话框。
步骤4在“ResolveProject”对话框中单击“OK”。
系统显示“SelectWSDLFile”对话框。
步骤5在“SelectWSDLFile”对话框中选择和导入的工程文件匹配的WSDL文件。
步骤6单击“打开”。
导入的工程显示在左侧工程导航栏中。
----结束
3.2soapUI的TestSuite功能
3.2.1任务说明
soapUI提供的测试套(TestSuite)功能,可以帮助用户测试soapUI与接收地址间的通信、并检查soapUI上的请求消息体是否正确。
3.2.2操作示例
下面以业务订购功能中单个业务订购操作(subscribeService)为例,介绍测试套的使用方法。
步骤1参考“3.1.1创建工程”创建了业务订购的工程。
此处假设工程名称为“业务订购”。
步骤2在soapUI左侧的工程栏中选择“业务订购”工程中要执行的测试套下的测试用例“subscribeServiceTestCase”,如图3-15中蓝色框。
图3-1选择测试套
步骤3展开测试用例下的“TestSteps
(1)”,双击其下的“subscribeService”。
右侧界面的请求栏中显示subscribeService操作的请求消息,如图3-16所示。
请求消息中的各个字段中的“?
”表示节点值需要在“?
”处填写。
图3-1请求消息
步骤4在图3-16中的请求消息中输入节点值。
步骤5参考“3.1.3修改消息发送地址”修改消息要发送到的URL地址。
步骤6单击消息发送地址栏前的“
”发送消息。
在单击“
”发送消息前,请先确认省级VGOP的能力管控已经启动成功。
消息发送出去之后,在图3-16的右侧的响应消息栏中会显示消息处理结果,如图3-17所示。
图3-1处理结果
----结束
3.3soapUI模拟服务端
3.3.1任务说明
soapUI模拟服务端时,是供其他接口调用的,并能给调用它的接口提供需要的结果。
soapUI模拟服务端主要是MockService功能,因此,如果要模拟服务端,在创建工程时,在“NewsoapUIProject”对话框中一定要选择“CreateMockService”。
3.3.2操作示例
下面以能力管控中的单条服务开通功能(syncOrderRelation)为例介绍soapUI模拟服务端的操作方法。
步骤1参考“3.1.1创建工程”创建“服务开通”工程时,已经选择了“CreateMockService”,并已经创建了名称为“/mockOrderRelationService”的MockService。
步骤2在左侧工程导航树中选择“服务开通>/mockOrderRelationService>syncOrderRelation”。
步骤3双击“syncOrderRelation”下的“Response1”,如图3-18所示。
图3-1Response1
右侧界面的响应消息栏中显示soapUI作为服务端需要返回给调用它的接口的响应消息,如图3-19所示红框。
图3-2响应消息
步骤4在响应消息中的“?
”中输入需要返回给调用它的接口的结果值。
步骤5启动MockService。
1.右键单击MockService的名称“/mockOrderRelationService”。
2.在快捷菜单中选择“StartMinimized”启动MockService,如图3-20所示。
如果要停止MockService,请选择“Stop”。
图3-1启动MockService
启动后的MockService“/mockOrderRelationService”前的图标变成可运动的,即“
”中的绿色会上下移动。
至此,服务端设置完毕,当接口调用soapUI模拟的业务平台时,soapUI的请求消息栏会收到调用方发送来的请求消息,soapUI在收到请求消息后,就会将准备好的响应消息发送给调用方,表示soapUI模拟的业务平台已经成功处理了从调用方发送过来的请求消息。
----结束
3.3.3查看MockService的Path和Port
如果要查看某个MockService的值,请单击MockService的名称,在导航树下方的“MockServiceProperties”页签中,就会显示该MockService的属性信息,其中的“Path”和“Port”即是需要查看的值,如图3-21所示。
图3-1查看MockService的Path和Port
3.4soapUI模拟客户端
3.4.1任务说明
soapUI模拟客户端,即作为soapUI作为消息发送方,将请求消息发送到地址栏中的地址,并接收响应结果。
soapUI模拟客户端主要是“Requests”功能,因此,在创建工程时,在“NewsoapUIProject”对话框中一定要选择“CreateRequests”项。
3.4.2操作示例
下面以能力管控中的服务开通功能中的单个服务开通结果反馈(syncOrderRelationCfm)操作为例介绍soapUI模拟客户端的操作方法。
此处假设“syncOrderRelatinCfm”所属的工程名称为“业务订购”,请求的名称为“OrderServiceHttpBinding”。
请求的名称是在创建工程时,系统默认的名称。
步骤1在左侧工程导航树中选择“业务订购>OrderServiceHttpBinding>syncOrderRelatinCfm”。
步骤2双击“syncOrderRelatinCfm”下的“Request1”。
界面右侧的“Request1”的请求消息栏中显示请求的消息内容,如图3-22所示。
图3-1Request1
步骤3在请求消息栏中填写各个节点的参数值。
节点前标识“
--Optional:
-->”表明下面紧邻的节点是可选节点,可以不用填参数值,也可将该节点删除。
例如,如下内容中的“servParamInfo>”节点的值可以不用填写。
cfmResult>?
cfmResult>
--Optional:
-->
servParamInfo>
para_num>?
para_num>
--Zeroormorerepetitions:
-->
para_info>
par