1、 SoapUI使用手冊SoapUI操作手冊制作人：測試團(tuán)隊(duì)制作單位：上海分中心工程管理部 文檔版本號: V1.0 目錄 TOC o 1-3 h z u HYPERLINK l _Toc374704323 第一章 概述 PAGEREF _Toc374704323 h 4 HYPERLINK l _Toc374704324 1.1 編寫目的 PAGEREF _Toc374704324 h 4 HYPERLINK l _Toc374704325 1.2 讀者 PAGEREF _Toc374704325 h 4 HYPERLINK l _Toc374704326 1.3 SoapUI簡介 PAGERE

2、F _Toc374704326 h 4 HYPERLINK l _Toc374704327 第二章 環(huán)境搭建 PAGEREF _Toc374704327 h 5 HYPERLINK l _Toc374704328 2.1 軟件包下載 PAGEREF _Toc374704328 h 5 HYPERLINK l _Toc374704329 2.2 Java環(huán)境配置 PAGEREF _Toc374704329 h 5 HYPERLINK l _Toc374704330 2.3 安裝SoapUI PAGEREF _Toc374704330 h 6 HYPERLINK l _Toc374704331 第

3、三章 SoapUI使用說明 PAGEREF _Toc374704331 h 7 HYPERLINK l _Toc374704332 3.1 SoapUI項(xiàng)目與實(shí)際項(xiàng)目對應(yīng)情況 PAGEREF _Toc374704332 h 7 HYPERLINK l _Toc374704333 3.2 創(chuàng)建SoapUI項(xiàng)目 PAGEREF _Toc374704333 h 8 HYPERLINK l _Toc374704334 3.3 創(chuàng)建服務(wù) PAGEREF _Toc374704334 h 9 HYPERLINK l _Toc374704335 3.4 創(chuàng)建資源 PAGEREF _Toc374704335 h

4、 10 HYPERLINK l _Toc374704336 3.5 創(chuàng)建方法 PAGEREF _Toc374704336 h 12 HYPERLINK l _Toc374704337 3.6 創(chuàng)建TestSuite PAGEREF _Toc374704337 h 13 HYPERLINK l _Toc374704338 3.7 創(chuàng)建TestCase PAGEREF _Toc374704338 h 14 HYPERLINK l _Toc374704339 3.8 創(chuàng)建TestStep PAGEREF _Toc374704339 h 15 HYPERLINK l _Toc374704340 3.9

5、 運(yùn)行測試 PAGEREF _Toc374704340 h 17 HYPERLINK l _Toc374704341 3.9.1 運(yùn)行TestStep PAGEREF _Toc374704341 h 17 HYPERLINK l _Toc374704342 3.9.2 運(yùn)行TestCase PAGEREF _Toc374704342 h 18 HYPERLINK l _Toc374704343 3.9.3 運(yùn)行TestSuite PAGEREF _Toc374704343 h 20 HYPERLINK l _Toc374704344 3.10 發(fā)送報(bào)文（以xml格式為例說明） PAGEREF

6、_Toc374704344 h 21 HYPERLINK l _Toc374704345 3.11 傳遞參數(shù) PAGEREF _Toc374704345 h 21 HYPERLINK l _Toc374704346 3.12 添加Assert PAGEREF _Toc374704346 h 23 HYPERLINK l _Toc374704347 3.13 腳本運(yùn)行自動(dòng)化 PAGEREF _Toc374704347 h 26 HYPERLINK l _Toc374704348 第四章 編寫測試腳本規(guī)范 PAGEREF _Toc374704348 h 27 HYPERLINK l _Toc374

7、704349 4.1 基本說明 PAGEREF _Toc374704349 h 27 HYPERLINK l _Toc374704350 4.2 腳本規(guī)范 PAGEREF _Toc374704350 h 27 HYPERLINK l _Toc374704351 第五章 版本管理 PAGEREF _Toc374704351 h 27 HYPERLINK l _Toc374704352 第六章 SoapUI腳本參數(shù)化 PAGEREF _Toc374704352 h 27 HYPERLINK l _Toc374704353 6.1、基本說明 PAGEREF _Toc374704353 h 27 HY

