JMeter學習-010-JMeter 配置元件實例之 - CSV Data Set Config 參數化配置

眾所周知，在進行接口測試的過程中，需要創建不同的場景（不同條件的輸入，來驗證不同的入參的返回結果）。因而，在日常的自動化接口監控或商品監控等線上監控過程中，需要配置大量的入參來監控接口的返回是否正確。

日常常見的線上監控幾個簡單的監控示例場景如下：

• 監控電商網站某個類目下的商品數量。若類目中商品的數量小於一定的數量，則認為需要認為查看商品池的商品是否正確；
• 監控商品的價格。當商品價格出現超出限定的波動幅度時，通知相應的商品負責人，對其進行確認，從而保證商品價格的正確無誤。
• 監控商品在某一地域是否有貨。當地域存貨達到最低庫存時，通知負責人進行貨源補充；或者當某地域限制出售或未配置地域庫存時，若發現存在相應庫存，則可通知相關人員查驗等。

那么，在 JMeter 中改如何對 HTTP請求進行參數化呢？

在 JMeter 的配置原件中就為我們提供了參數化需要的配置，下面以 CSV Data Set Config 進行參數化演示示例的配置，路徑如下圖所示：

PS：通過上圖可以看出我們可以進行各種各樣的參數化設置，例如用戶自定義變量、計數器、HTTP Cookie 管理器等，同時也可以通過 JDBC 讀取數據庫中保存的測試數據（需要相應的 jar 文件支持）。

CSV Data Set Config 讀取的文件不僅僅限於 csv 文件，其可以讀取文本文件，文件內容需以英文半角 "," 隔開，每一行為一條測試用例數據。

 

下面開始以大家都熟悉的搜索功能展開 HTTP請求 參數化配置實例演示，具體的操作步驟如下所示：

第一步、獲取搜索的 HTTP請求

獲取搜素的 HTTP請求如下圖所示（此步不再贅述，不知如何獲取 HTTP請求 的小主，敬請參閱之前的博文，非常感謝！）：

 

第二步、通過 HTTP請求，確定需要參數化的變量

通常根據實際的參數化需求，選取符合測試需求且經常變化或未來會變化的變量為需要參數化的變量，例如本例中的查詢關鍵字、配送區域、大區、產品源（或產品平台，例如：PC、Android、iPhone等）、產品版本，均可作為參數化的變量。

 

第三步、創建參數化文件，並填充測試用例數據

創建參數文件 mobileApp-IDC-0-searchGoods.txt，參數文件內容如下所示（注意參數文件編碼方式建議選擇 UTF-8）：

101-006-78945,29313,1,2169256,489349159815,android,45
101-005-31058,29313,1,1903913,472108827742,android,45
101-005-98536,29357,1,1993575,477948510289,android,45
101-006-88137,29358,1,2184120,490316513802,iphone,45
101-006-99103,29358,1,2201898,491473066849,iphone,45
101-005-84629,29358,1,1978716,476978170298,android,32
101-006-25777,29358,1,2035074,480647572701,android,45

 

第四步、通過 【配置元件/CSV Data Set Config】讀取參數化文件，並對變量進行賦值。

最終的配置如下圖所示：

• Filename：參數文件名，可以寫絕對路徑，個人強烈建議采用相對路徑，避免腳本遷移時需要修改路徑。
• File encoding：參數文件的編碼格式。推薦選擇 UTF-8。
• Variable Names：對對應參數文件每列的變量名。類似於 Excel 文件的文件頭，起到標示的作用，同時也是后續引用的標識符，建議采用有意義的英文標示。
• Delimiter：參數文件分隔符。與參數文件中的分隔符保持一致即可。
• Allow quoted data？：是否允許引用數據。默認設置為 false。例如數據樣式為："101-005-98536","29357","1","1993575","477948510289","android","45" 時，此處需設置為 true，一般默認為 false 即可。
• Recycle on EOF?：是否循環讀取參數文件內容。默認設置為 true。設置為 true 時，當已經讀取完參數文件內的測試用例數據，還需要繼續獲取用例數據時，此時會循環讀取參數文件數據；設置為 false 時，若已至文件末尾，則不再繼續讀取測試數據。通常在 線程組的線程數 * 線程組的循環次數 > 參數文件行數時，才需要將此項設置為 true。
• Sotp thread on EOF?：當讀取到參數文件末尾時，是否停止讀取線程。默認為 false。當 Recycle on EOF?  設置為 true 時，此項不起任何作用。當且僅當 Recycle on EOF? 為 false 時，此項配置才生效。
• 若為 true，則在讀取到參數文件行末尾時，終止參數文件讀取線程。例如：線程組的線程數 * 線程組的循環次數 = 10，參數文件行數 = 7，那么將在第 8 次開始停止線程。
• 若為 false，此時線程會繼續讀取，但是會請求錯誤，因此時讀取的數據為 EOF。以上同例，自第 8 次開始，線程的請求數據為 EOF。
• Sharing mode：共享模式，即參數文件變量作用域。主要有以下幾種方式：
• All threads：當前測試計划中的所有線程組中的所有的線程均有效。默認。
• Current thread group：當前的線程組中的線程有效。
• Current thread：當前線程有效。
• 編輯：（俺暫時沒有用過，嘿嘿 ^_^）

 

