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>

 

●

https://www.evernote.com/shard/s227/sh/5f8fb480-e393-45dc-b94a-e0556309bd20/430896c8bb5f3daeb05a8bcc0feb70f1