完全抛弃脚本录制，LR脚本之使用web_custom_request函数自定义http请求

初学性能测试时候，第一步必学脚本录制，但一路下来各类录制失败、回放脚本失败的问题层出不穷，究其缘由一是LR自己存在对测试环境的兼容性问题致使录制失败，更深层次的缘由是录制者不清楚LR录制脚本的原理，或者不清楚客户端与服务器端之间的请求和应答内容及通讯方式，致使一旦出现脚本执行失败便无从下手。最近在作项目的一个接口测试时候，因请求是合做第3方发起的且不容易让第3方提供他们的平台给咱们作测试，因此这种状况是没办法取录制脚本的，只能选择手动编写脚本实现。得知接口是使用http协议的post方法，想到了web_submit_form()和web_submit_data()两个函数，它们实现了http请求中的post方法，问题来了，它们都提交表单到某个页面，但如今被测试的仅是个http接口，显然这两个函数都没法知足须要。

因而想到了web_custom_request(),这个函数的做用是自定义http请求规则，一看不禁地暗喜原来web_custom_request()函数是一个能够用于自定义http请求的“万能”函数，具备web_link()、web_url()、web_submit_data()函数的功能，能够自由定义须要的http的get和post请求。网上看到一篇介绍web_custom_requst，写的很是详细，分享一下（固然英文好的直接看LR自带的帮助文档会感受更原味）：

附录：web_custom_request函数语法详解

语法：
Int web_custom_request (const char *RequestName, <List of Attributes>,[EXTRARES, <List of Resource Attributes>,] LAST );

返回值：
LR_PASS（0）表明成功
LR_FAIL（1）表明失败。

参数：
一、RequestName：步骤的名称，VuGen中树形视图中显示的名称。
二、List of Attribute：支持的属性有如下几种：
1）URL：
   页面地址。
2）Method ：
   页面的提交方式，POST或GET。
3）EncType：
   编码类型。此参数给出一个内容类型（Content-Type），指定其作为回放脚本时“Content-Type”请求头的值，例如“text/html”。Web_custom_request函数不处理未编码的请求体。请求体参数将会使用已经指定的编码方式。所以，若是指定了不匹配HTTP请求体的“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请求头。
4）BodyFilePath：
   做为请求体传送的文件的路径。它不能与下面的属性一块儿使用：Body，或者其余Body属性或Raw Body属性包括BodyBinary，BodyUnicode，RAW_BODY_START或Binary=1。
5）UserAgent：
   用户代理，它是一个HTTP头的名字，用来标识应用程序，一般是浏览器，它呈现的是用户和服务器的交互。
例如：头信息“User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)”识别的是Window NT下的IE浏览器6.0。其余的User-Agent的值用来描述其余的浏览器，或者非浏览器程序。一般，一个应用程序中全部的请求都使用相同的用户代理，录制者做为一个运行时参数来指定（Run-Time Setting—Browser Emulation—User Agent）。无论怎么说，即便是在一个简单的浏览器进程中，仍有可能会用到直接与服务器交互的非浏览器组件（例如ActiveX控件），一般他们有着不一样于浏览器的用户代理属性。指定“UserAgent”表示这是一个非浏览器的请求。指定的字符串被HTTP头“User-Agent:” 使用，在某些状况下，它同时会影响回放脚本时的行为。例如，不使用浏览器缓存，假设指定的URL属于资源等等。（LoadRunner自己不检查指定的字符串与浏览器自己的值是否相同）
6）Binary：
   “Binary=1”表示页面请求体中的每个以file://x/##形式出现的值（在这里“##”表明2个十六进制数字），都会被替换为单字节的十六进制的值。若是“Binary=0”（默认值），全部的字符序列只是按照字面的值传递。须要注意双斜杠的用法。在C编译器中双斜杠被解释为单斜杠。若是不须要零字节，单斜杠能够在Binary不等于1的状况下使用（例如，使用\x20代替file://x20/）。若是须要零字节，那么只能使用file://x00/且设置 “Binary=1”，\x00在逻辑上会被截断。
