新浪微博 有道云笔记 麦库 EverNote Pocket Instapaper 更多

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 */

page1image2992.png
 page1image3416.png page1image3576.png

iOS应⽤用数据存储的常⽤用⽅方式
XML属性列表(plist)归档
Preference(偏好设置)
NSKeyedArchiver归档
●  SQLite3 
●  Core Data 
page2image2576.png

应⽤用沙盒
每个iOS应⽤用都有⾃自⼰己的应⽤用沙盒(应⽤用沙盒就是⽂文件系统⽬目录),与其他 ⽂文件系统隔离。应⽤用必须待在⾃自⼰己的沙盒⾥里,其他应⽤用不能访问该沙盒
应⽤用沙盒的⽂文件系统⽬目录,如下图所⽰示(假设应⽤用的名称叫Layer)
page3image2600.png
模拟器应⽤用沙盒的根路径在: (apple是⽤用户名, 6.0是模拟器版本) /Users/apple/Library/Application Support/iPhone Simulator/ 6.0/Applications
应⽤用沙盒结构分析
●  应⽤用程序包:(上图中的Layer)包含了所有的资源⽂文件和可执⾏行⽂文件 
●  Documents:保存应⽤用运⾏行时⽣生成的需要持久化的数据,iTunes同步设备时会备 份该⽬目录。例如,游戏应⽤用可将游戏存档保存在该⽬目录  
●  tmp:保存应⽤用运⾏行时所需的临时数据,使⽤用完毕后再将相应的⽂文件从该⽬目录删 除。应⽤用没有运⾏行时,系统也可能会清除该⽬目录下的⽂文件。iTunes同步设备时不会 备份该⽬目录  
●  Library/Caches:保存应⽤用运⾏行时⽣生成的需要持久化的数据,iTunes同步设备 时不会备份该⽬目录。⼀一般存储体积⼤大、不需要备份的⾮非重要数据  
●  Library/Preference:保存应⽤用的所有偏好设置,iOSSettings(设置)应⽤用 会在该⽬目录中查找应⽤用的设置信息。iTunes同步设备时会备份该⽬目录 
page4image3792.png
 应⽤用沙盒⽬目录的常见获取⽅方式
沙盒根⽬目录: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];
page5image5048.png

应⽤用沙盒⽬目录的常见获取⽅方式
tmp:NSString *tmp = NSTemporaryDirectory();  
Library/Caches:(Documents类似的2种⽅方法) 利⽤用沙盒根⽬目录拼接”Caches”字符串
利⽤用NSSearchPathForDirectoriesInDomains函数(将函数的第2个参数改 为:NSCachesDirectory即可)
 
Library/Preference:通过NSUserDefaults类存取该⽬目录下的设置信息
属性列表
属性列表是⼀一种XML格式的⽂文件,拓展名为plist
如果对象是NSStringNSDictionaryNSArrayNSData NSNumber等类型,就可以使⽤用writeToFile:atomically:⽅方法 直接将对象写到属性列表⽂文件中
page7image1968.png
● ●
属性列表-归档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];
page8image3216.png

属性列表-归档NSDictionary
 成功写⼊入到Documents⽬目录下
  ⽤用⽂文本编辑器打开,⽂文件内容为:
page9image1624.png
 page9image1784.png

page9image2400.png
page10image720.png

属性列表-归档NSDictionary ⽤用xcode打开属性⽂文件
page10image1824.png
属性列表-恢复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"]);
打印信息如下
page11image3072.png

page11image4128.png
属性列表-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"];
page13image3184.png

● ●
page13image4192.png page13image4360.png
偏好设置
读取上次保存的设置
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; NSString *username = [defaults stringForKey:@"username"];
float textSize = [defaults
 floatForKey:@"text_size"];
BOOL autoLogin = [defaults
 boolForKey:@"auto_login"];
[defaults synchornize];
page14image3568.png

注意:UserDefaults设置数据时,不是⽴立即写⼊入,⽽而是根据时间戳定时地把缓存 中的数据写⼊入本地磁盘。所以调⽤用了set⽅方法之后数据有可能还没有写⼊入磁盘应⽤用 程序就终⽌止了。出现以上问题,可以通过调⽤用synchornize⽅方法强制写⼊入
page15image736.png



 NSKeyedArchiver
如果对象是NSStringNSDictionaryNSArrayNSData 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
page17image2592.png
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

page18image5584.png
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];
page19image3600.png


