iOS数据库存储之SQLite3

资源连接:

iOS数据库存储之SQL语句;

iOS数据存储之文件沙盒;

iOS数据存储之NSCoding;

SQLite常见问题;

数据库简介

数据库(Database)是按照数据结构来组织、存储和管理数据的仓库
数据库可以分为2大种类:关系型数据库(主流)和 对象型数据库

常用关系型数据库
PC端:Oracle、MySQL、SQL Server、Access、DB2、Sybase
嵌入式\移动客户端:SQLite

数据库存储单元

  1. 数据库的存储结构和excel很像,以表(table)为单位。
  2. 数据库存储数据的步骤
  • 新建一张表(table)
  • 添加多个字段(column,列,属性)
  • 添加多行记录(row,record,每行存放多个字段对应的值)

SQLite3

overview:SQLite是一款轻型的嵌入式数据库
它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了
它的处理速度比Mysql、PostgreSQL这两款著名的数据库都还快。目前iOS系统为开发者提供的数据库是SQLite3版本。

iOS 提供的数据库接口是C语言接口,用起来比较麻烦,下面我们重点介绍面向对象的FMDB。

FMDB

一款优秀的三方开源的SQLite操作框架,支持OC和Swift,上方资源链接有其GitHub地址,本文主要来自其README.Markdown。FMDB早已经支持CocoaPods,可以用 pod 'FMDB' 进行安装。你可以用在ARC和MRC项目中,因为FMDB已经为我们在编译阶段处理好了。

主要结构

有三个主要的类:

  1. FMDatabase: 为执行SQL语句(statements)提供了一个单一的数据库。
  2. FMResultSet :执行查询(query,这里FMDB特指,下面会有解释)语句的结果集。
  3. FMDatabaseQueue:在多线程中执行查询(queries)和更行(updates),需要用到,因为它线程安全。

数据库创建

MDatabase 是通过一个 SQLite 数据库文件路径创建的,此路径可以是以下三者之一:

  1. 一个文件的系统路径,如果此文件不存在,它会为你在此路径下创建文件
  2. 一个空的字符串 @""。会在临时位置创建一个空的数据库,当 FMDatabase 连接关闭时,该数据库会被删除。
  3. NULL。会在内存中创建一个数据库,当FMDatabase 连接关闭时,该数据库会被销毁。
NSString *path = [NSTemporaryDirectory() stringByAppendingPathComponent:@"tmp.db"];
FMDatabase *db = [FMDatabase databaseWithPath:path];

For more infomation

打开数据库

数据库必须是打开状态,才能与之交互。如果没有足够的资源和权限来打开创建数据库,数据库会打开失败。

if (![db open]) {
    // [db release];   // uncomment this line in manual referencing code; in ARC, this is not necessary/permitted
    db = nil;
    return;
}

Updates 和 Queries

  1. SQL语句(statement)只要不是SELECT语句,你都应该使用FMDB的update方法,这些SQL语句包括CREATE, UPDATE, INSERT, ALTER, COMMIT, BEGIN, DETACH, DELETE, DROP, END, EXPLAIN, VACUUM, and REPLACE,只要你的语句不以SELECT开,就用update方法吧。

  2. 执行update方法后会返回一个 BOOL 值,返回 YES 表示执行更新语句成功,返回 NO 表示出现错误,可以通过调用 -lastErrorMessage 和 -lastErrorCode 方法获取更多错误信息。

  3. 执行query方法后,如果成功会返回一个 FMResultSet 对象,反之会返回 nil。通过 -lastErrorMessage 和 -lastErrorCode 方法可以确定为什么会查询失败。

Queries

为了遍历查询结果,需要 while() 循环,然后逐条记录查看。在 FMDB 中,可以通过下面的简单方式实现:

FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
 //retrieve values for each record
}

FMResultSet 提供了很多方便的方法来查询数据:
intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dateForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumn:
objectForColumn:

不用字段名也可以查询,FMDB提供了一中通过列号获取相关值的变体方法 ForColumnIndex:

