Mysql中CAPI的學生信息管理
使用嵌入式MySQL服務器庫,能夠在客戶端應用程序中使用具備全部特性的MySQL服務器。 主要優點在於,增加了速度,並使得嵌入式應用程序的管理更簡單。
嵌入式服務器庫是以MySQL的客戶端/服務器版本為基礎的,采用C/C++語言編寫。 其結果是嵌入式服務器也是用C/C++語言編寫的。 在其他語言中,嵌入式服務器不可用。
API與嵌入式MySQL版本和客戶端/服務器版本等效。 要想更改舊的線程式應用程序以使用嵌入式庫,正常情況下,僅需添加對下述函數的調用即可。
與MySQL交互時,應用程序應使用該一般性原則:
1. 通過調用mysql_library_init(),初始化MySQL庫。庫可以是mysqlclient C客戶端庫,或mysqld嵌入式服務器庫,具體情況取決於應用程序是否與“-libmysqlclient”或“-libmysqld”標志鏈接。
2. 通過調用mysql_init()初始化連接處理程序,並通過調用mysql_real_connect()連接到服務器。
3. 發出SQL語句並處理其結果。(在下面的討論中,詳細介紹了使用它的方法)。
4. 通過調用mysql_close(),關閉與MySQL服務器的連接。
5. 通過調用mysql_library_end(),結束MySQL庫的使用。
調用mysql_library_init()和mysql_library_end()的目的在於,為MySQL庫提供恰當的初始化和結束處理。對於與客戶端庫鏈接的應用程序,它們提供了改進的內存管理功能。如果不調用mysql_library_end(),內存塊仍將保持分配狀態(這不會增加應用程序使用的內存量,但某些內存洩漏檢測器將抗議它)。對於與嵌入式服務器鏈接的應用程序,這些調用會啟動並停止服務器。
mysql_library_init()和mysql_library_end()實際上是#define符號,這類符號使得它們等效於mysql_server_init()和mysql_server_end(),但其名稱更清楚地指明,無論應用程序使用的是mysqlclient或mysqld庫,啟動或結束MySQL庫時,應調用它們。對於早期的MySQL版本,可調用mysql_server_init()和mysql_server_end()取而代之。
如果願意,可省略對mysql_library_init()的調用,這是因為,必要時,mysql_init()會自動調用它。
要想連接到服務器,可調用mysql_init()來初始化連接處理程序,然後用該處理程序(以及其他信息,如主機名、用戶名和密碼)調用mysql_real_connect()。建立連接後,在低於5.0.3版的API中,mysql_real_connect()會將再連接標志(MYSQL結構的一部分)設置為1,或在較新的版本中,將其設置為0。對於該標志,值“1”指明,如果因連接丟失而無法執行語句,放棄之前,會嘗試再次連接到服務器。從MySQL 5.0.13開始,可以在mysql_options()上使用MYSQL_OPT_RECONNECT選項,以控制再連接行為。完成連接後,調用mysql_close()中止它。
當連接處於活動狀態時,客戶端或許會使用mysql_query()或mysql_real_query()向服務器發出SQL查詢。兩者的差別在於,mysql_query()預期的查詢為指定的、由Null終結的字符串,而mysql_real_query()預期的是計數字符串。如果字符串包含二進制數據(其中可能包含Null字節),就必須使用mysql_real_query()。
對於每個非SELECT查詢(例如INSERT、UPDATE、DELETE),通過調用mysql_affected_rows(),可發現有多少行已被改變(影響)。
對於SELECT查詢,能夠檢索作為結果集的行。注意,某些語句因其返回行,類似與SELECT。包括SHOW、DESCRIBE和EXPLAIN。應按照對待SELECT語句的方式處理它們。
客戶端處理結果集的方式有兩種。一種方式是,通過調用mysql_store_result(),一次性地檢索整個結果集。該函數能從服務器獲得查詢返回的所有行,並將它們保存在客戶端。第二種方式是針對客戶端的,通過調用mysql_use_result(),對“按行”結果集檢索進行初始化處理。該函數能初始化檢索結果,但不能從服務器獲得任何實際行。
在這兩種情況下,均能通過調用mysql_fetch_row()訪問行。通過mysql_store_result(),mysql_fetch_row()能夠訪問以前從服務器獲得的行。通過mysql_use_result(),mysql_fetch_row()能夠實際地檢索來自服務器的行。通過調用mysql_fetch_lengths(),能獲得關於各行中數據大小的信息。
完成結果集操作後,請調用mysql_free_result()釋放結果集使用的內存。
這兩種檢索機制是互補的。客戶端程序應選擇最能滿足其要求的方法。實際上,客戶端最常使用的是mysql_store_result()。
mysql_store_result()的1個優點在於,由於將行全部提取到了客戶端上,你不僅能連續訪問行,還能使用mysql_data_seek()或mysql_row_seek()在結果集中向前或向後移動,以更改結果集內當前行的位置。通過調用mysql_num_rows(),還能發現有多少行。另一方面,對於大的結果集,mysql_store_result()所需的內存可能會很大,你很可能遇到內存溢出狀況。
mysql_use_result()的1個優點在於,客戶端所需的用於結果集的內存較少,原因在於,一次它僅維護一行(由於分配開銷較低,mysql_use_result()能更快)。它的缺點在於,你必須快速處理每一行以避免妨礙服務器,你不能隨機訪問結果集中的行(只能連續訪問行),你不知道結果集中有多少行,直至全部檢索了它們為止。不僅如此,即使在檢索過程中你判定已找到所尋找的信息,也必須檢索所有的行。
通過API,客戶端能夠恰當地對查詢作出響應(僅在必要時檢索行),而無需知道查詢是否是SELECT查詢。可以在每次mysql_query()或mysql_real_query()後,通過調用mysql_store_result()完成該操作。如果結果集調用成功,查詢為SELECT,而且能夠讀取行。如果結果集調用失敗,可調用mysql_field_count()來判斷結果是否的確是所預期的。如果mysql_field_count()返回0,查詢不返回數據(表明它是INSERT、UPDATE、DELETE等),而且不返回行。如果mysql_field_count()是非0值,查詢應返回行,但沒有返回行。這表明查詢是失敗了的SELECT。關於如何實現該操作的示例,請參見關於mysql_field_count()的介紹。
無論是mysql_store_result()還是mysql_use_result(),均允許你獲取關於構成結果集的字段的信息(字段數目,它們的名稱和類型等)。通過重復調用mysql_fetch_field(),可以按順序訪問行內的字段信息,或者,通過調用mysql_fetch_field_direct(),能夠在行內按字段編號訪問字段信息。通過調用mysql_field_seek(),可以改變當前字段的光標位置。對字段光標的設置將影響後續的mysql_fetch_field()調用。此外,你也能通過調用mysql_fetch_fields(),一次性地獲得關於字段的所有信息。
為了檢測和通報錯誤,MySQL提供了使用mysql_errno()和mysql_error()函數訪問錯誤信息的機制。它們能返回關於最近調用的函數的錯誤代碼或錯誤消息,最近調用的函數可能成功也可能失敗,這樣,你就能判斷錯誤是在何時出現的,以及錯誤是什麼。
Mysql中CAPI的學生信息管理系統
首先我是在fedora-8中進行的實驗
我把mysql需要的庫安裝在/usr/lib下,頭文件安裝在/usr/include/mysql/mysql.h下
利用 mysql中的C API對學生信息進行單個表格的管理。
部分源代碼:
void Show(char Table_Name[]) //輸出表格內容
{
char str[25];
sprintf(str, "select * from %s", Table_Name);
mysql_real_query(mysql, str, (unsigned int)strlen(str));
results = mysql_store_result(mysql);
printf("\n");
while((field = mysql_fetch_field(results)))
{
printf("%s\t\t", field->name);
}printf("\n");
while((record = mysql_fetch_row(results)))
{
num_fields = mysql_num_fields(results);
for(i = 0; i < num_fields; i++)
{
printf("%s\t\t", record[i]);
}printf("\n");
}
mysql_free_result(results);
}
void Insert(char Table_Name[]) //添加信息
{
char str1[4][10];
char str[30];
printf("請輸入名字: ");
scanf("%s", str1[0]);
printf("請輸入學號: ");
scanf("%s", str1[1]);
printf("請輸入數學成績: ");
scanf("%s", str1[2]);
printf("請輸入語文成績: ");
scanf("%s", str1[3]);
sprintf(str, "Insert into %s values(\"%s\", \"%s\", \"%s\", \"%s\")", Table_Name,str1[0],str1[1],str1[2],str1[3]);
printf("\n>>>%s\n", str);
mysql_real_query(mysql, str, (unsigned int)strlen(str));
printf(">>>添加成功!!!\n\n");
}
void Delete(char Table_Name[]) //刪除信息
{
char Delete_Name[10];
char Delete_Str[40];
printf("請輸入要刪除的信息的名字: ");
scanf("%s", Delete_Name);
sprintf(Delete_Str, "Delete from %s where name=\"%s\"", Table_Name, Delete_Name);
printf("\n>>>%s\n", Delete_Str);
mysql_real_query(mysql, Delete_Str, (unsigned int)strlen(Delete_Str));
printf(">>>刪除成功!!!\n\n");
}
void Find(char Table_Name[]) //修改信息
{
char Find_Str[40];
char Find_Name[10];
printf("請選擇要查詢的名字: ");
scanf("%s", Find_Name);
sprintf(Find_Str,"select * from %s where name=\"%s\"", Table_Name, Find_Name);
printf("\n>>>%s\n", Find_Str);
/*執行指定為“以Null終結的字符串”的SQL查詢*/
mysql_real_query(mysql, Find_Str, (unsigned int)strlen(Find_Str));
results = mysql_store_result(mysql); //能夠訪問以前從服務器獲得的行
printf(">>>共有%d條信息\n\n", *results);
while((field = mysql_fetch_field(results)))
{
printf("%s\t\t", field->name);
}printf("\n");
while((record = mysql_fetch_row(results))) //能夠訪問以前從服務器獲得的行
{
num_fields = mysql_num_fields(results);
for(i = 0; i < num_fields; i++)
{
printf("%s\t\t", record[i]);
}
printf("\n");
}
printf("\n");
}