类
FMDB中有三个常用的类：
-
FMDatabase表示一个SQLite数据库，用来执行SQL语句。 -
FMResultSet表示FMDatase执行查询语句后的结果。 -
FMDatabaseQueue当你需要在多线程中执行queries或updates时，需要使用这个类，它是线程安全的。
创建数据库
创建一个数据库FMDatabase 需要一个存储数据库的路径，这个路径可以是一下三种之一：
- 一个系统文件路径。当这个这个路径不存在database文件时，FMDB会为你创建一个。
- 一个空字符串
@""。此时FMDB会在临时路径tmp创建一个空的database，当FMDatabase的connection 被 closed的时候，它会被删除。 -
NULL。FMDB会在内存中创建一个database，同样的，当它的connection closed的时候会被删除。
FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];
打开数据库
在你跟数据库交互前，必须先打开它，当存储空间不足或者没有权限时，会打开失败。
if (![db open]) {
[db release];
return;
}
数据更新 Executing Updates
所有不是SELECT 的语句都被视为update，这其中包括CREATE、UPDATE、INSERT、ALTER、COMMIT、BEGIN、DETACH、DELETE、DROP、END、EXPLAIN、VACUUM 和REPLACE 等语句。基本上，如果你的SQL语句不是以SELECT 开头，就是一个update语句。
database执行updates会返回一个布尔值来表示是否成功，当是执行失败时，可以调用-lastErrorMessage 和 -lastErrorCode 方法来获取错误信息。
数据查询 Executing Queries
使用任何一个-executeQuery... 系列的方法执行SELECT 语句，被视为数据查询。
数据查询方法成功会返回一个FMResultSet 对象，失败时为nil。同样可以调用-lastErrorMessage 和 -lastErrorCode 方法来获取错误信息。
你可以用一个while 循环来遍历所有的查询结果：
FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ( [s next] ) {
// 获取数据
}
在获取查询结果的数据前，都应该调用-next 方法，及时你确定获取的结果只有一个
FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
int totalCount = [s intForColumnIndex:0];
}
FMResultSet 针对不同类型的数据有对应的数据获取方法：
intForColumn:longForColumn:longLongIntForColumn:boolForColumn:doubleForColumn:stringForColumn:dateForColumn:dataForColumn:dataNoCopyForColumn:-
UTF8StringForColumnName:
所有的这些方法都有一个{type}ForColumnIndex:方法，用columnIndex来获取数据。
FMResultSet并不需要手动去close，当对象被释放时会自动被close。
关闭数据库
当完成相关的操作后，应该调用-close 方法来关闭FMDatabase 的connection，让SQLite释放资源。
[db close];
事务处理(Transactions)
FMDatabase 可以通过调用相关的方法来进行事务处理。
多语句和批量任务
我们可以调用FMDatabase 的executeStatements: 、 -executeStatements: withResultBlock: 方法来执行多个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;
}];
数据消毒(Data Sanitization)
编写SQL语句时，应该使用? 作为变量值的占位符，? 是可以被SQLite识别的字符：
INSERT INTO myTable VALUES (?, ?, ?, ?);
FMDatabase 的执行方法可以接受多个参数，也可以调用下面的方法使用NSArray、NSDictionary等集合来表示这些参数。
- (BOOL)executeUpdate:(NSString*)sql withParameterDictionary:(NSDictionary *)arguments;
- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments;
NSInteger identifier = 42;
NSString *name = @"Liam O'Flahery(\"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：基本数据类型，如NSInteger 应该包装成NSNumber ，当对象可能是nil空时，应该使用[NSNull null] *
Swift 版本：
do {
let identifier = 42
let name = "Liam O'Flaherty (\"the famous Irish author\")"
let date = NSDate()
let comment: String? = nil
try db.executeUpdate("INSERT INTO authors (identifier, name, date, comment) VALUES (?, ?, ?, ?)", values: [identifier, name, date, comment ?? NSNull()])
} catch {
print("error = \(error)")
}
在swift中，基本数据不再需要包装成Number，但是在如果插入数据是可选型时，可以使用comment ?? NSNull() 类似的语法来防止插入nil。
也可以使用命名参数语法：
INSERT INTO authors (identifier, name, date, comment) VALUES (:identifier, :name, :date, :comment)
SQL语句中的 VALUES 后带的参数必须以冒号开头，而不要在字典中使用冒号开头的key。
NSDictionary *arguments = @{ @"identifier" : @identifier, @"name" : name, @"date": date, @"comment" : comment?:[NSNull null] };
success = [db executeUpdate:@"INSERT INTO authors (identifier, name, date, comment) VALUES (:identifier, :name:, :date, :comment" withParameterInDictionary:arguments];
if (!success) {
NSLog(@"error:%@", [db lastErrorMessage]);
}
使用FMDatabaseQueue和线程安全
不要在多个线程中使用同一个FMDatabase 对象，很容易造成程序崩溃。在每个线程中去创建FMDatabase 对象是可以的。
可以使用FMDatabaseQueue 对象，可以创建一个FMDatabaseQueue 对象，并且在多个线程中共用，因为它是线程安全的。怎么使用FMDatabaseQueue :
首先创建你的队列：
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath: aPath];
然后像这样使用它：
[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] ) {
// 获取数据...
}
}];
把多个语句包含在事务处理中也很简单：
[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 (whoopsSomethingWrongHappend) {
*rollback = YES;
}
// etc...
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @4];
}];
Swift ：
queue.inTransaction { db, rollback in
do {
try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [1])
try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [2])
try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [3])
if whoopsSomethingWrongHappened {
rollback.memory = true
return
}
try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [4])
} catch {
rollback.memory = true
print(error)
}
}
常用SQL语句
1.创建表
语法：
create table table_name (field1 type1, field2 type2, field3 type3...);
在SQLite3中可以不指定字段的数据类型，SQLite3会自动推断类型。常用的格式有：
文本： Text
整形： Integer
二进制数据: Blob
浮点型： Real Float、Double
布尔型： Boolean
时间型： Time
日期型： Date
时间戳： TimeStamp
示例代码：
NSString *createStatement = @"create table testTable (id integer primary key autoincrement, name text, length integer, year integer, actor text);"
字段可以添加约束：
- 主键：
primary key。主键的值必须唯一，用于标识每一条记录，如学生的学号；主键同时也是一个索引，通过主键查找记录速度较快；主键如果是整数类型，该列的值可以自动增长； - 自增：
autoincrement - 非空：
Not Null。字段值不能为空，否则报错。 - 唯一：
Unique。约束此字段值唯一。主键默认唯一。 - 条件检查：
Check。该字段值必须符合条件才能存入。 - 默认值：
Default。
2.增加数据
语法：
INSERT INTO table_name (field1, field2...) VALUES (var1, var2...);
示例代码
NSString *insertStatement = @"insert into student (stu_no, name) values (1, 'Jack')";
BOOL success = [db executeStatements:insertStatement];
3.更改数据
语法：
update table_name set field1 = var1, field2 = var2 where expression;
所有符合 where 条件的数据都会被更改。
示例代码：
NSString *updateStatement = @"update stuendt_info set stu_no = 0003, name = 'Merry' where stu_no = 0001;";
BOOL success = [db executeUpdate:updateStatement];
3.删除
语法：
delete from table_name where expression;
删除所有符合条件的数据，不设置条件时清空所有数据。
示例代码：
NSString *deleteStatement = @"delete from student_info where stu_no = 0001;";
BOOL success = [db executeUpdate:deleteStatement];
4.查询
// 选中所有
NSString *select = @"select * from film;";
FMResultSet *rs = [db executeQuery:select];
// 选中前2个
select = @"select * from film limit 2;";
rs = [db executeQuery:select];
// 选中几个column
select = @"select name,length from film limit 2;";
rs = [db executeQuery:select];
// 排序 (默认升序，desc 倒序)
select = @"select * from film order by length desc limit 3";
rs = [db executeQuery:select];
// 指定column值
select = @"select *from film where actor = 'Malanie Y'";
rs = [db executeQuery:select];
// 指定column开头, like, %是SQL中的通用符
select = @"select * from film where actor like 'J%'";
rs = [db executeQuery:select];
// 组合条件, 用and、or连接
select = @"select * from film where length >= 118 and year > 2010 and actor like 'M%';";
rs = [db executeQuery:select];
select = @"select *from film where length >= 120 or year >= 2016;";
rs = [db executeQuery:select];
// 表的数据量，有多少行, 取resultset的第0个column值就是rowCount
select = @"select count(*) from film;";
rs = [db executeQuery:select];
select = @"select count(*) from film where actor like 'J%'";
rs = [db executeQuery:select];
