軟件開發中我們經常要訪問數據庫,存取數據,之前已經有網友提出讓雞啄米講講數據庫編程的知識,本文就詳細講解如何使用Mysql的C語言API進行數據庫編程。

       API,全稱Application Programming Interfaces,即應用程序編程接口,我們可以調用這些接口,執行API函數提供的功能。

       Mysql C語言API就是用C語言編寫的Mysql編程接口,使用這些接口函數可以實現對Mysql數據庫的查詢等操作。
    
       Mysql的安裝
   
       要進行Mysql編程首先要在充當Mysql服務器的電腦和本機上都安裝Mysql,服務器上的Mysql用來連接查詢,本機上的Mysql作為開發之用,當然本機也可以兼顧服務器和開發之用。下載Mysql可以到http://www.mysql.com/downloads/mysql/。雞啄米安裝的是“Windows (x86, 64-bit), MSI Installer”版本。

       在Mysql安裝過程中,安裝選項一定要選上Development Components下的Client C API library(shared),這樣才會將Mysql API的頭文件和動態庫安裝到電腦中。

       安裝完成后,我們編程要用的就是include目錄下的頭文件和lib目錄下的庫文件。

       Mysql API數據結構   

       Mysql API中用到了很多結構體等數據類型,下面就簡單說說常用的幾個數據結構的含義,至于它們的定義雞啄米就不貼了,大家可以到Mysql提供的mysql.h頭文件中查看。

       MYSQL

       連接數據庫前,必須先創建MYSQL變量,此變量在很多Mysql API函數會用到。它包含了一些連接信息等數據。

       MYSQL_RES

       MYSQL_RES結構體中包含了查詢結果集,也就是從數據庫中查詢到的數據。可以使用mysql_store_result或mysql_use_result函數獲得。

       MYSQL_ROW

       MYSQL ROW的定義如下:

             typedef char **MYSQL_ROW;

       可見,它實際上是char **類型,指向一個字符串數組。可以通過mysql_fetch_row函數獲得。

       MYSQL_FIELD

       MYSQL_FIELD中包含了字段名、字段類型和大小等信息。可以重復調用mysql_fetch_field函數獲得所有字段的信息。

       Mysql C API編程步驟

       1、首先我們要包含mysql的頭文件,并鏈接mysql動態庫。即添加以下語句:

C++代碼
  1. #include <WinSock2.h>      // 進行網絡編程需要winsock2.h   
  2. #include <mysql.h>   
  3. #pragma comment(lib, "libmysql.lib")  

       2、創建MYSQL變量。如:

       MYSQL mysql;

       3、初始化MYSQL變量。

       mysql_init(&mysql);

       4、調用mysql_real_connect函數連接Mysql數據庫。mysql_real_connect函數的原型如下:

C++代碼
  1. MYSQL *  STDCALL mysql_real_connect(MYSQL *mysql, const char *host,const char *user,const char *passwd,const char *db,unsigned int port,const char *unix_socket,unsigned long clientflag);    

       參數說明:mysql--前面定義的MYSQL變量;host--MYSQL服務器的地址;user--登錄用戶名;passwd--登錄密碼;db--要連接的數據庫;port--MYSQL服務器的TCP服務端口;unix_socket--unix連接方式,為NULL時表示不使用socket或管道機制;clientflag--Mysql運行為ODBC數據庫的標記,一般取0。

       連接失敗時該函數返回0。

       5、調用mysql_real_query函數進行數據庫查詢。mysql_real_query函數的原型如下:

       int  STDCALL mysql_real_query(MYSQL *mysql, const char *q, unsigned long length);

       參數說明:mysql--前面定義的MYSQL變量;q--SQL查詢語句;length--查詢語句的長度。

       查詢成功則該函數返回0。

       6、通過調用mysql_store_result或mysql_use_result函數返回的MYSQL_RES變量獲取查詢結果數據。

       兩個函數的原型分別為:

       MYSQL_RES *     STDCALL mysql_store_result(MYSQL *mysql);

       MYSQL_RES *     STDCALL mysql_use_result(MYSQL *mysql);

       這兩個函數分別代表了獲取查詢結果的兩種方式。第一種,調用mysql_store_result函數將從Mysql服務器查詢的所有數據都存儲到客戶端,然后讀取;第二種,調用mysql_use_result初始化檢索,以便于后面一行一行的讀取結果集,而它本身并沒有從服務器讀取任何數據,這種方式較之第一種速度更快且所需內存更少,但它會綁定服務器,阻止其他線程更新任何表,而且必須重復執行mysql_fetch_row讀取數據,直至返回NULL,否則未讀取的行會在下一次查詢時作為結果的一部分返回,故經常我們使用mysql_store_result。

       7、調用mysql_fetch_row函數讀取結果集數據。

       上述兩種方式最后都是重復調用mysql_fetch_row函數讀取數據。mysql_fetch_row函數的原型如下:

       MYSQL_ROW STDCALL mysql_fetch_row(MYSQL_RES *result);

       參數result就是mysql_store_result或mysql_use_result的返回值。

       該函數返回MYSQL_ROW型的變量,即字符串數組,假設為row,則row[i]為第i個字段的值。當到結果集尾部時,此函數返回NULL。

       8、結果集用完后,調用mysql_free_result函數釋放結果集,以防內存泄露。mysql_free_result函數的原型如下:

       void  STDCALL mysql_free_result(MYSQL_RES *result);

       9、不再查詢Mysql數據庫時,調用mysql_close函數關閉數據庫連接。mysql_close函數的原型為:

       void STDCALL mysql_close(MYSQL *sock);

       Mysql C API編程實例

       雞啄米這里給大家一個簡單的Mysql API編程實例。使用VS2010編寫。訪問的數據庫為安裝Mysql后默認創建的名稱為“mysql”的數據庫,查詢其“user”表的數據,步驟如下:

       1、創建一個Win32 Console Application(Win32控制臺程序)的空工程(創建空工程需要在向導的Application Settings一步中,勾選Empty project),名稱就取為mysql。

       2、在Solution Explorer窗口的工程名“mysql”上點右鍵,選擇“Properties”,彈出工程的屬性頁,然后在左側子窗口中,選擇Configuration Properties->VC++ Directories,右側子窗口中會顯示一些設置項列表,然后在Include Directories項中添加Mysql的Include目錄,在Library Directories項中添加Mysql的lib目錄。

 Mysql C語言API編程入門講解之詳細篇

       3、新建一個cpp文件,取名mysql.cpp。

       4、在mysql.cpp文件中包含mysql頭文件并鏈接mysql動態庫。

