Loadrunder脚本篇——web_custom_request函数介绍

c语言版本：

int web_custom_request(const char *RequestName, ,

[EXTRARES, ,] LAST );

参数说明：

RequestName            step名称，即请求名。

List of Attributes    属性列表

注意：属性名称大小写敏感

EXTRARES               界定参数，表名接下来的参数将是个资源属性列表

LAST                   表名列表结束的标记

List of Attributes

URL - 统一资源定位器，通常为请求链接地址

Method - 请求方法：POST、GET

TargetFrame - 包含当前链接或资源的frame的名称

EncType - 提交请求使用的编码类型(type of encoding)。EncType指定“Content-Type”请求头的值，比如“text/html”。web_custom_request不处理未编码的请求体。Body参数指定的请求体会使用指定的编码。因此，如果指定的Enctype如果不匹配请求体，可能会引发服务端错误。通常情况下，按照录制所得，不对Enctype进行编辑。

如果指定了“EncType”，那么它将会覆盖web_add_[auto_]header函数指定的Content-Type。如果“EncType=”（空值），不会生成“Content-Type” 请求头；如果省略了“EncType”时，那么使用web_add_[auto_]header函数指定的。如果既没有指定EncType也没使用web_add_[auto_]header函数设定请求头，且“Method=POST”，那么，将使用“application/x-www-form-urlencoded”做为默认值。其他情况下，不会生成Content-Type请求头。

RecContentType - 指定了Content–Type 响应头的类型，比如text/html,application/x-javascript。当没有设置Resource属性时，用它来确定目标URL是否是可录制的资源。

Refer - 指定引用的页面

Body - 请求体

Raw Body - 请求体被当作指向数据的指针来传递

BodyFilePath - 需要作为请求体传递的文件路径，不能和Body一起使用，或者任何Body、Raw Body Attribute的属性: BodyBinary, BodyUnicode, RAW_BODY_START 或 Binary=1

Resource - 一个表明URL是否资源的值

Resouce=1，表明URL为一个资源，意味着当前操作与所在脚本的成功与否关系不大。在下载资源时如果发生错误，将当作警告而不是错误来处理的

是否下载URL受“Run-Time Setting—Browser Emulation--Download non-HTML resources” 这个选项的影响。勾选该选项，则不按HTML的形式解析响应信息。

“Resource=0”，表明此URL是重要的，不受发送请求（RTS）的影响，在需要时也会解析它。

ResourceByteLimit - 下载web页面资源的极限大小。当达到设置的极限后，不再下载资源，仅仅对需要下载的资源起作用。

Snapshot - 快照的文件名（.inf为后缀

Mode - 录制级别：HTML、HTTP

HTML级别：在当前Web界面上直观的录制HTML操作。这些操作被录制为web_url、web_link、web_image、web_submit_form等step。VuGen仅仅录制返回HTML页面的请求，不处理脚本和应用程序。

HTTP级别：VuGen把所有的请求录制为web_url step，不生成web_link、web_image、web_submit_form这些函数。这种方法更为灵活，但是生成的脚本不够直观。

ContentEncoding - 请求使用指定的方法（gzip或者deflate）对请求体进行编码，相应的“Content-Encoding:”HTTP头会随此请求一起发送。仅适用于web_custom_request和web_submit_data。

List of Resource Attributes

list of Attributes由非HTML机制的web页面生成,包含Javascript,Activex,Java applets和Flash请求的资源。VuGen Recording Options中可设置，把这些元素录制在当前脚本step中或者单独的step(查看Recording in HTML–Based Mode)

当录制在当前脚本的step中时，额外的资源被当作参数列出，支持以下资源属性：

URL       需要加载的web资源

Referer   URL引用的web页面

ENDITEM   表示list中，每个资源结束的标记

相比录制每个资源为一个单一的step，按这种模式录制non-HTML元素可以精简脚本，增加可读性。

当遇到一个附加的资源时，例如，一个Javascript，VuGen录制器添加资源到附加资源列表(Resource Attributes参数列表)。当回放脚本时，会请求该资源。如果资源规律性变化，可使用关联函数参数化该资源。

例子：

web_reg_save_param("extrares_11",

"LB=loadrunner <wbr> 脚本开发-web_custom_requests函数详细介绍”

"RB=\"",

"Ord=11",

LAST );

web_url("web_url",

"URL=http://lazarus/html/links.html",

"TargetFrame=",

"Resource=0",

"Referer=",

"Mode=HTTP",

EXTRARES,

"URL={extrares_11}", ENDITEM,

LAST );

函数使用范围:

支持所有Web脚本，和以HTTP协议或者无线会话协议(WSP，Wireless Session Protocol)运行的WAP脚本