iOS数据存取---iOS-Apple苹果官方文档翻译

本系列所有文章,链接地址:iOS7开发-Apple苹果iPhone开发Xcode官方文档翻译PDF下载地址(2013年12月29日更新版)

本文对应pdf文档下载链接,猛戳—>:数据存取文档.key.zip
3.1 MB
数据存取文档.pdf
1.1 MB

数据存取
/*技术博客http://www.cnblogs.com/ChenYilong/ 新浪微博http://weibo.com/luohanchenyilong */

iOS应⽤用数据存储的常⽤用⽅方式
XML属性列表(plist)归档
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 = [home stringByAppendingPathComponent:@"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 = [NSUserDefaults standardUserDefaults];
[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 = [defaults floatForKey:@"text_size"];
BOOL autoLogin = [defaults boolForKey:@"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:array toFile:path];
• 归档成功•

恢复(解码)NSArray对象
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"]; [encoder encodeFloat: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中 [archiver encodeObject:person1 forKey:@"person1"]; [archiver encodeObject:person2 forKey:@"person2"];
// 存档完毕(⼀一定要调⽤用这个⽅方法) [archiver finishEncoding];
// 将存档的数据写⼊入⽂文件[data writeToFile:path atomically:YES];

●
NSData-从同⼀一⽂文件中恢复2个Person对象恢复(解码)
// 从⽂文件中读取数据NSData *data = [NSData dataWithContentsOfFile:path];
// 根据数据,解析成⼀一个NSKeyedUnarchiver对象NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc]
initForReadingWithData:data];
Person *person1 = [unarchiver decodeObjectForKey:@"person1"]; Person *person2 = [unarchiver decodeObjectForKey:@"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 DataCore Data框架提供了对象-关系映射(ORM)的功能,即能够将OC对象转化成数据,保存在 SQLite3数据库⽂文件中,也能够将保存在数据库中的数据还原成OC对象。在此数据操作期间,不需要编写任何SQL语句。使⽤用此功能,要添加CoreData.framework和导⼊入主头⽂文件 <CoreData/CoreData.h>

模型⽂文件● 在Core Data,需要进⾏行映射的对象称为实体(entity),⽽而且需要使⽤用Core Data的模型⽂文件来描述应⽤用的所有实体和实体属性● 这⾥里以Person和Card(⾝身份证)2个实体为例⼦子,先看看实体属性和之间的关联关系•

模型⽂文件● 创建⽂文件

●添加实体

模型⽂文件● 添加Person实体的基本属性

●添加Card实体的基本属性

●模型⽂文件在Person中添加card属性

●在Card中添加person属性

● ●◆ ◆ NSManagbr>
通过Core Data从数据库取出的对象,默认情况下都是NSManagedObject对象 NSManagedObject的⼯工作模式有点类似于NSDictionary对象,通过键-值对来存取所有的实体属性setValue:forKey: 存储属性值(属性名为key) valueForKey: 获取属性值(属性名为key)

Core Data主要对象

搭建Core Data上下⽂文环境从应⽤用程序包中加载模型⽂文件NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];传⼊入模型,初始化NSPersistentStoreCoordinatorNSPersistentStoreCoordinator *psc = [[[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model] autorelease];构建SQLite⽂文件路径NSString
br>
[NSSearchPathForDirectoriesInDomains(NSDocumentDi
br>
NSUserDomainMask, YES) last
br>
NSURL *url = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"person.data"]];

●●●搭建Core Data上下⽂文环境

● 添加持久化存储库,这⾥里使⽤用SQLite作为存储库

NSError *errobr>
NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType configuration: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];

添加数据传⼊入上下⽂文,创建⼀一个Person实体对象NSManagedObject *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person" inManagedObjectContext:context];设置简单属性[person setValue:@"MJ" forKey:@
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],就能将更改的数据同步到数据库

●查询数据初始化⼀一个查询请求NSFetchRequest *request = [[[NSFetchRequest alloc] init] autorelease];设置要查询的实体NSEntityDescription *desc = [NSEntityDescription entityForName:@"Person" inManagedObjectContext:context];设置排序(按照age降序)NSSortDescriptor *sort = [NSSortDescriptorsortDescriptorWithKey:@"age" ascending:NO]; request.sortDescriptors = [NSArray arrayWithObject:sort];设置条件过滤(name like '%Itcast-1%') NSPredicate *predicate = [NSPredicatepredicateWithFormat:@"name like %@", @"*Itcast-1*"]; request.predicate = predicate;

查询数据执⾏行请求NSError *erro
br>
NSArray *objs = [context executeFetchRequest:request error:&error];if (error) {[NSException raise:@"查询错误" format:@"%@", [error localizedDescription]];}遍历数据for (NSManagedObject *obj in objs) { NSLog(@"name=%@", [obj valueForKey:@"name”]}

删除数据传⼊入需要删除的实体对象[context deleteObject:managedObject];将结果同步到数据库NSError *error = nil; [context save:&error]; if (error) {[NSException raise:@"删除错误" format:@"%@", [error localizedDescription]];}

打开Core Data的SQL⽇日志输出开关

●

●Core Data的延迟加载Core Data不会根据实体中的关联关系⽴立即获取相应的关联对象⽐比如通过Core Data取出Person实体时,并不会⽴立即查询相关联的 Card实体;当应⽤用真的需要使⽤用Card时,才会查询数据库,加载Card 实体的信息

●●创建NSManagedObject的⼦子类默认情况下,利⽤用Core Data取出的实体都是NSManagedObject类型的,能够利⽤用键-值对来存取数据但是⼀一般情况下,实体在存取数据的基础上,有时还需要添加⼀一些业务⽅方法来完成⼀一些其他任务,那么就必须创建NSManagedObject的⼦子类

创建NSManagedObject的⼦子类 • 选择模型⽂文件

• 选择需要创建⼦子类的实体

•

创建NSManagedObject的⼦子类

Person.h – Person.m

•Card.h
br>

创建NSManagedObject的⼦子类

那么⽣生成⼀一个Person实体对象就应该这样写

Person *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person" inManagedObjectContext:context];

person.name

br>

person.age = [NSNumber numberWithInt:27]; Card *card = [NSEntityDescription insertNewObjectForEntityForName:@”Card" inManagedObjectContext:context]; card.no = @”4414245

br>

person.card

br>