C++代碼
  1. #include <WinSock2.h>   
  2. #include <mysql.h>   
  3. #pragma comment(lib, "libmysql.lib")  

       這里要注意,因為mysql用到了網絡連接的接口函數,所以需要在前面包含WinSock2.h文件。

       同時本例中使用了輸出流cout,所以還要包含輸入輸出流頭文件:

C++代碼
  1. #include <iostream>   
  2. using namespace std;  

       5、創建main函數,并修改函數體如下:

C++代碼
  1. int main()  
  2. {  
  3.     MYSQL mysql;  
  4.     MYSQL_RES *res;  
  5.     MYSQL_ROW row;  
  6.   
  7.     // 初始化MYSQL變量  
  8.     mysql_init(&mysql);  
  9.     // 連接Mysql服務器,本例使用本機作為服務器。訪問的數據庫名稱為"msyql",參數中的user為你的登錄用戶名,***為登錄密碼,需要根據你的實際用戶進行設置  
  10.     if (!mysql_real_connect(&mysql, "127.0.0.1""user""123""mysql", 3306, 0, 0))  
  11.     {  
  12.         cout << "mysql_real_connect failure!" << endl;  
  13.         return 0;  
  14.     }  
  15.     // 查詢mysql數據庫中的user表  
  16.     if (mysql_real_query(&mysql, "select * from user", (unsigned long)strlen("select * from user")))  
  17.     {  
  18.         cout << "mysql_real_query failure!" << endl;  
  19.         return 0;  
  20.     }  
  21.     // 存儲結果集  
  22.     res = mysql_store_result(&mysql);  
  23.     if (NULL == res)  
  24.     {  
  25.         cout << "mysql_store_result failure!" << endl;  
  26.         return 0;  
  27.     }  
  28.     // 重復讀取行,并輸出第一個字段的值,直到row為NULL  
  29.     while (row = mysql_fetch_row(res))  
  30.     {  
  31.         cout << row[0] << endl;  
  32.     }  
  33.     // 釋放結果集  
  34.     mysql_free_result(res);  
  35.     // 關閉Mysql連接  
  36.     mysql_close(&mysql);  
  37.   
  38.     return 0;  
  39. }  

       6、將mysql安裝目錄中的libmysql.dll動態庫文件拷貝到工程的當前目錄,運行程序。

       如果你跟雞啄米一樣使用的是mysql的64位版本,此時程序會報錯,有很多不能解析的符號,這是因為我們的工程是32位的,應該改為64位,方法是,上面的工程屬性頁的右上角有個Configuration Manager按鈕,點擊它彈出Configuration Manager對話框,下面的列表中可以看到有我們的工程,Platform列顯示為“Win32”:

Mysql C語言API編程入門講解之詳細篇

       這里需要點擊右側的箭頭下拉,選擇New彈出New Project Platform對話框,New platform選擇x64創建新Platform:

Mysql C語言API編程入門講解之詳細篇

       上述的Platform列選擇x64就可以了。再次運行程序,你會發現它果然不報錯了。

       本文就到這里了,到此大家應該對Mysql C API編程有了基本的了解了,在實際開發中可以不斷深入研究。

除非特別注明,雞啄米文章均為原創
轉載請標明本文地址:http://www.vkzldl.live/software/279.html
2012年12月21日
作者:雞啄米 分類:軟件開發 瀏覽: 評論:7