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 请求的线程名稍作修改，如下所示：

再次执行脚本，执行结果如下所示，通过下图是否可以非常直观简洁的执行结果，及对应的入参了 ^_^

 

附录（一）：

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <jmeterTestPlan version="1.2" properties="2.7" jmeter="2.12 r1636949">
  3   <hashTree>
  4     <TestPlan guiclass="TestPlanGui" testclass="TestPlan" testname="接口自动化测试实例 - 参数化" enabled="true">
  5       <stringProp name="TestPlan.comments"></stringProp>
  6       <boolProp name="TestPlan.functional_mode">false</boolProp>
  7       <boolProp name="TestPlan.serialize_threadgroups">false</boolProp>
  8       <elementProp name="TestPlan.user_defined_variables" elementType="Arguments" guiclass="ArgumentsPanel" testclass="Arguments" testname="用户定义的变量" enabled="true">
  9         <collectionProp name="Arguments.arguments"/>
 10       </elementProp>
 11       <stringProp name="TestPlan.user_define_classpath"></stringProp>
 12     </TestPlan>
 13     <hashTree>
 14       <ThreadGroup guiclass="ThreadGroupGui" testclass="ThreadGroup" testname="008-搜索商品" enabled="true">
 15         <stringProp name="ThreadGroup.on_sample_error">continue</stringProp>
 16         <elementProp name="ThreadGroup.main_controller" elementType="LoopController" guiclass="LoopControlPanel" testclass="LoopController" testname="循环控制器" enabled="true">
 17           <boolProp name="LoopController.continue_forever">false</boolProp>
 18           <stringProp name="LoopController.loops">3</stringProp>
 19         </elementProp>
 20         <stringProp name="ThreadGroup.num_threads">3</stringProp>
 21         <stringProp name="ThreadGroup.ramp_time">0</stringProp>
 22         <longProp name="ThreadGroup.start_time">1419232321000</longProp>
 23         <longProp name="ThreadGroup.end_time">1419232321000</longProp>
 24         <boolProp name="ThreadGroup.scheduler">false</boolProp>
 25         <stringProp name="ThreadGroup.duration"></stringProp>
 26         <stringProp name="ThreadGroup.delay"></stringProp>
 27       </ThreadGroup>
 28       <hashTree>
 29         <CSVDataSet guiclass="TestBeanGUI" testclass="CSVDataSet" testname="参数化列表文件 - 待搜索的商品列表" enabled="true">
 30           <stringProp name="filename">./mobileApp-IDC-0-searchGoods.txt</stringProp>
 31           <stringProp name="fileEncoding">UTF-8</stringProp>
 32           <stringProp name="variableNames">goodsNo,districtId,areacode,sysNo,skuid,appSource,appVersion</stringProp>
 33           <stringProp name="delimiter">,</stringProp>
 34           <boolProp name="quotedData">false</boolProp>
 35           <boolProp name="recycle">true</boolProp>
 36           <boolProp name="stopThread">false</boolProp>
 37           <stringProp name="shareMode">shareMode.all</stringProp>
 38         </CSVDataSet>
 39         <hashTree/>
 40         <HTTPSamplerProxy guiclass="HttpTestSampleGui" testclass="HTTPSamplerProxy" testname="008-01-搜索商品 【${goodsNo} - ${districtId} - ${appSource} - ${appVersion}】" enabled="true">
 41           <elementProp name="HTTPsampler.Arguments" elementType="Arguments" guiclass="HTTPArgumentsPanel" testclass="Arguments" enabled="true">
 42             <collectionProp name="Arguments.arguments">
 43               <elementProp name="q" elementType="HTTPArgument">
 44                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 45                 <stringProp name="Argument.value">${goodsNo}</stringProp>
 46                 <stringProp name="Argument.metadata">=</stringProp>
 47                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 48                 <stringProp name="Argument.name">q</stringProp>
 49               </elementProp>
 50               <elementProp name="districtId" elementType="HTTPArgument">
 51                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 52                 <stringProp name="Argument.value">${districtId}</stringProp>
 53                 <stringProp name="Argument.metadata">=</stringProp>
 54                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 55                 <stringProp name="Argument.name">districtId</stringProp>
 56               </elementProp>
 57               <elementProp name="areacode" elementType="HTTPArgument">
 58                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 59                 <stringProp name="Argument.value">${areacode}</stringProp>
 60                 <stringProp name="Argument.metadata">=</stringProp>
 61                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 62                 <stringProp name="Argument.name">areacode</stringProp>
 63               </elementProp>
 64               <elementProp name="dtype" elementType="HTTPArgument">
 65                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 66                 <stringProp name="Argument.value">list|page|classes</stringProp>
 67                 <stringProp name="Argument.metadata">=</stringProp>
 68                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 69                 <stringProp name="Argument.name">dtype</stringProp>
 70               </elementProp>
 71               <elementProp name="districtId" elementType="HTTPArgument">
 72                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 73                 <stringProp name="Argument.name">districtId</stringProp>
 74                 <stringProp name="Argument.value">${districtId}</stringProp>
 75                 <stringProp name="Argument.metadata">=</stringProp>
 76                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 77               </elementProp>
 78               <elementProp name="exAppTag" elementType="HTTPArgument">
 79                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 80                 <stringProp name="Argument.name">exAppTag</stringProp>
 81                 <stringProp name="Argument.value">2045191607</stringProp>
 82                 <stringProp name="Argument.metadata">=</stringProp>
 83                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 84               </elementProp>
 85               <elementProp name="appSource" elementType="HTTPArgument">
 86                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 87                 <stringProp name="Argument.value">${appSource}</stringProp>
 88                 <stringProp name="Argument.metadata">=</stringProp>
 89                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 90                 <stringProp name="Argument.name">appSource</stringProp>
 91               </elementProp>
 92               <elementProp name="appVersion" elementType="HTTPArgument">
 93                 <boolProp name="HTTPArgument.always_encode">false</boolProp>
 94                 <stringProp name="Argument.value">${appVersion}</stringProp>
 95                 <stringProp name="Argument.metadata">=</stringProp>
 96                 <boolProp name="HTTPArgument.use_equals">true</boolProp>
 97                 <stringProp name="Argument.name">appVersion</stringProp>
 98               </elementProp>
 99             </collectionProp>
