【導(dǎo)讀】蒈薂襖莈莄薁羆膀芀薀腿羃蚈蕿袈艿薄薈羈肁蒀薈肅芇莆薇螃肀節(jié)蚆裊芅薁蚅羇肈蕆蚄聿芄莃蚃衿肆荿螞羈莂芅螞肄膅薃蟻螃莀葿蝕袆膃蒞蝿羈莈芁螈肀膁薀螇螀羄薆螆腿蒂螆肅肂莈螅螄羋芄螄袇肁薂螃罿芆蒈袂肁聿莄袁螁芄芀袁袃肇蠆袀肅芃薅衿膈膅蒁袈袇莁莇蒄羀膄芃蒄肂荿薂蒃螂膂蒈薂襖莈莄薁羆膀芀薀腿羃蚈蕿袈艿薄薈羈肁蒀薈肅芇莆薇螃肀節(jié)蚆裊芅薁蚅羇肈蕆蚄聿芄莃蚃衿肆荿螞羈莂芅螞肄膅薃蟻螃莀葿蝕袆膃蒞蝿羈莈芁螈肀膁薀螇螀羄薆螆腿蒂螆肅肂莈螅螄羋芄螄袇肁薂螃罿芆蒈袂肁聿莄袁螁芄芀袁袃肇蠆袀肅芃薅衿膈膅蒁袈袇莁莇蒄羀膄芃蒄肂荿薂蒃螂膂蒈薂襖莈莄薁羆膀芀薀腿羃蚈蕿袈艿薄薈羈肁蒀薈肅芇莆薇螃肀節(jié)蚆裊芅薁蚅羇肈蕆蚄聿芄莃蚃衿肆荿螞羈莂芅螞肄膅薃蟻螃莀葿蝕袆膃蒞蝿羈莈芁螈肀膁薀螇螀羄薆螆腿蒂螆肅肂莈螅螄羋芄螄袇肁薂螃罿芆蒈袂肁聿莄袁螁芄芀袁袃肇蠆袀肅芃薅衿膈膅蒁袈袇莁莇蒄羀膄芃蒄肂荿薂蒃螂膂蒈薂襖莈莄薁羆膀芀薀腿羃蚈蕿袈艿薄薈羈

　　

