iOS数据存取---iOS-Apple苹果官方文档翻译
/*技术博客http://www.cnblogs.com/ChenYilong/ 新浪微博http://weibo.com/luohanchenyilong*/
iOS应⽤用数据存储的常⽤用⽅方
Preference(偏好设置)
NSKeyedArchiver归档
● SQLite3
● Core Data
应⽤用沙盒
每个iOS应⽤用都有⾃自⼰己的应⽤用沙盒(应⽤用沙盒就是⽂文件系统⽬目录),与其他 ⽂文件系统隔离。应⽤用必须待在⾃自⼰己的沙盒⾥里,其他应⽤用不能访问该沙盒
应⽤用沙盒的⽂文件系统⽬目录,如下图所⽰示(假设应⽤用的名称叫Layer)
模拟器应⽤用沙盒的根路径在: (apple是⽤用户名, 6.0是模拟器版本) /Users/apple/Library/Application Support/iPhone Simulator/6.0/Applications
应⽤用沙盒结构分析
● 应⽤用程序包:(上图中的Layer)包含了所有的资源⽂文件和可执⾏行⽂文件
● Documents:保存应⽤用运⾏行时⽣生成的需要持久化的数据,iTunes同步设备时会备 份该⽬目录。例如,游戏应⽤用可将游戏存档保存在该⽬目录
● tmp:保存应⽤用运⾏行时所需的临时数据,使⽤用完毕后再将相应的⽂文件从该⽬目录删 除。应⽤用没有运⾏行时,系统也可能会清除该⽬目录下的⽂文件。iTunes同步设备时不会 备份该⽬目录
● Library/Caches:保存应⽤用运⾏行时⽣生成的需要持久化的数据,iTunes同步设备 时不会备份该⽬目录。⼀一般存储体积⼤大、不需要备份的⾮非重要数据
● Library/Preference:保存应⽤用的所有偏好设置,iOS的Settings(设置)应⽤用 会在该⽬目录中查找应⽤用的设置信息。iTunes同步设备时会备份该⽬目录
应⽤用沙盒⽬目录的常见获取⽅方式
沙盒根⽬目录:NSString *home =NSHomeDirectory();
Documents:(2种⽅方式)
利⽤用沙盒根⽬目录拼接”Documents”字符串NSString *home = NSHomeDirectory();
NSString *documents = [homestringByAppendingPathComponent:@"Documents"];
// 不建议采⽤用,因为新版本的操作系统可能会修改⽬目录名
利⽤用NSSearchPathForDirectoriesInDomains函数 // NSUserDomainMask 代表从⽤用户⽂文件夹下找
// YES 代表展开路径中的波浪字符“~”
NSArray *array = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
NSUserDomainMask, NO);
// 在iOS中,只有⼀一个⽬目录跟传⼊入的参数匹配,所以这个集合⾥里⾯面只有⼀一个元素 NSString *documents = [array objectAtIndex:0];
应⽤用沙盒⽬目录的常见获取⽅方式
tmp:NSString *tmp = NSTemporaryDirectory();
Library/Caches:(跟Documents类似的2种⽅方法) 利⽤用沙盒根⽬目录拼接”Caches”字符串
利⽤用NSSearchPathForDirectoriesInDomains函数(将函数的第2个参数改 为:NSCachesDirectory即可)
Library/Preference:通过NSUserDefaults类存取该⽬目录下的设置信息
属性列表
属性列表是⼀一种XML格式的⽂文件,拓展名为plist
如果对象是NSString、NSDictionary、NSArray、NSData、NSNumber等类型,就可以使⽤用writeToFile:atomically:⽅方法 直接将对象写到属性列表⽂文件中
● ●
属性列表-归档NSDictionary 将⼀一个NSDictionary对象归档到⼀一个plist属性列表中
// 将数据封装成字典NSMutableDictionary *dict = [NSMutableDictionary dictionary];
[dict setObject:@"母鸡" forKey:@"name"];
[dict setObject:@"15013141314" forKey:@"phone"]; [dict setObject:@"27" forKey:@"age"];
// 将字典持久化到Documents/stu.plist⽂文件中[dict writeToFile:path atomically:YES];
●
属性列表-归档NSDictionary
● 成功写⼊入到Documents⽬目录下
⽤用⽂文本编辑器打开,⽂文件内容为:
●
●
属性列表-归档NSDictionary ⽤用xcode打开属性⽂文件
属性列表-恢复NSDictionary
读取属性列表,恢复NSDictionary对象
// 读取Documents/stu.plist的内容,实例化NSDictionary NSDictionary *dict = [NSDictionary
dictionaryWithContentsOfFile:path];
NSLog(@"name:%@", [dict objectForKey:@"name"]);
NSLog(@"phone:%@", [dict objectForKey:@"phone"]);
NSLog(@"age:%@", [dict objectForKey:@"age"]);
打印信息如下
●
属性列表-NSDictionary的存储和读取过程
很多iOS应⽤用都⽀支持偏好设置,⽐比如保存⽤用户名、密码、字体⼤大⼩小等设置, iOS提供了⼀一套标准的解决⽅方案来为应⽤用加⼊入偏好设置功能
每个应⽤用都有个NSUserDefaults实例,通过它来存取偏好设置
⽐比如,保存⽤用户名、字体⼤大⼩小、是否⾃自动登录NSUserDefaults *defaults = [NSUserDefaultsstandardUserDefaults];
[defaults setObject:@"itcast" forKey:@"username"]; [defaults setFloat:18.0f forKey:@"text_size"]; [defaults setBool:YES forKey:@"auto_login"];
●
● ●
偏好设置
读取上次保存的设置
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; NSString *username = [defaults stringForKey:@"username"];
float textSize = [defaultsfloatForKey:@"text_size"];
BOOL autoLogin = [defaultsboolForKey:@"auto_login"];
[defaults synchornize];
注意:UserDefaults设置数据时,不是⽴立即写⼊入,⽽而是根据时间戳定时地把缓存 中的数据写⼊入本地磁盘。所以调⽤用了set⽅方法之后数据有可能还没有写⼊入磁盘应⽤用 程序就终⽌止了。出现以上问题,可以通过调⽤用synchornize⽅方法强制写⼊入
●
●
●
NSKeyedArchiver
如果对象是NSString、NSDictionary、NSArray、NSData、NSNumber等类型,可以直接⽤用NSKeyedArchiver进⾏行归档和恢复
不是所有的对象都可以直接⽤用这种⽅方法进⾏行归档,只有遵守了NSCoding协 议的对象才可以
NSCoding协议有2个⽅方法: 实例变量,可以使⽤用encodeObject:forKey:⽅方法归档实例变量
◆ initWithCoder:
每次从⽂文件中恢复(解码)对象时,都会调⽤用这个⽅方法。⼀一般在这个⽅方法⾥里⾯面指定如何解 码⽂文件中的数据为对象的实例变量,可以使⽤用decodeObject:forKey⽅方法解码实 例变量
◆ encodeWithCoder:
每次归档对象时,都会调⽤用这个⽅方法。⼀一般在这个⽅方法⾥里⾯面指定如何归档对象中的每个
NSKeyedArchiver-归档NSArray
• 归档⼀一个NSArray对象到Documents/array.archive
NSArray *array = [NSArray arrayWithObjects:@”a”,@”b”,nil]; [NSKeyedArchiver archiveRootObject:arraytoFile:path];
• 归档成功•
NSArray *array = [NSKeyedUnarchiver unarchiveObjectWithFile:path];
NSKeyedArchiver-归档Person对象(Person.h)
@interface Person : NSObject<NSCoding> @property (nonatomic, copy) NSString *name; @property (nonatomic, assign) int age; @property (nonatomic, assign) float height; @end
NSKeyedArchiver-归档Person对象(Person.m)
@implementation Person
- (void)encodeWithCoder:(NSCoder *)encoder {
[encoder encodeObject:self.name forKey:@"name"]; [encoder encodeInt:self.age forKey:@"age"]; [encoderencodeFloat:self.height forKey:@"height"];
}
- (id)initWithCoder:(NSCoder *)decoder {
self.name = [decoder decodeObjectForKey:@"name"]; self.age = [decoder decodeIntForKey:@"age"]; self.height = [decoder decodeFloatForKey:@"height"]; return self;
}
- (void)dealloc {
[super dealloc];
[_name release];
}
@end
NSKeyedArchiver-归档Person对象(编码和解码)
归档(编码)
Person *person = [[[Person alloc] init] autorelease];
person.name = @"MJ";
person.age = 27;
person.height = 1.83f;
[NSKeyedArchiver archiveRootObject:person toFile:path];
恢复(解码)
Person *person = [NSKeyedUnarchiver
unarchiveObjectWithFile:path];
●
●
NSKeyedArchiver-归档对象的注意如果⽗父类也遵守了NSCoding协议,请注意:
应该在encodeWithCoder:⽅方法中加上⼀一句 [super encodeWithCode:encode];
确保继承的实例变量也能被编码,即也能被归档
应该在initWithCoder:⽅方法中加上⼀一句self = [super initWithCoder:decoder];
确保继承的实例变量也能被解码,即也能被恢复
●
◆
◆
●
●
NSData
使⽤用archiveRootObject:toFile:⽅方法可以将⼀一个对象直接写⼊入到⼀一个⽂文 件中,但有时候可能想将多个对象写⼊入到同⼀一个⽂文件中,那么就要使⽤用 NSData来进⾏行归档对象
NSData可以为⼀一些数据提供临时存储空间,以便随后写⼊入⽂文件,或者存放从 磁盘读取的⽂文件内容。可以使⽤用[NSMutableData data]创建可变数据空间
NSData-归档2个Person对象到同⼀一⽂文件中 归档(编码)
// 新建⼀一块可变数据区NSMutableData *data = [NSMutableData data];
// 将数据区连接到⼀一个NSKeyedArchiver对象NSKeyedArchiver *archiver = [[[NSKeyedArchiver alloc]
initForWritingWithMutableData:data] autorelease];
// 开始存档对象,存档的数据都会存储到NSMutableData中 [archiverencodeObject:person1 forKey:@"person1"]; [archiver encodeObject:person2 forKey:@"person2"];
// 存档完毕(⼀一定要调⽤用这个⽅方法) [archiverfinishEncoding];
// 将存档的数据写⼊入⽂文件[data writeToFile:path atomically:YES];
●
NSData-从同⼀一⽂文件中恢复2个Person对象 恢复(解码)
// 从⽂文件中读取数据NSData *data = [NSDatadataWithContentsOfFile:path];
// 根据数据,解析成⼀一个NSKeyedUnarchiver对象NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc]
initForReadingWithData:data];
Person *person1 = [unarchiverdecodeObjectForKey:@"person1"]; Person *person2 = [unarchiverdecodeObjectForKey:@"person2"];
// 恢复完毕[unarchiver finishDecoding];
●
利⽤用归档实现深复制
⽐比如对⼀一个Person对象进⾏行深复制
// 临时存储person1的数据
NSData *data = [NSKeyedArchiver archivedDataWithRootObject:person1];
// 解析data,⽣生成⼀一个新的Person对象
Student *person2 = [NSKeyedUnarchiver unarchiveObjectWithData:data];
// 分别打印内存地址
NSLog(@"person1:0x%x", person1); // person1:0x7177a60
NSLog(@"person2:0x%x", person2); // person2:0x7177cf0
archivedDataWithRootObject: unarchiveObjectWithData: person1
● ●
SQLite3
SQLite3是⼀一款开源的嵌⼊入式关系型数据库,可移植性好、易使⽤用、内存开销⼩小
SQLite3是⽆无类型的,意味着你可以保存任何类型的数据到任意表的任意字段中。⽐比如下列 的创表语句是合法的:
create table t_person(name, age);
为了保证可读性,建议还是把字段类型加上:
create table t_person(name text, age integer); SQLite3常⽤用的5种数据类型:text、integer、float、boolean、blob 在iOS中使⽤用SQLite3,⾸首先要添加库⽂文件libsqlite3.dylib和导⼊入主头⽂文件
● ●
创建、打开、关闭数据库
创建或打开数据库
// path为:~/Documents/person.db
sqlite3 *db;
int result = sqlite3_open([path UTF8String], &db);
代码解析: sqlite3_open()将根据⽂文件路径打开数据库,如果不存在,则会创建⼀一个新的
数据库。如果result等于常量SQLITE_OK,则表⽰示成功打开数据库
sqlite3 *db:⼀一个打开的数据库实例
数据库⽂文件的路径必须以C字符串(⽽而⾮非NSString)传⼊入
关闭数据库:sqlite3_close(db);
执⾏行不返回数据的SQL语句
char *errorMsg; // 用来存储错误信息
char *sql = "create table if not exists t_person(id integer primary key autoincrement, name text, age integer);";
int result = sqlite3_exec(db, sql, NULL, NULL, &errorMsg);
代码解析:
sqlite3_exec()可以执行任何SQL语句,比如创表、更新、插入和删除操作。但是一般不用它执行查询语句,因为它不会返回查询到的数据
sqlite3_exec()还可以执行的语句:
开启事务:begin transaction;
回滚事务:rollback;
提交事务:commit;
//带占位符插入数据
char *sql = "insert into t_person(name, age) values(?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
sqlite3_bind_text(stmt, 1, "母鸡", -1, NULL);
sqlite3_bind_int(stmt, 2, 27);
}
if (sqlite3_step(stmt) != SQLITE_DONE) {
NSLog(@"插入数据错误");
}
sqlite3_finalize(stmt);
代码解析:
sqlite3_prepare_v2()返回值等于SQLITE_OK,说明SQL语句已经准备成功,没有语法问题
//带占位符插入数据
sqlite3_bind_text():大部分绑定函数都只有3个参数
第1个参数是sqlite3_stmt *类型
第2个参数指占位符的位置,第一个占位符的位置是1,不是0
第3个参数指占位符要绑定的值
第4个参数指在第3个参数中所传递数据的长度,对于C字符串,可以传递-1代替字符串的长度
第5个参数是一个可选的函数回调,一般用于在语句执行后完成内存清理工作
sqlite_step():执行SQL语句,返回SQLITE_DONE代表成功执行完毕
sqlite_finalize():销毁sqlite3_stmt *对象
//查询数据
char *sql = "select id,name,age from t_person;";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
int _id = sqlite3_column_int(stmt, 0);
char *_name = (char *)sqlite3_column_text(stmt,1);
NSString *name = [NSString stringWithUTF8String:_name];
int _age = sqlite3_column_int(stmt, 2);
NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);
}
}
sqlite3_finalize(stmt);
代码解析
sqlite3_step()返回SQLITE_ROW代表遍历到一条新记录
sqlite3_column_*()用于获取每个字段对应的值,第2个参数是字段的索引,从0开始
通过Core Data从数据库取出的对象,默认情况下都是NSManagedObject对象 NSManagedObject的⼯工作模式有点类似于NSDictionary对象,通过键-值对来存取所有的实体属性setValue:forKey: 存储属性值(属性名为key) valueForKey: 获取属性值(属性名为key)
br>
[NSSearchPathForDirectoriesInDomains(NSDocumentDi
br>
NSUserDomainMask, YES) last
br>
NSURL *url = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"person.data"]];
NSPersistentStore *store = [pscaddPersistentStoreWithType:NSSQLiteStoreTypeconfiguration:nil URL:url options:nil error:&error];if (store == nil) { // 直接抛异常[NSException raise:@"添加数据库错误" format:@"%@", [error localizedDescri
br
br>
● 初始化上下⽂文,设置persistentStoreCoordinator属性NSManagedObjectContext *context = [[NSManagedObjectContext alloc
br>
context.persistentStoreCoordinato
br>
// ⽤用完之后,还是要[context release];
br>
[person setValue:[NSNumber numberWithInt:27] forKey:
br>
传⼊入上下⽂文,创建⼀一个Card实体对象NSManagedObject *card = [NSEntityDescription insertNewObjectForEntityForName:@"Card"inManagedObjectContext:context];[card setValue:@"4414241933432" forKey
br>
设置Person和Card之间的关联关系[person setValue:card forKey:@"card”];
br>
NSError *erro
br>
BOOL success = [context save:&error]; if ( success) {[NSException raise:@"访问数据库错误" format:@"%@", [error localizedDescription]];}// 如果是想做更新操作:只要在更改了实体对象的属性后调⽤用[context save:&error],就能将更改的数据同步到数据库
br>
NSArray *objs = [context executeFetchRequest:request error:&error];if (error) {[NSException raise:@"查询错误" format:@"%@", [error localizedDescription]];}遍历数据for (NSManagedObject *obj in objs) { NSLog(@"name=%@", [objvalueForKey:@"name”]}
br>
br>
person.age = [NSNumber numberWithInt:27]; Card *card = [NSEntityDescription insertNewObjectForEntityForName:@”Card"inManagedObjectContext:context]; card.no = @”4414245
br>
person.card
br>