jmeter使用文檔-接口測試

Jmeter使用簡明文檔王東輝2015.6之

接口測試目錄前期準(zhǔn)備TestPlanThreadGroupSampler-HTTPRequestAssertionsListenerConfigElementPreProcessorPostProcessor前期準(zhǔn)備Jmeter

是一款使用Java開發(fā)的，開源免費的測試工具，主要用來做功能測試和性能測試〔壓力測試/負(fù)載測試〕，而且用Jmeter來測試RestfulAPI,非常好用。下載jmeter官網(wǎng)地址：://Jmeter啟動下載jmeter后解壓，運行bin目錄下的jmeter.bat即可啟動jmeter非GUI模式啟動:jmeter-n-ttest.jmx-llogfile1.jtlant執(zhí)行測試，extras目錄下有build.xml(先配置好ant環(huán)境)圖形界面啟動Jmeter后，點擊Options->ChooseLanguage

來選擇語言，支持中文需要jdk1.6以上AnExample此處需要演示Example.jmx一個簡單測試包含的根本元件:Testplan(測試方案)->ThreadGroup〔線程組〕->Sampler〔取樣器〕->Assertions〔斷言〕和Listener〔監(jiān)聽器〕初步印象：一個測試方案下，可以創(chuàng)立多個線程組〔分組配置測試執(zhí)行規(guī)那么〕；線程組下的每個sampler+斷言組成用例，測試時監(jiān)聽器統(tǒng)計輸出測試結(jié)果。TestPlanName：測試方案名字Comments：關(guān)于該測試方案的注釋UserDefinedVariables：可以定義整個測試中使用的重復(fù)值，如效勞器名稱。如果相同的變量名重復(fù)賦值，該值被設(shè)置為在測試方案〔讀從上到下〕的最后一個定義。需要注意的是測試方案不能引用它定義的變量。如果需要從測試方案變量構(gòu)建其他變量，使用配置元件。其他地方引用變量用${var_name}RunThreadGroupsconsecutively：勾選后，普通線程組之間按上下排列順序執(zhí)行，而非默認(rèn)的并行。RuntearDownThreadGroupsaftershutdownofmainthreads：如果選中，tearDown線程組將在主線程正常關(guān)閉后〔StopTest〕運行。如果測試被強制停止〔StopTestNow〕tearDown線程將不會被運行。函數(shù)測試模式：在非GUI模式下運行時，-l標(biāo)志創(chuàng)立的日志文件。此選項勾選后，日志文件默認(rèn)寫入更多的數(shù)據(jù)字段如完整響應(yīng)數(shù)據(jù)，影響性能。添加classpath：類路徑設(shè)置，可以添加jar文件或目錄到特定的測試方案?！卷氈匦聠覬Meter】可以直接把jar包放到j(luò)meter的lib目錄〔默認(rèn)的classpath〕ThreadGroupName：線程組名字Comments：關(guān)于該線程組的注釋ActiontobetakenafteraSamplererror:遇到sampler出現(xiàn)errorContinue：忽略，繼續(xù)運行測試StartNextThreadLoop：忽略錯誤，開始下一個循環(huán)〔Loopcount〕，并繼續(xù)進行測試StopThread：退出當(dāng)前線程組，繼續(xù)其他測試StopTest：整個測試在當(dāng)前所有運行sampler結(jié)束后停止StoptestNow：立即停止測試，正在運行的sampler也中斷Numberofthreads：線程數(shù)Ramp-UpPeriod：多久后需啟動所有線程〔如100s，共10個線程，那么每個線程在前一個線程開始后10s開始〕Loopcount:重復(fù)執(zhí)行次數(shù)，forever(調(diào)度器停止或error終止測試)DelayThreadcreationuntilneeded:延遲線程創(chuàng)立，直到需要(如10s啟動共10個線程，那么確保每隔1s時創(chuàng)立一個，如果不選擇該項，測試開始時默認(rèn)創(chuàng)立所有線程，只是未到開始時間的線程會暫停)。Scheduler：調(diào)度器測試開始時間〔啟動測試時檢查是否到達開始時間〕結(jié)束時間〔如果到達結(jié)束時間，測試終止〕測試持續(xù)時間〔設(shè)置后，忽略結(jié)束時間，次序X秒后停止測試〕延遲開始〔設(shè)置后，忽略開始時間，X秒后開始測試〕StopTest和StopTestNow對teardown線程組影響情況1:Test在準(zhǔn)備階段就出錯了，即SetupThreadGroup運行時出錯。這時如果發(fā)生"StopTest"或者"StopTestNow",TeardownThreadGroup不會被執(zhí)行。情況2:Test已經(jīng)開始執(zhí)行,在ThreadGroup中發(fā)生了錯誤?！癝topTestNow”發(fā)生,那么這后所有的TeardownThreadGroups不會運行?！癝topTest"發(fā)生,那么TeardownThreadGroups執(zhí)行條件依賴于TestPlan的配置"RuntearDownThreadGroupsaftershutdownofmainthreads"。如果Enable此設(shè)置，那么TeardownThreadGroups會被執(zhí)行。線程組分類在JMeter