7）ContentEncoding
   指定请求体的使用指定的方式（gzip或者deflate）进行编码（例如，压缩），相应的“Content-Encoding:” HTTP头会和此请求一块儿发送。这个参数适用于web_custom_request和web_submit_data。
8）FtpAscii：
   “1”使用ASCII模式处理FTP操做；"0" 使用二进制模式。
9）TargetFrame：
   当前连接或资源所在Frame的名称。除了Frame的名字，还能够指定下面的参数：
_BLANK：打开一个空窗口。
_PARENT：把最新更改过的的Frame替换为它的上级。
_SELF：替换最新更改过的的Frame。
_TOP：替换整个页面。
10）RecContentType：
   录制脚本时响应头的内容类型。例如text/html、 application/x-javascript等。当没有设置Resource属性时，用它来肯定目标URL是不是可记录的资源。此属性包含主要的和次要的资源。最频繁使用的类型是 text、application、image。次要的类型根据资源不一样变化不少。例如："RecContentType=text/html"：表示html文本。"RecContentType=application/msword"：表示当前使用的是Msword。
11）Referer：
   当前页面关联的页面。若是已经显式指定了url的地址，此项能够省略。
12）Resource：
   指示URL是否属于资源。1 是；0 不是。设置了这个参数后，RecContentType参数被忽略。“Resource=1”，意味着当前操做与所在脚本的成功与否关系不大。在下载资源时若是发生错误，是看成警告而不是错误来处理的；URL是否被下载受“Run-Time Setting—Browser Emulation--Download non-HTML resources” 这个选项的影响。此操做的响应信息是不作为HTML来解析的。“Resource=0”，代表此URL是重要的，不受发送请求（RTS）的影响，在须要时也会解析它。
13）ResourceByteLimit：
   web页面下载资源的极限大小。当达到设置的极限后，没法下载其余资源。仅仅对须要下载的资源有效。下载过程：若是总计下载大小小于极限值，则正常开始下载。若是当下载时达到了设置的极限值，资源大小可知（在HTTP响应头中指定了Content-Length），这中状况下，若是只须要一个缓冲区，那么下载能够正常完成。若是须要的不止一个缓冲区，或者资源大小不可知，下载就会中断同时关闭当前链接。这个特性能够用来模拟用户不等待一个页面下载完成时导航到另外一个页面的状况。在HTTP模式中没法使用，在Concurrent Groups（Vuser脚本中的一个区，此区中的全部函数并发执行）区中也没法使用。仅仅适用于Sockets的回放，WinInet也是不适用的。
14）Snapshot：
   快照的文件名。
15）Mode：
   两种录制级别HTML、HTTP。HTML级别--在当前Web界面上录制直观的HTML动做。以一步步的web_url、web_link、web_image、web_submit_form来录制这些动做。VuGen仅仅录制返回HTML页面的请求，不处理脚本和应用程序。HTTP级别--VuGen把全部的请求录制为web_url指令，不生成web_link、web_image、web_submit_form这些函数。这种方法更为灵活，可是生成的脚本不够直观。
16）ExtraResBaseDir：
   根URL，放在EXTRARES组里。它是用来解析相对URL的（译者加：相似于Windows的相对路径和绝对路径）。URL能够是绝对路径（例如http://weather.abc.com/weather/forecast.jsp?locCode=LFPO），也能够是相对路径（例如“forecast.jsp?locCode=LFPO”）。真正的URL的下载是经过绝对路径进行的，因此相对URL路径必须使用根路径URL去解析。例如，使用http://weather.abc.com/weather/作为根路径来解析“forecast.jsp?locCode=LFPO”，最后的URL是：http://weather.abc.com/weather/forecast.jsp?locCode=LFPO。若是没有指定“ExtraResBaseDir”，默认的根URL是主页面的URL。

