jmeter使用文檔-接口測試

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

接口測試目錄前期準備TestPlanThreadGroupSampler-HTTPRequestAssertionsListenerConfigElementPreProcessorPostProcessor前期準備Jmeter

是一款使用Java開發(fā)的，開源免費的測試工具，主要用來做功能測試和性能測試（壓力測試/負載測試），而且用Jmeter

來測試RestfulAPI,非常好用。下載jmeter官網(wǎng)地址：http:///download_jmeter.cgiJmeter啟動下載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：關于該測試計劃的注釋UserDefinedVariables：可以定義整個測試中使用的重復值，如服務器名稱。如果相同的變量名重復賦值，該值被設置為在測試計劃（讀從上到下）的最后一個定義。需要注意的是測試計劃不能引用它定義的變量。如果需要從測試計劃變量構建其他變量，使用配置元件。其他地方引用變量用${var_name}RunThreadGroupsconsecutively：勾選后，普通線程組之間按上下排列順序執(zhí)行，而非默認的并行。RuntearDownThreadGroupsaftershutdownofmainthreads：如果選中，tearDown線程組將在主線程正常關閉后（StopTest）運行。如果測試被強制停止（StopTestNow）tearDown線程將不會被運行。函數(shù)測試模式：在非GUI模式下運行時，-l標志創(chuàng)建的日志文件。此選項勾選后，日志文件默認寫入更多的數(shù)據(jù)字段如完整響應數(shù)據(jù)，影響性能。添加classpath：類路徑設置，可以添加jar文件或目錄到特定的測試計劃?！卷氈匦聠覬Meter】可以直接把jar包放到jmeter的lib目錄（默認的classpath

）ThreadGroupName：線程組名字Comments：關于該線程組的注釋ActiontobetakenafteraSamplererror:遇到sampler出現(xiàn)errorContinue：忽略，繼續(xù)運行測試StartNextThreadLoop：忽略錯誤，開始下一個循環(huán)（Loopcount），并繼續(xù)進行測試StopThread：退出當前線程組，繼續(xù)其他測試StopTest：整個測試在當前所有運行sampler結(jié)束后停止StoptestNow：立即停止測試，正在運行的sampler也中斷Numberofthreads：線程數(shù)Ramp-UpPeriod：多久后需啟動所有線程（如100s，共10個線程，則每個線程在前一個線程開始后10s開始）Loopcount:重復執(zhí)行次數(shù)，forever(調(diào)度器停止或error終止測試)DelayThreadcreationuntilneeded:延遲線程創(chuàng)建，直到需要(如10s啟動共10個線程，則確保每隔1s時創(chuàng)建一個，如果不選擇該項，測試開始時默認創(chuàng)建所有線程，只是未到開始時間的線程會暫停)。Scheduler：調(diào)度器測試開始時間（啟動測試時檢查是否到達開始時間）結(jié)束時間（如果到達結(jié)束時間，測試終止）測試持續(xù)時間（設置后，忽略結(jié)束時間，次序X秒后停止測試）延遲開始（設置后，忽略開始時間，X秒后開始測試）StopTest和StopTestNow對teardown線程組影響情況1:Test

在準備階段就出錯了，即SetupThreadGroup運行時出錯。這時如果發(fā)生"StopTest"或者"StopTestNow",TeardownThreadGroup不會被執(zhí)行。情況2:Test

已經(jīng)開始執(zhí)行,在ThreadGroup中發(fā)生了錯誤?！癝topTestNow”發(fā)生,則這后所有的TeardownThreadGroups不會運行?！癝topTest"發(fā)生,則TeardownThreadGroups執(zhí)行條件依賴于TestPlan的配置"RuntearDownThreadGroupsaftershutdownofmainthreads"。如果Enable

此設置，則TeardownThreadGroups會被執(zhí)行。線程組分類在JMeter

中有3種ThreadGroup,一個Test

