打開、關閉、創建 數據庫 －sqlite 基礎教程(4)

文章出處：http://blog.csdn.net/iukey

上一講的最后我留了點懸念，不知道上一講看完你有木有疑問。我的疑問就是我創建了一個句柄，但是我怎么知道這個句柄指向的是磁盤上哪個數據庫文件呢？我們只是創建了一個指針，指向一個 sqlite3 類型的結構體。里面的數據都是空的或者默認的。我們接下來要做的就是去為這個結構體申請內存並填充這個結構體。是不是感覺又被嚇到了？這個結構體這么龐大，我們自己去填充還不的猴年馬月啊。一切都不用害怕，並不需要我們顯式的去填充它，我們只需要告訴它一些最基本的信息，然后調用API讓API去幫我們填充。

目前我們只需要告訴這個結構體一個信息，就是數據庫文件的路徑。然后調用 sqlite3_open 函數就OK了。

 

SQLITE_API int sqlite3_open(//SQLITE_API 是個宏，用來標注API的不用理它
  const char *zFilename,
  sqlite3 **ppDb
);

第一個參數是路徑，const char * 型，第二個參數是數據庫句柄的指針，注意是一個二級指針，我們聲明的一級指針，所以我們還要加一個取地址符&，請看我下面的實例：

int ret = sqlite3_open( getFilePath(), &pdb);//

 不要奇怪，其實打開數據庫就是獲得數據庫的一些信息，然后方便我們操縱它，不是嗎？通過這個函數 我們把 數據庫與 句柄 pdb 綁定在一起了，我們以就通過 這個 pdb 來操縱數據庫了。在這個函數中第一個參數是數據庫文件的路徑(包括文件名)，我一般會把路徑寫成一個函數，這樣遵循編碼原則(這里用到的原則是一個函數盡量只做一件事情)，建議你也這樣，好處你自己可以慢慢體會到。我獲取路徑的函數如下你可以參考一下：

const char* getFilePath(){  
    return [[NSString stringWithFormat:@"%@/Documents/db",NSHomeDirectory() ] UTF8String];  
            //不好意思這里用到了與IOS相關的一點東西，不過這個也沒辦法，除非我寫成絕對路徑，但是那樣是行不通的  
            // 不過也沒關系，你移植到別處肯定也是要改路徑的咯，所以移植的時候改一下就好了  
}  

 

還有一點就是返回值，返回值我們用來判斷是否執行成功。sqlite 中幫我們定義了一系列的宏，用來作為返回值：

#define SQLITE_OK           0   /* Successful result */  
/* beginning-of-error-codes */  
#define SQLITE_ERROR        1   /* SQL error or missing database */  
#define SQLITE_INTERNAL     2   /* Internal logic error in SQLite */  
#define SQLITE_PERM         3   /* Access permission denied */  
#define SQLITE_ABORT        4   /* Callback routine requested an abort */  
#define SQLITE_BUSY         5   /* The database file is locked */  
#define SQLITE_LOCKED       6   /* A table in the database is locked */  
#define SQLITE_NOMEM        7   /* A malloc() failed */  
#define SQLITE_READONLY     8   /* Attempt to write a readonly database */  
#define SQLITE_INTERRUPT    9   /* Operation terminated by sqlite3_interrupt()*/  
#define SQLITE_IOERR       10   /* Some kind of disk I/O error occurred */  
#define SQLITE_CORRUPT     11   /* The database disk image is malformed */  
#define SQLITE_NOTFOUND    12   /* Unknown opcode in sqlite3_file_control() */  
#define SQLITE_FULL        13   /* Insertion failed because database is full */  
#define SQLITE_CANTOPEN    14   /* Unable to open the database file */  
#define SQLITE_PROTOCOL    15   /* Database lock protocol error */  
#define SQLITE_EMPTY       16   /* Database is empty */  
#define SQLITE_SCHEMA      17   /* The database schema changed */  
#define SQLITE_TOOBIG      18   /* String or BLOB exceeds size limit */  
#define SQLITE_CONSTRAINT  19   /* Abort due to constraint violation */  
#define SQLITE_MISMATCH    20   /* Data type mismatch */  
#define SQLITE_MISUSE      21   /* Library used incorrectly */  
#define SQLITE_NOLFS       22   /* Uses OS features not supported on host */  
#define SQLITE_AUTH        23   /* Authorization denied */  
#define SQLITE_FORMAT      24   /* Auxiliary database format error */  
#define SQLITE_RANGE       25   /* 2nd parameter to sqlite3_bind out of range */  
#define SQLITE_NOTADB      26   /* File opened that is not a database file */  
#define SQLITE_ROW         100  /* sqlite3_step() has another row ready */  
#define SQLITE_DONE        101  /* sqlite3_step() has finished executing */  
/* end-of-error-codes */  

有了這些我們就可以更加方便地調試我們的代碼了。

好了，進入正題，上面這個函數就是在數據庫存在的情況下打開數據庫，不存在的情況下創建數據庫，數據庫的名字可以隨便亂取，只要是ASCII字符就好了，因為sqlite數據庫本來就是一個ASCII文件(所以它的安全性還是不大行的，不過作為本地數據庫沒啥問題)。

數據庫打開后我們就可以進行一系列的增刪查改的操作了，操作完畢我們就要關閉數據庫，不是么？否則怎么釋放資源呢？

關閉也很簡單：

SQLITE_API int sqlite3_close(sqlite3 *db);

 這個就不用解釋了吧，直接看我的實例：

sqlite3_close(pdb);// 這里就可以不去考慮返回值了

 

好了，這一節又講完了。是不是覺得很簡單。OK，期待下一節吧，下一節我們學習：創建表。