17）Body：
   请求体。不一样的应用中，请求体分别经过Body、BodyBinary或者BodyUnicode参数来传递。请求体能够只使用其中一个参数，也可使用一连串的分开的参数组成多请求体。例如：
web_custom_request（

……

"BodyUnicode=REPRICE"

"BodyBinary=\\x08\\x00\\xCC\\x02\\x00\\x00"

"Body=.\r\n"

"-dxjjtbw/(.tp?eg:ch/6--\r\n",

LAST）；
    在上面的代码中，使用了3个参数来划分请求体，一个是Unicode段，一个是二进制段，最后一个是常规的字符串。最终的请求体是这3个参数按照在函数中的顺序链接起来的值。还有一个不多用到的参数，Binary。它也能描述二进制请求体，但只容许函数中只有一个请求体参数。全部的请求体都是ASCII字符，以null结束。
    Body--表示规则的，可打印的字符串。没法表示空字节。全部的字符都以一个反斜杠表示。注意：在旧的脚本中,能够看见不可打印的字符在请求体中以16进制方式进行编码。（例如 “\\x5c”），在这种状况下，必须使用“Binary=1”来标识。空字节使用"file://0.0.0.0/"来表示。 相反，新脚本则会把把请求体分开放在不一样的参数中（"Body=...", "BodyBinary=...", Body=..."）。
    BodyBinary--表示二进制代码。不可打印的字符在请求体中以16进制方式file://xhh/进行编码。在这里HH 表示十六进制值。空字节使用"file://0.0.0.0/"来表示。
    BodyUnicode--美国英语，特指拉丁UTF-16LE（little-endian）编码。这种编码方式会在在每一个字符末尾附加一个0字节，以便使字符更可读。可是在VuGen中实际的参数把全部的0字节都去掉的。可是在发送给Web服务器以前, web_custom_request函数会从新添加0字节的。对于不可打印的字符,使用单反斜杠表示，没法表示空字节。

注意:若是请求体大于100K,会使用一个变量来代替Body参数。变量是在 lrw_custom_body.h中定义的。

18）Raw Body：
   请求体是做为指针传递的，此指针指向一串数据。 二进制的请求体可使用BodyBinary 属性来发送(或者使用Body 属性来传递,前提是必设置
"Binary=1" )。不管如何,这种方法须要使用转义字符反斜杠把不可打印的字符转换为ASCII字符。为了能有一种更简便的表现原始数据的方式，Raw Body属性应运而生，能够传递指向二进制数据的指针。使用4个连续的参数集来表示指针，并且必须按照顺序排列：
RAW_BODY_START
指向数据缓冲区的指针
（int） 长度
RAW_BODY_END

例子：
char *abc= .../* a pointer to the raw data */
web_custom_request("StepName",
"URL=http://some.url ",
"Method=POST",
RAW_BODY_START,
"abc",
3,
RAW_BODY_END,
LAST);
    在应用中，即便设置了数据的长度为0，指针也必须有值，不能为空。在“Binary=1”时，不能使用上面的语法传递原始数据。数据缓冲区中的数据不能使用参数化。也就时说，缓冲区中的任何参数(例如 "{MyParam}")不能被正确的替代为相应的值，只会以字面值发送。

三、EXTRARES：代表下面的参数将会是List Of Resource Attributes了。

四、LAST ：结尾的标示符。

五、List of Resource Attributes    仅仅当Recording Options--Recording --HTML-based script-- Record within the current script step选项被选中时，List of Resource Attributes才会被插入到代码中。Web页面中的非HTML机制产生了资源列表，包含了Javascript, ActiveX, Java applets and Flash所请求的资源。VuGen's 的Recording 选项中，能够设置把这些资源录制在当前的操做中（默认是此设置）仍是做为单独的步骤来录制。