與MySQL交互時(shí), 應(yīng)用程序應(yīng)使用該一般性原則:
1. 通過(guò)調(diào)用mysql_library_init(),初始化MySQL庫(kù)。庫(kù)可以是mysqlclient C客戶端庫(kù),或mysqld嵌入式服務(wù)器庫(kù),具體情況取決于應(yīng)用程序是否與“-libmysqlclient”或“-libmysqld”標(biāo)志鏈接。
2. 通過(guò)調(diào)用mysql_init()初始化連接處理程序,并通過(guò)調(diào)用mysql_real_connect()連接到服務(wù)器。
3. 發(fā)出SQL語(yǔ)句并處理其結(jié)果。(在下面的討論中,詳細(xì)介紹了使用它的方法)。
4. 通過(guò)調(diào)用mysql_close(),關(guān)閉與MySQL服務(wù)器的連接。
5. 通過(guò)調(diào)用mysql_library_end(),結(jié)束MySQL庫(kù)的使用。
調(diào)用 mysql_library_init()和mysql_library_end()的目的在于,為MySQL庫(kù)提供恰當(dāng)?shù)某跏蓟徒Y(jié)束處理。對(duì)于與客戶 端庫(kù)鏈接的應(yīng)用程序,它們提供了改進(jìn)的內(nèi)存管理功能。如果不調(diào)用mysql_library_end(),內(nèi)存塊仍將保持分配狀態(tài)(這不會(huì)增加應(yīng)用程序使 用的內(nèi)存量,但某些內(nèi)存泄漏檢測(cè)器將抗議它)。對(duì)于與嵌入式服務(wù)器鏈接的應(yīng)用程序,這些調(diào)用會(huì)啟動(dòng)并停止服務(wù)器。
mysql_library_init() 和mysql_library_end()實(shí)際上是#define符號(hào),這類符號(hào)使得它們等效于mysql_server_init()和 mysql_server_end(),但其名稱更清楚地指明,無(wú)論應(yīng)用程序使用的是mysqlclient或mysqld庫(kù),啟動(dòng)或結(jié)束MySQL庫(kù) 時(shí),應(yīng)調(diào)用它們。對(duì)于早期的MySQL版本,可調(diào)用mysql_server_init()和mysql_server_end()取而代之。
如 果愿意,可省略對(duì)mysql_library_init()的調(diào)用,這是因?yàn)椋匾獣r(shí),mysql_init()會(huì)自動(dòng)調(diào)用它。
要 想連接到服務(wù)器,可調(diào)用mysql_init()來(lái)初始化連接處理程序,然后用該處理程序(以及其他信息,如主機(jī)名、用戶名和密碼)調(diào)用 mysql_real_connect()。建立連接后,在低于5.0.3版的API中,mysql_real_connect()會(huì)將再連接標(biāo)志 (MYSQL結(jié)構(gòu)的一部分)設(shè)置為1,或在較新的版本中,將其設(shè)置為0。對(duì)于該標(biāo)志,值“1”指明,如果因連接丟失而無(wú)法執(zhí)行語(yǔ)句,放棄之前,會(huì)嘗試再次 連接到服務(wù)器。從MySQL 5.0.13開(kāi)始,可以在mysql_options()上使用MYSQL_OPT_RECONNECT選項(xiàng),以控制再連接行為。完成連接后,調(diào)用 mysql_close()中止它。
當(dāng)連接處于活動(dòng)狀態(tài)時(shí),客戶端或許會(huì)使用 mysql_query()或mysql_real_query()向服務(wù)器發(fā)出SQL查詢。兩者的差別在于,mysql_query()預(yù)期的查詢?yōu)橹?定的、由Null終結(jié)的字符串,而mysql_real_query()預(yù)期的是計(jì)數(shù)字符串。如果字符串包含二進(jìn)制數(shù)據(jù)(其中可能包含Null字節(jié)),就 必須使用mysql_real_query()。
對(duì)于每個(gè)非SELECT查詢(例如INSERT、 UPDATE、DELETE),通過(guò)調(diào)用mysql_affected_rows(),可發(fā)現(xiàn)有多少行已被改變(影響)。
對(duì) 于SELECT查詢,能夠檢索作為結(jié)果集的行。注意,某些語(yǔ)句因其返回行,類似與SELECT。包括SHOW、DESCRIBE和EXPLAIN。應(yīng)按照 對(duì)待SELECT語(yǔ)句的方式處理它們。
客戶端處理結(jié)果集的方式有兩種。一種方式是,通過(guò)調(diào)用 mysql_store_result(),一次性地檢索整個(gè)結(jié)果集。該函數(shù)能從服務(wù)器獲得查詢返回的所有行,并將它們保存在客戶端。第二種方式是針對(duì)客 戶端的,通過(guò)調(diào)用mysql_use_result(),對(duì)“按行”結(jié)果集檢索進(jìn)行初始化處理。該函數(shù)能初始化檢索結(jié)果,但不能從服務(wù)器獲得任何實(shí)際行。
在 這兩種情況下,均能通過(guò)調(diào)用mysql_fetch_row()訪問(wèn)行。通過(guò) mysql_store_result(),mysql_fetch_row()能夠訪問(wèn)以前從服務(wù)器獲得的行。通過(guò) mysql_use_result(),mysql_fetch_row()能夠?qū)嶋H地檢索來(lái)自服務(wù)器的行。通過(guò)調(diào)用 mysql_fetch_lengths(),能獲得關(guān)于各行中數(shù)據(jù)大小的信息。
完成結(jié)果集操作 后,請(qǐng)調(diào)用mysql_free_result()釋放結(jié)果集使用的內(nèi)存。
這兩種檢索機(jī)制是互補(bǔ) 的。客戶端程序應(yīng)選擇最能滿足其要求的方法。實(shí)際上,客戶端最常使用的是mysql_store_result()。
mysql_store_result() 的1個(gè)優(yōu)點(diǎn)在于,由于將行全部提取到了客戶端上,你不僅能連續(xù)訪問(wèn)行,還能使用mysql_data_seek()或mysql_row_seek()在 結(jié)果集中向前或向后移動(dòng),以更改結(jié)果集內(nèi)當(dāng)前行的位置。通過(guò)調(diào)用mysql_num_rows(),還能發(fā)現(xiàn)有多少行。另一方面,對(duì)于大的結(jié)果 集,mysql_store_result()所需的內(nèi)存可能會(huì)很大,你很可能遇到內(nèi)存溢出狀況。
mysql_use_result() 的1個(gè)優(yōu)點(diǎn)在于,客戶端所需的用于結(jié)果集的內(nèi)存較少,原因在于,一次它僅維護(hù)一行(由于分配開(kāi)銷較低,mysql_use_result()能更快)。它 的缺點(diǎn)在于,你必須快速處理每一行以避免妨礙服務(wù)器,你不能隨機(jī)訪問(wèn)結(jié)果集中的行(只能連續(xù)訪問(wèn)行),你不知道結(jié)果集中有多少行,直至全部檢索了它們?yōu)?止。不僅如此,即使在檢索過(guò)程中你判定已找到所尋找的信息,也必須檢索所有的行。
通過(guò)API,客戶 端能夠恰當(dāng)?shù)貙?duì)查詢作出響應(yīng)(僅在必要時(shí)檢索行),而無(wú)需知道查詢是否是SELECT查詢。可以在每次mysql_query()或 mysql_real_query()后,通過(guò)調(diào)用mysql_store_result()完成該操作。如果結(jié)果集調(diào)用成功,查詢?yōu)镾ELECT,而且 能夠讀取行。如果結(jié)果集調(diào)用失敗,可調(diào)用mysql_field_count()來(lái)判斷結(jié)果是否的確是所預(yù)期的。如果 mysql_field_count()返回0,查詢不返回?cái)?shù)據(jù)(表明它是INSERT、UPDATE、DELETE等),而且不返回行。如果 mysql_field_count()是非0值,查詢應(yīng)返回行,但沒(méi)有返回行。這表明查詢是失敗了的SELECT。關(guān)于如何實(shí)現(xiàn)該操作的示例,請(qǐng)參見(jiàn)關(guān) 于mysql_field_count()的介紹。
無(wú)論是 mysql_store_result()還是mysql_use_result(),均允許你獲取關(guān)于構(gòu)成結(jié)果集的字段的信息(字段數(shù)目,它們的名稱和 類型等)。通過(guò)重復(fù)調(diào)用mysql_fetch_field(),可以按順序訪問(wèn)行內(nèi)的字段信息,或者,通過(guò)調(diào)用 mysql_fetch_field_direct(),能夠在行內(nèi)按字段編號(hào)訪問(wèn)字段信息。通過(guò)調(diào)用mysql_field_seek(),可以改變當(dāng) 前字段的光標(biāo)位置。對(duì)字段光標(biāo)的設(shè)置將影響后續(xù)的mysql_fetch_field()調(diào)用。此外,你也能通過(guò)調(diào)用 mysql_fetch_fields(),一次性地獲得關(guān)于字段的所有信息。
為了檢測(cè)和通報(bào)錯(cuò) 誤,MySQL提供了使用mysql_errno()和mysql_error()函數(shù)訪問(wèn)錯(cuò)誤信息的機(jī)制。它們能返回關(guān)于最近調(diào)用的函數(shù)的錯(cuò)誤代碼或錯(cuò) 誤消息,最近調(diào)用的函數(shù)可能成功也可能失敗,這樣,你就能判斷錯(cuò)誤是在何時(shí)出現(xiàn)的,以及錯(cuò)誤是什么。