iOS文件管理之沙盒

1.沙盒的基本概念：

ios应用程序只能对自己创建的文件进行读取操作，这个独立的空间，我们称为沙盒，每个应用程序都有自己独立的空间，一般来说应用程序的存储空间是不能相互访问的；

模拟器应用沙盒的位置：/users/username/Library/Application Support/iPhone Simulator

用户根目录下的资源库文件默认是隐藏的，可以通过以下命令来显示和隐藏mac电脑的文件夹：

 

注意：其中的空格并且区分大小写
显示Mac隐藏文件的命令：defaults write com.apple.finder AppleShowAllFiles -bool true

隐藏Mac隐藏文件的命令：defaults write com.apple.finder AppleShowAllFiles -bool false

或者

显示Mac隐藏文件的命令：defaults write com.apple.finder AppleShowAllFiles YES

隐藏Mac隐藏文件的命令：defaults write com.apple.finder AppleShowAllFiles NO输完单击Enter键，退出终端，重新启动Finder就可以了重启Finder：鼠标单击窗口左上角的苹果标志-->强制退出-->Finder-->重新启动

 

当我们创建我们的应用程序时，在沙盒中会产生三个文件夹：Documents，Library，tmp；

Documents：一般我们需要持久保存的数据存放在里面，里面可以添加子文件夹，需要注意的是在：在iTunes上备份和恢复数据时会对Documents进行备份和恢复；
Library：用于设置应用程序的默认设置，和其他状态，数据永久保存，与Documents不同的是，在iTunes上备份和恢复数据时不包括此文件夹下的数据；
tmp：保存一些临时文件的目录，当设备重启时会清空此文件夹下的数据；

 

2.获取沙盒的目录

获取程序的根目录（home目录）：NSString *homePath = NSHomeDirectory();
获取Documents目录：NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory , NSUserDomainMask,YES);
                    NSString *docPath = [paths objectAtIndex:0];或[paths lastObject];
获取Library目录：NSArray *paths = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory , NSUserDomainMask,YES);
                    NSString *docPath = [paths objectAtIndex:0];或[paths lastObject];
获取Library中Cache目录：NSArray *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory , NSUserDomainMask,YES);
                    NSString *docPath = [paths objectAtIndex:0];或[paths lastObject];
获取tmp目录：NSString ＊tempath ＝ NSTemporaryDirectory();

 

3.NSString处理路径的方法：

例：NSString *path = @"/Users/apple/text.text";

常用方法：

a.获得组成此路径的各个组成成分，结果－－（"/","Users","apple","text.text"）;
- (NSArray *)pathComponents;
b.提取路径最后的文件名，结果－－text.text
-(NSString *)lastPathComponent;
c.删除路径最后的文件名，结果－－/Users/apple
-(NSString *)stringByDeletingLastPathComponent;
d.将str添加到现有路径的末尾，结果－－/Users/apple/text.text/addStr
-(NSString *)stringByAppendingPathComponent:(NSString *)addStr;
e.获取路径最后文件的扩展名，结果－－text
-(NSString *)pathExtension;
f.删除路径最后的扩展名，结果－－/Users/apple/text
-(NSString *)stringByDeletingPathExtension;
g.在路径最后添加扩展名，结果－－/Users/apple/text.text.app
-(NSString *)stringByAddendingPahtExtension:(NSString *)str;

 

4.NSFileManager对文件的基本操作

a.创建一个文件并写入数据
-(BOOL)createFileAtPath:(NSString *)path contents:(NSData *)data attributes:(NSDictionary *)attr;

b.从一个文件中读取数据
-(NSData *)contentsAtPath:(NSString *)path;

c.文件移动，从srcPath路径上移动到dstPath路径上，这里是文件路径，而不是目录路径，没有文件，先创建文件；
- (BOOL)moveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error ;

d.比较两个文件的内容是否一样
- (BOOL)contentsEqualAtPath:(NSString *)path1 andPath:(NSString *)path2;

