FMDB中有三个常用的类:
FMDatabase
表示一个SQLite数据库,用来执行SQL语句。FMResultSet
表示FMDatase
执行查询语句后的结果。FMDatabaseQueue
当你需要在多线程中执行queries或updates时,需要使用这个类,它是线程安全的。创建一个数据库FMDatabase
需要一个存储数据库的路径,这个路径可以是一下三种之一:
@""
。此时FMDB会在临时路径tmp
创建一个空的database,当FMDatabase
的connection 被 closed的时候,它会被删除。NULL
。FMDB会在内存中创建一个database,同样的,当它的connection closed的时候会被删除。FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];
在你跟数据库交互前,必须先打开它,当存储空间不足或者没有权限时,会打开失败。
if (![db open]) {
[db release];
return;
}
所有不是SELECT
的语句都被视为update,这其中包括CREATE
、UPDATE
、INSERT
、ALTER
、COMMIT
、BEGIN
、DETACH
、DELETE
、DROP
、END
、EXPLAIN
、VACUUM
和REPLACE
等语句。基本上,如果你的SQL语句不是以SELECT
开头,就是一个update语句。
database执行updates会返回一个布尔值来表示是否成功,当是执行失败时,可以调用-lastErrorMessage
和 -lastErrorCode
方法来获取错误信息。
使用任何一个-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];
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;
}];
编写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]);
}
不要在多个线程中使用同一个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)
}
}
语法:
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
。语法:
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];
语法:
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];
语法:
delete from table_name where expression;
删除所有符合条件的数据,不设置条件时清空所有数据。
示例代码:
NSString *deleteStatement = @"delete from student_info where stu_no = 0001;";
BOOL success = [db executeUpdate:deleteStatement];
// 选中所有
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];