soapUI使用手册.docx

1、soapUI使用手册插图目录1 概 述关于本章本章描述内容如下表所示。标题内容1.1 soapUI的作用介绍soapUI的作用。1.2 soapUI的版本说明介绍soapUI的版本。1.3 soapUI网站信息介绍soapUI的下载网址。1.1 soapUI的作用soapUI是一个简单易用的测试Web Service的工具，安装在本地PC（Personal Computer）机上即可使用。soapUI通过SOAP（Simple Object Access Protocol）/HTTP（Hypertext Transfer Protocol）来调用Web Service，从而实现对Web Ser

2、vice的功能/负载/符合性测试。该工具既可作为一个桌面应用软件使用，也可利用插件集成到Eclipse中使用。soapUI在省级VGOP（Value-added General Operation Platform）项目中的主要作用如下：模拟业务平台服务端接收从省级VGOP发送来的数据模拟业务平台客户端向省级VGOP发送数据1.2 soapUI的版本说明soapUI有普通版本和专业版本。普通版本可以实现一般的功能，不需要申请License即可使用。本手册以普通版本为例，介绍soapUI的使用方法。专业版本相对于普通版有更多更灵活的测试步骤可以添加。专业版本需要申请一个免费试用的License才

3、可使用。试用License的有效期是两周。License的申请很简单，只需要在“soapUI Pro License”对话框中单击“Apply for Trial”，然后填上邮箱、姓名和公司名称，一分钟左右邮箱中就能收到试用的License。但是，一个邮箱地址只能申请一个License，即两周的试用期过后，不能再使用之前申请时使用的License再次申请。1.3 soapUI网站信息soapUI的网站信息如下：soapUI的官方网址为ui.org/soapUI的下载地址为ts/soapui2 安装soapUI关于本章本章描述内容如下表所示。标题内容2.1 准备工作介绍安装soapUI之前的准备

4、工作。 安装过程介绍soapUI的安装过程。2.3 启动和关闭soapUI介绍启动和关闭soapUI的方法。2.1 准备工作安装JDKsoapUI需要在JDK（Java Developers Kit）上运行，因此，安装soapUI的本地PC机上必须安装JDK，并配置JDK的环境变量。检查PC机上是否配置了JDK的环境变量的方法，请参考步骤 2步骤 6的操作，检查“JAVA_HOME”变量和“PATH”变量的值是否是正确的JDK的目录。如果不正确，请重新配置。请参考如下操作安装及配置JDK：步骤 1获取JDK的安装包或安装目录。可以从已安装了JDK的PC机上拷贝JDK的安装目录。如果获取的是JD

5、K的安装包，请在PC机的某个目录下解压。JDK的版本一定是1.5以上的版本。步骤 2右键单击需要设置环境变量的PC机桌面上的“我的电脑”。步骤 3在快捷菜单中选择“属性”。系统弹出“系统属性”界面。步骤 4选择“高级”页签。步骤 5单击“高级”页签中的“环境变量”。系统显示环境变量页面。步骤 6在“XXX的用户变量”区域框新增或修改“JAVA_HOME”变量和“PATH”变量。“XXX”为PC机的用户名。如果区域框中已经有“JAVA_HOME”和“PATH”变量，请执行如下操作：1.选择“PATH”变量。2.单击该区域框中的“编辑”。系统弹出“编辑用户变量”对话框。3.在“变量值”文本框中输入

6、本机的JDK的正确路径。与其他变量值之间用英文格式的分号（;）分隔开。“PATH”的值需要包括JDK的bin目录，例如，JDK存放在E盘的tool目录下，则“PATH”的值应该为E:tooljdk_06bin。4.选择“JAVA_HOME”变量。5.单击该区域框中的“编辑”。6.在“变量值”文本框中输入本机的JDK路径。“JAVA_HOME”的值不需要包括JDK的bin目录，例如，JDK存放在E盘的tool目录下，则“JAVA_HOME”的值应该为E:tooljdk_06。如果区域框中没有“JAVA_HOME”和“PATH”变量，请执行如下操作：7.在“XXX的用户变量”区域框中单击“新建”。

