一个SQLite3的小例子

一个SQLite3的小例子
http://blog.csdn.net/decemberd/article/details/7056258

写了一个比较简单的SQLite3的简单demo只实现了增加 更新 删除 获取全部数据  查找   数据库部分有详细注释    界面也比较简陋主要是实现一下数据库部分

资源地址：

        

部分代码如下：

//获取document目录并返回数据库目录

- (NSString *)dataFilePath{

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);

NSString *documentsDirectory = [paths objectAtIndex:0];

return [documentsDirectory stringByAppendingPathComponent:kFilename];

}

//创建，打开数据库

- (BOOL)openDB {

//获取数据库路径

NSString *path = [self dataFilePath];

//文件管理器

NSFileManager *fileManager = [NSFileManager defaultManager];

//判断数据库是否存在

BOOL find = [fileManager fileExistsAtPath:path];

//如果数据库存在，则用sqlite3_open直接打开（不要担心，如果数据库不存在sqlite3_open会自动创建）

if (find) {

NSLog(@"Database file have already existed.");

//打开数据库，这里的[path UTF8String]是将NSString转换为C字符串，因为SQLite3是采用可移植的C(而不是

//Objective-C)编写的，它不知道什么是NSString.

if(sqlite3_open([path UTF8String], &_database) != SQLITE_OK) {

//如果打开数据库失败则关闭数据库

sqlite3_close(self._database);

NSLog(@"Error: open database file.");

return NO;

}

//创建一个新表

[self createTestList:self._database];

return YES;

}

//如果发现数据库不存在则利用sqlite3_open创建数据库（上面已经提到过），与上面相同，路径要转换为C字符串

if(sqlite3_open([path UTF8String], &_database) == SQLITE_OK) {

//创建一个新表

[self createTestList:self._database];

return YES;

    } else {

//如果创建并打开数据库失败则关闭数据库

sqlite3_close(self._database);

NSLog(@"Error: open database file.");

return NO;

    }

return NO;

}

//创建表

- (BOOL) createTestList:(sqlite3*)db {

//这句是大家熟悉的SQL语句

char *sql = "create table if not exists testTable(ID INTEGER PRIMARY KEY AUTOINCREMENT, testID int,testValue text)";

sqlite3_stmt *statement;

//sqlite3_prepare_v2 接口把一条SQL语句解析到statement结构里去. 使用该接口访问数据库是当前比较好的的一种方法

NSInteger sqlReturn = sqlite3_prepare_v2(_database, sql, -1, &statement, nil);

//第一个参数跟前面一样，是个sqlite3 * 类型变量，

//第二个参数是一个 sql 语句。

//第三个参数我写的是-1，这个参数含义是前面 sql 语句的长度。如果小于0，sqlite会自动计算它的长度（把sql语句当成以\0结尾的字符串）。

//第四个参数是sqlite3_stmt 的指针的指针。解析以后的sql语句就放在这个结构里。

//第五个参数我也不知道是干什么的。为nil就可以了。

//如果这个函数执行成功（返回值是 SQLITE_OK 且 statement 不为NULL ），那么下面就可以开始插入二进制数据。

//如果SQL语句解析出错的话程序返回

if(sqlReturn != SQLITE_OK) {

NSLog(@"Error: failed to prepare statement:create test table");

return NO;

}

//执行SQL语句

int success = sqlite3_step(statement);

//释放sqlite3_stmt 

sqlite3_finalize(statement);

//执行SQL语句失败

if ( success != SQLITE_DONE) {

NSLog(@"Error: failed to dehydrate:create table test");

return NO;

}

NSLog(@"Create table 'testTable' successed.");

return YES;

}

//插入数据

