loadrunner Web_类函数之web_custom_request（）

最新推荐文章于 2020-06-03 14:13:26 发布

testingstar

最新推荐文章于 2020-06-03 14:13:26 发布

阅读量2.9k

点赞数

分类专栏： LoadRunner 性能测试 LoadRunner函数文章标签： loadrunner 性能测试函数 c语言

LoadRunner函数同时被 3 个专栏收录

159 篇文章 8 订阅

订阅专栏

性能测试

158 篇文章 2 订阅

订阅专栏

LoadRunner

152 篇文章 2 订阅

订阅专栏

web_custom_request（）--常用函数

允许您使用HTTP支持的任何方法创建自定义HTTP请求。

该函数与web_submit_data()函数相比优点在于body参数部分可以是不固定动态参数数据信息，可以动态添加多个ENDITEM参数值。

int web_custom_request( const char *RequestName,<List of Attributes>,
[EXTRARES, <List of Resource Attributes>,] LAST );

参数说明:

Object:一个表达式，求值到类型为WebApi的对象。通常是webfor Java和Visual Basic。另请参见函数和常量前缀。

RequestName:步骤的名称，如图形脚本中所示。

List ofAttributes:属性列表请参阅属性。注意：属性名称区分大小写（方法与方法）。

EXTRARES:一个分界参数，指示下一个参数将是资源属性列表。

List of Resource Attributes: Listof Resource Attributes

LAST:指示字段列表结束的标记。

一般信息:

web_custom_request函数是一个操作函数，允许您使用任何方法或主体创建自定义HTTP请求。默认情况下，VuGen仅为无法使用其他Web功能解释的请求生成此函数。

要手动插入此功能，请使用“添加步骤”对话框。要指定要在自定义请求之前发送的HTTP标头，请添加web_add_header或web_add_auto_header函数。

仅当执行基于HTML的记录时插入额外资源属性，并且在当前脚本步骤中将“非HTML生成元素”高级记录选项设置为记录。这是默认设置。有关详细信息，请参阅“HP LoadRunner虚拟用户生成器用户指南”。

所有Web脚本以及以HTTP或无线会话协议（WSP）重放模式运行的WAP脚本支持此功能。

属性:

URL - 要加载的网页的URL（统一资源定位符）。

Method - 表单提交方法：POST或GET。

TargetFrame - 包含当前链接或资源的帧的名称。点击这里了解更多信息。

EncType - 使用的编码方法的类型

EncType指定要指定为当前重放的“Content-Type”REQUEST标题的值的Content-Type，例如“text /html”。 web_custom_request不执行正文编码。 Body参数指定要使用的主体（或在应用“二进制”处理之后），其中已经应用了任何编码。因此，指定与主体不匹配的EncType可能会导致服务器端错误。一般来说，建议您不要将EncType编辑为已记录。

任何EncType规范以静默方式覆盖Content-Type的任何web_add_[auto_]标题。如果指定“EncType =”（空值），则不会生成“Content-Type”请求标头。如果省略“EncType”，则使用任何适用的web_add_ [auto_]标题。如果没有标题和“Method = POST”，“application / x-www-form-urlencoded”被用作默认值。否则，不生成Content-Type请求头。

RecContentType - 记录期间RESPONSE标头的内容类型，例如，text/ html，application / x-javascript。它被读取以确定目标URL是否是可记录资源。点击这里了解更多信息。

RecContentType指定记录的“Content-Type”RESPONSE标头值。当未指定资源以确定目标URL是否是资源时，将使用RecContentType值。

Referer - 引用网页。点击这里了解详情。

Body - 请求的正文。有关可用选项的完整列表，请参阅Body Attribute（主体属性部分）。有关在Body属性中使用二进制代码的信息，请参阅Using Binary Code（使用二进制代码）。

Raw Body - 请求的主体作为指向数据的指针传递。请参见Raw Body Attribute（原始属性部分）。

BodyFilePath - 要作为请求的主体传递的文件的路径。 BodyFilePath不能与Body或任何Body, or any Body Attribute or Raw Body Attribute：BodyBinary，BodyUnicode，RAW_BODY_START或Binary = 1。

Resource - 指示URL是否为资源的值：

“Resource = 1”表示URL是一个资源，这意味着它对于脚本的成功并不重要。任何下载资源的失败都将被视为警告而不是错误

是否下载是否受“下载非HTML资源”运行时设置的影响

响应不会解析为HTML

“Resource = 0”表示URL是关键的，不受RTS影响，如果需要，将被解析。

ResourceByteLimit- 请参阅ResourceByteLimit部分。

Snapshot - 用于关联的快照文件的文件名（inf扩展名）。

Mode - 录制级别：HTML或HTTP。点击这里了解更多信息。

ExtraResBaseDir -解析EXTRARES组内相对URL的基本URL。

UserAgent - “User-Agent”是标识应用程序的HTTP标头的名称，通常是浏览器，代表与服务器交互的用户。