7、系统弹出“新建用户变量”对话框，如图2-1所示。图2-1 新建用户变量8.在“变量名”中输入“PATH”，在“变量值”中输入JDK的启动目录。JDK的启动目录包括bin目录，例如：E:tooljdk_06bin。9.单击“确定”。系统返回“环境变量”页面。10.在“XXX的用户变量”区域框中再次单击“新建”。11.在弹出的“新建用户变量”对话框中的“变量名”中输入“JAVA_HOME”，在“变量值”中输入JDK的存放目录，例如：E:tooljdk_06。12.单击“确定”。步骤 7在“环境变量”页面单击“确定”。系统返回“系统属性”页面。步骤 8单击“确定”，完成环境变量的设置。-结束获取so

8、apUI安装包请从soapUI的下载网址“657327”上下载soapUI的安装包，或者从其他已有soapUI的PC机上拷贝到需要安装的PC机上。soapUI是绿色软件，如果从其他的PC机上拷贝过来的是已经安装过的soapUI的普通版本，则可以直接使用，不需要再次安装。2.2 安装过程此处以安装文件为例，介绍soapUI的安装方法。不同的版本安装界面可能不同，请以实际使用的版本的安装界面为准，此处仅为参考。步骤 1进入本地PC上存放安装文件的目录下。步骤 2双击启动安装。系统显示如图2-2所示界面。图2-1 Welcome步骤 3单击“Next”。系统显示如图2-3所示界面。图2-1 Lice

9、nse Agreement步骤 4单击“I Agree”。系统显示如图2-4所示界面。图2-1 Choose Components步骤 5保持默认值，单击“Next”。也可根据需要从“Select the type of install：”中选择要安装的类型。选择的安装类型不同，则安装的部件会不同。系统显示如图2-5所示界面。图2-1 Choose Install Location步骤 6单击“Next”。如果要修改soapUI的安装路径，请单击“”，重新选择安装路径。单击“Next”后，系统显示如图2-6所示界面。图2-1 Choose Start Menu Folder步骤 7单击“Ins

10、tall”，开始安装soapUI。请等待一分钟左右，安装完后会显示如图2-7所示界面。图2-1 Completing步骤 8单击“Finish”，完成安装。图2-7中“1”选项是被选中的，因此，在单击“Finish”后，soapUI会被启动。如果不想在安装完成后启动soapUI，请将“1”选项前的“”去掉，然后再单击“Finish”。-结束2.3 启动和关闭soapUI2.3.1 启动soapUI如果是直接从其他PC机上拷贝过来的soapUI，启动方法是：双击soapUI目录下的bin文件夹中的“”。如果是通过执行soapUI的安装文件安装了soapUI，则启动的方法是：选择“开始 程序 so

11、apUI 2.5-beta1 1”。2.3.2 关闭soapUI直接单击soapUI界面右上角的“”关闭soapUI，或者选择“File Exit”退出soapUI。3 soapUI使用方法关于本章本章描述内容如下表所示。标题内容3.1 soapUI基本操作介绍soapUI的基本操作。3.2 soapUI的TestSuite功能介绍soapUI的测试套功能。3.3 soapUI模拟服务端介绍soapUI模拟服务端的方法。3.4 soapUI模拟客户端介绍soapUI模拟客户端的方法。3.1 soapUI基本操作3.1.1 创建工程准备工作创建工程前，请先准备好需要的WSDL文件，将WSDL文件