中有3種ThreadGroup,一個Test

中可以包含多個同類型的ThreadGroupThreadGroup：標(biāo)準(zhǔn)線程組SetupThreadGroup：在Test

開始先被執(zhí)行的ThreadGroup(方便用戶做Testing

的初始化)TeardownThreadGroup：在所有其它類型的ThreadGroup結(jié)束后執(zhí)行的ThreadGroup(方便做cleanup

的工作)Tips-1Name：取樣器名字Comments：取樣器注釋W(xué)ebserver:分別是效勞器地址、端口；以及連接和響應(yīng)的超時時間設(shè)置。Implementation:請求實現(xiàn)方法，下拉選擇項client3.1、client4、java、空，當(dāng)該項為空時取perties中

jmeter.sampler設(shè)置值，如果perties也沒設(shè)置,那么默認(rèn)為client4。Protocol：HTTP,HTTPSorFILE.Default:HTTP。Method：HTTP請求方法，常見的是GET和POST。Contentencoding:請求內(nèi)容編碼〔用于設(shè)置POST，PUT，F(xiàn)ILE方法等發(fā)送的內(nèi)容使用編碼〕，響應(yīng)讀取時使用的內(nèi)容編碼設(shè)置是在perties中的項，默認(rèn)為ISO-8859-1。Path：url路徑〔不包括效勞器、端口〕。特例：如果路徑以”://”或“s://”開頭，即視為完整的URL，這時設(shè)置的效勞器、端口和協(xié)議字段被忽略;并且此時如果選擇的是GET和DELETE方法時，parameters設(shè)置也會被忽略。Sampler〔取樣器〕模擬各種請求，如：HTTPRequest、FtpRequest、JDBCRequest等等。Jmeter中所有實際的測試任務(wù)都由Sampler承擔(dān)，包括向效勞器發(fā)送請求，記錄效勞器的響應(yīng)數(shù)據(jù)和時間信息等結(jié)果信息。Sampler〔HTTPRequest〕-1RedirectAutomatically/FollowRedirects:選擇時兩項互斥，當(dāng)發(fā)送HTTP請求后得到的響應(yīng)是302/301重定向時，JMeter

自動重定向到新的頁面。RedirectAutomatically只記錄最后跳轉(zhuǎn)請求，會喪失初始請求上的header、cookie信息。FollowRedirects記錄整個過程，過程請求為sub-sampler。UseKeepAlive:請求頭信息Connection:keep-alive，是否保持連接。Usemultipart/form-dataforPOST:當(dāng)發(fā)送HTTP

POST