100           </elementProp>
101           <stringProp name="HTTPSampler.domain">mb.51buy.com</stringProp>
102           <stringProp name="HTTPSampler.port"></stringProp>
103           <stringProp name="HTTPSampler.connect_timeout"></stringProp>
104           <stringProp name="HTTPSampler.response_timeout"></stringProp>
105           <stringProp name="HTTPSampler.protocol">http</stringProp>
106           <stringProp name="HTTPSampler.contentEncoding">GB2312</stringProp>
107           <stringProp name="HTTPSampler.path">/json.php?mod=Search&amp;act=page&amp;p=1&amp;pp=20</stringProp>
108           <stringProp name="HTTPSampler.method">POST</stringProp>
109           <boolProp name="HTTPSampler.follow_redirects">true</boolProp>
110           <boolProp name="HTTPSampler.auto_redirects">false</boolProp>
111           <boolProp name="HTTPSampler.use_keepalive">true</boolProp>
112           <boolProp name="HTTPSampler.DO_MULTIPART_POST">false</boolProp>
113           <boolProp name="HTTPSampler.monitor">false</boolProp>
114           <stringProp name="HTTPSampler.embedded_url_re"></stringProp>
115         </HTTPSamplerProxy>
116         <hashTree>
117           <HeaderManager guiclass="HeaderPanel" testclass="HeaderManager" testname="HTTP信息头管理器" enabled="true">
118             <collectionProp name="HeaderManager.headers">
119               <elementProp name="Charset" elementType="Header">
120                 <stringProp name="Header.name">Charset</stringProp>
121                 <stringProp name="Header.value">UTF-8</stringProp>
122               </elementProp>
123               <elementProp name="Content-Type" elementType="Header">
124                 <stringProp name="Header.name">Content-Type</stringProp>
125                 <stringProp name="Header.value">application/x-www-form-urlencoded</stringProp>
126               </elementProp>
127               <elementProp name="Accept-Encoding" elementType="Header">
128                 <stringProp name="Header.name">Accept-Encoding</stringProp>
129                 <stringProp name="Header.value">gzip</stringProp>
130               </elementProp>
131               <elementProp name="User-Agent" elementType="Header">
132                 <stringProp name="Header.name">User-Agent</stringProp>
133                 <stringProp name="Header.value">Dalvik/1.6.0 (Linux; U; Android 4.4.2; GT-I9502 Build/KOT49H)</stringProp>
134               </elementProp>
135             </collectionProp>
136           </HeaderManager>
137           <hashTree/>
138           <ResponseAssertion guiclass="AssertionGui" testclass="ResponseAssertion" testname="响应断言" enabled="true">
139             <collectionProp name="Asserion.test_strings">
140               <stringProp name="365072765">${goodsNo}</stringProp>
141               <stringProp name="-781931418">${sysNo}</stringProp>
142               <stringProp name="-794775524">${skuid}</stringProp>
143             </collectionProp>
144             <stringProp name="Assertion.test_field">Assertion.response_data</stringProp>
145             <boolProp name="Assertion.assume_success">false</boolProp>
146             <intProp name="Assertion.test_type">16</intProp>
147           </ResponseAssertion>
148           <hashTree/>
149         </hashTree>
150       </hashTree>
151       <ResultCollector guiclass="AssertionVisualizer" testclass="ResultCollector" testname="断言结果" enabled="true">
152         <boolProp name="ResultCollector.error_logging">false</boolProp>
153         <objProp>
154           <name>saveConfig</name>
155           <value class="SampleSaveConfiguration">
156             <time>true</time>
157             <latency>true</latency>
158             <timestamp>true</timestamp>
159             <success>true</success>
160             <label>true</label>
161             <code>true</code>
162             <message>true</message>
163             <threadName>true</threadName>
164             <dataType>true</dataType>
165             <encoding>false</encoding>
166             <assertions>true</assertions>
167             <subresults>true</subresults>
168             <responseData>false</responseData>
169             <samplerData>false</samplerData>
170             <xml>false</xml>
171             <fieldNames>false</fieldNames>
172             <responseHeaders>false</responseHeaders>
173             <requestHeaders>false</requestHeaders>
174             <responseDataOnError>false</responseDataOnError>
175             <saveAssertionResultsFailureMessage>false</saveAssertionResultsFailureMessage>
176             <assertionsResultsToSave>0</assertionsResultsToSave>
177             <bytes>true</bytes>
178             <threadCounts>true</threadCounts>
179           </value>
180         </objProp>
181         <stringProp name="filename"></stringProp>
182       </ResultCollector>
183       <hashTree/>
184       <ResultCollector guiclass="ViewResultsFullVisualizer" testclass="ResultCollector" testname="察看结果树" enabled="true">
185         <boolProp name="ResultCollector.error_logging">false</boolProp>
186         <objProp>
187           <name>saveConfig</name>
188           <value class="SampleSaveConfiguration">
189             <time>true</time>
190             <latency>true</latency>
191             <timestamp>true</timestamp>
192             <success>true</success>
193             <label>true</label>
194             <code>true</code>
195             <message>true</message>
196             <threadName>true</threadName>
197             <dataType>true</dataType>
198             <encoding>false</encoding>
199             <assertions>true</assertions>
200             <subresults>true</subresults>
201             <responseData>false</responseData>
202             <samplerData>false</samplerData>
203             <xml>false</xml>
204             <fieldNames>false</fieldNames>
205             <responseHeaders>false</responseHeaders>
206             <requestHeaders>false</requestHeaders>
207             <responseDataOnError>false</responseDataOnError>
208             <saveAssertionResultsFailureMessage>false</saveAssertionResultsFailureMessage>
209             <assertionsResultsToSave>0</assertionsResultsToSave>
210             <bytes>true</bytes>
211             <threadCounts>true</threadCounts>
212           </value>
213         </objProp>
214         <stringProp name="filename">${__property(JmeterAuto_LogFile)}</stringProp>
215       </ResultCollector>
216       <hashTree/>
217     </hashTree>
218   </hashTree>
219 </jmeterTestPlan>

JMeter 配置元件 - CSV Data Set Config 参数化演示实例脚本源码

 

至此， JMeter学习-010-JMeter 配置元件实例之 - CSV Data Set Config 参数化配置 顺利完结，希望此文能够给初学 JMeter 的您一份参考。

最后，非常感谢亲的驻足，希望此文能对亲有所帮助。热烈欢迎亲一起探讨，共同进步。非常感谢！ ^_^