8、PERLINK l _Toc374704354 6.2 Soap UI參數(shù)化操作 PAGEREF _Toc374704354 h 28 HYPERLINK l _Toc374704355 6.2.1 報(bào)文體的參數(shù)化 PAGEREF _Toc374704355 h 28 HYPERLINK l _Toc374704356 6.2.2 報(bào)文頭的參數(shù)化 PAGEREF _Toc374704356 h 33 HYPERLINK l _Toc374704357 第七章 持續(xù)集成過程 PAGEREF _Toc374704357 h 39 HYPERLINK l _Toc374704358 7.1 MAVE

9、N工程的創(chuàng)建 PAGEREF _Toc374704358 h 39 HYPERLINK l _Toc374704359 7.1.1 新建Maven Project PAGEREF _Toc374704359 h 39 HYPERLINK l _Toc374704360 7.1.2 編譯maven project PAGEREF _Toc374704360 h 44 HYPERLINK l _Toc374704361 7.2 SoapUI與Jenkins集成過程 PAGEREF _Toc374704361 h 46 HYPERLINK l _Toc374704362 A&Q PAGEREF _T

10、oc374704362 h 48 HYPERLINK l _Toc374704363 附錄： PAGEREF _Toc374704363 h 50 HYPERLINK l _Toc374704364 安裝包的組成 PAGEREF _Toc374704364 h 5 HYPERLINK l _Toc374704365 其他有用的信息 PAGEREF _Toc374704365 h 50第一章 概述1.1 編寫目的自動(dòng)化測試是敏捷測試中很重要的一環(huán)，可以讓測試人員以較高的效率實(shí)現(xiàn)回歸測試。此篇文檔詳細(xì)描述了SoapUI的安裝、接口案例的配置、案例版本管理、MAVEN項(xiàng)目的建立，實(shí)現(xiàn)了將SoapUI

11、與Jenkins持續(xù)集成，以及在Jenkins上的構(gòu)建過程。1.2 讀者本文檔適用于使用SoapUI工具進(jìn)行接口測試并實(shí)現(xiàn)持續(xù)集成的人員。1.3 SoapUI簡介由于 Web 服務(wù)是被程序調(diào)用的, 一般不會(huì)提供界面讓最終用戶或測試人 員直接使用,在 SoapUI 等工具出現(xiàn)之前,測試人員不得不自己編寫程序來測試 它, 這就要求測試人員花費(fèi)很大的精力了解底層的接口,調(diào)用關(guān)系和詳細(xì)的協(xié) 議,導(dǎo)致他們不能把注意力集中到測試中。SoapUI 的出現(xiàn)極大的改變了這一局面。作為一個(gè)開源的工具,SoapUI 強(qiáng)大 的功能、易用的界面,吸引了很多用戶。用戶可以在 SoapUI 中通過簡單的操作 完成復(fù)雜的測試

12、,不需要了解底層的細(xì)節(jié), 極大的減輕了工作量。SoapUI 支持 多樣的測試, 例如功能測試,性能測試,回歸測試等。到目前為止 SoapUI 的 下載量已經(jīng)超過了 100 萬次,成為了 Web 服務(wù)測試標(biāo)準(zhǔn)和領(lǐng)先的 Web 服務(wù)測試 工具。它不僅僅可以測試基于SOAP的Web 服務(wù),也可以測試REST風(fēng)格的 Web 服務(wù),后者也是本文介紹的重點(diǎn)。SoapUI是一個(gè)自由和 HYPERLINK /view/394804.htm t _blank 開放源碼的跨平臺(tái) HYPERLINK /view/651435.htm t _blank 功能測試解決方案。通過一個(gè)易于使用的圖形界面和企業(yè)級功能，Soa