e.判断文件是否存在
- (BOOL)fileExistsAtPath:(NSString *)path;

f.删除文件
- (BOOL)removeItemAtPath:(NSString *)path error:(NSError **)error;

g.获取文件大小
 NSFileManager ＊fileManager = [NSFileManager defaultManager];
NSDIctionary *attrDic = [fileManager attributesOfItemAtPath:filePath error:nil];
NSNumber *fileSize = [attrDic objectForKey:NSFileSize];

5.NSFileHandle对文件的基本操作

 

NSFileManager主要对文件进行操作（文件的创建，删除，修改，移动，复制）

NSFileHandle主要对文件内容进行读取

NSFileHandle操作文件的步骤：a.创建一个NSFileHandle对象  b.对打开的文件进行I/O操作 c.关闭文件

NSFileHandle只能读写文件，不能创建文件

常用的文件处理：

+ (id)fileHandleForReadingAtPath:(NSString *)path;//打开一个文件读取
+ (id)fileHandleForWritingAtPath:(NSString *)path;//打开一个文件写入
+ (id)fileHandleForUpdatingAtPath:(NSString *)path;//打开一个文件更新

- (NSData *)availableData; //返回所有可用数据
- (NSData *)readDataToEndOfFile;//从当前节点读取到文件末尾
- (NSData *)readDataOfLength:(NSUInteger)length;//从当前节点读取指定长度的数据
- (void)writeData:(NSData *)data;// 写入数据
- (unsigned long long)offsetInFile;// 获取文件当前的偏移量，也就是文件当前读取到什么位置
- (unsigned long long)seekToEndOfFile;// 跳转到文件末尾
- (void)seekToFileOffset:(unsigned long long)offset;// 将文件长度设置为offset字节

- (void)closeFile;//关闭文件
iPhone文件系统NSFileManager讲解是本文要介绍的内容，主要是通过iphone文件系统来学习NSFileManager的使用方法，具体内容来看本文详解。
iPhone文件系统：创建、重命名以及删除文件，NSFileManager中包含了用来查询单词库目录、创建、重命名、删除目录以及获取/设置文件属性的方法（可读性，可编写性等等）。
每个程序都会有它自己的沙盒，通过它你可以阅读/编写文件。写入沙盒的文件在程序的进程中将会保持稳定，即便实在程序更新的情况下。
如下所示，你可以在沙盒中定位文件目录：

//对于错误信息  
NSError *error;  
// 创建文件管理器  
NSFileManager *fileMgr = [NSFileManagerdefaultManager];  
//指向文件目录  
NSString *documentsDirectory= [NSHomeDirectory()   
stringByAppendingPathComponent:@"Documents"];  
 
//创建一个目录  
[[NSFileManager defaultManager]   createDirectoryAtPath: [NSString stringWithFormat:@"%@/myFolder", NSHomeDirectory()] attributes:nil]; 

创建一个文件
现在我们已经有了文件目录，我们就能使用这个路径在沙盒中创建一个新文件并编写一段代码：

// File we want to create in the documents directory我们想要创建的文件将会出现在文件目录中  
// Result is: /Documents/file1.txt结果为：/Documents/file1.txt  
NSString *filePath= [documentsDirectory  
stringByAppendingPathComponent:@"file1.txt"];  
//需要写入的字符串  
NSString *str= @"iPhoneDeveloper Tips\nhttp://iPhoneDevelopTips,com";  
//写入文件  
[str writeToFile:filePath atomically:YES   
encoding:NSUTF8StringEncoding error:&error];  
//显示文件目录的内容  
NSLog(@"Documentsdirectory: %@",  
[fileMgr contentsOfDirectoryAtPath:documentsDirectoryerror:&error]); 

我们为想要创建的文件构建一条路径（file1.txt），初始化一个字符串来写入文件，并列出目录。最后一行显示了在我们创建文件之后出现在文件目录下的一个目录列表：
对一个文件重命名
想要重命名一个文件，我们需要把文件移到一个新的路径下。下面的代码创建了我们所期望的目标文件的路径，然后请求移动文件以及在移动之后显示文件目录。

