iOS App使用SQLite之句柄的定义及数据库的基本操作

句柄
要操纵一个数据库你就得有一个这个数据库的句柄（又碰到这个难以理解的词了，不过确实还没得一个更好的词来替代它）。其实你跟本不需要去在乎这个词叫什么，你只要搞清楚他是一个什么玩意儿。就如同鞋子为什么叫鞋子，仔细想想确实也难以理解，不过清楚他的功能就OK了，不是吗？
句柄在很多地方我们见到过，最常见的就是文件的句柄，我们要操纵一个文件，我们就要取得一个文件的句柄。句柄是个什么东东呢？其实很简单，句柄是一个东东的描述，他被定义为一个结构体，这个结构体可能会包含要描述的东东的具体信息，比如位置、大小、类型等等。我们有了这个描述信息我们就能去找到这个东东，然后操纵它。
一句话：句柄是物体的描述结构体。
我们来看看sqlite的句柄是怎么定义的（不要被吓到了，代码直接跳过就好）：

struct sqlite3 {sqlite3_vfs *pVfs;/* OS Interface */int nDb; /* Number of backends currently in use */Db *aDb; /* All backends */int flags;/* Miscellaneous flags. See below */unsigned int openFlags;/* Flags passed to sqlite3_vfs.xOpen（） */int errCode; /* Most recent error code （SQLITE_*） */int errMask; /* & result codes with this before returning */u8 autoCommit;/* The auto-commit flag. */u8 temp_store;/* 1: file 2: memory 0: default */u8 mallocFailed; /* True if we have seen a malloc failure */u8 dfltLockMode; /* Default locking-mode for attached dbs */signed char nextAutovac; /* Autovac setting after VACUUM if >=0 */u8 suppressErr;/* Do not issue error messages if true */u8 vtabOnConflict;/* Value to return for s3_vtab_on_conflict（） */int nextPagesize; /* Pagesize after VACUUM if >0 */int nTable;/* Number of tables in the database */CollSeq *pDfltColl;/* The default collating sequence （BINARY） */i64 lastRowid;/* ROWID of most recent insert （see above） */u32 magic;/* Magic number for detect library misuse */int nChange; /* Value returned by sqlite3_changes（） */int nTotalChange; /* Value returned by sqlite3_total_changes（） */sqlite3_mutex *mutex; /* Connection mutex */int aLimit[SQLITE_N_LIMIT];/* Limits */struct sqlite3InitInfo { /* Information used during initialization */ int iDb;/* When back is being initialized */ int newTnum;/* Rootpage of table being initialized */ u8 busy;/* TRUE if currently initializing */ u8 orphanTrigger;/* Last statement is orphaned TEMP trigger */} init;int nExtension;/* Number of loaded extensions */void **aExtension;/* Array of shared library handles */struct Vdbe *pVdbe;/* List of active virtual machines */int activeVdbeCnt;/* Number of VDBEs currently executing */int writeVdbeCnt; /* Number of active VDBEs that are writing */int vdbeExecCnt; /* Number of nested calls to VdbeExec（） */void （*xTrace）（void*,const char*）;/* Trace function */void *pTraceArg; /* Argument to the trace function */void （*xProfile）（void*,const char*,u64）; /* Profiling function */void *pProfileArg;/* Argument to profile function */void *pCommitArg; /* Argument to xCommitCallback（） */int （*xCommitCallback）（void*）;/* Invoked at every commit. */void *pRollbackArg;/* Argument to xRollbackCallback（） */void （*xRollbackCallback）（void*）; /* Invoked at every commit. */void *pUpdateArg;void （*xUpdateCallback）（void*,int, const char*,const char*,sqlite_int64）; #ifndef SQLITE_OMIT_WALint （*xWalCallback）（void *, sqlite3 *, const char *, int）;void *pWalArg; #endifvoid（*xCollNeeded）（void*,sqlite3*,int eTextRep,const char*）;void（*xCollNeeded16）（void*,sqlite3*,int eTextRep,const void*）;void *pCollNeededArg;sqlite3_value *pErr; /* Most recent error message */char *zErrMsg;/* Most recent error message （UTF-8 encoded） */char *zErrMsg16; /* Most recent error message （UTF-16 encoded） */union { volatile int isInterrupted; /* True if sqlite3_interrupt has been called */ double notUsed1;/* Spacer */} u1;Lookaside lookaside; /* Lookaside malloc configuration */ #ifndef SQLITE_OMIT_AUTHORIZATIONint （*xAuth）（void*,int,const char*,const char*,const char*,const char*）; /* Access authorization function */void *pAuthArg;/* 1st argument to the access auth function */ #endif #ifndef SQLITE_OMIT_PROGRESS_CALLBACKint （*xProgress）（void *）; /* The progress callback */void *pProgressArg;/* Argument to the progress callback */int nProgressOps; /* Number of opcodes for progress callback */ #endif #ifndef SQLITE_OMIT_VIRTUALTABLEHash aModule; /* populated by sqlite3_create_module（） */VtabCtx *pVtabCtx;/* Context for active vtab connect/create */VTable **aVTrans; /* Virtual tables with open transactions */int nVTrans; /* Allocated size of aVTrans */VTable *pDisconnect;/* Disconnect these in next sqlite3_prepare（） */ #endifFuncDefHash aFunc;/* Hash table of connection functions */Hash aCollSeq;/* All collating sequences */BusyHandler busyHandler; /* Busy callback */int busyTimeout; /* Busy handler timeout, in msec */Db aDbStatic[2]; /* Static space for the 2 default backends */Savepoint *pSavepoint;/* List of active savepoints */int nSavepoint;/* Number of non-transaction savepoints */int nStatement;/* Number of nested statement-transactions */u8 isTransactionSavepoint;/* True if the outermost savepoint is a TS */i64 nDeferredCons;/* Net deferred constraints this transaction. */int *pnBytesFreed;/* If not NULL, increment this in DbFree（） */#ifdef SQLITE_ENABLE_UNLOCK_NOTIFY/* The following variables are all protected by the STATIC_MASTER** mutex, not by sqlite3.mutex. They are used by code in notify.c.**** When X.pUnlockConnection==Y, that means that X is waiting for Y to** unlock so that it can proceed.**** When X.pBlockingConnection==Y, that means that something that X tried** tried to do recently failed with an SQLITE_LOCKED error due to locks** held by Y.*/sqlite3 *pBlockingConnection; /* Connection that caused SQLITE_LOCKED */sqlite3 *pUnlockConnection;/* Connection to watch for unlock */void *pUnlockArg; /* Argument to xUnlockNotify */void （*xUnlockNotify）（void **, int）; /* Unlock notify callback */sqlite3 *pNextBlocked;/* Next in list of all blocked connections */ #endif }; typedef struct sqlite3 sqlite3;//

是不是被吓到了，没关系，这段代码本来就是我贴出来吓唬你的，我也没认真研究过这个代码，也不想去研究，除非哪天有人出高价请我去研究，我现在只知道怎么用就好了。
这个 sqlite3 结构体就是被用来描述我们磁盘里的数据库文件的，有了这个描述符我们就可以对这个数据库进行各种操作了，操作的具体内情我们不必要了解，我们只需要知道怎么去调用API就好了，当然有时候还是要了解一点点内情的，这个以后碰到再讲。
我用这么长的话加一大段吓人的代码只有一个目的：不要对句柄有恐惧感。
好了，开始我们的正题，sqlite 里面你要操纵数据库我们先得创建一个句柄，然后后面所有对数据库得操作都会用到这个句柄。

sqlite3* pdb;

就这么简单，这样一个ssqlite的句柄我们就创建完成了，我们以后针对数据库的操作都离不开它了。

打开、关闭、创建数据库
我创建了一个句柄，但是我怎么知道这个句柄指向的是磁盘上哪个数据库文件呢？我们只是创建了一个指针，指向一个 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_OK0/* Successful result */ /* beginning-of-error-codes */ #define SQLITE_ERROR1/* SQL error or missing database */ #define SQLITE_INTERNAL 2/* Internal logic error in SQLite */ #define SQLITE_PERM 3/* Access permission denied */ #define SQLITE_ABORT4/* Callback routine requested an abort */ #define SQLITE_BUSY 5/* The database file is locked */ #define SQLITE_LOCKED6/* A table in the database is locked */ #define SQLITE_NOMEM7/* A malloc（） failed */ #define SQLITE_READONLY 8/* Attempt to write a readonly database */ #define SQLITE_INTERRUPT9/* Operation terminated by sqlite3_interrupt（）*/ #define SQLITE_IOERR10/* Some kind of disk I/O error occurred */ #define SQLITE_CORRUPT 11/* The database disk image is malformed */ #define SQLITE_NOTFOUND12/* Unknown opcode in sqlite3_file_control（） */ #define SQLITE_FULL13/* Insertion failed because database is full */ #define SQLITE_CANTOPEN14/* Unable to open the database file */ #define SQLITE_PROTOCOL15/* Database lock protocol error */ #define SQLITE_EMPTY16/* 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_MISMATCH20/* Data type mismatch */ #define SQLITE_MISUSE 21/* Library used incorrectly */ #define SQLITE_NOLFS22/* Uses OS features not supported on host */ #define SQLITE_AUTH23/* Authorization denied */ #define SQLITE_FORMAT 24/* Auxiliary database format error */ #define SQLITE_RANGE25/* 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_DONE101 /* sqlite3_step（） has finished executing */ /* end-of-error-codes */

有了这些我们就可以更加方便地调试我们的代码了。
好了，进入正题，上面这个函数就是在数据库存在的情况下打开数据库，不存在的情况下创建数据库，数据库的名字可以随便乱取，只要是ASCII字符就好了，因为sqlite数据库本来就是一个ASCII文件（所以它的安全性还是不大行的，不过作为本地数据库没啥问题）。
数据库打开后我们就可以进行一系列的增删查改的操作了，操作完毕我们就要关闭数据库，不是么？否则怎么释放资源呢？
关闭也很简单：

SQLITE_API int sqlite3_close（sqlite3 *db）;

这个就不用解释了吧，直接看我的实例：

sqlite3_close（pdb）;// 这里就可以不去考虑返回值了