13、pUI讓您輕松，快速創(chuàng)建和執(zhí)行自動(dòng)化功能，回歸，合規(guī)和 HYPERLINK /view/651437.htm t _blank 負(fù)載測試。第二章 環(huán)境搭建2.1 軟件包下載SoapUI 基于 Java 開發(fā)，支持多個(gè)平臺(tái),安裝非常簡單。讀者可以到 SoapUI 的官方網(wǎng)站下載一個(gè)安裝包，根據(jù)各自的機(jī)器位數(shù)來選擇相應(yīng)的安裝文件安裝即可。安裝包的組成文件描述來源soapUI-Pro-x32-4.5.2.exe32位安裝包soapUI-Pro-4.5.2-X6464位免安裝版注：若無外網(wǎng)，可在以下FTP上下載安裝包，打開FTP：ftp:/ftptest:ftptest20/，找到路徑“softwar

14、e/通訊接口測試SOAPUI、SOCKET自動(dòng)化/”， 2.2 Java環(huán)境配置由于SoapUI是基于Java開發(fā)的，因此在安裝SoapUI時(shí)需要設(shè)置JAVA_HOME和Path環(huán)境變量。成功安裝JDK1.6（及其以上版本），選擇“我的電腦”，點(diǎn)擊“屬性 |高級系統(tǒng)設(shè)置 | 高級 | 環(huán)境變量 | 系統(tǒng)變量”下點(diǎn)擊“新建”，【變量名】輸入“JAVA_HOME”，【變量值】指向JDK所在的路徑，選中“系統(tǒng)變量”中的“PATH”，點(diǎn)編輯，在變量值的后面添加“PATH”值，如下圖所示。圖2-1 JAVA環(huán)境變量配置步驟（一）圖2-2 JAVA環(huán)境變量配置步驟（二）2.3 安裝SoapUISoapUI

15、的安裝和普通的軟件安裝沒有什么區(qū)別，根據(jù)提示一步一步進(jìn)行就可以安裝成功。配置環(huán)境變量。計(jì)算機(jī)屬性-高級系統(tǒng)設(shè)置-環(huán)境變量-新建圖2-3 設(shè)置環(huán)境變量點(diǎn)擊確定，重啟計(jì)算機(jī)，環(huán)境變量即可生效。第三章 SoapUI使用說明 3.1 SoapUI項(xiàng)目與實(shí)際項(xiàng)目對應(yīng)情況在SoapUI的各種版本里，我們都能深刻地體會(huì)到它所提供的測試用例的管理與我們測試項(xiàng)目所需要的層級的映射關(guān)系是相當(dāng)貼近的，對應(yīng)關(guān)系圖如下：圖3-1 測試用例管理與項(xiàng)目測試層級對應(yīng)關(guān)系SoapUI里著重引入了以下的概念：測試步驟TestStep：測試步驟是最小的單位，一個(gè)完整的測試用例是由多個(gè)測試步驟所組成的，而每一個(gè)測試步驟，都需要根據(jù)實(shí)

16、際的業(yè)務(wù)要求進(jìn)行組織。3.2 創(chuàng)建SoapUI項(xiàng)目步驟一：點(diǎn)擊“File” “New SoapUI Project”，創(chuàng)建一個(gè)新項(xiàng)目。圖3-2 SoapUI項(xiàng)目創(chuàng)建步驟（一）步驟二：填寫項(xiàng)目名稱（TestPoject）和勾選“Stores all file paths in project relatively to project file(requires save)”。圖3-3 SoapUI項(xiàng)目創(chuàng)建步驟（二）步驟三：選擇保存路徑并填寫項(xiàng)目文件名。圖3-4 SoapUI項(xiàng)目創(chuàng)建步驟（三）3.3 創(chuàng)建服務(wù)步驟一：右擊項(xiàng)目名，點(diǎn)“New REST Service”。圖3-5 SoapUI服務(wù)創(chuàng)