第五步、修改 HTTP請求 中對應的參數為參數變量

將如下部分中值替換為參數文件的值，即對應的 Variable Names，應用方式類似於 shell 腳本的變量引用，例如：${goodsNo}。

 

第六步、設置 HTTP請求 斷言

將參數文件中的第 5 列（即商品的 skuid 設置為校驗數據，通過此判斷單品是否正確），測試數據如下所示：

設置斷言如下所示：

 

第七步：執行腳本，查看結果

參數文件用例數據 101-006-25777,29358,1,2035074,480647572731,android,45 對應的 skuid：480647572731 設置的是錯誤的（方便對比斷言結果）。執行結果如下所示：

 

第八步：腳本改進

其實，有些朋友看到這兒，可能會問執行結果列的標題均為線程標題，都是相同的無法區分，不方便閱讀？其實，我們可以將腳本中的變量添加到線程名的后面（PS：需要考慮變量的作用域）即可簡潔明了的區分每個線程，同時也可查看不同的入參，非常的方便。

將上述 HTTP 請求的線程名稍作修改，如下所示：

再次執行腳本，執行結果如下所示，通過下圖是否可以非常直觀簡潔的執行結果，及對應的入參了 ^_^

 

附錄（一）：

<?xml version="1.0" encoding="UTF-8"?>
<jmeterTestPlan version="1.2" properties="2.7" jmeter="2.12 r1636949">
  <hashTree>
    <TestPlan guiclass="TestPlanGui" testclass="TestPlan" testname="接口自動化測試實例 - 參數化" enabled="true">
      <stringProp name="TestPlan.comments"></stringProp>
      <boolProp name="TestPlan.functional_mode">false</boolProp>
      <boolProp name="TestPlan.serialize_threadgroups">false</boolProp>
      <elementProp name="TestPlan.user_defined_variables" elementType="Arguments" guiclass="ArgumentsPanel" testclass="Arguments" testname="用戶定義的變量" enabled="true">
        <collectionProp name="Arguments.arguments"/>
      </elementProp>
      <stringProp name="TestPlan.user_define_classpath"></stringProp>
    </TestPlan>
    <hashTree>
      <ThreadGroup guiclass="ThreadGroupGui" testclass="ThreadGroup" testname="008-搜索商品" enabled="true">
        <stringProp name="ThreadGroup.on_sample_error">continue</stringProp>
        <elementProp name="ThreadGroup.main_controller" elementType="LoopController" guiclass="LoopControlPanel" testclass="LoopController" testname="循環控制器" enabled="true">
          <boolProp name="LoopController.continue_forever">false</boolProp>
          <stringProp name="LoopController.loops">3</stringProp>
        </elementProp>
        <stringProp name="ThreadGroup.num_threads">3</stringProp>
        <stringProp name="ThreadGroup.ramp_time">0</stringProp>
        <longProp name="ThreadGroup.start_time">1419232321000</longProp>
        <longProp name="ThreadGroup.end_time">1419232321000</longProp>
        <boolProp name="ThreadGroup.scheduler">false</boolProp>
        <stringProp name="ThreadGroup.duration"></stringProp>
        <stringProp name="ThreadGroup.delay"></stringProp>
      </ThreadGroup>
      <hashTree>
        <CSVDataSet guiclass="TestBeanGUI" testclass="CSVDataSet" testname="參數化列表文件 - 待搜索的商品列表" enabled="true">
          <stringProp name="filename">./mobileApp-IDC-0-searchGoods.txt</stringProp>
          <stringProp name="fileEncoding">UTF-8</stringProp>
          <stringProp name="variableNames">goodsNo,districtId,areacode,sysNo,skuid,appSource,appVersion</stringProp>
          <stringProp name="delimiter">,</stringProp>
          <boolProp name="quotedData">false</boolProp>
          <boolProp name="recycle">true</boolProp>
          <boolProp name="stopThread">false</boolProp>
          <stringProp name="shareMode">shareMode.all</stringProp>
        </CSVDataSet>
        <hashTree/>
        <HTTPSamplerProxy guiclass="HttpTestSampleGui" testclass="HTTPSamplerProxy" testname="008-01-搜索商品 【${goodsNo} - ${districtId} - ${appSource} - ${appVersion}】" enabled="true">
          <elementProp name="HTTPsampler.Arguments" elementType="Arguments" guiclass="HTTPArgumentsPanel" testclass="Arguments" enabled="true">
            <collectionProp name="Arguments.arguments">
              <elementProp name="q" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.value">${goodsNo}</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
                <stringProp name="Argument.name">q</stringProp>
              </elementProp>
              <elementProp name="districtId" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.value">${districtId}</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
                <stringProp name="Argument.name">districtId</stringProp>
              </elementProp>
              <elementProp name="areacode" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.value">${areacode}</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
                <stringProp name="Argument.name">areacode</stringProp>
              </elementProp>
              <elementProp name="dtype" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.value">list|page|classes</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
                <stringProp name="Argument.name">dtype</stringProp>
              </elementProp>
              <elementProp name="districtId" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.name">districtId</stringProp>
                <stringProp name="Argument.value">${districtId}</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
              </elementProp>
              <elementProp name="exAppTag" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.name">exAppTag</stringProp>
                <stringProp name="Argument.value">2045191607</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
              </elementProp>
              <elementProp name="appSource" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.value">${appSource}</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
                <stringProp name="Argument.name">appSource</stringProp>
              </elementProp>
              <elementProp name="appVersion" elementType="HTTPArgument">
                <boolProp name="HTTPArgument.always_encode">false</boolProp>
                <stringProp name="Argument.value">${appVersion}</stringProp>
                <stringProp name="Argument.metadata">=</stringProp>
                <boolProp name="HTTPArgument.use_equals">true</boolProp>
                <stringProp name="Argument.name">appVersion</stringProp>
              </elementProp>
            </collectionProp>
          </elementProp>
          <stringProp name="HTTPSampler.domain">mb.51buy.com</stringProp>
          <stringProp name="HTTPSampler.port"></stringProp>
          <stringProp name="HTTPSampler.connect_timeout"></stringProp>
          <stringProp name="HTTPSampler.response_timeout"></stringProp>
          <stringProp name="HTTPSampler.protocol">http</stringProp>
          <stringProp name="HTTPSampler.contentEncoding">GB2312</stringProp>
          <stringProp name="HTTPSampler.path">/json.php?mod=Search&amp;act=page&amp;p=1&amp;pp=20</stringProp>
          <stringProp name="HTTPSampler.method">POST</stringProp>
          <boolProp name="HTTPSampler.follow_redirects">true</boolProp>
          <boolProp name="HTTPSampler.auto_redirects">false</boolProp>
          <boolProp name="HTTPSampler.use_keepalive">true</boolProp>
          <boolProp name="HTTPSampler.DO_MULTIPART_POST">false</boolProp>
          <boolProp name="HTTPSampler.monitor">false</boolProp>
          <stringProp name="HTTPSampler.embedded_url_re"></stringProp>
        </HTTPSamplerProxy>
        <hashTree>
          <HeaderManager guiclass="HeaderPanel" testclass="HeaderManager" testname="HTTP信息頭管理器" enabled="true">
            <collectionProp name="HeaderManager.headers">
              <elementProp name="Charset" elementType="Header">
                <stringProp name="Header.name">Charset</stringProp>
                <stringProp name="Header.value">UTF-8</stringProp>
              </elementProp>
              <elementProp name="Content-Type" elementType="Header">
                <stringProp name="Header.name">Content-Type</stringProp>
                <stringProp name="Header.value">application/x-www-form-urlencoded</stringProp>
              </elementProp>
              <elementProp name="Accept-Encoding" elementType="Header">
                <stringProp name="Header.name">Accept-Encoding</stringProp>
                <stringProp name="Header.value">gzip</stringProp>
              </elementProp>
              <elementProp name="User-Agent" elementType="Header">
                <stringProp name="Header.name">User-Agent</stringProp>
                <stringProp name="Header.value">Dalvik/1.6.0 (Linux; U; Android 4.4.2; GT-I9502 Build/KOT49H)</stringProp>
              </elementProp>
            </collectionProp>
          </HeaderManager>
          <hashTree/>
          <ResponseAssertion guiclass="AssertionGui" testclass="ResponseAssertion" testname="響應斷言" enabled="true">
            <collectionProp name="Asserion.test_strings">
              <stringProp name="365072765">${goodsNo}</stringProp>
              <stringProp name="-781931418">${sysNo}</stringProp>
              <stringProp name="-794775524">${skuid}</stringProp>
            </collectionProp>
            <stringProp name="Assertion.test_field">Assertion.response_data</stringProp>
            <boolProp name="Assertion.assume_success">false</boolProp>
            <intProp name="Assertion.test_type">16</intProp>
          </ResponseAssertion>
          <hashTree/>
        </hashTree>
      </hashTree>
      <ResultCollector guiclass="AssertionVisualizer" testclass="ResultCollector" testname="斷言結果" enabled="true">
        <boolProp name="ResultCollector.error_logging">false</boolProp>
        <objProp>
          <name>saveConfig</name>
          <value class="SampleSaveConfiguration">
            <time>true</time>
            <latency>true</latency>
            <timestamp>true</timestamp>
            <success>true</success>
            <label>true</label>
            <code>true</code>
            <message>true</message>
            <threadName>true</threadName>
            <dataType>true</dataType>
            <encoding>false</encoding>
            <assertions>true</assertions>
            <subresults>true</subresults>
            <responseData>false</responseData>
            <samplerData>false</samplerData>
            <xml>false</xml>
            <fieldNames>false</fieldNames>
            <responseHeaders>false</responseHeaders>
            <requestHeaders>false</requestHeaders>
            <responseDataOnError>false</responseDataOnError>
            <saveAssertionResultsFailureMessage>false</saveAssertionResultsFailureMessage>
            <assertionsResultsToSave>0</assertionsResultsToSave>
            <bytes>true</bytes>
            <threadCounts>true</threadCounts>
          </value>
        </objProp>
        <stringProp name="filename"></stringProp>
      </ResultCollector>
      <hashTree/>
      <ResultCollector guiclass="ViewResultsFullVisualizer" testclass="ResultCollector" testname="察看結果樹" enabled="true">
        <boolProp name="ResultCollector.error_logging">false</boolProp>
        <objProp>
          <name>saveConfig</name>
          <value class="SampleSaveConfiguration">
            <time>true</time>
            <latency>true</latency>
            <timestamp>true</timestamp>
            <success>true</success>
            <label>true</label>
            <code>true</code>
            <message>true</message>
            <threadName>true</threadName>
            <dataType>true</dataType>
            <encoding>false</encoding>
            <assertions>true</assertions>
            <subresults>true</subresults>
            <responseData>false</responseData>
            <samplerData>false</samplerData>
            <xml>false</xml>
            <fieldNames>false</fieldNames>
            <responseHeaders>false</responseHeaders>
            <requestHeaders>false</requestHeaders>
            <responseDataOnError>false</responseDataOnError>
            <saveAssertionResultsFailureMessage>false</saveAssertionResultsFailureMessage>
            <assertionsResultsToSave>0</assertionsResultsToSave>
            <bytes>true</bytes>
            <threadCounts>true</threadCounts>
          </value>
        </objProp>
        <stringProp name="filename">${__property(JmeterAuto_LogFile)}</stringProp>
      </ResultCollector>
      <hashTree/>
    </hashTree>
  </hashTree>
</jmeterTestPlan>

 

至此， JMeter學習-010-JMeter 配置元件實例之 - CSV Data Set Config 參數化配置 順利完結，希望此文能夠給初學 JMeter 的您一份參考。

最后，非常感謝親的駐足，希望此文能對親有所幫助。熱烈歡迎親一起探討，共同進步。非常感謝！ ^_^