//通过移动该文件对文件重命名  
NSString *filePath2= [documentsDirectory  
stringByAppendingPathComponent:@"file2.txt"];  
//判断是否移动  
if ([fileMgr moveItemAtPath:filePath toPath:filePath2 error:&error] != YES)  
NSLog(@"Unable to move file: %@", [error localizedDescription]);  
//显示文件目录的内容  
NSLog(@"Documentsdirectory: %@",   
[fileMgr contentsOfDirectoryAtPath:documentsDirectoryerror:&error]); 

在移动了文件之后，输出结果应该如下图所示：
删除一个文件
为了使这个技巧完整，让我们再一起看下如何删除一个文件：

//在filePath2中判断是否删除这个文件  
if ([fileMgr removeItemAtPath:filePath2 error:&error] != YES)  
NSLog(@"Unable to delete file: %@", [error localizedDescription]);  
//显示文件目录的内容  
NSLog(@"Documentsdirectory: %@",  
[fileMgr contentsOfDirectoryAtPath:documentsDirectoryerror:&error]); 

一旦文件被删除了，正如你所预料的那样，文件目录就会被自动清空：
这些示例能教你的，仅仅只是文件处理上的一些皮毛。想要获得更全面、详细的讲解，你就需要掌握NSFileManager文件的知识。
在开发iPhone程序时，有时候要对文件进行一些操作。而获取某一个目录中的所有文件列表，是基本操作之一。通过下面这段代码，就可以获取一个目录内的文件及文件夹列表。

NSFileManager *fileManager = [NSFileManager defaultManager];  
//在这里获取应用程序Documents文件夹里的文件及文件夹列表  
        NSArray *documentPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);  
        NSString *documentDir = [documentPaths objectAtIndex:0];  
        NSError *error = nil;  
        NSArray *fileList = [[NSArray alloc] init];  
//fileList便是包含有该文件夹下所有文件的文件名及文件夹名的数组  
        fileList = [fileManager contentsOfDirectoryAtPath:documentDir error:&error]; 

以下这段代码则可以列出给定一个文件夹里的所有子文件夹名

NSMutableArray *dirArray = [[NSMutableArray alloc] init];  
        BOOL isDir = NO;  
//在上面那段程序中获得的fileList中列出文件夹名  
        for (NSString *file in fileList) {  
                NSString *path = [documentDir stringByAppendingPathComponent:file];  
                [fileManager fileExistsAtPath:path isDirectory:(&isDir)];  
                if (isDir) {  
                        [dirArray addObject:file];  
                }  
                isDir = NO;  
        }  
        NSLog(@"Every Thing in the dir:%@",fileList);  
        NSLog(@"All folders:%@",dirArray);
//对于错误信息
NSError *error;
// 创建文件管理器
NSFileManager *fileMgr = [NSFileManagerdefaultManager];
//指向文件目录
NSString *documentsDirectory= [NSHomeDirectory()
stringByAppendingPathComponent:@"Documents"];