中可以包含多個同類型的ThreadGroupThreadGroup：標準線程組SetupThreadGroup：在Test

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

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

的工作)Tips-1Name：取樣器名字Comments：取樣器注釋Webserver:分別是服務器地址、端口；以及連接和響應的超時時間設置。Implementation:http請求實現(xiàn)方法，下拉選擇項httpclient3.1、httpclient4、java、空，當該項為空時取perties中

jmeter.httpsampler設置值，如果perties也沒設置,則默認為httpclient4。Protocol：HTTP,HTTPSorFILE.Default:HTTP。Method：HTTP請求方法，常見的是GET和POST。Contentencoding:請求內(nèi)容編碼（用于設置POST，PUT，F(xiàn)ILE方法等發(fā)送的內(nèi)容使用編碼），響應讀取時使用的內(nèi)容編碼設置是在perties

中的sampleresult.default.encoding項，默認為ISO-8859-1。Path：url路徑（不包括服務器、端口）。特例：如果路徑以”http://”或“https://”開頭，即視為完整的URL，這時設置的服務器、端口和協(xié)議字段被忽略;并且此時如果選擇的是GET和DELETE方法時，parameters設置也會被忽略。Sampler（取樣器）模擬各種請求，如：HTTPRequest、Ftp

Request、JDBCRequest等等。

Jmeter中所有實際的測試任務都由Sampler承擔，包括向服務器發(fā)送請求，記錄服務器的響應數(shù)據(jù)和時間信息等結(jié)果信息。Sampler（HTTPRequest）-1RedirectAutomatically/FollowRedirects:選擇時兩項互斥，當發(fā)送HTTP請求后得到的響應是302/301重定向時，JMeter

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

POST

請求時，使用Content-Type:multipart/form-data（默認為application/x-www-form-urlencoded）發(fā)送，默認不選中（上傳文件時使用）。Browser-compatibleheaders:當使用multipart/form-data，請求頭Content-Type、Content-Transfer-Encoding被忽略；Parameters:設置url請求參數(shù)Encode?:是否urlencode，參數(shù)有“=”、“&”、“？”等特殊符號時一定要選擇。IncludeEquals?:自動添加參數(shù)名和值之間的等號。Bodydata:設置post消息體SendFiles:發(fā)送文件相關設置ProxyServer:代理相關設置RetrieveAllEmbeddedResourcesfromHTMLFiles:當該選項被選中時，jmeter在發(fā)出HTTP請求并獲得響應的HTML文件內(nèi)容后，還對該HTML進行分析并獲取HTML中包含的所有資源（圖片、flash等），默認不選中Useconcurrentpool.size:發(fā)送資源請求時使用并發(fā)連接，并設定并發(fā)連接數(shù)EmbeddedURLsmustmatch:使用正則表達式過濾特定頁面,如http://wap\.cmread\.com/.*Sourceaddresstype/Sourceaddressfield:模擬請求發(fā)起的ip地址（可參數(shù)化）Useasmonitor:在MonitorResults里查看服務器性能數(shù)據(jù)(tomcat5以上，http://07:9098/manager/status)SaveresponseasMD5hash:響應保存為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ì)上只有一個請求。但是當我們發(fā)一個請求時，可以觸發(fā)多個服務器請求，如ajax，抑或是重定向的請求（勾選了“跟隨重定向”）那么就有mainsample

和sub-sample之分了。JmeterVariable:比較自定義變量值。ResponseFieldtoTest:TextResponse:服務器響應文本（不包括頭信息），一般普通http響應，都勾選這個。Document(Text):一切ApacheTika的支持服務器響應，包括文本響應，還支持PDF,Office,Audio,Videoformats。jmeter會用ApacheTika去解析服務器響應內(nèi)容，會很耗內(nèi)存，而且也很容易解析失敗。所以一般普通http請求，不要選擇這個。URLSampled:是對sample的url進行斷言。如果請求沒有重定向（302），那么就是這個就是請求url。如果有重定向（且跟隨重定向），那么url就包含請求url

