郝萌主倾心贡献。尊重作者的劳动成果,请勿转载。
假设文章对您有所帮助,欢迎给作者捐赠。支持郝萌主,捐赠数额任意,重在心意^_^
我要捐赠: 点击捐赠
Cocos2d-X源代码下载:点我传送
因为FMDB是建立在SQLite的之上的,所以你至少也该把这篇文章从头到尾读一遍。
与此同一时候,把SQLite的文档页 http://www.sqlite.org/docs.html 加到你的书签中。
两种都行,FMDB会在编译的时候知道你是用的哪一种,然后进行对应处理。
FMDB有三个基本的类
FMDatabase – 表示一个单独的SQLite数据库。 用来运行SQLite的命令。
FMResultSet – 表示FMDatabase运行查询后结果集
FMDatabaseQueue – 假设你想在多线程中运行多个查询或更新。你应该使用该类。这是线程安全的。
数据库创建
创建FMDatabase对象时參数为SQLite数据库文件路径。该路径能够是下面三种之中的一个:
文件路径。该文件路径无需真实存,假设不存在会自己主动创建。
空字符串(@”")。表示会在暂时文件夹创建一个空的数据库,当FMDatabase 链接关闭时,文件也被删除。
NULL. 将创建一个内在数据库。
相同的。当FMDatabase连接关闭时,数据会被销毁。
(如需对暂时数据库或内在数据库进行一步了解,请继续阅读:http://www.sqlite.org/inmemorydb.html)
FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];
打开数据库
在和数据库交互 之前,数据库必须是打开的。假设资源或权限不足无法打开或创建数据库。都会导致打开失败。
if (![db open]) {
[db release];
return;
}
运行更新
一切不是SELECT命令的命令都视为更新。
这包含 CREATE, UPDATE, INSERT,ALTER,
COMMIT, BEGIN, DETACH, DELETE, DROP, END, EXPLAIN, VACUUM, and REPLACE (等)。
简单来说,仅仅要不是以SELECT开头的命令都是UPDATE命令。
运行更新返回一个BOOL值。YES表示运行成功,否则表示有那些错误 。
你能够调用 -lastErrorMessage 和 -lastErrorCode方法来得到很多其它信息。
SELECT命令就是查询,运行查询的方法是以 -excuteQuery开头的。
运行查询时。假设成功返回FMResultSet对象, 错误返回nil. 与运行更新相当。
支持使用 NSError**參数。同一时候,你也能够使用 -lastErrorCode和-lastErrorMessage获知错误信息。
为了遍历查询结果,你能够使用while循环。你还须要知道怎么跳到下一个记录。
使用FMDB。非常easy实现。就像这样:
FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
//retrieve values for each record
}
你必须一直调用 -[FMResultSet next] 在你訪问查询返回值之前,甚至你仅仅想要一个记录:
FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
int totalCount = [s intForColumnIndex:0];
}
FMResultSet 提供了非常多方法来获得所需的格式的值:
intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumnIndex:
objectForColumn:
这些方法也都包含 {type}ForColumnIndex 的这样子的方法,參数是查询结果集的列的索引位置。
你无需调用 [FMResultSet close]来关闭结果集, 当新的结果集产生,或者其数据库关闭时,会自己主动关闭。
关闭数据库
当使用完数据库。你应该 -close 来关闭数据库连接来释放SQLite使用的资源。
[db close];
事务
FMDatabase是支持事务的。
数据净化(数据格式化)
使用FMDB。插入数据前,你不要花时间审查你的数据。你能够使用标准的SQLite数据绑定语法。
INSERT INTO myTable VALUES (?, ?, ?)
SQLite会识别 “?” 为一个输入的点位符。 这种运行会接受一个可变參数(或者表示为其它參数。如NSArray, NSDictionary,或va_list等)。会正确为您转义。
你也能够选择使用命名參数语法。
INSERT INTO myTable VALUES (:id, :name, :value)
參数名必须以冒名开头。
SQLite本身支持其它字符,当Dictionary key的内部实现是冒号开头。
注意你的NSDictionary key不要包括冒号。
NSDictionary *argsDict = [NSDictionary dictionaryWithObjectsAndKeys:@"My Name", @"name", nil];
[db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)" withParameterDictionary:argsDict];
并且,代码不能这么写(为什么?想想吧。)
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has \" lots of ' bizarre \" quotes '"];
你应该:
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has " lots of ' bizarre " quotes '"];
提供给 -executeUpdate: 方法的參数都必须是对象。就像下面的代码就无法工作,且会产生崩溃。
[db executeUpdate:@"INSERT INTO myTable VALUES (?
)", 42];
正确有做法是把数字打包成 NSNumber对象
[db executeUpdate:@"INSERT INTO myTable VALUES (?
)", [NSNumber numberWithInt:42]];
或者,你能够使用 -execute*WithFormat: 。这是NSString风格的參数
[db executeUpdateWithFormat:@"INSERT INTO myTable VALUES (%d)", 42];
-execute*WithFormat: 的方法的内部实现会帮你封装数据, 下面这些修饰符都能够使用: %@, %c, %s, %d, %D,
%i, %u, %U, %hi, %hu, %qi, %qu, %f, %g, %ld, %lu, %lld, and %llu. 除此之外的修饰符可能导致无法预知的结果。
一些情况下,你须要在SQL语句中使用 % 字符,你应该使用 %%。
在多个线程中同一时候使用一个FMDatabase实例是不明智的。
如今你能够为每一个线程创建一个FMDatabase对象。
不要让多个线程分享同一个实例。它无法在多个线程中同一时候使用。 若此,坏事会常常发生,程序会时不时崩溃,
或者报告异常,或者陨石会从天空中掉下来砸到你Mac Pro. 总之非常崩溃。
所以,不要初始化FMDatabase对象,然后在多个线程中使用。
请使用 FMDatabaseQueue,它是你的朋友并且会帮助你。
下面是用法:
首先创建队列。FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];
这样使用。
[queue inDatabase:^(FMDatabase *db) {
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];
FMResultSet *rs = [db executeQuery:@"select * from foo"];
while([rs next]) {
…
}
}];
像这样,轻松地把简单任务包装到事务里:
[queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
[db executeUpdate:@"INSERT INTO myTable VALUES (?
)", [NSNumber numberWithInt:1]];
[db executeUpdate:@"INSERT INTO myTable VALUES (?
)", [NSNumber numberWithInt:2]];
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];
if (whoopsSomethingWrongHappened) {
*rollback = YES; return;
}
// etc…
[db executeUpdate:@"INSERT INTO myTable VALUES (?
)", [NSNumber numberWithInt:4]];
}];
FMDatabaseQueue 后台会建立系列化的GCD队列,并运行你传给GCD队列的块。
这意味着你从多线程同一时候调用调用方法,GCD也会按它接收的块的顺序来运行。
郝萌主倾心贡献,尊重作者的劳动成果,请勿转载。
假设文章对您有所帮助。欢迎给作者捐赠,支持郝萌主。捐赠数额任意,重在心意^_^
我要捐赠: 点击捐赠
Cocos2d-X源代码下载:点我传送
版权声明:本文博客原创文章,博客,未经同意,不得转载。