17、建步驟（一）步驟二：輸入服務(wù)名稱和 “Service Endpoint”,“Service Endpoint”由部署項(xiàng)目服務(wù)器的IP和端口號組成，例如： HYPERLINK :8080 :8080。 HYPERLINK :8080 :8080/resouse圖3-6 SoapUI服務(wù)創(chuàng)建步驟（二）3.4 創(chuàng)建資源步驟一：右擊服務(wù)名，點(diǎn)擊“New Resource”。圖3-7 SoapUI資源創(chuàng)建步驟（一）步驟二：輸入“Resource Name”，和“ResourcePath” （ResourePath是該資源的訪問路徑）“Parameters”可以在這里設(shè)置也可以在創(chuàng)建完成之后進(jìn)行創(chuàng)建。圖3

18、-8 SoapUI資源創(chuàng)建步驟（二）3.5 創(chuàng)建方法創(chuàng)建好“Resource”后，彈出“New REST Method”對話框。在這里創(chuàng)建方法（接口）。輸入“Method Name”（即接口名），選擇“HTTP Method”，輸入相關(guān)“Parameters”。圖3-9 SoapUI方法創(chuàng)建3.6 創(chuàng)建TestSuite步驟：右擊項(xiàng)目名，點(diǎn)擊“New TestSuite”，在彈出框中輸入TestSuite的名稱。圖3-10 TestSuite創(chuàng)建步驟（一）圖3-11 TestSuite創(chuàng)建步驟（二）3.7 創(chuàng)建TestCase步驟：右擊“TestSuite”名稱，點(diǎn)擊“New TestCase

19、”，在彈出框中輸入TestCase名稱。圖3-12 TestCase創(chuàng)建步驟（一）圖3-13 TestCase創(chuàng)建步驟（二）3.8 創(chuàng)建TestStep在TestCase頁面中點(diǎn)擊“REST”圖標(biāo)，在彈出框中輸入TestStep名稱，然后選擇相應(yīng)Resource下的method（方法（接口）映射。圖3-14 TestStep創(chuàng)建步驟（一）圖3-15 TestStep創(chuàng)建步驟（二）3.9 運(yùn)行測試3.9.1 運(yùn)行TestStep步驟一：點(diǎn)擊左上角運(yùn)行按鈕。圖3-16 TestStep運(yùn)行步驟（一）步驟二：在response區(qū)域出現(xiàn)響應(yīng)的報(bào)應(yīng)表示成功。圖3-17 TestStep運(yùn)行步驟（二）3.

20、9.2 運(yùn)行TestCase步驟：雙擊TestCase，然后點(diǎn)擊綠色的運(yùn)行按鈕圖3-18 TestCase運(yùn)行步驟（一）圖3-19 TestCase運(yùn)行步驟（二）3.9.3 運(yùn)行TestSuite圖3-20 TestSuite運(yùn)行步驟3.10 發(fā)送報(bào)文（以xml格式為例說明）雙擊“TestStep”，在Request區(qū)域中“Media Type”中輸入報(bào)文和“Header”中輸入Header信息。點(diǎn)擊運(yùn)行按鈕在服務(wù)器中得到如下圖信息：圖3-21 SoapUI發(fā)送xml格式報(bào)文示例3.11 傳遞參數(shù)右擊Method（接口）點(diǎn)擊 “Show method viewer Enter”彈出視圖窗體，點(diǎn)

