【测试技术-性能测试-Loadrunner】Loadrunner常用函数详解
Loadrunner定义了很多用于性能测试脚本编写和增强的方法，本文总结了web测试时经常会使用到的方法，掌握这些方法之后，基本可以不依赖录制就能完成脚本编写和增强。
1、web常用方法
1.1、web_url方法
模拟用户请求，实现HTTP请求中的GET方法。
语法如下：
int web_url( const char *StepName, const char *url, <List of Attributes>, [EXTRARES, <List of Resource Attributes>,] LAST );
//参数说明：
//StepName：测试结果中显示的名称，也可用作自动事务的名称
//url：需要访问的网页地址
//List of Attributes:支持属性如下：
//FtpAscii：FTP下载文件时使用，不常用
//TargetFrame：包含当前资源或连接的frame标签名
//Resource：请求的URL是否是一个资源，0不是，1是
//RecContentType：响应头的文本类型
//Referer：URL引用的页面
//Snapshot：快照名称，用于关联
//Mode：录制模式，HTML或HTTP
//EXTRARES：分界函数，指示下一个参数将是资源属性列表
//List of Resource Attributes：资源属性列表，支持以下资源属性：
//URL：通过URL地址要下载的web资源
//Refer：发送下载请求的页面地址
//ENDITEM：列表中每个资源的标志符
//LAST：参数列表结束标记
返回值如下：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
示例如下：
int status;
status = web_url("index",
"URL=http://127.0.0.1:1080/WebTours/index.htm",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t1.inf",
"Mode=HTML",
LAST);
lr_output_message("status=%d",status);
//运行结果：status=0
1.2、web_image方法
模拟单击图片，必须在有前置操作的上下文中使用
语法：
int web_image (const char *StepName, <List of Attributes>, [EXTRARES,
<List of Resource Attributes>,] LAST );
返回值：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
示例：
web_image("SignOff Button",
"Alt=SignOff Button",
"Snapshot=t110.inf",
LAST);
//Alt为html结构中图片的alt属性值
1.3、web_link方法
模拟用户单击指定属性链接，必须在有前置操作的上下文中使用
语法：
int web_link (const char *StepName, <List of Attributes>, [EXTRARES, <List
of Resource Attributes>,] LAST );
//List of Attributes：支持下列的属性：
//Text：超链接中的文字，必须精确匹配。
//Frame：录制操作时所在的 Frame 的名称。
//TargetFrame、ResourceByteLimit
//Ordinal：如果用给定的Attributes筛选出的元素不唯一，则使用此属性来指定其中的一个。如：“SRC=pic.gif”，“Ordinal=3”标记的是 SRC的值是“pic.gif”的第3张图片
返回值：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
1.4、web_submit_data方法
生成表单的POST或GET请求，与上下文无关
语法：
int web_submit_data( const char *StepName, const char *Action, <List of Attributes>,
ITEMDATA, <List of data>, [ EXTRARES, <List of Resource Attributes>,]LAST);
//Action：Form表单中的action属性，即提交数据时执行操作的http地址
//List of Attributes：
//Method：表单提交方法：POST或GET（默认值：POST）
//EncType：编码方法
//EncodeAtSign：以其ASCII表示法编码“@”符号。Yes或No。
//TargetFrame：包含当前链接或资源的帧的名称。
//Referer、Mode（HTTP/HTML）
//UserAgent：标识将执行该步骤的浏览器以外的组件
//ITEMDATA：数据域和属性的分隔符
//List of data：表单提交的内容，上下文无关，格式为：“name=name1”, “value=value1”, ENDITEM,
//EXTRARES：数据域和资源属性列表分隔符
//List of Resource Attributes：资源属性列表
返回值：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
示例：
web_submit_data("reservations.pl",
"Action=http://127.0.0.1:1080/cgi-bin/reservations.pl",
"Method=POST",
"RecContentType=text/html",
"Referer=http://127.0.0.1:1080/cgi-bin/reservations.pl?page=welcome",
"Snapshot=t9.inf",
"Mode=HTML",
ITEMDATA,
"Name=advanceDiscount", "Value=0", ENDITEM,
"Name=depart", "Value=PEK", ENDITEM,
"Name=departDate", "Value=05/28/2022", ENDITEM,
"Name=arrive", "Value=SHA", ENDITEM,
"Name=returnDate", "Value=05/29/2022", ENDITEM,
"Name=numPassengers", "Value=1", ENDITEM,
"Name=seatPref", "Value=Window", ENDITEM,
"Name=seatType", "Value=First", ENDITEM,
"Name=.cgifields", "Value=roundtrip", ENDITEM,
"Name=.cgifields", "Value=seatType", ENDITEM,
"Name=.cgifields", "Value=seatPref", ENDITEM,
"Name=findFlights.x", "Value=65", ENDITEM,
"Name=findFlights.y", "Value=5", ENDITEM,
LAST);
1.5、web_submit_form方法
提交表单，此函数可能必须在前一个操作的上下文中执行。录制时会判断浏览器中是否有cache的内容，如果有web_submit_form函数中只保存和缓存不相同的数据。其他同web_submit_data。
1.6、web_custom_request方法
发送自定义的http请求。
语法：
Int web_custom_request (const char *RequestName, ,[EXTRARES, ,] LAST );
//List of Attribute：支持属性如下：
//URL:页面地址
//Method：提交方式，如POST/GET
//TargetFrame
//EncType：编码类型
//RecContentType:响应头的内容类型
//Referer
//Body：请求体
//RAW BODY
//BodyFilePath：作为请求体传送的文件的路径
//Resource、ResourceByteLimit、Snapshot、Mode
//ExtraResBaseDir
//UserAgent：用户代理
//Binary
//ContentEncoding:指定请求体的使用指定的方式进行编码
//EXTRARES：分隔符
返回值：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
使用示例：
web_custom_request("login",
"URL=https://www.xxxx.com/login",
"Method=POST",
"RecContentType=application/json;charset=UTF-8",
"Referer=https://exam.cata.org.cn/",
"Mode=HTTP",
"EncType=application/json",
"body={\"code\":\"1q2w\",\"password\":\"xxxx\",\"str\":\"xxxxxx\",\"username\":\"xxx\"}",
LAST);
1.7、web_find方法
从HTML页面中查找指定的文本字符串
语法：
int web_find( const char *StepName, <Attributes and Specifications list>, char *searchstring, LAST);
//支持的属性：
//Frame：多Frame时，定义要查找的Frame范围
//Expect：定义检查成功的标准：found（默认）/notfound
//Matchcase：搜索是否区分大小写
//Repeat：第一次发现待查字符串时，是否继续搜索。yes/no
//Report：指定那种情况下在执行日志中显示检查结果：success/failure/always(默认)
//Onfailure：检查失败后，Vuser是否终端，设为abort时，运行时中的error-handling设置不生效，脚本中断；未指定该值，则error-handling设置生效
//RightOf：要查找的字符串右边内容
//LeftOf：要查找的字符串左边内容
//Searchstring：需要查找的字符串，格式为"What=stringxxx"，不区分大小写
返回值：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
示例：
web_find("find_string",
"RightOf=aaa",
"LeftOf=bbb",
"What=name",
LAST);
//注意：1、该函数在请求的页面内容完全显示出来以后在页面中查找，故需写道打开页面的动作之后；
//2、必须启用内容检查选项
1.8、web_reg_find方法
从HTML页面中查找指定的文本字符串
语法：
int web_reg_find(const char *attribute_list, LAST);
//attribute_list：通过Name=Value传参，Text/TextPfx/TextSfx必须有一个，其他属性可选。
//Text：要搜索的字符串，肥哦那个；
//TextPfx：要搜索的字符串的直接前缀
//TextSfx：要搜索的字符串的直接后缀
//Search：搜索的范围：Headers、Body（默认）、Noresource（仅在HTML请求体中搜索，不含头和资源）、ALL
//SaveCount：匹配个数，若指定了该值，且未使用Fail，无论是否找到，检查不会失败
//Fail：设置检查函数在什么状态下失败，Found/NotFound（默认）
//ID：日志文件中标识此函数的一个字符串
//RelFrameId：相关联的FrameId
返回值：
成功时返回LR_PASS (0)，失败时返回 LR_FAIL (1)
示例：
示例1：
web_reg_find("Fail=NotFound",
"Search=Body",
"SaveCount=1",
"Text=Web Tours",
LAST
);
示例2：
Action()
{
web_reg_save_param("userSession",
"LB=name=\"userSession\" value=\"",
"RB=\"/>",
LAST);
web_url("index",
"URL=http://127.0.0.1:1080/WebTours/index.htm",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t1.inf",
"Mode=HTML",
LAST);
web_reg_find("Text=Welcome",
"SaveCount=WelcomeCount", //记录Text出现的次数
LAST);
web_submit_data("login.pl",
"Action=http://127.0.0.1:1080/cgi-bin/login.pl",
"Method=POST",
"RecContentType=text/html",
"Referer=http://127.0.0.1:1080/cgi-bin/nav.pl?in=home",
"Snapshot=t4.inf",
"Mode=HTML",
ITEMDATA,
"Name=userSession", "Value={userSession}", ENDITEM,
"Name=username", "Value=jojo", ENDITEM,
"Name=password", "Value=bean", ENDITEM,
"Name=JSFormSubmit", "Value=on", ENDITEM,
"Name=login.x", "Value=51", ENDITEM,
"Name=login.y", "Value=10", ENDITEM,
LAST);
lr_output_message(lr_eval_string("{WelcomeCount}"));
if (atoi(lr_eval_string("{WelcomeCount}")) > 0){
//atoi:将字符串转化为整型
lr_output_message("Login success!");
} else {
lr_output_message("Login failure!");
}
return 0;
}
//运行结果：
//2
//Login success!
web_find和web_reg_find对比：
1、web_find必须开启内容检查才可生效；web_reg_find不必
2、web_find在返回页面中查；web_reg_find在缓存中查
3、web_find效率较低
4、总结：更推荐使用web_reg_find
1.9、web_reg_save_param方法
将请求的动态数据信息保存到参数，一般用于参数关联
语法：
int web_reg_save_param (const char *ParamName, <List of Attributes>, LAST);
//ParamName:参数名，将关联的文本字符串保存在该参数
//List of Attributes：
//Convert：可选，HTML_TO_URL(将HTML编码数据转换为URL编码数据格式)/HTML_TO_TEXT(将HTML编码数据转为纯文本数据格式)
//IgnoreRedirections：可选，Yes时，不搜索重定向(300-303、307)返回的信息
//LB:必选，参数左边界
//RB:必选，参数右边界
//NOTFOUND:可选，当边界未找到时，生成一个空串，error（当边界未找到时，报错）；warning（未找到时，设置参数计数为0，并继续执行脚本）
//ORD:可选，匹配的序号或出现的次数，默认为1，设置为ALL，则将参数值保存在数组中
//Search：可选，搜索范围：Headers、Body、ALL
//SaveLen：找到的值的字符按串长度（在指定偏移量中），默认-1，表示到字符串末尾
//SaveOffSet:找到的值的子字符串的偏移量，默认为0，从搜索到的字符串中取子串。
示例：
//设置userSession参数关联
web_reg_save_param("userSession",
"LB=name=\"userSession\" value=\"",
"RB=\"/>",
LAST);
//打开WebTours主页
web_url("index.htm",
"URL=http://127.0.0.1:1080/WebTours/index.htm",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t1.inf",
"Mode=HTML",
LAST);
注意：在关联期间可以捕获的参数的最大长度的默认值为256个字符，如果需要使用到超过256字符的关联参数，需要使用web_set_max_html_param_len函数增加最大有效长度：
web_set_max_html_param_len("1024"); //login_token参数超长，需要增加最大长度
web_reg_save_param("login_token", //login_token参数长度超过256
"LB={\"token\":\"",
"RB=\",\"",
"Search=Body",
LAST);
1.10、web_add_header方法
将指定请求头添加到下一个HTTP请求中，如：
web_add_auto_header("content-type", "application/json;charset=UTF-8");
1.11、web_add_auto_header方法
将指定的标头添加到所有后续HTTP请求中，如：
web_add_auto_header("token", "xxxxxx"); //后面的请求都自动带上token
添加了之后，后续所有请求请求头中都会带token。
2、lr常用方法
2.1、lr_start_transaction
为性能分析标记事务的开始，具体如下：
int lr_start_transaction (const char * transaction_name);
//transaction_name:事务名
//如：lr_start_transaction("tran01_login");
2.2、lr_end_transaction
为性能分析标记事务的结束，具体如下：
int lr_end_transaction (const char * transaction_name,int status);
//status：事务的结束状态：共有LR_PASS(通过)、LR_FAIL(失败)、LR_AUTO（自动）、 LR_STOP(暂停)
//如：lr_end_transaction("tran01_login",LR_AUTO);
2.3、lr_rendezvous
设置集合点，具体如下：
int lr_rendezvous(const char * rendezvous_name);
//rendezvous_name:集合点名称
//如：lr_rendezvous("旅客值机");
2.4、lr_think_time
设置思考时间，单位秒，如：
lr_think_time(22);
2.5、lr_eval_string
返回脚本中一个参数的当前值：
格式：lr_eval_string("{参数名}");
2.6、lr_save_string
将以NULL结尾的字符串保存到参数中
lr_save_string( const char *param_value, const char *param_name)
//param_value:指定字符串值
//param_name：参数名
//如：将字符串value1保存至参数name1：
//lr_save_string("value1", "name1");
示例如下：
Action()
{
lr_save_string("value1","name1");
lr_output_message("name1 is:%s",lr_eval_string("{name1}"));
lr_save_string(lr_eval_string("{name1}"),"name2");
lr_output_message("name2 is:%s",lr_eval_string("{name2}"));
return 0;
}
//运行结果：
//name1 is:value1
//name2 is:value1
2.7、lr_save_var
将变长字符串保存到参数中
int lr_save_var (const char * param_value，unsigned long constvalue_len，unsigned long const options，const char *param_name);
//param_value：待分配给参数的值。
//value_len：值的长度（以字节为单位）。
//options：参数选项，当前为0。
//param_name：参数名称。
示例如下：
Action()
{
lr_save_string("abcde12345","string1");
lr_output_message(lr_eval_string("{string1}"));
lr_save_var(lr_eval_string("{string1}")+3, 4, 0, "string2");
//从string1下标3处开始截取，截取长度为4，将结果赋值给string2
lr_output_message(lr_eval_string("{string2}"));
return 0;
}
//运行结果：
//abcde12345
//de12
2.8、lr_save_datetime
将当前日期和时间保存到参数中
void lr_save_datetime(const char *format, int offset, const char *name);
//format：格式化信息
/*
%a 星期几的简写
%A 星期几的全称
%b 月分的简写
%B 月份的全称
%c 标准的日期的时间串
%C 年份的后两位数字
%d 十进制表示的每月的第几天
%D 月/天/年
%e 在两字符域中，十进制表示的每月的第几天
%F 年-月-日
%g 年份的后两位数字，使用基于周的年
%G 年分，使用基于周的年
%h 简写的月份名
%H 24小时制的小时
%I 12小时制的小时
%j 十进制表示的每年的第几天
%m 十进制表示的月份
%M 十时制表示的分钟数
%n 新行符
%p 本地的AM或PM的等价显示
%r 12小时的时间
%R 显示小时和分钟：hh:mm
%S 十进制的秒数
%t 水平制表符
%T 显示时分秒：hh:mm:ss
%u 每周的第几天，星期一为第一天 （值从0到6，星期一为0）
%U 第年的第几周，把星期日做为第一天（值从0到53）
%V 每年的第几周，使用基于周的年
%w 十进制表示的星期几（值从0到6，星期天为0）
%W 每年的第几周，把星期一做为第一天（值从0到53）
%x 标准的日期串
%X 标准的时间串
%y 不带世纪的十进制年份（值从0到99）
%Y 带世纪部分的十制年份
%z，%Z 时区名称，如果不能得到时区名称则返回空字符。
%% 百分号
*/
//offset：时间偏移量
/*
DATE_NOW(现在的日期)
TIME_NOW(现在的时间)
ONE_DAY(一天的时间)
ONE_HOUR(一小时的时间)
ONE_MIN(一分钟的时间)
*/
//name：保存的参数名
示例如下：
Action()
{
lr_save_datetime("%Y-%m-%d",DATE_NOW+3*ONE_DAY,"threeDay");
lr_output_message(lr_eval_string("{threeDay}"));
return 0;
}
//保存3天后的日期到参数threeDay中，如今天为20220606，运行结果如下：
//2022-06-09
2.9、lr_output_message
将消息打印到输出窗口
2.10、lr_error_message
3、C语言常用方法
脚本增强时，为了对返回的数据做处理，经常会使用c语言字符串处理函数，常用的函数总结如下：
3.1、数据类型定义
Loadrunner中常用的C数据类型包括整型和字符串，定义方法示例如下：
注意：定义数据必须要写在脚本的最前面，否则会报错。
char str1[] = "aabbcc"; //定义后需要即刻赋初值
char * str2, str3[10], str4[10]; //定义字符串str2；str3,str4长度为10
long num1 = 12345678; //定义长整型num1，并赋初值
int num2; //定义整型num2
str2 = "112233"; //给str2赋值
num2 = 123; //给num2赋值
lr_output_message("str1 is %s", str1);
lr_output_message("str2 is %s", str2);
itoa(num1,str3,10); //取num1值，转为10进制的字符串
itoa(num2,str4,16); //取num2值，转为16进制的字符串
lr_output_message("str3 is %s", str3);
lr_output_message("str4 is %s", str4);
运行结果如下：
/*
str1 is aabbcc
str2 is 112233
str3 is 12345678
str4 is 7b
*/
3.2、sprintf
将格式化的字符串输出到目标字符串（一般为数组）
sprintf( char *string_buffer, const char *format_string[, args] );
//string_buffer:目标字符串(一般为数组)
//format_string：一个或多个格式化字符
//args：一个或多个可选的打印参数
示例如下
int num1 = 001;
char str1[20], * str2 = "abc";
sprintf(str1, "%d+%s", num1, str2);
lr_output_message("str1 is %s", str1);
//运行结果：str1 is 1+abc
3.3、strstr
返回字符串中首次出现子串的地址。
char *strstr(const char *str1, const char *str2);
//str1：被查找的目标
//str2：要查找的对象
//运行结果：若str2为str1的字串，则返回str2首次出现地址，若不是，则返回NULL
示例如下：
char * str1 = "abcdefg";
char * str2 = "cde";
char * str3 = "cdf";
lr_output_message("substr2 is %s", strstr(str1, str2));
lr_output_message("substr3 is %s", strstr(str1, str3));
lr_output_message("substr4 is %s" ,(char *)strstr(str1, str2));
if (strstr(str1, str3) == NULL) {
lr_output_message("fail!!!");
}
//运行结果如下：
/*
substr2 is cdefg
substr3 is (null)
substr4 is cdefg
fail!!!
*/
3.4、strcat
连接两个字符串。
char *strcat ( char *to, const char *from );
//将from连接到to后，连接后的字符串值赋给to
示例：
char str1[] = "abc"; //注意不能定义为char *str1 = "abc";这种方式定义的字符串不可变
char * str2 = "def";
strcat(str1, str2);
lr_output_message(str1);
//运行结果：abcdef
3.5、strncat
连接两个字符串，最多n位，如：
char str1[10] = "abcdef";
char str2[10] = "123456";
strncat(str1, str2 ,3);
lr_output_message(str1);
//运行结果：abcdef123
3.6、strcpy
复制一个字符串到另一个字符串
char *strcpy(char *dest, const char *source)
示例：
char str1[100];
strcpy(str1, "abcdef");
lr_output_message(str1);
//运行结果：abcdef
3.7、strncpy
复制一个字符串到另一个字符串，最多复制n个字符，示例如下：
char str1[20],str2[20];
strcpy(str1, "abcdef");
strncpy(str2, str1, 3); //str1的前3个字符复制到str2
lr_output_message(str1);
lr_output_message(str2);
lr_output_message((char *)strncpy(str2, str1, 3));
//运行结果
/*
abcdef
abc
abc
*/
3.8、strchr
返回字符串中指定字符后的字符串，未找到则返回NULL
char *strchr(const char *string, int c)
示例：
char *str1 = "abcdecfg";
char *str2, *str3, str4;
str2 = (char *)strchr(str1, 'c');
//strchr表示第一个出现的字符
//不能写成"c",单引号引起的字符代表整数，双引号为字符串
//(char *)为强制类型转换，将后面表达式强制转为char*类型
lr_output_message("str2 is %s", str2);
str3 = (char *)strrchr(str1, 'c');
//strrchr表示最后一个出现的字符
lr_output_message("str3 is %s", str3);
str4 = strchr(str1, 'm');
lr_output_message("str4 is %s", str4);
//运行结果：
/*
str2 is cdecfg
str3 is cfg
str4 is (null)
*/
3.9、strcmp/stricmp
比较字符串
int strcmp ( constchar *string1, const char *string2 );
int stricmp ( const char *string1, const char *string2 );
//strcmp大小写敏感，stricmp大小写不敏感
//string1 < string2时，返回-1
//string1 > string2时，返回1
//string1 = string2时，返回0
示例：
char *str1 = "AAA";
char *str2 = "aaa";
lr_output_message("result is %d", strcmp(str2, str1));
lr_output_message("result is %d", strcmp(str1, str2));
lr_output_message("result is %d", stricmp(str1, str2));
//运行结果：
/*
result is 1
result is -1
result is 0
*/
3.10、strlwr
将字符串转为小写
char *strlwr(char *string);
示例：
char str1[10] = "AAA";
strlwr(str1);
lr_output_message(str1);
//运行结果：aaa
3.11、strlen
返回字符串长度，如：
char str1[10] = "abcdef";
lr_output_message("str1 length is %d", strlen(str1));
//运行结果：str1 length is 6
3.12、sizeof
判断数据类型或者表达式长度，如：
char str1[123];
lr_output_message("str1 size is %d", sizeof(str1));
lr_output_message("int size is %d", sizeof(int));
lr_output_message("long size is %d", sizeof(long));
lr_output_message("char size is %d", sizeof(char));
//运行结果如下：
/*
str1 size is 123
int size is 4
long size is 4
char size is 1
*/
3.12、menset
将某一块内存中的内容全部设置为指定的值，通常为新申请的内存做初始化工作
void *memset(void *str, int c, size_t n)
如：
char str1[20];
strcpy(str1, "abcdefg");
memset(str1, '#',3);
lr_output_message(str1);
//运行结果：###defg
实际初始化内存使用方法如下：
char str1[20];
strcpy(str1, "abcdefg");
memset(str1, 0, sizeof(str1));
//也可以写成：memset(str1, '\0', sizeof(str1));
lr_output_message("str1 is %s", str1);
//运行结果：str1 is