12、保存在和soapUI同一台PC机上的某个目录下。例如：D:wsdl文件。操作步骤请参考如下操作步骤在soapUI上创建一个工程。步骤 1单击SoapUi的bin目录下的soapui.bat脚本启动SoapUi。步骤 2右键单击左侧导航树中的“Projects”。步骤 3在弹出的快捷菜单中选择“New soapUI Project”，如图3-1所示。图3-1 创建新工程系统弹出“New soapUI Project”对话框，如图3-2所示。图3-2 “New soapUI Project”对话框在“Initial WSDL/WADL”中选择了某个WSDL文件之后，该参数下面的“Create Re

13、quests”、“Create TestSuite”和“Create MockService”会由不可编辑变为可编辑。建议“Create Requests”、“Create TestSuite”和“Create MockService”三个选项都选上。步骤 4在“New soapUI Project”对话框中输入相关信息。“Create Request”是默认必选项。如果仅选择了“Create Request”，则在执行完步骤 5后，工程创建完成。如果选择了“Create Request”和“Create TestSuite”，则需要执行步骤 5和步骤 6。如果选择了“Create Reque

14、st”和“Create MockService”，则需要执行步骤 5和步骤 7。建议“Create Request”、“Create TestSuite”和“Create MockService”都选上，则需要执行步骤 5步骤 7。步骤 5单击“OK”。步骤 6创建测试套。1.在“Generate TestSuite”界面单击“OK”，如图3-3中红色框。图3-1 Generate TestSuite显示如图3-4所示的输入测试套名称对话框。图3-2 Generate TestSuite2.在图3-4所示对话框的文本框中输入测试套的名称，也可保持默认值。3.单击“确定”。系统显示“Genera

15、te MockService”对话框。测试套创建完成。步骤 7创建MockService。创建MockService之后，导入的WSDL中的操作就可以模拟服务端的功能，供客户端调用。1.在弹出的“Generate MockService”界面输入“Path”和“Port”的值，如图3-5所示。图3-1 Generate MockService此处请拷贝“Path”的值，在3中输入MockService名称时需要用到，并请记录“Port”的值，在后续调测时需要用到。PathPath的值应与模拟测试时，在基础信息管理界面上配置的业务信息的“业务开通服务URL”或“能力管控服务URL”的值保持一致，

16、如图3-6所示红色框中的内容。这样VGOP才能将业务请求发到该Path对应模拟的业务平台上。为了避免在基础信息管理界面上配置的“业务开通服务器URL”或“能力管控服务URL”的值超出基础信息管理界面的显示，在填写“Path”的值时，请不要输入太长的字符串。图3-2 URLPortPort为模拟的业务平台的监听端口号，建议保持默认值。该值需要与后面模拟测试时在基础信息管理界面上配置平台信息时的“平台URL”里的端口号保持一致，如图3-7所示红色框中的内容。如果在一个soapUI上模拟多个业务平台时，可以通过修改Port的值来区分不同的业务平台。图3-3 端口号2.在图3-5所示对话框中单击“OK

17、”。显示如图3-8所示对话框。图3-1 Generate MockService3.在图3-8所示对话框的文本框中MockService的名称。请保持该处的名称与图3-5中的“Path”的值保持一致。4.单击“OK”。系统显示创建的MockService包含的操作信息的界面。5.单击右上角的“”关闭MockService操作信息界面。至此，MockService创建完成，同时，需要调测的功能的整个工程也创建完成，可以在左侧导航树中看到创建好的工程，类似图3-9所示。图3-1 创建好的工程-结束3.1.2 编辑消息下面以要编辑“业务订购”工程中的测试套中的subscribeService用例的消

18、息为例，介绍编辑消息的操作步骤。步骤 1单击左侧工程导航栏中的“业务订购”工程前的“”，展开该工程下的类型信息，例如测试套等。步骤 2单击测试套“OrderServiceHttpBinding TestSuite”前的“”，展开测试套下的测试用例。步骤 3单击测试用例“subscribeService TestCase”前的“”，展开测试用例下的测试类型。步骤 4单击“Test Steps”前的“”。步骤 5双击“Test Steps”下的“subscribeService”。右侧显示“subscribeService”的消息“Request1”，如图3-10所示。图3-1 消息体步骤 6在“