//创建一个目录
[[NSFileManager defaultManager]   createDirectoryAtPath: [NSString stringWithFormat:@"%@/myFolder", NSHomeDirectory()] attributes:nil];
// File we want to create in the documents directory我们想要创建的文件将会出现在文件目录中
// Result is: /Documents/file1.txt结果为：/Documents/file1.txt
NSString *filePath= [documentsDirectory
stringByAppendingPathComponent:@"file1.txt"];
//需要写入的字符串
NSString *str= @"iPhoneDeveloper Tips\nhttp://iPhoneDevelopTips,com";
//写入文件
[str writeToFile:filePath atomically:YES
encoding:NSUTF8StringEncoding error:&error];
//显示文件目录的内容
NSLog(@"Documentsdirectory: %@",
[fileMgr contentsOfDirectoryAtPath:documentsDirectoryerror:&error]);
//通过移动该文件对文件重命名
NSString *filePath2= [documentsDirectory
stringByAppendingPathComponent:@"file2.txt"];
//判断是否移动
if ([fileMgr moveItemAtPath:filePath toPath:filePath2 error:&error] != YES)
NSLog(@"Unable to move file: %@", [error localizedDescription]);
//显示文件目录的内容
NSLog(@"Documentsdirectory: %@",
[fileMgr contentsOfDirectoryAtPath:documentsDirectoryerror:&error]);
//在filePath2中判断是否删除这个文件
if ([fileMgr removeItemAtPath:filePath2 error:&error] != YES)
NSLog(@"Unable to delete file: %@", [error localizedDescription]);
//显示文件目录的内容
NSLog(@"Documentsdirectory: %@",
[fileMgr contentsOfDirectoryAtPath:documentsDirectoryerror:&error]);
NSFileManager *fileManager = [NSFileManager defaultManager];
//在这里获取应用程序Documents文件夹里的文件及文件夹列表
        NSArray *documentPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
        NSString *documentDir = [documentPaths objectAtIndex:0];
        NSError *error = nil;
        NSArray *fileList = [[NSArray alloc] init];
//fileList便是包含有该文件夹下所有文件的文件名及文件夹名的数组
        fileList = [fileManager contentsOfDirectoryAtPath:documentDir error:&error];
NSMutableArray *dirArray = [[NSMutableArray alloc] init];
        BOOL isDir = NO;
//在上面那段程序中获得的fileList中列出文件夹名
        for (NSString *file in fileList) {
                NSString *path = [documentDir stringByAppendingPathComponent:file];
                [fileManager fileExistsAtPath:path isDirectory:(&isDir)];
                if (isDir) {
                        [dirArray addObject:file];
                }
                isDir = NO;
        }
        NSLog(@"Every Thing in the dir:%@",fileList);
        NSLog(@"All folders:%@",dirArray);

我们看看NSFileManager如何使用。包括创建文件，目录，删除，遍历目录等。
 
1、在Documents里创建目录
创建一个叫test的目录,先找到Documents的目录，
 
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
   NSString *documentsDirectory = [paths objectAtIndex:0];
   NSLog(@"documentsDirectory%@",documentsDirectory);
   NSFileManager *fileManager = [NSFileManager defaultManager];
   NSString *testDirectory = [documentsDirectory stringByAppendingPathComponent:@"test"];
   // 创建目录
   [fileManager createDirectoryAtPath:testDirectory withIntermediateDirectories:YES attributes:nil error:nil];
 
启动程序，这时候目录就创建了：

 
2、在test目录下创建文件
创建文件怎么办呢？接着上面的代码 testPath 要用stringByAppendingPathComponent拼接上你要生成的文件名，比如test00.txt。这样才能在test下写入文件。
 
testDirectory是上面代码生成的路径哦，不要忘了。我往test文件夹里写入三个文件，test00.txt ,test22.txt,text.33.txt。内容都是写入内容，write String。
实现代码如下：
 
NSString *testPath = [testDirectory stringByAppendingPathComponent:@"test00.txt"];
NSString *testPath2 = [testDirectory stringByAppendingPathComponent:@"test22.txt"];
NSString *testPath3 = [testDirectory stringByAppendingPathComponent:@"test33.txt"];


NSString *string = @"写入内容，write String";
[fileManager createFileAtPath:testPath contents:[string  dataUsingEncoding:NSUTF8StringEncoding] attributes:nil];
[fileManager createFileAtPath:testPath2 contents:[string  dataUsingEncoding:NSUTF8StringEncoding] attributes:nil];
[fileManager createFileAtPath:testPath3 contents:[string  dataUsingEncoding:NSUTF8StringEncoding] attributes:nil];
看下面的图，三个文件都出来了，内容也对。
 