特别说明,一个 FMResultSet 没有必要手动 -close,因为结果集合 (result set) 被释放或者源数据库关闭会自动关闭。

关闭数据库

当对数据库进行查询和更新操作完成后,需要调用 -close 关闭数据库 FMDatabase 的连接。

[db close];

事务

FMDatabase 可以通过调用方法来开始和提交事务,也可以通过执行开始\结束事务 (begin\end transaction) 语句。

多语句和批处理

在一句话中执行多个SQL语句

NSString *sql = @"create table bulktest1 (id integer primary key autoincrement, x text);"
                 "create table bulktest2 (id integer primary key autoincrement, y text);"
                 "create table bulktest3 (id integer primary key autoincrement, z text);"
                 "insert into bulktest1 (x) values ('XXX');"
                 "insert into bulktest2 (y) values ('YYY');"
                 "insert into bulktest3 (z) values ('ZZZ');";

success = [db executeStatements:sql];

sql = @"select count(*) as count from bulktest1;"
       "select count(*) as count from bulktest2;"
       "select count(*) as count from bulktest3;";

success = [self.db executeStatements:sql withResultBlock:^int(NSDictionary *dictionary) {
    NSInteger count = [dictionary[@"count"] integerValue];
    XCTAssertEqual(count, 1, @"expected one record for dictionary %@", dictionary);
    return 0;
}];

数据类型处理

当使用FMDB处理SQL语句时,你应该使用标准的SQLite语法,不应该有额外处理。先看张图:

数据库参数语法.png

通过图我们可以看出尽管SQL语句大体相似,但是在不同数据库的特点,可能参数化SQL语句不同,例如在Access中参数化SQL语句是在参数直接以“?”作为参数名,在SQL Server中是参数有“@”前缀,在MySQL中是参数有“?”前缀,在Oracle中参数以“:”为前缀。

这里SQLite的参数化语法与Access相同,如下代码。

NSInteger identifier = 42;
NSString *name = @"Liam O'Flaherty (\"the famous Irish author\")";
NSDate *date = [NSDate date];
NSString *comment = nil;

BOOL success = [db executeUpdate:@"INSERT INTO authors (identifier, name, date, comment) VALUES (?, ?, ?, ?)", @(identifier), name, date, comment ?: [NSNull null]];
if (!success) {
    NSLog(@"error = %@", [db lastErrorMessage]);
}

NOTE:基本数据类型应该被包装成OC对象。

当然你也可以使用命名参数语法,例如:INSERT INTO authors (identifier, name, date, comment) VALUES (:identifier, :name, :date, :comment);看下面一段代码:

NSDictionary *arguments = @{@"identifier": @(identifier), @"name": name, @"date": date, @"comment": comment ?: [NSNull null]};
BOOL success = [db executeUpdate:@"INSERT INTO authors (identifier, name, date, comment) VALUES (:identifier, :name, :date, :comment)" withParameterDictionary:arguments];
if (!success) {
    NSLog(@"error = %@", [db lastErrorMessage]);
}

Note:字典里面的key值,不应该加上:号了,因为FMDB已经帮你做了。

FMDatabaseQueue 和 Thread Safety

Note: 在多线程中用单一的FMDatabase实例不是好的做法,因为他不是线程安全的。作为替代方案,可以用FMDatabaseQueue实例。

  1. 第一步,创建实例
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];

  1. 这么用
[queue inDatabase:^(FMDatabase *db) {
   [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @1];
   [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @2];
   [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @3];

   FMResultSet *rs = [db executeQuery:@"select * from foo"];
   while ([rs next]) {
       …
   }
}];

  1. 事物处理

    [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
     [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @1];
     [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @2];
     [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @3];
    
     if (whoopsSomethingWrongHappened) {
         *rollback = YES;
         return;
     }
    
     // etc ...
    

}];

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,723评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,080评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,604评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,440评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,431评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,499评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,893评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,541评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,751评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,547评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,619评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,320评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,890评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,896评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,137评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,796评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,335评论 2 342

推荐阅读更多精彩内容