本文主要講述了Socket協議指令碼的基礎知識和編寫方法，讓大家能夠在短時間內快速掌握簡單的Socket協議指令碼的編寫方法。
1.socket協議介紹
Socket協議有萬能協議之稱，很多系統底層都是用的socket協議，用處十分廣泛。
1.1 Socket通訊方式說明
與socket通訊有兩種方式，一種是建立長連線，建立後不停的傳送，接收；另一種是建立短連線，即建立連線傳送報文，接收報文關閉連線
1.2 Socket協議傳送的buf型別介紹
Send buffer型別分為字串和xml型別
1.3 Socket協議指令碼編寫前提：
與專案組溝通，確認是否是socket協議，由專案組提供伺服器IP和埠號還有socket協議交易的報文傳送及接收報文對，及交易介面文件，瞭解清楚報文的資料長度，引數化欄位，結構，代表什麼等，瞭解清楚後進行socket協議指令碼的開發。
1.4、Socket協議指令碼函式說明及例項：
1）名稱 lrs_create_socket();
建立socket連線，新增IP和埠號，如果建立成功返回值為0，反之則返回為非0數值。（對於長連線，建立socket連線放在vuser_init函式中，短連線放在Action中即可） 例項： lrs_create_socket("socket0","TCP","RemoteHost=180.170.150.230:7700", LrsLastArg);
2）名稱 lrs_send();
傳送socket請求訊息，取緩衝區buf0的報文併傳送。
例項： lrs_send("socket0","buf1",LrsLastArg);
3）名稱 lrs_receive();
接收socket的響應報文，放置buf1中。
例項：lrs_receive("socket0","buf2",LrsLastArg);
4）名稱 lrs_get_last_received_buffer();
獲取最後收到的buffer和大小，其中將最後收到的buffer的值賦給RecvBuf變數，將大小賦值給RecvLen。
例項： lrs_get_last_received_buffer("socket0",&recvBuf,&recvLen);
5）名稱 lrs_free_buffer();
為防止記憶體洩露，釋放記憶體空間。
例項： lrs_free_buffer(recvBuf);
6）名稱 lrs_close_socket();
關閉Socket連線，（對於長連線，關閉socket連線應放在vuser_end函式中）
例項： lrs_close_socket("socket0");
其他常用的Socket函式：
lrs_set_send_buffer("socket0", sSendPkg, iLenOfPkg );//指定要傳送的socket資訊
lrs_get_buffer_by_name("buf0", sSendPkg, iLenOfPkg);// 獲取收到的buffer和大小
lrs_length_send("socket0","buf0",1,"Size=4","Encoding=1",LrsLastArg);
關聯函式：
lrs_save_param_ex("socket0","received","",151,7,"ascii","response");//取指定位置字串儲存到變數，以便判斷事務是否成功
lrs_save_searched_string();//在指定位置搜尋字串，將出現的字串報錯到引數中
超時函式
lrs_set_connect_timeout();//設定連線超時時間
lrs_set_recv_timeout();//設定伺服器響應超時時間
lrs_set_recv_timeout2();//設定接收超時時間，使系統不去檢查回收的內容是否一致
2、Socket指令碼編寫
2.1 簡單劃分步驟
這種方法是我無意在一片文章中看到的，總體說來，比較簡單。就像把大象放進冰箱一樣，總共分三步：
第一步：把冰箱門開啟
//建立到服務端的連線
rc = lrs_create_socket("socket0", "TCP", "LocalHost=0", "RemoteHost=128.64.64.23:8988", LrsLastArg);
if (rc==0)
lr_output_message("Socket was successfully created ");
else
lr_output_message("An error occurred while creating the socket, Error Code: %d", rc);
第二步：把大象裝進去
lrs_send("socket0", "buf0", LrsLastArg); //往"socket0"傳送"buf0"中的資料
lrs_receive("socket0", "buf1", LrsLastArg);//將"socke0"中返回的資料存放到"buf1"中
第三步：把冰箱門帶上
//關閉連線
lrs_close_socket("socket0");
2.2 詳細劃分步驟
◇變數的宣告與定義
◇ 建立socket連線
◇ 傳送socket請求
◇ 接收socket響應
◇ 從返回Buffer 中抽取結果
◇ 結果判斷
◇ 釋放記憶體
◇ 斷開連線。
2.3 例項指令碼
下面我們就是用一個實際專案不同報文格式的指令碼進行講解；
若專案是短連線，且報文不是從檔案中讀取資訊時，vuser_init和vuser_end部分預設即可，主要在Action中開發測試指令碼和在data.ws中傳輸資料到Action的程式碼中。
Vuser_init.c
|
#include "lrs.h" vuser_init() { lrs_startup(257); return 0; } |
Action.c
|
#include "lrs.h" Action() { int rc,rv;//儲存連線成功返回值 char *recvBuf;//儲存接收資料的內容 int recvLen;//儲存接收資料的大小 /*對於長連線，建立socket連線放在vuser_init函式中，短連線放在Action中即可*/ rc=lrs_create_socket("socket0","TCP","RemoteHost=IP:埠", LrsLastArg); //判斷連線是否建立成功 if(rc==0){ lr_output_message("Socket連線建立成功"); } else{ lr_error_message("Socket連線建立失敗！錯誤碼=%d",rc); return -1； } lr_start_transaction("XXXX_1234_FCX");//事務開始 //傳送socket請求訊息（資料包內容放在data.ws中） lrs_send("socket0", "buf0", LrsLastArg); //取緩衝區buf0的報文併傳送 rv = lrs_receive("socket0", "buf1", LrsLastArg);//接收響應報文 if(rv==0){ lr_output_message("Socket接收返回訊息成功"); } else{ lr_error_message("Socket接收返回訊息失敗！錯誤碼=%d",rv); return -1； } //獲取最後收到的buffer和大小 lrs_get_last_received_buffer("socket0",&recvBuf,&recvLen); /*設定檢查點，驗證返回資料是否成功，這個根據各交易具體情況進行判斷，以下示例是通過返回報文的長度大於3即為成功*/ if(recvLen>3){ lr_end_transaction("XXXX_1234_FCX ",PASS); } else{ lr_end_transaction("XXXX_1234_FCX ",FAIL); lr_error_message("XXXX_8550_FCX Fail!出錯資訊：[%s]", recvBuf);//交易失敗時，輸出RecvBuf返回資訊，用於排查出錯原因 } lrs_free_buffer(recvBuf); //釋放recvBuf記憶體空間，否則會引起記憶體洩露 /*關閉Socket連線,對於長連線，關閉socket連線應放在vuser_end函式中*/ lrs_close_socket("socket0"); return 0; } |
data.ws
1）XML報文格式
|
;WSRData 2 1 send buf0 360 "<?xmlversion=\"1.0\"encoding=\"GBK\"?>" "<TRANINFO>" "<HEAD>" "<TransCode>S001</TransCode>" "<TransDate>20170613</TransDate>" "<TransTime>144206</TransTime>" "<TransNo>21219603</TransNo>" "<Operator>999088</Operator>" "<TransInst>70090</TransInst>" "</HEAD>" "<MSG>" "<CustomerID><userID></CustomerID>"//客戶編號 "<Type>3</Type>"//查詢型別 "<BusinessType>01</BusinessType>"//業務型別 "</MSG>" "</TRANINFO>" recv buf1 300 -1 |
2）16進位制報文格式
|
;WSRData 2 1 send buf0 32 "\x00\x00\x00\x1c\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00" " " "\x00\x00\x00\x00" "PID <tran>" recv buf1 197 "\x00\x00\x00\x1a\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00" "\x1e\x00\x00\x00\x00" "STW -1" "\x00\x00\x00\x1e\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00" "\x1e\x00\x00\x00\x00" "STT " "\x1f" -1 |
其中buf0代表傳送的報文的名稱，後跟的數字程式碼傳送報文長度，其下放置傳送報文；buf1代表接收報文的名稱，後跟數字代表接收報文長度，其下放置接收報文。
注意：該協議指令碼引數化格式為：<引數名>