-(BOOL) insertTestList:(sqlTestList *)insertList {

//先判断数据库是否打开

if ([self openDB]) {

sqlite3_stmt *statement;

//这个 sql 语句特别之处在于 values 里面有个? 号。在sqlite3_prepare函数里，?号表示一个未定的值，它的值等下才插入。

static char *sql = "INSERT INTO testTable(testID, testValue) VALUES(?, ?)";

int success2 = sqlite3_prepare_v2(_database, sql, -1, &statement, NULL);

if (success2 != SQLITE_OK) {

NSLog(@"Error: failed to insert:testTable");

sqlite3_close(_database);

return NO;

}

//这里的数字1，2，3代表第几个问号，这里将两个值绑定到两个绑定变量

sqlite3_bind_int(statement, 1, insertList.sqlID);

sqlite3_bind_text(statement, 2, [insertList.sqlText UTF8String], -1, SQLITE_TRANSIENT);

//执行插入语句

success2 = sqlite3_step(statement);

//释放statement

sqlite3_finalize(statement);

//如果插入失败

if (success2 == SQLITE_ERROR) {

NSLog(@"Error: failed to insert into the database with message.");

//关闭数据库

sqlite3_close(_database);

return NO;

}

//关闭数据库

sqlite3_close(_database);

return YES;

}

return NO;

}

//获取数据

- (NSMutableArray*)getTestList{

NSMutableArray *array = [NSMutableArray arrayWithCapacity:10];

//判断数据库是否打开

if ([self openDB]) {

sqlite3_stmt *statement = nil;

//sql语句

char *sql = "SELECT testID, testValue FROM testTable";

if (sqlite3_prepare_v2(_database, sql, -1, &statement, NULL) != SQLITE_OK) {

NSLog(@"Error: failed to prepare statement with message:get testValue.");

return NO;

}

else {

//查询结果集中一条一条的遍历所有的记录，这里的数字对应的是列值。

while (sqlite3_step(statement) == SQLITE_ROW) {

sqlTestList* sqlList = [[sqlTestList alloc] init] ;

sqlList.sqlID    = sqlite3_column_int(statement,0);

char* strText   = (char*)sqlite3_column_text(statement, 1);

sqlList.sqlText = [NSString stringWithUTF8String:strText];

                [array addObject:sqlList];

[sqlList release];

}

}

sqlite3_finalize(statement);

sqlite3_close(_database);

}

return [array retain];

}

//更新数据

-(BOOL) updateTestList:(sqlTestList *)updateList{

if ([self openDB]) {

//我想下面几行已经不需要我讲解了，嘎嘎 

sqlite3_stmt *statement;

//组织SQL语句

char *sql = "update testTable set testValue = ?  WHERE testID = ?";

//将SQL语句放入sqlite3_stmt中

int success = sqlite3_prepare_v2(_database, sql, -1, &statement, NULL);

if (success != SQLITE_OK) {

NSLog(@"Error: failed to update:testTable");

sqlite3_close(_database);

return NO;

}

//这里的数字1，2，3代表第几个问号。这里只有1个问号，这是一个相对比较简单的数据库操作，真正的项目中会远远比这个复杂

//当掌握了原理后就不害怕复杂了

sqlite3_bind_text(statement, 1, [updateList.sqlText UTF8String], -1, SQLITE_TRANSIENT);

sqlite3_bind_int(statement, 2, updateList.sqlID);

//执行SQL语句。这里是更新数据库

success = sqlite3_step(statement);

//释放statement

sqlite3_finalize(statement);

//如果执行失败

if (success == SQLITE_ERROR) {

NSLog(@"Error: failed to update the database with message.");

//关闭数据库

sqlite3_close(_database);

return NO;

}

//执行成功后依然要关闭数据库

sqlite3_close(_database);

return YES;

}

return NO;

}

//删除数据

- (BOOL) deleteTestList:(sqlTestList *)deletList{

if ([self openDB]) {

sqlite3_stmt *statement;

//组织SQL语句

static char *sql = "delete from testTable  where testID = ? and testValue = ?";

//将SQL语句放入sqlite3_stmt中

int success = sqlite3_prepare_v2(_database, sql, -1, &statement, NULL);

if (success != SQLITE_OK) {

NSLog(@"Error: failed to delete:testTable");

sqlite3_close(_database);

return NO;

}

//这里的数字1，2，3代表第几个问号。这里只有1个问号，这是一个相对比较简单的数据库操作，真正的项目中会远远比这个复杂

//当掌握了原理后就不害怕复杂了

sqlite3_bind_int(statement, 1, deletList.sqlID);

sqlite3_bind_text(statement, 2, [deletList.sqlText UTF8String], -1, SQLITE_TRANSIENT);

//执行SQL语句。这里是更新数据库

success = sqlite3_step(statement);

//释放statement

sqlite3_finalize(statement);

//如果执行失败

if (success == SQLITE_ERROR) {

NSLog(@"Error: failed to delete the database with message.");

//关闭数据库

sqlite3_close(_database);

return NO;

}

//执行成功后依然要关闭数据库

sqlite3_close(_database);

return YES;

}

return NO;

}