21、擊添加按鈕，彈出對話框，輸入?yún)?shù)名稱，并在視圖窗體中輸入對應(yīng)的參數(shù)值。圖3-22 SoapUI參數(shù)傳遞示例圖3-23 SoapUI參數(shù)傳遞示例3.12 添加AssertAssert采用Groovy腳本編寫，基本語法如示例。圖3-24 SoapUI添加AssertXML報(bào)文的示例如圖3-25。圖3-25 SoapUI添加Assert-XMLJSON格式的報(bào)文添加Assert見圖3-26。圖3-26 SoapUI添加Assert-JSONJson/取得響應(yīng)上下文def holder=net.sf.json.JSONSerializer.toJSON(messageExchange.response

22、Content);/取得響應(yīng)上下文def books=holder.get(books);/采用數(shù)組下標(biāo)遍歷元素并用get鏈?zhǔn)浇Y(jié)構(gòu)獲得子代元素值assert books0.get(book).get(id)=1234;Xmldef holder=newcom.eviware.soapui.support.XmlHolder(messageExchange.responseContentAsXml);/采用Url開式獲得節(jié)點(diǎn)信息并用text方法取值，其中bookid=1234表示book節(jié)點(diǎn)下id值為1234的節(jié)點(diǎn)信息def node =holder.getNodeValue(/bookid=1

23、234/price/text();assert node=29.0;3.13 腳本運(yùn)行自動(dòng)化用SoapUI自帶的testrunner.bat命令可以實(shí)現(xiàn)SoapUI的腳本運(yùn)行自動(dòng)化。具體實(shí)現(xiàn)的方法如下：步驟一：下載并安裝SoapUI-Pro版，只有Pro版本的SoapUI可以通過運(yùn)行testrunner.bat命令來生成詳細(xì)的測試報(bào)告；步驟二：編寫bat批處理文件（linux為shell腳本）調(diào)用restrunner.bat。示例如下：圖3-27 SoapUI批處理文件示例其中“C:Program FilesSmartBearsoapUI-Pro-4.5.2bin”為SoapUI-Pro安裝路

24、徑； “E:SoapTest-soapui-project.xml”為SoapUI project file； “E:soupui_reports”為測試報(bào)告輸出目錄。 testrunner參數(shù)說明： -s指定要運(yùn)行的 TestSuite-f 指定運(yùn)行結(jié)果的輸出目錄-j 生成 junit 風(fēng)格的 report-r 運(yùn)行完成以后打印一個(gè)簡單的 summary testrunner.bat還有其它參數(shù)可以指定，詳細(xì)請查看幫助文檔或google。對于SoapUI來說很多功能可以使用右鍵功能，例如：創(chuàng)建TestStep、TestCase等等其他功能可以在右鍵找到菜單選項(xiàng)。對于Groovy腳本的使用，只

25、要能使用一些常用功能的用法就可以滿足測試要求，對于復(fù)雜的功能可以查找其他的資料進(jìn)行補(bǔ)充。本文檔是針對已經(jīng)部署的服務(wù)進(jìn)行創(chuàng)建的測試項(xiàng)目。第四章 編寫測試腳本規(guī)范4.1 基本說明對測試腳本進(jìn)行規(guī)范化管理對后續(xù)的版本管理及持續(xù)集成有重大意義，本章從全局觀出發(fā)提出測試腳本的基本編寫規(guī)范。4.2 腳本規(guī)范1、接口定義編號名稱與功能統(tǒng)一。在SOAPUI中配置接口信息的時(shí)候需保證編號名稱與接口功能上的統(tǒng)一。2、接口配置與案例配置向分離。在SOAPUI中需先配置接口信息，配置的接口信息應(yīng)包含請求URL、通用報(bào)文頭等基本信息。接口的請求參數(shù)等信息應(yīng)配置在測試案例中。3、合理配置TESTCASE。測試人員需合理利

26、用TESTSUIT，將一個(gè)功能點(diǎn)中的多個(gè)接口請求配置為多個(gè)TESTCASE然后配置至一個(gè)TESTSUIT中。第五章 版本管理創(chuàng)建完一個(gè)SoapUI項(xiàng)目后，會(huì)生成一個(gè)本地的XML腳本文件。當(dāng)有多個(gè)測試人員同時(shí)測試一個(gè)項(xiàng)目時(shí)，那么如何將不同的測試人員的案例腳本有效地進(jìn)行管理和合并便成為一個(gè)亟待解決的問題。在此，我們利用SVN工具來實(shí)現(xiàn)腳本文件的版本管理。測試人員對項(xiàng)目的腳本進(jìn)行編輯前先update下最新的版本，在添加完自己的測試案例后，再將案例commit上去，以避免發(fā)生沖突。第六章 SoapUI腳本參數(shù)化6.1、基本說明Soap UI自動(dòng)化測試中，在接口請求參數(shù)中時(shí)常有一些請求參數(shù)是時(shí)常變化（如

27、隨機(jī)數(shù)，sessionid），這些請求參數(shù)需要根據(jù)其它接口返回消息作為請求參數(shù)實(shí)時(shí)變化,為解決此問題，特研究SOAP UI參數(shù)化。6.2 Soap UI參數(shù)化操作6.2.1 報(bào)文體的參數(shù)化具體的步驟如下：第一步，請求隨機(jī)數(shù)接口獲取返回隨機(jī)數(shù)報(bào)文中的數(shù)據(jù)第二步，新建Property Transfer第三步，在 Property Transfer 中配置參數(shù)傳遞，在Transfers中新建變量，在右邊Source中設(shè)置之前請求的隨機(jī)數(shù)接口名，在Property中設(shè)置ResponseXml。先按照第4步操作在TestSuite中再配置變量，然后在Property Transfer右邊Target處設(shè)

28、置剛配置的TestSuite名，在property處設(shè)置剛設(shè)置的變量名。第四步，在TestSuite-Custom proerties中配置變量第五步，在新接口中把之前幾步取到的變量值放入到請求參數(shù)中，取變量值如下圖所示。Formcookie-Get DataTestSuite變量名第六步，將傳遞過來的值放入到新接口請求報(bào)文中6.2.2 報(bào)文頭的參數(shù)化取請求接口返回報(bào)文Headers中cookie的值,并把取出的cookie賦值給下一個(gè)需要調(diào)用接口的headers中。具體步驟如下：第一步，請求新增用戶授權(quán)接口，獲取返回報(bào)文第二步，新建Groovy Script第三步，在TestCase-Cus

29、tom Properties中設(shè)置變量第四步，在Groovy Script中取headers中的Set-cookie值,并截取字符串，然后放入TestCase Custom Properties 的cookie變量中，代碼如下：/取header中的cookiedef cookie=testRunner.testCase.testStepslogin.testRequest.response.responseHeadersSet-Cookie0/截取字符串formatsCookie=cookie0.37(截取字符串cookie=+formatsCookie)/將變量值寫入cookie中testR

30、unner.testCase.setPropertyValue(cookie,formatsCookie)第五步，在新接口中把之前幾步取到的變量值放入到請求參數(shù)中，取變量值如下圖所示。Formcookie-Get DataTestCase變量名第六步，取cookie變量中的值放入headers中第七章 持續(xù)集成過程自動(dòng)化測試是敏捷測試中很重要的一環(huán)，可以讓測試人員以較高的效率實(shí)現(xiàn)回歸測試。本章實(shí)現(xiàn)了將SoapUI與Jenkins持續(xù)集成，詳細(xì)描述了項(xiàng)目構(gòu)建過程。7.1 MAVEN工程的創(chuàng)建本節(jié)是實(shí)現(xiàn)SoapUI與Jenkins集成前的準(zhǔn)備工作。首先在本地成功創(chuàng)建Maven工程，并且編譯成功后將

31、項(xiàng)目集成到Jenkins上。7.1.1 新建Maven Project打開eclipse-file-new-other，接下來的步驟按照圖6-1圖6-5。圖6-1 maven project 創(chuàng)建（一）圖6-2 maven project 創(chuàng)建（二）圖6-3 maven project 創(chuàng)建（三）圖6-4 maven project 創(chuàng)建（四）圖6-5 maven project 創(chuàng)建（五）7.1.2 編譯maven project在6.3.1節(jié)中我們已經(jīng)成功創(chuàng)建了一個(gè)新的Maven Project，接下來是實(shí)現(xiàn)SoapUI案例腳本的批處理。示例源碼如圖6-6所示：圖6-6 Junit源碼示例第一步，先在項(xiàng)目當(dāng)前目錄下創(chuàng)建一個(gè)prject_xml文件夾，將案例腳本放在該文件夾里；第二步，本地運(yùn)行maven install；圖6-7 Maven Inst