請求時，使用Content-Type:multipart/form-data〔默認(rèn)為application/x-www-form-urlencoded〕發(fā)送，默認(rèn)不選中〔上傳文件時使用〕。Browser-compatibleheaders:當(dāng)使用multipart/form-data，請求頭Content-Type、Content-Transfer-Encoding被忽略；Parameters:設(shè)置url請求參數(shù)Encode?:是否urlencode，參數(shù)有“=”、“&”、“？”等特殊符號時一定要選擇。IncludeEquals?:自動添加參數(shù)名和值之間的等號。Bodydata:設(shè)置post消息體SendFiles:發(fā)送文件相關(guān)設(shè)置ProxyServer:代理相關(guān)設(shè)置RetrieveAllEmbeddedResourcesfromHTMLFiles:當(dāng)該選項被選中時，jmeter在發(fā)出HTTP請求并獲得響應(yīng)的HTML文件內(nèi)容后，還對該HTML進行分析并獲取HTML中包含的所有資源〔圖片、flash等〕，默認(rèn)不選中Useconcurrentpool.size:發(fā)送資源請求時使用并發(fā)連接，并設(shè)定并發(fā)連接數(shù)EmbeddedURLsmustmatch:使用正那么表達式過濾特定頁面,如://wap\read\/.*Sourceaddresstype/Sourceaddressfield:模擬請求發(fā)起的ip地址〔可參數(shù)化〕Useasmonitor:在MonitorResults里查看效勞器性能數(shù)據(jù)(tomcat5以上，://07:9098/manager/status)SaveresponseasMD5hash:響應(yīng)保存為32位的MD5加密字符Sampler〔HTTPRequest〕-2PatternMatchingRules:Contains，matches:正那么表達式匹配局部和全部。如(注意轉(zhuǎn)義)： <\?xmlversion="1.0"encoding="UTF-8"\?> <Response> <totalCount>.*</totalCount> </Response>Equals,Substring:純文本，區(qū)分大小寫。Not:取反Applyto:mainsampleonly,sub-sampleonly,mainsampleandsubsample,jmetervariable一般勾選“mainsampleonly”就足夠了，因為我們一個請求，實質(zhì)上只有一個請求。但是當(dāng)我們發(fā)一個請求時，可以觸發(fā)多個效勞器請求，如ajax，抑或是重定向的請求〔勾選了“跟隨重定向”〕那么就有mainsample

和sub-sample之分了。JmeterVariable:比較自定義變量值。ResponseFieldtoTest:TextResponse:效勞器響應(yīng)文本〔不包括頭信息〕，一般普通響應(yīng)，都勾選這個。Document(Text):一切ApacheTika的支持效勞器響應(yīng)，包括文本響應(yīng)，還支持PDF,Office,Audio,Videoformats。jmeter會用ApacheTika去解析效勞器響應(yīng)內(nèi)容，會很耗內(nèi)存，而且也很容易解析失敗。所以一般普通請求，不要選擇這個。URLSampled:是對sample的url進行斷言。如果請求沒有重定向〔302〕，那么就是這個就是請求url。如果有重定向〔且跟隨重定向〕，那么url就包含請求url和重定向url〔mainsampleandsubsample〕AssertionsJmeter提供了很多種斷言，經(jīng)常使用的是響應(yīng)斷言〔ResponseAssertion〕。ResponseFieldTest:Responsecode:響應(yīng)代碼，如101,200,302,404,501等。但當(dāng)我們要驗證4xxand5xx

等響應(yīng)代碼時，需要勾選“Ignorestatus”。因為當(dāng)響應(yīng)代碼為400,500時，jmeter默認(rèn)這個請求失敗。ResponseMessage:響應(yīng)代碼對應(yīng)的響應(yīng)信息，例如下面的：OK,FoundHTTP/1.1200OkHTTP/1.1302FoundResponseHeader:響應(yīng)頭信息Writeresulttofile/Readfromfile:保存結(jié)果到文件Filename:選擇本地文件LogDisplayOnly:根據(jù)結(jié)果是否成功，篩選后顯示和記錄Configure:配置需要保存到結(jié)果的內(nèi)容〔勾選項〕Sampler顯示區(qū):響應(yīng)數(shù)據(jù)默認(rèn)以Text顯示，還可以選擇Html等進行渲染；其中RegExpTester可以測試正那么表達式。Scrollautomatically:自動滾動到最后一個結(jié)果顯示區(qū):Samplerresult:ThreadName:線程組名稱、SampleStart:啟動開始時間Loadtime:加載時長、Latency:

等待時長Sizeinbytes:發(fā)送的數(shù)據(jù)總大小、Headerssizeinbytes:發(fā)送頭大小、Bodysizeinbytes:發(fā)送數(shù)據(jù)的其余局部大小SampleCount:發(fā)送統(tǒng)計、ErrorCount:錯誤統(tǒng)計Responsecode:返回碼、Responsemessage:返回信息、Responseheaders:返回的頭部信息Request:發(fā)送的請求信息Responsedata:響應(yīng)的內(nèi)容AssertionResult:查看斷言結(jié)果〔點擊各個sampler下的斷言列表時顯示〕Listener〔ViewResultsTree〕Jmeter提供了多種監(jiān)聽器。查看結(jié)果樹一般不在進行負(fù)載測試期間使用，因為它占用了大量的資源〔內(nèi)存和CPU〕。但做功能測試或在測試方案的調(diào)試和驗證階段使用它很好用?！财渌鸏istener:AggregateReport、ViewResultsinTable〕TEXT下結(jié)果查詢區(qū):忽略大小寫/正那么查詢Name:變量名Value:變量值Description:變量描述Tips:無論放哪里作用域整個測試方案下，所有線程組會產(chǎn)生可變結(jié)果的函數(shù)取設(shè)置值時無效，只有第一次產(chǎn)生的結(jié)果會保存一般建議放在線程組的開始UserDefinedVariable元件中的變量，經(jīng)過重新賦值后,值只影響該線程后續(xù)操作，不影響其他線程只有TestPlan和位置放在更前面的UserDefinedVariable中的變量可以被當(dāng)前UserDefinedVariable引用TestPlan中的變量最先初始化，不能引用其他元件定義的變量的，這點是區(qū)別。ConfigElement〔UserDefinedVariable〕ConfigElement(配置元件)中的UserDefinedVariable，顧名思義是用于定義自定義變量的。Filename:在當(dāng)前測試方案下的相對路徑或絕對路徑Fileencoding:讀取文件時用的編碼VariableNames:如果變量名稱字段為空，那么該文件的第一行被讀取并解釋為列名的列表。該名稱必須用分隔符分隔。他們可以使用雙引號標(biāo)注。多個變量名對應(yīng)文件中多個列?？梢允褂秒p引號Delimiter:文件內(nèi)的分隔符，如果某行的列少于VariableNames變量數(shù)，剩下的變量會保持原值。Allowquoteddata?:啟用后，和VariableNames一樣，文件中可以用雙引號標(biāo)注，如“111,222”，這樣就可以在值里面有分隔符。RecycleonEOF:到達文件末尾后是否從頭讀取。StopthreadonEOF:到達文件末尾后是否停止線程。Sharingmode:設(shè)置線程間是否共享Allthreads〔默認(rèn)值〕:所有線程之間共享,只翻開一次文件。Currentthreadgroup:同一個線程組，只翻開一次文件，Currentthread:每個線程，文件分別翻開一次〔第一行讀取〕Edit:可以手動輸入Currentthread等，用于變量化ConfigElement〔CSVDataSetConfig〕ConfigElement(配置元件)中的CSVDataSetConfig，可以使用CSV文件來參數(shù)化變量VariableName:數(shù)據(jù)庫連接池名，供其他元件如JDBCsampler使用，不同數(shù)據(jù)庫連接該名字不能相同。ConnectionPoolConfiguration:一般默認(rèn)就行MaxNumberofconnection:連接池最大連接數(shù)，設(shè)置為0，那么線程間不共享，每個線程會重新取連接。小于線程數(shù)〔非0〕，線程會等待。PoolTimeout:試圖獲得數(shù)據(jù)庫連接時的超時時間IdeCleanupinterval:連接池多久未使用，回收時間AutoCommit:是否自動提交〔更新數(shù)據(jù)的操作，是否需要commit〕TransactionIsolation:事務(wù)隔離級別設(shè)置〔未commit的數(shù)據(jù)是否允許其他事務(wù)讀取操作等等〕ConnectionvalidationbyPool:Keep-Alive:是否保持連接，只有Ture的時候下面2個選項生效。MaxConnectionage:連接多長時間未使用后，將測試一次連接有效。ValidationQuery:簡單的查詢來確定數(shù)據(jù)庫仍然響應(yīng)。DatabaseConnectionConfiguration:DatabaseURL:數(shù)據(jù)庫連接url，不同數(shù)據(jù)庫寫法不同。JDBCDriverclass:JDBC驅(qū)動類，不同數(shù)據(jù)庫寫法不同。Usename/Password:用戶名/密碼。ConfigElement〔JDBCConnectionConfiguration〕ConfigElement(配置元件)中的JDBCConnectionConfiguration，管理數(shù)據(jù)庫連接?！残枰约簠⒓覬DBC驅(qū)動jar包〕DBDriverclassDatabaseURLMySQLcom.mysql.jdbc.Driverjdbc:mysql://host[:port]/dbnameOracleoracle.jdbc.OracleDriverjdbc:oracle:thin:@//host:port/service

