iOS数据持久化
概念:所谓持久化,就是将数据保存在硬盘中,使得在应用程序重启或者机器重启之后可以继续访问之前保存的数据。在iOS开发中,有很多持久化方案,下面列举几种:
plist(属性列表)
preference(偏好设置)
NSKeyedArchiver(归档)
SQLite 3 (数据库)
CoreData
沙盒机制:
沙盒文件夹路径:
// 沙盒
NSString *path = [[NSBundle mainBundle] bundlePath];
NSLog(@"%@",path);```
沙盒的目录结构
- Documents
- Library
- Caches
- Preferences
- tmp
目录特性
虽然沙盒中有这么多文件夹,但是各个文件夹都有自己的特性,存放数据的时候要选择合适的文件夹
应用程序包:
这里存放的是应用程序的源文件,包括资源文件、可执行文件
Documents: 最常用的目录,iTunes同步该应用时会同步此文件夹中的内容,适合存储重要数据。
Library/Caches: iTunes不会同步此文件夹,适合存储体积大,不需要备份的非重要数据。
```objc
// 缓存路径
NSString *cachesPath = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject;
NSLog(@"缓存路径为%@",cachesPath);```
Library/Preferences: iTunes同步该应用时会同步此文件夹中的内容,通常保存应用的设置信息。
tmp: iTunes不会同步此文件夹,系统可能在应用没运行时就删除该目录下的文件,所以此目录适合保存应用中的一些临时文件,用完就删除。
```objc
NSString *tmpPath = NSTemporaryDirectory();
NSLog(@"%@", tmpPath);```
**plist文件**
plist文件是将某些特定的类,通过XML文件的方式保存在目录中。
可以被序列化的类型只有如下几种:
- NSArray
- NSMutableArray
- NSDictionary
- NSMutableDictionary
- NSData
- NSMutableData
- NSString
- NSMutableString
- NSNumber
- NSDate
存储步骤:
```objc
// 获得文件路径
NSString *documentPath1 = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
NSString *fileName = [documentPath1 stringByAppendingString:@"123.plist"];
// 存储
NSArray *array = @[@"123", @"345", @"456"];
[array writeToFile:fileName atomically:YES];
// 读取
NSArray *result = [NSArray arrayWithContentsOfFile:fileName];
NSLog(@"文件读取结果为%@", result);```
**注意**
只有以上列出的类型才能使用plist文件存储。
存储时使用writeToFile: atomically:方法。 其中atomically表示是否需要先写入一个辅助文件,再把辅助文件拷贝到目标文件地址。这是更安全的写入文件方法,一般都写YES。
读取时使用arrayWithContentsOfFile:方法。
**Preference**
使用方法:
```objc
// preference
// 获得NSUserDefults文件
NSUserDefaults *userDefult = [NSUserDefaults standardUserDefaults];
// 向文件中写入内容
[userDefult setObject:@"aaa" forKey:@"a"];
[userDefult setBool:YES forKey:@"sex"];
[userDefult setInteger:21 forKey:@"age"];
// 立即同步
[userDefult synchronize];
// 读取文件
NSString *name = [userDefult objectForKey:@"a"];
BOOL sex = [userDefult boolForKey:@"sex"];
NSInteger age = [userDefult integerForKey:@"age"];
NSLog(@"name = %@ sex = %d age = %ld", name, sex, age);```
**2.注意**
偏好设置是专门用来保存应用程序的配置信息的,一般不要在偏好设置中保存其他数据。
如果没有调用synchronize方法,系统会根据I/O情况不定时刻地保存到文件中。所以如果需要立即写入文件的就必须调用synchronize方法。
偏好设置会将所有数据保存到同一个文件中。即preference目录下的一个以此应用包名来命名的plist文件。
**NSKeyedArchiver**
归档在iOS中是另一种形式的序列化,只要遵循了NSCoding协议的对象都可以通过它实现序列化。由于决大多数支持存储数据的Foundation和Cocoa Touch类都遵循了NSCoding协议,因此,对于大多数类来说,归档相对而言还是比较容易实现的。
**1.遵循NSCoding协议**
NSCoding协议声明了两个方法,这两个方法都是必须实现的。一个用来说明如何将对象编码到归档中,另一个说明如何进行解档来获取一个新对象。
- 遵循协议和设置属性
```objc
#import <Foundation/Foundation.h>
@interface People : NSObject <NSCoding> // 遵循NSCoding协议
// 设置属性
@property (nonatomic, strong) NSString * name;
@property (nonatomic, assign) NSInteger age;
@property (nonatomic, assign) BOOL sex;
- (void)archiveObject; // 归档
@end```
- 实现归档解档协议
```objc
// 解档
- (id)initWithCoder:(NSCoder *)aDecoder
{
if ([super init]) {
self.name = [aDecoder decodeObjectForKey:@"name"];
self.age = [aDecoder decodeIntegerForKey:@"age"];
self.sex = [aDecoder decodeBoolForKey:@"sex"];
}
return self;
}
// 归档
- (void)encodeWithCoder:(NSCoder *)aCoder
{
[aCoder encodeObject:self.name forKey:@"name"];
[aCoder encodeBool:self.sex forKey:@"sex"];
[aCoder encodeInteger:self.age forKey:@"age"];
}```
- 特别注意
如果需要归档的类是某个自定义类的子类时,就需要在归档和解档之前先实现父类的归档和解档方法。即 [super encodeWithCoder:aCoder] 和 [super initWithCoder:aDecoder] 方法;
**2.使用**
需要把对象归档是调用NSKeyedArchiver的工厂方法 archiveRootObject: toFile: 方法。
```objc
// 把对象归档
- (void)archiveObject
{
// 获取文件路径
NSString *documentPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
NSString *fileName = [documentPath stringByAppendingString:@"person.data"];
// 创建对象
People *people = [[People alloc] init];
people.name = @"贾元发";
people.age = 24;
people.sex = YES;
// 归档
[NSKeyedArchiver archiveRootObject:people toFile:fileName];
// 解档
People *person2 = [NSKeyedUnarchiver unarchiveObjectWithFile:fileName];
if (person2) {
NSLog(@"name = %@ age = %ld sex = %d", person2.name, person2.age, person2.sex);
}
}```
**3.注意**
必须遵循并实现NSCoding协议
保存文件的扩展名可以任意指定
继承时必须先调用父类的归档解档方法
**SQLite3**
之前的所有存储方法,都是覆盖存储。如果想要增加一条数据就必须把整个文件读出来,然后修改数据后再把整个内容覆盖写入文件。所以它们都不适合存储大量的内容。
**1.字段类型**
表面上SQLite将数据分为以下几种类型:
integer : 整数
real : 实数(浮点数)
text : 文本字符串
blob : 二进制数据,比如文件,图片之类的
实际上SQLite是无类型的。即不管你在创表时指定的字段类型是什么,存储是依然可以存储任意类型的数据。而且在创表时也可以不指定字段类型。SQLite之所以什么类型就是为了良好的编程规范和方便开发人员交流,所以平时在使用时最好设置正确的字段类型!主键必须设置成integer
**2. 准备工作**
准备工作就是导入依赖库啦,在iOS中要使用SQLite3,需要添加库文件:libsqlite3.dylib并导入主头文件,这是一个C语言的库,所以直接使用SQLite3还是比较麻烦的。
**3.使用**
- 创建数据库并打开
操作数据库之前必须先指定数据库文件和要操作的表,所以使用SQLite3,首先要打开数据库文件,然后指定或创建一张表。
```objc
#pragma mark - 打开数据库并创建一张表
- (void)openDataBase
{
// 1:设置文件名
NSString *fileName = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject stringByAppendingString:@"person.db"];
// 2:打开数据库文件,如果没有会自动创建一个
NSInteger result = sqlite3_open(fileName.UTF8String, &_sqlite3);
if (result == SQLITE_OK) {
NSLog(@"打开数据库成功!");
// 3:创建数据库表
char *errmsg = NULL;
sqlite3_exec(_sqlite3, "CREATE TABLE IF NOT EXISTS t_person (id integer primary key autoincrement, name text , age integer)", NULL, NULL, &errmsg);
if (errmsg) {
NSLog(@"错误:%s", errmsg);
}else
{
NSLog(@"创建表成功!");
}
}else
{
NSLog(@"打开数据库失败!");
}
}```
- 执行插入指令
使用 sqlite3_exec() 方法可以执行任何SQL语句,比如创表、更新、插入和删除操作。但是一般不用它执行查询语句,因为它不会返回查询到的数据。
```objc
#pragma mark - 往表中插入1000条数据
- (void)insertDataInTable
{
NSString *nameStr;
NSInteger age;
for (NSInteger i = 0; i < 1000; i ++) {
nameStr = [NSString stringWithFormat:@"name_%d", arc4random_uniform(10000)];
age = arc4random_uniform(80) + 20;
NSString *sql = [NSString stringWithFormat:@"INSERT INTO t_person (name, age) VALUES('%@','%ld')", nameStr, age];
char *errmsg = NULL;
sqlite3_exec(_sqlite3, sql.UTF8String, NULL, NULL, &errmsg);
if (errmsg) {
NSLog(@"错误:%s", errmsg);
}
}
NSLog(@"插入完毕!");
}```
- 查询指令(读取数据)
前面说过一般不使用 sqlite3_exec() 方法查询数据。因为查询数据必须要获得查询结果,所以查询相对比较麻烦。示例代码如下:
sqlite3_prepare_v2() : 检查sql的合法性
sqlite3_step() : 逐行获取查询结果,不断重复,直到最后一条记录
sqlite3_coloum_xxx() : 获取对应类型的内容,iCol对应的就是SQL语句中字段的顺序,从0开始。根据实际查询字段的属性,使用sqlite3_column_xxx取得对应的内容即可。
sqlite3_finalize() : 释放stmt
```objc
#pragma mark - 从表中读取数据到数组中
- (void)readData
{
// 初始化数组
self.dataArray = [NSMutableArray arrayWithCapacity:1000];
char *sql = "select name, age from t_person;";
sqlite3_stmt *stmt;
NSInteger result = sqlite3_prepare_v2(_sqlite3, sql, -1, &stmt, NULL);
if (result == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
char *name = (char *)sqlite3_column_text(stmt, 0);
NSInteger age = sqlite3_column_int(stmt, 1);
// 创建对象
People *people = [[People alloc] init];
people.name = [NSString stringWithUTF8String:name];
people.age = age;
[_dataArray addObject:people];
}
}
NSLog(@"数组的数据为%@", self.dataArray);
sqlite3_finalize(stmt);
}```
**4.总结**
总得来说,SQLite3的使用还是比较麻烦的,因为都是些c语言的函数,理解起来有些困难。不过在一般开发过程中,使用的都是第三方开源库 FMDB,封装了这些基本的c语言方法,使得我们在使用时更加容易理解,提高开发效率。
**FMDB**
**1.简介**
FMDB是iOS平台的SQLite数据库框架,它是以OC的方式封装了SQLite的C语言API,它相对于cocoa自带的C语言框架有如下的优点:
使用起来更加面向对象,省去了很多麻烦、冗余的C语言代码
对比苹果自带的Core Data框架,更加轻量级和灵活
提供了多线程安全的数据库操作方法,有效地防止数据混乱
注:[FMDB的gitHub地址](https://github.com/ccgus/fmdb)
**2.核心类**
FMDB有三个主要的类:
FMDatabase
一个FMDatabase对象就代表一个单独的SQLite数据库,用来执行SQL语句
FMResultSet
使用FMDatabase执行查询后的结果集
FMDatabaseQueue
用于在多线程中执行多个查询或更新,它是线程安全的
**3.打开数据库并创建表**
和c语言框架一样,FMDB通过指定SQLite数据库文件路径来创建FMDatabase对象,但FMDB更加容易理解,使用起来更容易,使用之前一样需要导入sqlite3.dylib。打开数据库方法如下:
```objc
#pragma mark - FMDB
- (void)openDataBaseForFMDB
{
// 路径
NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject stringByAppendingString:@"person.db"];
databasePath = path;
datebase = [FMDatabase databaseWithPath:path];
if (![datebase open]) {
NSLog(@"数据库打开失败!");
}else
{
// 创建表语句
NSString *sqlCreateTable = [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS t_person (id integer primary key autoincrement, name text, age integer)"];
// 执行并判断
BOOL res = [datebase executeUpdate:sqlCreateTable];
if (!res) {
NSLog(@"创建表失败!");
}else
{
NSLog(@"创建表成功!");
}
}
[datebase close];
}```
值得注意的是,Path的值可以传入以下三种情况:
具体文件路径,如果不存在会自动创建
空字符串@"",会在临时目录创建一个空的数据库,当FMDatabase连接关闭时,数据库文件也被删除
nil,会创建一个内存中临时数据库,当FMDatabase连接关闭时,数据库会被销毁
**4.更新**
在FMDB中,除查询以外的所有操作,都称为“更新”, 如:create、drop、insert、update、delete等操作,使用executeUpdate:方法执行更新:
- 插入数据
```objc
#pragma mark - 插入数据
- (void)insertDataForFMDB
{
if ([datebase open]) {
NSString *insertSql = [NSString stringWithFormat:@"INSERT INTO t_person ('name', 'age') VALUES ('贾元发', '24')"];
BOOL res = [datebase executeUpdate:insertSql];
if (!res) {
NSLog(@"插入失败!");
}else
{
NSLog(@"插入成功!");
}
}
[datebase close];
}```
- 修改数据
```objc
#pragma mark - 修改数据
- (void)changeDataForFMDB
{
if ([datebase open]) {
NSString *updateSql = [NSString stringWithFormat:@"UPDATE t_person SET 'name' = '贾元发' WHERE 'name' = '张良'"];
BOOL res = [datebase executeUpdate:updateSql];
if (!res) {
NSLog(@"更新数据失败!");
}else
{
NSLog(@"更新数据成功!");
}
}
[datebase close];
}```
- 删除数据
```objc
#pragma mark - 删除数据
- (void)deleteDataForFMDB
{
if ([datebase open]) {
NSString *deleteSql = [NSString stringWithFormat:@"DELETE FROM t_person WHERE 'name' = '张良'"];
BOOL res = [datebase executeUpdate:deleteSql];
if (!res) {
NSLog(@"删除数据失败!");
}else
{
NSLog(@"删除数据成功!");
}
}
}```
- 查询数据
pragma mark - 查询数据
-
(void)selectDataFromFMDB
{
if ([datebase open]) {
NSString *selectDataSql = [NSString stringWithFormat:@"SELECT * FROM t_person"];
FMResultSet *rs = [datebase executeQuery:selectDataSql];
while ([rs next]) {
People *person = [[People alloc] init];
person.name = [rs stringForColumn:@"name"];
person.age = [rs intForColumn:@"age"];
NSLog(@"学生的姓名为%@ 年龄为%ld", person.name, person.age);
}
}
[datebase close];
}``` -
线程安全
在多个线程中同时使用一个FMDatabase实例是不明智的。不要让多个线程分享同一个FMDatabase实例,它无法在多个线程中同时使用。 如果在多个线程中同时使用一个FMDatabase实例,也就是两个线程同时处理一条数据,会造成数据混乱等问题。所以,请使用 FMDatabaseQueue,它是线程安全的。以下是使用方法: -
创建队列
-
使用队列
// 创建队列
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:databasePath];
// 使用队列
[queue inDatabase:^(FMDatabase *db) {
[datebase executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?)", @"贾元发", [NSNumber numberWithInt:1]];
[datebase executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?)", @"张良", [NSNumber numberWithInt:2]];
[datebase executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?)", @"焦亮", [NSNumber numberWithInt:3]];
FMResultSet *rs = [datebase executeQuery:@"SELECT * FROM t_person"];
while ([rs next]) {
NSString *name = [rs stringForColumn:@"name"];
NSInteger age = [rs intForColumn:@"age"];
NSLog(@"name = %@ age = %ld", name, age);
}
}];```
- 使用事务
/**
* 事务
*/
[queue inTransaction:^(FMDatabase *database, BOOL *rollback) {
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_1", [NSNumber numberWithInt:1]];
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_2", [NSNumber numberWithInt:2]];
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_3", [NSNumber numberWithInt:3]];
FMResultSet *result = [database executeQuery:@"select * from t_person"];
while([result next]) {
}
//回滚
*rollback = YES;
}];```