【正文】 系統(tǒng)難點(diǎn)技術(shù)分析與設(shè)計 回結(jié)果集）、 MYSQL_ROW（行集）、 MYSQL_FIELD（字段信息）、 MYSQL_FIELD_OFFSET（字段表的偏移量）、 my_ulonglong（自定義 的無符號整型數(shù)）等； C API 提供的函數(shù)包括： mysql_close()、 mysql_connect()、 mysql_query()、mysql_store_result()、 mysql_init()等，其中 mysql_query()最為重要，能完成絕大部分的數(shù)據(jù)庫操控。 C API通過兩個組件實現(xiàn)： ① 頭文件： ，包含結(jié)構(gòu)和功能說明。 ② Mysql 庫： libmysqlclient(Unix) 或 (Windows)，包括 C的實際功能。 C API描 述： ① 初始化 MYSQL結(jié)構(gòu)： mysql_init(amp。mysql)。 // mysql 類型為 MYSQL. ② 建立到服務(wù)器連接： mysql_real_connect(amp。mysql, “host”, “user”, “password”, “db1”, 0, NULL, 0)。 //采用默認(rèn)值的三個參數(shù)分別為：連接 MySQL服務(wù)器時使用的端口，連接 MySQL服務(wù)器時使用的套接字，控制客戶機(jī)行為使用的一個或多個可選標(biāo)志。如果連接成功，將返回一個句柄，連接失敗，將返回假。 ③ 選擇數(shù)據(jù) 庫： mysql_select_db(amp。mysql, “db_name”)。 ④ 查詢實施： mysql_query(amp。mysql, query_string)。 ⑤ 對 Select查詢返回的結(jié)果集處理： 1) MYSQL_RES * result = mysql_store_result(amp。mysql)。 //將查詢的結(jié)果保持到變量 result。如果 mysql_query()執(zhí)行出錯，用 mysql_store_query()函數(shù)取結(jié)果集將返回 NULL 給 result。如果客戶機(jī) = mysql_fetch_row(result)。 //從結(jié)果集讀取一行記錄。 5) MYSQL_FIELD * field = mysql_fetch_field(result)。 //返回字段屬性詳細(xì)信息，如：字段名，類型，長度。 6) MYSQL_FIELD* fields=mysql_fetch_fields(result)。 //返回 MYSQL_FIELD結(jié)構(gòu)的數(shù)組，每個字段針對一個結(jié)果集合。 7) mysql_free_result(result)。 //使用完后，要釋放結(jié)果集變量空間。 ⑥ INSERT， UPDATE、 DELETE等操作的結(jié)果處理： mysql_affected_rows(amp。mysql)。 //返回受影響的記錄數(shù)。 28 XXX大學(xué)本科學(xué)生畢業(yè)設(shè)計（論文） 4 系統(tǒng)難點(diǎn)技術(shù)分析與設(shè)計 ⑦ 涉及結(jié)果集處理的輔助函數(shù)： 1) MYSQL_ROW_OFFSET *result, MYSQL_ROW_OFFSET offset)。 //跳至該具體行。 2) MYSQL_FIELD_OFFSET STDCALL mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset)。 //跳至該行具體列。 3) MYSQL_ROW_OFFSET STDCALL mysql_row_tell(MYSQL_RES *res)。 //返回字段列表中字段游標(biāo)當(dāng)前位置。 4) MYSQL_FIELD_OFFSET STDCALL mysql_field_tell(MYSQL_RES *res)。 //返回結(jié)果集中行游標(biāo)當(dāng)前位置。 5) unsigned long * STDCALL mysql_fetch_lengths(MYSQL_RES *result)。 //當(dāng)前行的字段值長度。 6) my_ulonglong STDCALL mysql_insert_id(MYSQL *mysql)。 // 返回產(chǎn)生ATUO_INCREMENT字段的最后 ID。 ⑧ 錯誤處置： 1) unsigned int STDCALL mysql_errno(MYSQL *mysql)。 //錯誤號。 2) const char * STDCALL mysql_error(MYSQL *mysql)。 //錯誤信息。 ⑨ 關(guān)閉連接： mysql_close (MYSQL* mysql)。[14] STDCALL mysql_row_seek(MYSQL_RES 封裝 C API 我們分別使用 Database 類（如圖 ）、 DBInterface 類（如圖 ）、 Field 類（如圖 ）、 QueryResult 類（如圖 ）、 QueryResultMysql 類（如圖 ）封裝了 MySQL數(shù)據(jù)庫的功能，因此不具備通用性，只能在對 MySQL的應(yīng)用程序 中使用。 ① Database 類：主要負(fù)責(zé)初始化 MySQL結(jié)構(gòu)以及建立到服務(wù)器的連接。 圖 Database 類 ② DBInterface 類：是 Database 類的子類，負(fù)責(zé)初始化 MySQL結(jié)構(gòu)以及建 29 XXX大學(xué)本科學(xué)生畢業(yè)設(shè)計（論文） 4 系統(tǒng)難點(diǎn)技術(shù)分析與設(shè)計 立到服務(wù)器的連接。 圖 DBInterface 類 ③ Field類：主要負(fù)責(zé)對數(shù)據(jù)庫表中內(nèi)容的操 作。 圖 Field類 ④ QueryResult類：主要負(fù)責(zé)對查詢結(jié)果的存儲以及操作。 圖 QueryResult類 ⑤ QueryResultMysql 類：是 QueryResult類的子類，負(fù)責(zé)對查詢結(jié)果的存儲 30 XXX大學(xué)本科學(xué)生畢業(yè)設(shè)計（論文） 4 系統(tǒng)難點(diǎn)技術(shù)分析與設(shè)計 以及操作。 圖 QueryResultMysql 類 通過這些類中定義的這些功能函數(shù)，我們可以通過遠(yuǎn)程或本機(jī)完成對 MySQL數(shù)據(jù)庫的絕大部分操控，大大提高了效能。以上函數(shù)的具體功能都是通過調(diào)用 C API函數(shù)實現(xiàn)的。 基于以上類，并結(jié)合系統(tǒng)各個部分的工作情況以及數(shù)據(jù)的交互情況。我們?yōu)閿?shù)據(jù)庫服務(wù)器提供如下對應(yīng)的函數(shù)來實現(xiàn)每個部分的功能。 ① 陸登錄服務(wù)器請求數(shù)據(jù)庫服務(wù)器驗證登錄。 void ClientLSRecvPacketProcess::Handle_DSLS_C_LoginVerify (WorldPacketamp。 wp, unsigned long stub) ② 用戶登錄，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器驗證登陸。 void ClientHSRecvPacketProcess::Handle_DSHS_C_QueryLogin (WorldPacketamp。 wp, unsigned long stub) ③ 用戶選擇大廳，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器保存游戲客戶端選擇大廳的操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_SaveSelectHS (WorldPacketamp。 wp, unsigned long stub) ④ 用戶退出程序 ,大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器刪除驗證碼。 void ClientHSRecvPacketProcess::Handle_DSHS_C_PlayerQuit (WorldPacketamp。 wp, unsigned long stub) ⑤ 游戲結(jié)束時，游戲服務(wù)器提交了用戶信息變更數(shù)據(jù)給大廳服務(wù)器 , 大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行數(shù)據(jù)更新。 void ClientHSRecvPacketProcess::Handle_DSHS_C_UpdatePlayerInfo (WorldPacket amp。 wp, unsigned long stub) ⑥ 用戶進(jìn)行配置時需要激活道具、裝備和角色，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行激活操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_UserActiveThing 31 XXX大學(xué)本科學(xué)生畢業(yè)設(shè)計（論文） 4 系統(tǒng)難點(diǎn)技術(shù)分析與設(shè)計 (WorldPacketamp。 wp, unsigned long stub) ⑦ 用戶點(diǎn)擊丟棄按鈕丟棄一個道具、裝備或者角色，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行丟棄操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_UserDiscardThing (WorldPacketamp。 wp, unsigned long stub) ⑧ 用戶點(diǎn)擊確定按鈕確認(rèn)當(dāng)前的道具、裝備或者角色在船上的配置，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行確認(rèn)操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_UserConfigThing (WorldPacketamp。 wp, unsigned long stub) ⑨ 用戶點(diǎn)擊購買結(jié)算，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行結(jié)算操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_UserPay (WorldPacketamp。 wp, unsigned long stub) ⑩ 用戶贈送禮物時，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行贈送操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_Present (WorldPacketamp。 wp, unsigned long stub) ? 用戶接收禮物時，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行收贈操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_ReceivePresent (WorldPacketamp。 wp, unsigned long stub) ? 用戶丟棄贈品時，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行丟棄贈品操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_DiscardPresent (WorldPacketamp。 wp, unsigned long stub) ? 用戶查詢禮物時，大廳服務(wù)器請求數(shù)據(jù)庫服務(wù)器進(jìn)行贈品查詢操作。 void ClientHSRecvPacketProcess::Handle_DSHS_C_RequirePresent (WorldPacketamp。 wp, unsigned long stub) 32 XXX大學(xué) 本科學(xué)生畢業(yè)設(shè)計（論文）