NSKeyedArchiver-归档对象的注意 如果⽗父类也遵守了NSCoding协议,请注意:
应该在encodeWithCoder:⽅方法中加上⼀一句 [super encodeWithCode:encode];
确保继承的实例变量也能被编码,即也能被归档
应该在
initWithCoder:⽅方法中加上⼀一句 self = [super initWithCoder:decoder];
确保继承的实例变量也能被解码,即也能被恢复
page20image2800.png



page21image872.png


NSData
使⽤用archiveRootObject:toFile:⽅方法可以将⼀一个对象直接写⼊入到⼀一个⽂文 件中,但有时候可能想将多个对象写⼊入到同⼀一个⽂文件中,那么就要使⽤用 NSData来进⾏行归档对象
NSData可以为⼀一些数据提供临时存储空间,以便随后写⼊入⽂文件,或者存放从 磁盘读取的⽂文件内容。可以使⽤用[NSMutableData data]创建可变数据空间
 


NSData-归档2Person对象到同⼀一⽂文件中 归档(编码)
// 新建⼀一块可变数据区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];
page22image4552.png

NSData-从同⼀一⽂文件中恢复2Person对象 恢复(解码)
// 从⽂文件中读取数据NSData *data = [NSData dataWithContentsOfFile:path];
// 根据数据,解析成⼀一个NSKeyedUnarchiver对象NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc]
initForReadingWithData:data];
Person *person1 = [unarchiver
 decodeObjectForKey:@"person1"]; Person *person2 = [unarchiver decodeObjectForKey:@"person2"];
// 恢复完毕[unarchiver finishDecoding];
page23image3856.png

利⽤用归档实现深复制
⽐比如对⼀一个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
page24image4304.png
 







page25image744.png
● ●
SQLite3
SQLite3是⼀一款开源的嵌⼊入式关系型数据库,可移植性好、易使⽤用、内存开销⼩小
SQLite3是⽆无类型的,意味着你可以保存任何类型的数据到任意表的任意字段中。⽐比如下列 的创表语句是合法的:
  create table t_person(name, age);
为了保证可读性,建议还是把字段类型加上:
create table t_person(name text, age integer); SQLite3常⽤用的5种数据类型:textintegerfloatbooleanblob iOS中使⽤用SQLite3,⾸首先要添加库⽂文件libsqlite3.dylib和导⼊入主头⽂文件
● ●
page25image4472.png page25image4640.png page25image4808.png
创建、打开、关闭数据库
创建或打开数据库
// 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);
page26image4008.png


执⾏行不返回数据的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开始
   
    




page30image5408.pngpage31image792.png
Core DataCore Data框架提供了对象-关系映射(ORM)的功能,即能够将OC对象转化成数据,保存在 SQLite3数据库⽂文件中,也能够将保存在数据库中的数据还原成OC对象。在此数据操作期间,不需要编写任何SQL语句。使⽤用此功能,要添加CoreData.framework和导⼊入主头⽂文件 <CoreData/CoreData.h>


 
 

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


模型⽂文件 创建⽂文件page33image1488.png page33image1648.png page33image1816.png
添加实体page33image2784.png模型⽂文件 添加Person实体的基本属性page34image1488.png
page34image1648.png page34image1816.png

添加Card实体的基本属性page34image2784.pngpage35image744.png
模型⽂文件Person中添加card属性page35image1960.png page35image2128.png
Card中添加person属性page35image3096.pngpage36image720.png

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



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"]];page38image4368.png
搭建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];
page39image5232.png
添加数据传⼊入上下⽂文,创建⼀一个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>
设置PersonCard之间的关联关系[person setValue:card forKey:@"card”];page40image4704.png
添加数据  利⽤用上下⽂文对象,将数据同
br>
NSError *erro
br>
BOOL success = [
context save:&error]; if ( success) {[NSException raise:@"访问数据库错误" format:@"%@", [error localizedDescription]];}// 如果是想做更新操作:只要在更改了实体对象的属性后调⽤用[context save:&error],就能将更改的数据同步到数据库page41image3544.png

查询数据初始化⼀一个查询请求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;page42image5144.png

查询数据执⾏行请求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”]}

page43image4672.png

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

page44image3544.pngpage45image560.png

打开Core DataSQL⽇日志输出开关page45image1480.png page45image1648.pngpage46image712.png

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

page47image720.png

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


创建NSManagedObject的⼦子类  选择模型⽂文件page48image1376.png


page48image1536.png
 选择需要创建⼦子类的实体
page48image2192.png page48image2360.png

page49image752.png


创建NSManagedObject的⼦子类

Person.h – Person.m
page49image1936.png page49image2104.png

Card.h
br>
page49image3152.png page49image3320.png




创建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>

 


posted @ 2013-12-27 00:32  iTeaTime(技术清谈)  阅读(807)  评论(0编辑  收藏  举报