19、Request1”中的“？”处删掉“？”，并输入节点的值。-结束3.1.3 修改消息发送地址在图3-10中的上方的“”即是消息发送的地址，即soapUI要将消息发送到的URL地址。要修改发送地址，请参考如下操作。步骤 1单击消息地址栏。地址栏列出如图3-11中的蓝色框的信息。图3-1 地址栏操作步骤 2单击图3-11中的“edit current.”。系统显示如图3-12所示对话框。图3-1 Editendpoint步骤 3在“Edit endpoint”对话框中输入正确的URL地址。如果要发送到的地址和soapUI在同一台PC机上，可以保持“localhost”，如果不在同一台PC机上，请将

20、“localhost”修改为实际需要发送到的IP地址。URL中的端口及端口后的字符串也需要根据实际情况修改。步骤 4修改完毕，单击“确定”。地址栏显示为修改后的URL地址。-结束3.1.4 保存工程保存后的工程的格式为“.xml”格式的文件。保存所有工程如果要一次保存soapUI左侧导航树中的所有工程的话，请直接单击工具栏中的“”。保存所有工程并退出soapUI如果要一次保存soapUI左侧导航树中的所有工程，并且退出soapUI的话，请直接单击工具栏中的“”。保存单个工程要保存单击工程时，请右键单击需要保存的工程的名称，在快捷菜单中选择“Save Project”。如果要保存的工程之前没有执

21、行过保存操作，则系统会弹出对话框，需要选择工程保存的本地文件夹。如果要保存的工程之前已经设置过保存路径，则系统会直接保存，不需要重新设置路径。如果要另存工程，请在快捷菜单中选择“Sava Project As”，在系统弹出的对话框中选择保存的路径，单击“保存”即可。3.1.5 删除工程如果要删除某个工程，请参考如下操作。步骤 1在左侧工程导航栏中右键单击需要删除的工程的名称，例如要删除“测试业务订购”的工程，则右键单击“测试业务订购”。步骤 2在弹出的快捷菜单中选择“Remove”，如图3-13所示。图3-1 Remove系统弹出如图3-14所示对话框。图3-2 Remove Project步

22、骤 3根据需要单击“是”或“否”确认是否保存该工程再从soapUI上删除。如果单击“撤消”，则退出删除工程的操作。-结束3.1.6 导入工程如果要导入之前保存过但已经从soapUI的工程导航栏中删除的工程，请操作如下操作。步骤 1单击工具栏中的“”。也可以右键单击左侧工程导航栏中的“Projects”，在快捷菜单中选择“Import Project”。步骤 2在系统弹出的“Select soapUi Project File”对话框中选择要导入的工程文件（后缀为“.xml”）。步骤 3单击“打开”。系统弹出“Resolve Project”对话框。步骤 4在“Resolve Project”对

23、话框中单击“OK”。系统显示“Select WSDL File”对话框。步骤 5在“Select WSDL File”对话框中选择和导入的工程文件匹配的WSDL文件。步骤 6单击“打开”。导入的工程显示在左侧工程导航栏中。-结束3.2 soapUI的TestSuite功能3.2.1 任务说明soapUI提供的测试套（TestSuite）功能，可以帮助用户测试soapUI与接收地址间的通信、并检查soapUI上的请求消息体是否正确。3.2.2 操作示例下面以业务订购功能中单个业务订购操作（subscribeService）为例，介绍测试套的使用方法。步骤 1参考“3.1.1 创建工程”创建了业务

24、订购的工程。此处假设工程名称为“业务订购”。步骤 2在soapUI左侧的工程栏中选择“业务订购”工程中要执行的测试套下的测试用例“subscribeService TestCase”，如图3-15中蓝色框。图3-1 选择测试套步骤 3展开测试用例下的“Test Steps （1）”，双击其下的“subscribeService”。右侧界面的请求栏中显示subscribeService操作的请求消息，如图3-16所示。请求消息中的各个字段中的“?”表示节点值需要在“？”处填写。图3-1 请求消息步骤 4在图3-16中的请求消息中输入节点值。步骤 5参考“3.1.3 修改消息发送地址”修改消息要发

