全国咨询热线：136-9172-9932
性能测试工具LoadRunner中关于异步通信的API函数主要包括：web_reg_async_attributes、web_stop_async、web_sync、web_util_set_request_url和web_util_set_request_boby。在本章节中将详细介绍web_reg_async_attributes和web_stop_async这两个异步通信API。
1、 web_reg_async_attributes
异步通信API函数web_reg_async_attributes的格式如下：
int web_reg_async_attributes("ID=id","URL[/RE][/IC]=URL_or_RegEx_Pattern", ["Pattern=None|Push|Poll|LongPoll", ["PollIntervalMs=integer"]], ["XMLHttpRequest=No|Async|Sync",] ["CrossStep=No|Yes",] ["RequestCB=function_name",] ["ResponseBodyBufferCB=function_name",] ["ResponseCB=function_name",] LAST);
参数说明：
ID：会话ID。
URL：表示URL地址。
Pattern：设置异步通信的方式。
PollIntervalMs：在另一个实例开始之前，等待多久结束轮询实例。
XMLHttpRequest：设置是否处理javascript中的XML HTTP请求，以及处理其它任务的异步信息。
CrossStep：设置服务器是否等待完成指定URL的响应。
RequestCB：用户编码的用于回调功能的函数名称。
ResponseBodyBufferCB：用户编码的用于回调功能的函数名称，但针对的内容为缓存中接收的内容。
ResponseCB：用户编码的用于回调功能的函数名称，在会话结束后调用。
LAST：结束参数标志。
1) ID
LAST：结束参数标志。
标识一个异步会话的ID，一个异步会话是由一系列的请求任务，包括所有的请求和重定向任务。会话是从请求获得了所需要的服务器响应开始，包括所有的请求和响应，当期望响应被覆盖或是一系列的会话被取消，ID在整个Vuer脚本中必须是唯一的。
一个会话ID命名规则应该遵循以下规则：
不能是空字符串;
不能以下划线开始;
ID名中第一个字符和最后一个字符不能为空格;
不能包含控制字符，字符从0x00到ox1F;
不能包含描述性能控制字符，如\r、\t和\n等。
会话ID不区分大小写，如：“www.host.com/Path?Query”可以匹配“www.host.com/PATH?Query”。
会话ID对空格是敏感的，即一个空格不可以匹配多个空格，如“AA A”不能匹配“AA A”。
如果使用URL做为会话ID，那么将URL字符都会转换成小写字符，但并不对其再做其它的操作。如没有解决的URL转义码、没有添加或去除默认端口号，“http://www.abcd.com:80 ≠ http://www.abcd.com”。
2) URL
表示URL地址，如果设置为“/RE”表示URL可以使用正则表达式匹配;如果设置为“/IC”表示不区分大小写。
3) Pattern
设置异步通信的方式，通常异步包括堆、轮询和长轮询三种，可以设置为None、Push、Poll和LongPoll中的一种。
4) PollIntervalMs
在另一个实例开始之前，等待多久结束轮询实例，单位为毫秒。
5) XMLHttpRequest
设置是否处理javascript中的XML HTTP请求，以及处理其它任务的异步信息，有三个可选项设置：No、Async或Sync。
如果Pattern选项设置为None或Push，那么该选项应该设置为No。
如果Pattern选项设置为Poll或LongPoll，那么该选项应该设置为Async。
6) CrossStep
设置服务器是否等待完成指定URL的响应，如果设置为“Yes”，那么将不等待服务器返回指定URL请求，可设置项为“Yes”或“No”，对于所有的Pattern选项内容其默认设置为“Yes”(除Pattern选项设置为None)。
7) RequestCB
用户编码的用于回调功能的函数名称，这个回调在发送请求之前被执行。
8) ResponseBodyBufferCB
用户编码的用于回调功能的函数名称，但针对的内容为缓存中接收的内容，如果响应的内容涉及到缓存数据，则会触发该回调函数。
9) ResponseCB
用户编码的用于回调功能的函数名称，在异步会话结束时，回调该函数。
在录制完成后，VuGen会扫描脚本中是否有异步的会话，如果发现有异步会话，那么VuGen会在web_reg_async_attributes函数中添加回调函数来匹配异步信息，主要包括RequestCB、ResponseBodyBufferCB和ResponseCB三个回调函数，这些回调函数存储在AsyncCallbacks.c文件中(该文件保存在脚本的根目录下)。
在web_reg_async_attributes函数中回调函数的内容如图6-68所示。
图6-68 回调函数
AsyncCallbacks.c文件中的内容如下：
int Poll_0_RequestCB()
{
//enter your implementation for RequestCB() here
//call web_util_set_request_url() here to modify polling url
//url is expected to be of the form:
//http://flight.qunar.com/twell/flight/tags/onewayflight_groupdata.jsp?&departureCity=%e6%b7%b1%e5%9c%b3&arrivalCity=%e5%8d%97%e6%98%8c&departureDate=2013-04-12&returnDate=2013-04-12&nextNDays=0&searchType=OneWayFlight&searchLangs=zh&locale=zh&from=qunarindex&queryID=192.168.0.19%3a63ab0de2%3a13df30a3fd7%3a-597b&serverIP=l-tw6.f.cn1.qunar.com%2f192.168.0.19&status={TimeStamp_Poll_0_0}&_token={Unknown_Poll_0_1}&deduce=true
//the following parameters must be assigned:
web_save_timestamp_param("TimeStamp_Poll_0_0",LAST);
//TODO - implement parameter of type unknown: Unknown_Poll_0_1.
//Known examples for Unknown_Poll_0_1: _token=67228, _token=72210, _token=19725, _token=24410,
lr_save_string("67228","Unknown_Poll_0_1");
//once all parameters have been assigned, copy them to the updated url,
//and call web_util_set_request_url() with the updated url:
web_util_set_request_url("http://flight.qunar.com/twell/flight/tags/onewayflight_groupdata.jsp?&departureCity=%e6%b7%b1%e5%9c%b3&arrivalCity=%e5%8d%97%e6%98%8c&departureDate=2013-04-12&returnDate=2013-04-12&nextNDays=0&searchType=OneWayFlight&searchLangs=zh&locale=zh&from=qunarindex&queryID=192.168.0.19%3a63ab0de2%3a13df30a3fd7%3a-597b&serverIP=l-tw6.f.cn1.qunar.com%2f192.168.0.19&status={TimeStamp_Poll_0_0}&_token={Unknown_Poll_0_1}&deduce=true");
//call web_util_set_request_body() here to modify request body:
//web_util_set_request_body("
return WEB_ASYNC_CB_RC_OK;
}
int Poll_0_ResponseBodyBufferCB(
const char * aLastBufferStr,
int aLastBufferLen,
const char * aAccumulatedStr,
int aHttpStatusCode)
{
//enter your implementation for ResponseBodyBufferCB() here
return WEB_ASYNC_CB_RC_OK;
}
int Poll_0_ResponseCB(
const char * aResponseHeadersStr,
int aResponseHeadersLen,
const char * aResponseBodyStr,
int aResponseBodyLen,
int aHttpStatusCode)
{
//enter your implementation for ResponseCB() here
return WEB_ASYNC_CB_RC_OK;
}
在实际测试过程中可以对RequestCB回调包进行修改，通常修改的方法有以下两种：
1) 在RequestCB回调包中修改请求的URL信息
在轮询和长轮询会话过程中，每次轮询迭代时请求的URL信息经常会发生改变，这些变化通常是由客户端逻辑决定的，通常是由JavaScript通过浏览器来执行的。URL主要是由一些相关的参数组成，如果会话ID，要修改异步会话请求的URL信息使用的函数为web_util_set_request_url。
web_util_set_request_url函数格式如下：
web_util_set_request_url ( const char * aUrlStr);
aUrlStr是指请求URL字符串。
写在AsyncCallbacks.c文件中的int Push_0_RequestCB回调函数中，代码如下：
int Push_0_RequestCB()
{
//enter your implementation for RequestCB() here
//call web_util_request_set_url() here to modify request url:
web_util_set_request_url("
//call web_util_set_request_body() here to modify request body:
web_util_set_request_body("
return WEB_ASYNC_CB_RC_OK;
}
如会话中的URL请求内容如图6-69所示。
图6-69 变动的URL请求内容
web_util_set_request_url函数内容如图6-70所示。
图6-70 web_util_set_request_url参数内容
2) 在RequestCB回调包中修改请求的body信息
如果在异步会话中在发送请求点需要修改请求的body内容，那么需要使用web_util_set_request_body函数来修改body内容，并在每一次轮询前进行修改。
web_util_set_request_body函数格式如下：
web_util_set_request_body ( const char * aUrlStr);
aUrlStr是指请求URL字符串。
写在AsyncCallbacks.c文件中的int Push_0_RequestCB回调函数中，代码如下：
int Push_0_RequestCB()
{
//enter your implementation for RequestCB() here
//call web_util_request_set_url() here to modify request url:
web_util_set_request_url("
//call web_util_set_request_body() here to modify request body:
web_util_set_request_body("
return WEB_ASYNC_CB_RC_OK;
}
1、web_stop_async
当异步会话结束后需要取消异步会话，web_stop_async用于结束异步会话，函数格式如下：
web_stop_async( "ID=id", LAST);
当异步会话结束后需要取消异步会话，web_stop_async用于结束异步会话，函数格式如下：
ID：是指异步会话ID，指明需要结束的异步会话;
LAST：结束标识符;
如以下结束异步会话代码：
web_stop_async( "ID=Poll_0", LAST);
今天关于“LoadRunner中API函数”的内容就学习完了，相信大家都已经掌握了，如果喜欢的话记得每天来这里和小编一起学习涨薪技能哦。(笔芯)
附：川石信息全国校区最新开班时间，课程资料获取13691729932(微信同号)。