在Documents目录下创建就更简单了，不用加test就ok了
3、获取目录列里所有文件名
两种方法获取：subpathsOfDirectoryAtPath 和 subpathsAtPath
 
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSLog(@"documentsDirectory%@",documentsDirectory);
NSFileManager *fileManage = [NSFileManager defaultManager];
NSString *myDirectory = [documentsDirectory stringByAppendingPathComponent:@"test"];
NSArray *file = [fileManage subpathsOfDirectoryAtPath: myDirectory error:nil];
NSLog(@"%@",file);
NSArray *files = [fileManage subpathsAtPath: myDirectory ];
NSLog(@"%@",files);
获取上面刚才test文件夹里的文件名
打印结果
 
2012-06-17 23:23:19.684 IosSandbox[947:f803] fileList:(
    ".DS_Store",
    "test00.txt",
    "test22.txt",
    "test33.txt"
)
2012-06-17 23:23:19.686 IosSandbox[947:f803] fileLit(
    ".DS_Store",
    "test00.txt",
    "test22.txt",
    "test33.txt"
)
两个方法都可以，隐藏的文件也打印出来了。
4、fileManager使用操作当前目录
 
//创建文件管理器
    NSFileManager *fileManager = [NSFileManager defaultManager];
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];
    //更改到待操作的目录下
    [fileManager changeCurrentDirectoryPath:[documentsDirectory stringByExpandingTildeInPath]];
    //创建文件fileName文件名称，contents文件的内容，如果开始没有内容可以设置为nil，attributes文件的属性，初始为nil
    NSString * fileName = @"testFileNSFileManager.txt";
    NSArray *array = [[NSArray alloc] initWithObjects:@"hello world",@"hello world1", @"hello world2",nil];
    [fileManager createFileAtPath:fileName contents:array attributes:nil];
这样就创建了testFileNSFileManager.txt并把三个hello world写入文件了
 

 
changeCurrentDirectoryPath目录更改到当前操作目录时，做文件读写就很方便了，不用加上全路径
5、删除文件
接上面的代码，remove就ok了。
 
[fileManager removeItemAtPath:fileName error:nil];
6、混合数据的读写
 
用NSMutableData创建混合数据，然后写到文件里。并按数据的类型把数据读出来
6.1写入数据：
 
NSString * fileName = @"testFileNSFileManager.txt";
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
//获取文件路径
NSString *path = [documentsDirectory stringByAppendingPathComponent:fileName];
//待写入的数据
NSString *temp = @"nihao 世界";
int dataInt = 1234;
float dataFloat = 3.14f;
//创建数据缓冲
NSMutableData *writer = [[NSMutableData alloc] init];
//将字符串添加到缓冲中
[writer appendData:[temp dataUsingEncoding:NSUTF8StringEncoding]];
//将其他数据添加到缓冲中
[writer appendBytes:&dataInt length:sizeof(dataInt)];
[writer appendBytes:&dataFloat length:sizeof(dataFloat)];
//将缓冲的数据写入到文件中
[writer writeToFile:path atomically:YES];
我们看看数据怎么样了：
 
我们看到后面的是乱码，那是中文被转成了NSData后，还有int float的二进制
6.2读取刚才写入的数据：
 
//读取数据：
   int intData;
   float floatData = 0.0;
   NSString *stringData;

   NSData *reader = [NSData dataWithContentsOfFile:path];
   stringData = [[NSString alloc] initWithData:[reader subdataWithRange:NSMakeRange(0, [temp length])]
                                  encoding:NSUTF8StringEncoding];
   [reader getBytes:&intData range:NSMakeRange([temp length], sizeof(intData))];
   [reader getBytes:&floatData range:NSMakeRange([temp length] + sizeof(intData), sizeof(floatData))];
   NSLog(@"stringData:%@ intData:%d floatData:%f", stringData, intData, floatData);

打印出来的结果：
 
2012-06-17 23:51:14.723 IosSandbox[1285:f803] stringData:nihao hello! intData:1234332 floatData:3.140000

这里把写入的汉字改成了 hello。因为[temp length]算长度是，把中文算成一位了，出来的结果有误。
 
 
例子代码：https://github.com/schelling/YcDemo