//查询数据

- (NSMutableArray*)searchTestList:(int)searchID{

NSMutableArray *array = [NSMutableArray arrayWithCapacity:10];

//判断数据库是否打开

if ([self openDB]) {

sqlite3_stmt *statement = nil;

//sql语句

char *sql = "SELECT testID, testValue FROM testTable WHERE testID = ?";

if (sqlite3_prepare_v2(_database, sql, -1, &statement, NULL) != SQLITE_OK) {

NSLog(@"Error: failed to prepare statement with message:search testValue.");

return NO;

}

else {

sqlite3_bind_int(statement, 1, searchID);

//查询结果集中一条一条的遍历所有的记录，这里的数字对应的是列值。

while (sqlite3_step(statement) == SQLITE_ROW) {

sqlTestList* sqlList = [[sqlTestList alloc] init] ;

sqlList.sqlID    = sqlite3_column_int(statement,0);

char* strText   = (char*)sqlite3_column_text(statement, 1);

sqlList.sqlText = [NSString stringWithUTF8String:strText];

                [array addObject:sqlList];

[sqlList release];

}

}

sqlite3_finalize(statement);

sqlite3_close(_database);

}

return [array retain];

}
http://www.cnblogs.com/hanjun/archive/2012/10/29/2744573.html

三、小结：

  1.数据查询：sqlite3_exec()函数执行sql语句，在没有返回值的情况下（比如创建表格、插入记录、删除记录等操作中）很好用。

                 也会用到sqlite3_stat结构、sqlite3_prepare_v2()函数、sqlte3_step()函数和sqlite3_finalize()函数。

       查询分三个阶段：准备阶段：sqlite3_stat、sqlite3_prepare_v2()

       执行阶段：sqlte3_step()

     终止阶段： sqlite3_finalize()

 2.附表：

 

sqlite3数据库打开时的返回值及其所代表的含义

返回值	描述	返回值	描述
SQLITE_OK=0	返回成功	SQLITE_FULL=13	数据库满，插入失败
SQLITE_ERROR=1	Sql错误或错误的数据库	SQLITE_CANTOPEN=14	不能打开数据库文件
SQLITE_INTERNAL=2	Sqlite的内部逻辑错误	SQLITE_PROTOCOL=15	数据库锁定协议错误
SQLITE_PERM=3	拒绝访问	SQLITE_EMPTY=16	数据库表为空
SQLITE_ABORT=4	回调函数请求中断	SQLITE_SCHEMA=17	数据库模式改变
SQLITE_BUSY=5	数据库文件被锁	SQLITE_TOOBIG=18	一个表数据行过多
SQLITE_LOCKED=6	数据库中的一个表被锁	SQLITE_CONSTRAINT=19	由于约束冲突而中止
SQLITE_NOMEN=7	内存分配失败	SQLITE_MISMATCH=20	数据类型不匹配
SQLITE_READONLY=8	试图对一个只读数据库进行写操作	SQLITE_MISUSE=21	数据库错误使用
SQLITE_INTERRUPT=9	由sqlite_interrupt()结束操作	SQLITE_NOLFS=22	使用主机操作系统不支持的特性
SQLITE_IOERR=10	磁盘I/O发生错误	SQLITE_AUTH=23	非法授权
SQLITE_CORRUPT=11	数据库磁盘镜像畸形	SQLITE_FORMAT=24	辅助数据库格式错误
SQLITE_NOTFOUND=12	（Internal Only）表或记录不存在	SQLITE_NOTADB=26	打开的不是一个数据库文件