和重定向url（mainsampleandsubsample）AssertionsJmeter提供了很多種斷言，經(jīng)常使用的是響應斷言（ResponseAssertion）。ResponseFieldTest:Responsecode:http響應代碼，如101,200,302,404,501等。但當我們

要驗證4xxand5xx

等http響應代碼時，需要勾選“Ignorestatus”。因為當http

響應代碼為400,500時，jmeter默認這個請求失敗。ResponseMessage:http響應代碼對應的響應信息，例如下面的：OK,FoundHTTP/1.1200OkHTTP/1.1302FoundResponseHeader:響應頭信息Writeresulttofile/Readfromfile:保存結(jié)果到文件Filename:選擇本地文件LogDisplayOnly:根據(jù)結(jié)果是否成功，篩選后顯示和記錄Configure:配置需要保存到結(jié)果的內(nèi)容（勾選項）Sampler顯示區(qū):響應數(shù)據(jù)默認以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:響應的內(nèi)容AssertionResult:查看斷言結(jié)果（點擊各個sampler下的斷言列表時顯示）Listener（ViewResultsTree）Jmeter提供了多種監(jiān)聽器。查看結(jié)果樹一般不在進行負載測試期間使用，因為它占用了大量的資源（內(nèi)存和CPU）。但做功能測試或在測試計劃的調(diào)試和驗證階段使用它很好用。（其他Listener:AggregateReport、ViewResultsinTable）TEXT下結(jié)果查詢區(qū):忽略大小寫/正則查詢Name:變量名Value:

變量值Description:變量描述Tips:無論放哪里作用域整個測試計劃下，所有線程組會產(chǎn)生可變結(jié)果的函數(shù)取設置值時無效，只有第一次產(chǎn)生的結(jié)果會保存一般建議放在線程組的開始UserDefinedVariable元件中的變量，經(jīng)過重新賦值后,值只影響該線程后續(xù)操作，不影響其他線程只有TestPlan和位置放在更前面的UserDefinedVariable中的變量可以被當前UserDefinedVariable引用TestPlan中的變量最先初始化，不能引用其他元件定義的變量的，這點是區(qū)別。ConfigElement（UserDefinedVariable）ConfigElement(配置元件)中的UserDefinedVariable，顧名思義是用于定義自定義變量的。Filename:在當前測試計劃下的相對路徑或絕對路徑Fileencoding:

讀取文件時用的編碼VariableNames:如果變量名稱字段為空，則該文件的第一行被讀取并解釋為列名的列表。該名稱必須用分隔符分隔。他們可以使用雙引號標注。多個變量名對應文件中多個列?？梢允褂秒p引號Delimiter:文件內(nèi)的分隔符，如果某行的列少于VariableNames變量數(shù)，剩下的變量會保持原值。Allowquoteddata?:啟用后，和VariableNames一樣，文件中可以用雙引號標注，如“111,222”，這樣就可以在值里面有分隔符。RecycleonEOF:到達文件末尾后是否從頭讀取。StopthreadonEOF:到達文件末尾后是否停止線程。Sharingmode:設置線程間是否共享Allthreads（默認值）:所有線程之間共享,只打開一次文件。Currentthreadgroup:同一個線程組，只打開一次文件，Currentthread:每個線程，文件分別打開一次（第一行讀?。〦dit:可以手動輸入Currentthread等，用于變量化ConfigElement（CSVDataSetConfig）ConfigElement(配置元件)中的CSVDataSetConfig，可以使用CSV文件來參數(shù)化變量VariableName:數(shù)據(jù)庫連接池名，供其他元件如JDBCsampler使用，不同數(shù)據(jù)庫連接該名字不能相同。ConnectionPoolConfiguration:一般默認就行MaxNumberofconnection:連接池最大連接數(shù)，設置為0，則線程間不共享，每個線程會重新取連接。小于線程數(shù)（非0），線程會等待。PoolTimeout:試圖獲得數(shù)據(jù)庫連接時的超時時間IdeCleanupinterval:連接池多久未使用，回收時間AutoCommit:是否自動提交（更新數(shù)據(jù)的操作，是否需要commit）TransactionIsolation:事務隔離級別設置（未commit的數(shù)據(jù)是否允許其他事務讀取操作等等）ConnectionvalidationbyPool:Keep-Alive:是否保持連接，只有Ture的時候下面2個選項生效。MaxConnectionage:連接多長時間未使用后，將測試一次連接有效。ValidationQuery:簡單的查詢來確定數(shù)據(jù)庫仍然響應。DatabaseConnectionConfiguration:DatabaseURL:數(shù)據(jù)庫連接url，不同數(shù)據(jù)庫寫法不同。JDBCDriverclass:JDBC驅(qū)動類，不同數(shù)據(jù)庫寫法不同。Usename/Password:用戶名/密碼。ConfigElement（JDBCConnectionConfiguration）ConfigElement(配置元件)中的JDBCConnectionConfiguration，管理數(shù)據(jù)庫連接。（需要自己加入JDBC驅(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ù)化。有區(qū)別于測試計劃中設置的變量：作用于當前線程組，其他線程組不起作用。測試計劃設置的作用于整個測試計劃?？缮倭繀?shù)化，大量參數(shù)建議用CSVDataSetConfig。設置值列表后一個線程更新一次，線程數(shù)多于值列表后重復使用。VariableName:JDBCConnectionConfiguration配置元件中設置的VariableNameSQLQUERY:QueryType:設置statementtype，SelectStatement/Updatestatement…Query:待執(zhí)行SQL語句,最普通的兩種select*fromtablenamewhereid=1select*fromtablename

whereid=?(結(jié)合下面的Parametervalues和Parametertypes，？用指定的參數(shù)代入，

此時QueryType選擇PreparedXXX)Parametervalues:用于替換SQL語句中占位符？（逗號分隔）。Parametertypes:對應參數(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運行之后。可以清理測試后的數(shù)據(jù)ResetInterpreterbeforeeachcall:默認為false，每一個BeanShell測試元件都有獨立的解釋器備份（針對每個線程）。如果測試元件被重復調(diào)用，例如，被放在循環(huán)之中，那么在多次調(diào)用間解釋器將被保留。一些長期運行的測試可能導致解釋器使用很多內(nèi)存；如果遇到這種情況，請嘗試使用Reset選項。Parameters:往beanshell傳參，在beanshell中引用時，“Parameters”表示整個入?yún)?，或是bsh.args[]數(shù)組下標引用，用空格分隔。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配置屬性或臨時設置屬性供其他線程傳遞使用（線程間共享），props.get("START.HMS");props.put("PROP1","1234");prev(SampleResult):響應信息

(prev.setDataType(“text”))；https:///bugzilla/show_bug.cgi?id=58027Stringres=

prev.getResponseDataAsString();sampler(Sampler):Javadoc：/api/overview-summary.html

PreProcessor(BeanShellPreProcessor)BeanShell是面向Java的腳本語言，因此如果你想在完全不會BeanShell的前提下使用他，那么直接編寫Javacode就可以RegularExpressionReferenceName:對應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é)果中提取值構造參數(shù)。正則表達式用戶參數(shù)是作用域是單個線程。Applyto:適用對象，參考ResponseAssertion中的ApplytoResponseFieldtocheck:參考ResponseAssertion中的ResponseFieldtoTestBody(unescaped)，不轉(zhuǎn)義。響應的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:正則表達式來解析響應數(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:無匹配時的默認值PostProcessor(RegularExpressionExtractor)RegularExpressionExtractor作為后置處理器，允許從HTTP響應或特定參數(shù)中根據(jù)正則表達式提取內(nèi)