學習二：loadrunner函式

一、基礎函式

在VU左邊導航欄中，有三個LR框架函式，分別是vuser_init(),Action(),vuser_end()。這三個函式存在與任何Vuser型別的指令碼中。

• vuser_init()：虛擬使用者的初始化函式，存放使用者初始化操作，如登入、分配記憶體等。（只執行一次）
• Action：虛擬使用者要做的業務，也就是測試內容的主體。引數化只對Action有效，Action重複執行。
• vuser_end()：與init()相對，做收尾工作，如退出登入，free記憶體。（同樣只執行一次）

在LR指令碼中，我們可以呼叫三種函式：

1. VU通用函式，一般以lr開頭，如lr_start_transaction函式。
2. 協議相關函式，不同型別的Vuser的函式一般以本協議型別開頭。如果指令碼是Web（HTTP/HTML）型別的，web_url就是一個協議函式。
3. 語言相關函式。如VU指令碼用C語言寫的，那麼C語言的標準函式庫或DLL都可以在這裡被載入和使用。

二、通用VU函式

通用VU函式是構建在C語言基礎之上的指令碼框架函式，起支援作用。通用VU函式有一個特徵，就是以LR開頭，以標明它們屬於LR，而不專屬於任何協議，只要是C指令碼，都可以使用。

通用VU函式可分為：

• 事務控制函式
• 命令列分析函式
• 系統資訊函式
• 字串函式
• 日誌函式
• 執行時函式

1.事務與事務控制函式

軟體系統的效能就是以一個個事務來度量的。LR中事務的定義就是靠事務函式來進行，在執行效能測試時，LR會採集完成其定義的每個事務所花費的時間，並在效能測試後在Analysis中進行統計分析

• lr_end_sub_transaction:標記子事務的結束以便進行效能分析。
• lr_end_transaction:標記LoadRunner事務的結束。
• lr_end_transaction_instance:標記事務例項的結束以便進行效能分析。
• lr_fail_trans_with_error:將開啟事務的狀態設定為LR_FAIL併發送錯誤訊息。
• lr_get_trans_instance_duration:獲取事務例項的持續時間。
• lr_get_trans_instance_wasted_time:獲取事務例項浪費的時間。
• lr_resume_transaction:繼續收集事務資料以便進行效能分析。
• lr_resume_transaction_instance:繼續收集事務例項資料以便進行效能分析。
• lr_set_transaction_instance_status:設定事務例項的狀態。
• lr_set_transaction_status:設定開啟事務的狀態。
• lr_set_transaction_status_by_name:設定事務的狀態。
• lr_start_sub_transaction:標記子事務的開始。
• lr_start_transaction:標記事務的開始。
• lr_start_transaction_instance:啟動巢狀事務。
• lr_stop_transaction:停止事務資料的收集。
• lr_stop_transaction_instance:停止事務資料的收集。
• lr_wasted_time:消除所有開啟事務浪費的時間。

2.命令列分析函式

當LoadRunner用命令列方式啟動和執行時，以下函式用來分析命令列，以得到命令列中的引數資訊。

• lr_get_attrib_double:檢索指令碼命令列中使用的double型別變數。
• lr_get_attrib_long:檢索指令碼命令列中使用的long型別變數。
• lr_get_attrib_string:檢索指令碼命令列中使用的字串。

3.系統資訊函式

用來得到VU系統資訊：

• lr_user_data_point:記錄使用者定義的資料採集點。
• lr_whoami:將有關Vuser的資訊返回給Vuser指令碼。
• lr_get_host_name:返回執行Vuser指令碼的主機名。
• lr_get_master_host_name:返回執行LoadRunner Controller的計算機名。
  　　

4.字串函式

主要是對引數進行操作，包括對不同型別引數的讀取、儲存和移動。

• lr_eval_string:返回引數的當前值。
• lr_save_string:將以NULL結尾的字串儲存到引數中。
• lr_save_var:將變長字串儲存到引數中。
• lr_save_datetime:將當前日期和時間儲存到引數中。
• lr_advance_param:前進到下一個可用引數。
• lr_decrypt:解密已編碼的字串。
• lr_eval_string_ext:lr_eval_string的擴充套件，為指向包含引數資料的緩衝區的指標。
• lr_eval_string_ext_free:釋放由lr_eval_string_ext分配的指標。
• lr_save_searched_string:在緩衝區中搜索字串例項，並將改字串例項儲存到引數中。
  　　

5.訊息函式

是VU傳送和記錄log的函式

• lr_debug_message:將除錯訊息傳送到輸出視窗。
• lr_error_message:將錯誤訊息傳送到輸出視窗。
• lr_get_debug_message:得到當前的訊息類。
• lr_log_message:將輸出訊息直接傳送到output.txt檔案，此檔案位於Vuser指令碼目錄中。
• lr_output_message:將訊息傳送到輸出視窗。
• lr_set_debug_message:為輸出訊息設定訊息類。
• lr_vuser_status_message:生成格式化輸出並將其列印到Controller Vuser狀態區域。
• lr_message:將訊息傳送到Vuser日誌和輸出視窗。
  　　

6.執行時函式

執行時(run-time)多數是通過VU的runtime來設定的。

• lr_load_dll,載入外部dll。
• lr_think_time:暫停指令碼的執行，以模擬思考時間。
• lr_continue_on_error,指定指令碼如何處理錯誤場景，是繼續還是退出。
• lr_rendezvous:在Vuser指令碼中設定集合點。

三、協議相關函式

除了通用Vuser函式以外，Vugen還會在錄製時生成特定於協議的函式，並將它們插入到Vuser指令碼中。

1.http協議

Header設定函式：

• Web_add_header
• Web_clean_header

點選連結:

• Web_link
• Web_image

提交表單:

• Web_submit_data
• Web_submit_form

2.web系統設定

Cache設定:

• Web_cache_leanup
• Web_load_cache

Cookie設定:

• Web_add_cookie
• Web_cleanup_cookies

Proxy設定:

• Web_set_proxy
• Web_set_secure_proxy

3.LR框架支援

檢查點：

• Web_find
• Web_image_check

關聯：

• Web_create_html_param
• Web_create_html_param_ex
• Web_reg_save_param
• Web_set_max_html_param_len

控制：

• Lr_start_transaction
• Lr_rendzvous
• Lr_think_time