例如，标题“User-Agent：Mozilla /4.0（compatible; MSIE 6.0; Windows NT 5.0）”标识用于Windows NT的MicrosoftInternet Explorer 6.0。其他用户代理字符串用于不同的浏览器和其他非浏览器应用程序。通常，来自应用程序的所有请求使用相同的User-Agent值，记录器将其指定为运行时设置。然而，即使在常规的浏览器会话中，也可能存在直接与服务器交互的非浏览器组件（例如，Active-X），并且通常具有与浏览器不同的User-Agent字符串。指定UserAgent表示这是非浏览器请求。指定的字符串在“User-Agent：”HTTP标头中使用，并且在某些方面影响Replay的行为，例如，通过不使用浏览器缓存，假设指定的URL是资源等。

不进行检查以验证指定的值是否不同于浏览器的值。

Binary

“Binary = 1”指定形式为\\ x ##，其中“##”是两个“十六进制数字”（0-9，a-f或A-F）的正文中的每个序列，字节包含指定的十六进制值。

如果“Binary = 0”（默认值），这样的序列按字面传递。

注意，使用两个反斜杠。它们被C解释器解释为一个反斜杠。当不需要零字节时，可以使用一个反斜杠而不使用“Binary = 1”（例如，\ x20而不是\\ x20）。当需要零字节IS时，指定\ x00将导致字符串被逻辑截断（空终止符），并且\\ x00需要使用“Binary = 1”指定。

ContentEncoding

请求通过使用指定方法（即gzip或deflate）编码（例如，压缩）请求主体，以及相应的“Content-Encoding：”HTTP头与请求一起发送。这适用于web_custom_request和web_submit_data。

示例：web_custom_request

在以下记录的脚本中，用户从http：//lazarus/html/forms/file.html开始记录。当用户提交他的请求时，VuGen插入了一个web_add_header函数，然后是一个web_custom_request函数。

web_url（“file.html”，“URL = http：//lazarus/html/forms/file.html”，

“TargetFrame= _TOP”，LAST）;

web_add_header（“Content-Type”，

“multipart /form-data; boundary = --------------------------- 292742461228954”）;

web_custom_request（“post_query.exe”，“Method =POST”，

“URL = http：//lazarus/cgi-bin/post_query.exe”，

“Body =----------------------------- 292742461228954 \ r \ n Content-Disp”

“osition：form-data;name = \”entry \“\ r \ n \ r \ nText \ r \ n ----------”

“-------------------292742461228954 \ r \ n内容 - 处置：f”

“-----------292742461228954 - \ r \ n”，

“TargetFrame=”，

LAST）;

RecContentType

记录的资源类型。此属性包含有关主资源和辅助资源的信息。最常用的主要类型是文本，应用程序和图像。辅助类型根据资源而异。例如，“RecContentType= text / html”表示导航到HTML文本。“RecContentType = application / msword”表示使用MS Word应用程序。

请注意，当设置资源属性参数时，将忽略此参数。 Resource参数是Action函数的另一个可用属性。

Resource Attribute

如果“资源”设置为0，则在重放期间始终会下载URL。

如果“资源”设置为1，则仅当选中下载非HTML资源选项（请参阅运行时设置>浏览器仿真选项卡）时才会下载URL。

Body Attribute

请求的主体作为属性参数Body，BodyBinary或BodyUnicode的值传递，具体取决于内容。主体可以是单个参数，也可以划分为多个主体段，即一系列参数。例如，以下对web_custom_request的调用将正文分为三个段：一个unicode段，后跟一个二进制段，后跟常规文本。最终的主体是所有三个部分以与传递给函数的顺序相同的顺序连接在一起的结果。

web_custom_request（

......

“BodyUnicode= REPRICE”

“BodyBinary =\\ x08 \\ x00 \\ xCC \\ x02 \\ x00 \\ x00”

“Body =。\ r \ n”

“-dxjjtbw /（.tp？eg：ch / 6 - \ r\ n”，

持续）;

不推荐使用的web_custom_request参数Binary也可以用于表示二进制主体，但仅当将一个Body段传递给函数时。

所有正文值都是ASCII，以null结尾的字符串。

正文 - 表示正常，可打印的文本。无法表示空字节（除了见下面的注释）。所有字符都使用反斜杠指定。

注意：在较早的脚本中，您可能会看到以十六进制代码（例如，“\\ x5c”）在Body参数中编码的不可打印字符，在这种情况下，还必须将“Binary = 1”作为参数传递。 NULL字节可以以这种方式表示（“\\ 00”）。相比之下，较新的脚本将主体分为多个主体段，例如“Body = ...”，“BodyBinary = ...”，Body = ...“。

BodyBinary - 表示二进制代码。不可打印字符以十六进制编码，格式为\\ xHH，其中HH指定十六进制值。 NULL字节由“\\ 00”指定

BodyUnicode - 美国英语，特别是Latin1UTF-16LE（小端）仅Unicode。实际参数被去除额外的零字节，附加每个字符以使得更容易阅读文本。在发送到Web服务器之前，它由web_custom_request重新附加。

对于不可打印的字符，使用单个反斜杠。无法表示空字节。

注意：对于长度超过100K的实体，将显示变量名称，而不是属性。变量在lrw_custom_body.h中定义。