jdbc:oracle:thin:@(description=(address=(host={mc-name})(protocol=tcp)(port={port-no}))(connect_data=(sid={sid})))UpdateoncePerIteration:如變量值使用函數(shù)，比方random函數(shù)進行參數(shù)化，勾選這個選項后，會檢查確保每次迭代〔比方使用循環(huán)控制器〕更新變量值，不勾選的話不會保證相近兩次的值不同。Parameters:Name:變量名User_1….user3:值列表變量引用方法:${username}、${password}Tips:值列表只在不同線程間迭代，一個線程里使用循環(huán)控制器屢次執(zhí)行sampler的話，取的是同一組值(CSVDataSetConfig相同)如果值使用了函數(shù)，那么一個線程里的循環(huán)控制器，每次函數(shù)會迭代執(zhí)行。PreProcessor(UserParameters)UserParameters前置處理器用于設(shè)置用戶變量和小范圍的參數(shù)化。有區(qū)別于測試方案中設(shè)置的變量：作用于當(dāng)前線程組，其他線程組不起作用。測試方案設(shè)置的作用于整個測試方案?？缮倭繀?shù)化，大量參數(shù)建議用CSVDataSetConfig。設(shè)置值列表后一個線程更新一次，線程數(shù)多于值列表后重復(fù)使用。VariableName:JDBCConnectionConfiguration配置元件中設(shè)置的VariableNameSQLQUERY:QueryType:設(shè)置statementtype，SelectStatement/Updatestatement…Query:待執(zhí)行SQL語句,最普通的兩種select*fromtablenamewhereid=1select*fromtablenamewhereid=?(結(jié)合下面的Parametervalues和Parametertypes，？用指定的參數(shù)代入，

此時QueryType選擇PreparedXXX)Parametervalues:用于替換SQL語句中占位符？〔逗號分隔〕。Parametertypes:對應(yīng)參數(shù)數(shù)據(jù)庫中的類型，INTEGER，VARCHAR，….VariableNames:調(diào)用數(shù)據(jù)庫存儲過程〔CallableStatement

〕執(zhí)行后，output參數(shù)列表，保存到變量名列表〔逗號〕，多于變量列表忽略。ResultVariableName:保存SQL執(zhí)行結(jié)果，每一行結(jié)果是一個包含列名的map，如要取查詢第一行的某個字段使用方法如下columnValue=vars.getObject("resultObject").get(0).get("ColumnName");HandleResultSet:定義數(shù)據(jù)庫存儲過程〔CallableStatement

〕執(zhí)行結(jié)果如何保存StoreasString:保存為String，不能迭代StoreasObject:保存為對象，可以迭代CountRecords:結(jié)果條數(shù)PreProcessor(JDBCPreProcessor)JDBC