25、送到的URL地址。步骤 6单击消息发送地址栏前的“”发送消息。在单击“”发送消息前，请先确认省级VGOP的能力管控已经启动成功。消息发送出去之后，在图3-16的右侧的响应消息栏中会显示消息处理结果，如图3-17所示。图3-1 处理结果-结束3.3 soapUI模拟服务端3.3.1 任务说明soapUI模拟服务端时，是供其他接口调用的，并能给调用它的接口提供需要的结果。soapUI模拟服务端主要是MockService功能，因此，如果要模拟服务端，在创建工程时，在“New soapUI Project”对话框中一定要选择“Create MockService”。3.3.2 操作示例下面以能力管控

26、中的单条服务开通功能（syncOrderRelation）为例介绍soapUI模拟服务端的操作方法。步骤 1参考“3.1.1 创建工程”创建“服务开通”工程时，已经选择了“Create MockService”，并已经创建了名称为“/mockOrderRelationService”的MockService。步骤 2在左侧工程导航树中选择“服务开通 /mockOrderRelationService syncOrderRelation”。步骤 3双击“syncOrderRelation”下的“Response1”，如图3-18所示。图3-1 Response1右侧界面的响应消息栏中显示soap

27、UI作为服务端需要返回给调用它的接口的响应消息，如图3-19所示红框。图3-2 响应消息步骤 4在响应消息中的“？”中输入需要返回给调用它的接口的结果值。步骤 5启动MockService。1.右键单击MockService的名称“/mockOrderRelationService”。2.在快捷菜单中选择“Start Minimized”启动MockService，如图3-20所示。如果要停止MockService，请选择“Stop”。图3-1 启动MockService启动后的MockService“/mockOrderRelationService”前的图标变成可运动的，即“”中的绿色会上

28、下移动。至此，服务端设置完毕，当接口调用soapUI模拟的业务平台时，soapUI的请求消息栏会收到调用方发送来的请求消息，soapUI在收到请求消息后，就会将准备好的响应消息发送给调用方，表示soapUI模拟的业务平台已经成功处理了从调用方发送过来的请求消息。-结束3.3.3 查看MockService的Path和Port如果要查看某个MockService的值，请单击MockService的名称，在导航树下方的“MockService Properties”页签中，就会显示该MockService的属性信息，其中的“Path”和“Port”即是需要查看的值，如图3-21所示。图3-1 查看

29、MockService的Path和Port3.4 soapUI模拟客户端3.4.1 任务说明soapUI模拟客户端，即作为soapUI作为消息发送方，将请求消息发送到地址栏中的地址，并接收响应结果。soapUI模拟客户端主要是“Requests”功能，因此，在创建工程时，在“New soapUI Project”对话框中一定要选择“Create Requests”项。3.4.2 操作示例下面以能力管控中的服务开通功能中的单个服务开通结果反馈（syncOrderRelationCfm）操作为例介绍soapUI模拟客户端的操作方法。此处假设“syncOrderRelatinCfm”所属的工程名称为

30、“业务订购”，请求的名称为“OrderServiceHttpBinding”。请求的名称是在创建工程时，系统默认的名称。步骤 1在左侧工程导航树中选择“业务订购 OrderServiceHttpBinding syncOrderRelatinCfm”。步骤 2双击“syncOrderRelatinCfm”下的“Request1”。界面右侧的“Request1”的请求消息栏中显示请求的消息内容，如图3-22所示。图3-1 Request1步骤 3在请求消息栏中填写各个节点的参数值。节点前标识“”表明下面紧邻的节点是可选节点，可以不用填参数值，也可将该节点删除。例如，如下内容中的“”节点的值可以不用填写。? ? com:par