Jmeter-Beanshell

一、什么是Beanshell

BeanShell是一种完全符合Java语法规范的脚本语言,并且又拥有自己的一些语法和方法;
BeanShell是一种松散类型的脚本语言(这点和JS类似);
BeanShell是用Java写成的,一个小型的、免费的、可以下载的、嵌入式的Java源代码解释器,具有对象脚本语言特性,非常精简的解释器jar文件大小为175k。
BeanShell执行标准Java语句和表达式,另外包括一些脚本命令和语法。
官网:http://www.BeanShell.org/

二、Jmeter中的Beanshell组件

• BeanShell Sampler（BeanShell 取样器）
• BeanShell PreProcessor（BeanShell 前置处理器）
• BeanShell PostProcessor（BeanShell 后置处理器）
• BeanShell Assertion（BeanShell 断言）
• BeanShell Timer（BeanShell 定时器）
• BeanShell Listener（BeanShell 监听器）

三、BeanShell的内置变量

1. vars-(JMeterVariables)：操作jmeter变量，这个变量实际引用了JMeter线程中的局部变量容器（本质上是Map），它 是测试用例与BeanShell交互的桥梁，常用方法：
   a) vars.get(String key)：从jmeter中获得变量值
   b) vars.put(String key，String value)：数据存到jmeter变量中
   如果需要获取或者放置非String类型数据 需要用putObject（）和getObject（）

//Beanshell vars.putObject() vars.getObject()的使用
List list = new ArrayList();

list.add("aaa");
list.add("bbb");
//putObject()可以在vars对象中放置Object类型对象
vars.putObject("list",list);
//===========================
//获取Object list对象
Object Value = vars.getObject("list");
//log.info只能输出String类型变量
log.info(Value.toString());

更多方法可参考：org.apache.jmeter.threads.JMeterVariables

2. props- (JMeterProperties - class java.util.Properties)：操作jmeter属性，该变量引用了JMeter的配置信息，可以获取Jmeter的属性，它的使用方法与vars类似，但是只能put进去String类型的值，而不能是一个对象。对应于java.util.Properties。
   vars是不能跨线程组使用的，即在线程组A中put的值在线程组B中时get不到的，props就是为了解决上述问题：
   a) props.get(“START.HMS”);　　注：START.HMS为属性名，在文件jmeter.properties中定义
   b) props.put(“PROP1”,“1234”);
3. prev - (SampleResult)：获取前面的sample返回的信息，常用方法：
   a) getResponseDataAsString()：获取响应信息
   b) getResponseCode() ：获取响应code
   更多方法可参考：org.apache.jmeter.samplers.SampleResult
4. ctx：该变量引用了当前线程的上下文，使用方法可参考：org.apache.jmeter.threads.JMeterContext。

//SampleResult需要import对象
import org.apache.jmeter.samplers.SampleResult;

SampleResult result = ctx.getPreviousResult();
//getRequestHeaders()方法返回String字符串
String RequestHeaders = result.getRequestHeaders();
//getResponseHeaders() 返回响应headers
String ResponseHeaders = result.getResponseHeaders() 
//getResponseCode() 返回响应状态码字符串
String responseCode = result.getResponseCode();
//ResponseMessage 响应信息,其类型为String。
//getURL() 返回请求URL对象 
URL url = result.getURL();
log.info(RequestHeaders);
log.info(RequestHeaders);

5. sampler-使用时，需要引入包import org.apache.jmeter.config.Arguments;
   a)获取http请求的 url
   String url = sampler.getPath();
   b)获取http请求的body内容
   Arguments arguments = sampler.getArguments();
   String body = arguments.getArgument(0).getValue();
6. SampleResult 获取SampleResult对象，能通过这个对象获取想要的信息。
7. Response 获取Response对象，能通过这个对象获取响应信息。
8. Failure和FailureMessage-(BeanShell Assertion组件独有的内置变量)。其作用是设置当前sampler的测试结果（成功或失败），Failure的类型是boolean，FailureMessage的类型是String。

// 设置sampler为测试通过
Failure = true;
 
// 设置sampler为测试失败
Failure = false;
FailureMessage = "测试失败";

9. ResponseData
   ResponseData就是sampler response data（响应数据），其类型为byte []：

String samplerData = new String(ResponseData);

10. Label和SampleLabel
    Label和SampleLabel是sampler的标题，其类型是String。
11. log：log就是输出不同等级的日志,写入信息到jmeber.log文件

log.debug("xxx");
log.info("xxx");
log.warn("xxx");
log.error("xxx");

四、vars和props 主要两点的区别：

vars中的变量仅对当前线程组内可见， 跨线程组则需要使用属性。
读取变量使用 vars.put(var, value)函数， 例如：

vars.put("new_value", value) ;

注意：上面的“new_value”必须是字符串类型， 传递其他类型，包括null,都会报错，如果想使用数字，数字等类型，一种方法是做类型转换

vars.put("MUST_BE_STRING", "" + 1);
vars.put("MUST_BE_STRING", (String)1);
vars.put("MUST_BE_STRING", [2, 3, 4].toString());
vars.put("MUST_BE_STRING", (String)[1,2]);
vars.put("MUST_BE_STRING", "" + [2, 3, 4]);
vars.put("MUST_BE_STRING", "" + true);
vars.put("MUST_BE_STRING", true.toString());

获取字符串变量：
vars.get()方法用于读取变量值：
如：vars.get(“goodId”);
如果传递的 variable_name 预先不存在，将返回null.

保存对象类型：
vars保存对象类型（包括List, Map， closure之类），使用如下方法：

vars.putObject("object_name", Object);

vars.putObject("NUMBER", 1);
vars.putObject("ARRAY", []);
vars.putObject("CLOSURE", { x, y -> x+y });

获取对象类型：

vars.getObject("OBJECT_NAME");

props
props 继承了Hashtable的累，所以拥有与vars类似的get和put 方法， 另外还有继承Hashtable的其他方法：
判断某属性是否存在， 返回布尔值

props.containsKey("PROPERTY_NAME")　　

判断某项值是否存在，返回布尔值：

props.contains("PROPERTY_VALUE")

删除某个值

props.remove("PROPERTY_NAME")

所有属性以字符串形式表示

props.toString()

五、Beanshell的For循环与集合

//普通for循环的写法
for(int i = 0; i<list.size();i++){
	log.info(list.get(i));
}
//增强for循环的写法
for(object : list){		
	log.info(object);
}