前置處理器，可以運行一些SQL語句在Sampler運行之前。適用于一些測試數(shù)據(jù)，需要從數(shù)據(jù)庫獲取的場景。Tips:JDBCPostProcessor〔后置處理器〕與JDBCPreProcessor類似，只是運行次序在Sampler運行之后?？梢郧謇頊y試后的數(shù)據(jù)ResetInterpreterbeforeeachcall:默認(rèn)為false，每一個BeanShell測試元件都有獨立的解釋器備份〔針對每個線程〕。如果測試元件被重復(fù)調(diào)用，例如，被放在循環(huán)之中，那么在屢次調(diào)用間解釋器將被保存。一些長期運行的測試可能導(dǎo)致解釋器使用很多內(nèi)存；如果遇到這種情況，請嘗試使用Reset選項。Parameters:往beanshell傳參，在beanshell中引用時，“Parameters”表示整個入?yún)ⅲ蚴莃sh.args[]數(shù)組下標(biāo)引用，用空格分隔。Scriptfile:指定運行包含BeanShell的腳本文件Script:一些內(nèi)置變量:log(Logger):記日志,(“調(diào)試信息…”);ctx(JMeterContext):vars(JMeterVariables):讀寫變量,vars.get(key);vars.put(key,val);vars.putObject("OBJ1",newObject());props(JMeterProperties-classjava.util.Properties):讀取perties配置屬性或臨時設(shè)置屬性供其他線程傳遞使用〔線程間共享〕，props.get("START.HMS");props.put("PROP1","1234");prev(SampleResult):響應(yīng)信息

(prev.setDataType(“text”))；sStringres=

prev.getResponseDataAsString();sampler(Sampler):Javadoc：PreProcessor(BeanShellPreProcessor)BeanShell是面向Java的腳本語言，因此如果你想在完全不會BeanShell的前提下使用他，那么直接編寫Javacode就可以RegularExpressionReferenceName:對應(yīng)RegularExpressionExtractor(正那么表達式提取器)的Reference

NameParameternamesregexpgroupnumber:正那么表達式中，作為變量名的提取位置Parametervaluesregexgroupnumber:正那么表達式中，作為變量值的提取位置Example:正那么表達式提取器的正那么表達式：inputname="([^"]+?)"value="([^"]+?)"Parameternamesregexpgroupnumber輸入1，提取第一個括號內(nèi)正那么匹配的內(nèi)容作為變量名Parametervaluesregexpgroupnumber輸入2，提取第一個括號內(nèi)正那么匹配的內(nèi)容作為變量值如變量名提取到的為username，其他元件可以以${username}引用Tips:與正那么表達式提取器一起使用PreProcessor(RegExUserParameters)RegExUserParameters作為前置處理器，允許從上一個HTTP請求的后置處理器RegularExpressionExtractor〔正那么表達式提取器〕結(jié)果中提取值構(gòu)造參數(shù)。正那么表達式用戶參數(shù)是作用域是單個線程。Applyto:適用對象，參考ResponseAssertion中的ApplytoResponseFieldtocheck:參考ResponseAssertion中的ResponseFieldtoTestBody(unescaped)，不轉(zhuǎn)義。響應(yīng)的html已經(jīng)轉(zhuǎn)義的字符回到轉(zhuǎn)義前，耗性能ReferenceName:正那么表達式提取值保存的變量名，可以被RegExUserParameters引用[refname]_g1，表示RegularExpression第一組()內(nèi)的內(nèi)容，[refname]_g0表示全部組()內(nèi)的內(nèi)容，如果RegularExpression有()時，${refname_g0}和${refnamer}不相等。RegularExpression:正那么表達式來解析響應(yīng)數(shù)據(jù)。必須包含至少一組括號“()”捕捉字符串的一局部Template使用$0$時，可以沒有括號，因為這時提取整個正那么表達式匹配的內(nèi)容。此時${refname_g0}和${refnamer}相等。Template:$1$指第一個()中內(nèi)容，$2$指第二個()中內(nèi)容…$0$指整個表達式匹配內(nèi)容。MatchNo.(0forRandom):指定第幾處匹配正那么表達式的內(nèi)容作為提取對象，0表示隨機，-1表示全部DefaultValue:無匹配時的默認(rèn)值PostProcessor(RegularExpressionExtractor)RegularExpressionExtractor作為后置處理器，允許從HTTP響應(yīng)或特定參數(shù)中根據(jù)正那么表達式提取內(nèi)容。

元件作用