[iOS翻译]《iOS 7 Programming Cookbook》：iOS文件与文件夹管理（下）

2022-09-12 21:11:29

三. 创建文件夹

问题：

你想创建文件夹到磁盘，存储一些文件到里面

解决方案：

使NSFileManager类的实例方法createDirectoryAtPath:withIntermediateDirectories:attributes:error:，代码如下：

 1 - (BOOL) application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
 2         NSFileManager *fileManager = [[NSFileManager alloc] init];
 3 
 4         NSString *tempDir = NSTemporaryDirectory();
 5         NSString *imagesDir = [tempDir stringByAppendingPathComponent:@"images"];
 6 
 7     NSError *error = nil;
 8     if ([fileManager createDirectoryAtPath:imagesDir
 9                    withIntermediateDirectories:YES
10                                     attributes:nil
11                                          error:&error]){
12             NSLog(@"Successfully created the directory.");
13 
14     } else {
15         NSLog(@"Failed to create the directory. Error = %@", error);
16     }
17 
18     self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
19     self.window.backgroundColor = [UIColor whiteColor]; 
20     [self.window makeKeyAndVisible];
21     return YES;
22 }

讨论

NSFileManager如此简洁易用，仅用几行就搞定了文件夹创建，下面是方法参数：

createDirectoryAtPath
- 创建文件夹的路径　　
withIntermediateDirectories
- BOOL类型。如果设为YES，将会自动补全最终文件夹之前的中间目录　　
- 例如，如果你想在tmp/data目录创建一个images文件夹，但data文件夹并不存在，怎么办？只需要把withIntermediateDirectories参数设为YES，系统就会自动创建目录tmp/data/images/
attributes
- 通常设为nil　　
error
- 接受一个指针指向NSError对象

四. 枚举文件/文件夹

问题：

你想在一个文件夹里枚举文件/文件夹列表，这个枚举动作意味着你想找到所有文件/文件夹

解决方案：

使用NSFileManager类的实例方法contentsOfDirectoryAtPath:error:。例如我们想要在bundle文件夹下枚举所有文件/文件夹，代码如下：

 1 - (BOOL) application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
 2     NSFileManager *fileManager = [[NSFileManager alloc] init];
 3     NSString *bundleDir = [[NSBundle mainBundle] bundlePath];
 4     NSError *error = nil;
 5     NSArray *bundleContents = [fileManager
 6                                    contentsOfDirectoryAtPath:bundleDir
 7                                    error:&error];
 8 
 9     if ([bundleContents count] > 0 && error == nil){
10     　　NSLog(@"Contents of the app bundle = %@", bundleContents);
11      }
12 　　　else if ([bundleContents count] == 0 && error == nil){
13  　　　　NSLog(@"Call the police! The app bundle is empty.");
14      }
15 　　　else {
16 　　　　 NSLog(@"An error happened = %@", error);
17 　　　}
18 
19 　　self.window = [[UIWindow alloc]
20                  initWithFrame:[[UIScreen mainScreen] bounds]];
21 　　self.window.backgroundColor = [UIColor whiteColor];
22    [self.window makeKeyAndVisible]; 
23    return YES;
24 }

讨论

在一些APP里，你可能需要枚举一个文件夹的内容，让我们来看一个例子吧。

想象一下，用户从网络下载了10张图片并缓存到APP里，这时你需要存储它们，也就是说，你要手动创建tmp/images/目录。现在用户关闭后又打开了APP，在界面上，你想要在一个table view里展示下载完成列表，该如何实现？

其实很简单，需要做的就是在目录里使用NSFileManager类进行内容枚举。在解决方案部分，你已经使用了NSFileManager类的实例方法contentsOfDirectoryAtPath:error:进行枚举，然而这个方法并不能指出哪个是文件，哪个是文件夹等等。想要从文件管理里获取更多细节，调用方法contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:，参数如下：

contentsOfDirectoryAtURL
- 想要检索的文件夹路径（NSURL类型）　　
includingPropertiesForKeys
- NSArray类型，代表检索目录下个各个条目的信息　　
- NSURLIsDirectoryKey　　
  - 是否是一个字典

- NSURLIsReadableKey　　
  - 是否可读

- NSURLCreationDateKey　　
  - 创建日期

- NSURLContentAccessDateKey　　
  - 访问日期

- NSURLContentModificationDateKey　　
  - 修改日期

options
- 参数只能为0或NSDirectoryEnumerationSkipsHiddenFiles，后者在枚举时会跳过隐藏内容　　
error
- 接受一个指针指向NSError对象

现在我们在XXX.app目录下进行枚举，并打印各条目的名字、是否为字典、是否可读以及创建/最后修改/最后访问的日期，代码如下；

 1 - (NSArray *) contentsOfAppBundle{
 2 　　　　 NSFileManager *manager = [[NSFileManager alloc] init]; NSURL *bundleDir = [[NSBundle mainBundle] bundleURL];
 3 
 4         NSArray *propertiesToGet = @[
 5                                      NSURLIsDirectoryKey,
 6                                      NSURLIsReadableKey,
 7                                      NSURLCreationDateKey,
 8                                      NSURLContentAccessDateKey,
 9                                      NSURLContentModificationDateKey
10                                      ];
11 
12 　　　　 NSError *error = nil;
13         NSArray *result = [manager contentsOfDirectoryAtURL:bundleDir
14                                  includingPropertiesForKeys:propertiesToGet
15                                                     options:0
16    　　　　　　　　　　　　　　　　　　　　　　　　　　　　   error:&error];
17 
18 　　　　if (error != nil){
19     　　　　NSLog(@"An error happened = %@", error);
20 　　　　}
21     　　return result; 
22 }
23

 1 - (NSString *) stringValueOfBoolProperty:(NSString *)paramProperty ofURL:(NSURL *)paramURL{
 2     NSNumber *boolValue = nil;
 3     NSError *error = nil;
 4     [paramURL getResourceValue:&boolValue
 5                         forKey:paramProperty
 6                          error:&error];
 7 
 8     if (error != nil){
 9         NSLog(@"Failed to get property of URL. Error = %@", error);
10     }
11         return [boolValue isEqualToNumber:@YES] ? @"Yes" : @"No";
12 }

1 - (NSString *) isURLDirectory:(NSURL *)paramURL{
2     return [self stringValueOfBoolProperty:NSURLIsDirectoryKey ofURL:paramURL];
3 }
4 
5 - (NSString *) isURLReadable:(NSURL *)paramURL{
6     return [self stringValueOfBoolProperty:NSURLIsReadableKey ofURL:paramURL];
7 }

 1 - (NSDate *) dateOfType:(NSString *)paramType inURL:(NSURL *)paramURL{ 
 2     NSDate *result = nil;
 3     NSError *error = nil;
 4     [paramURL getResourceValue:&result
 5                         forKey:paramType
 6                          error:&error];
 7 
 8     if (error != nil){
 9         NSLog(@"Failed to get property of URL. Error = %@", error);
10     }
11     return result; 
12 }

 1 - (void) printURLPropertiesToConsole:(NSURL *)paramURL{ 
 2 
 3     NSLog(@"Item name = %@", [paramURL lastPathComponent]); 
 4 
 5     NSLog(@"Is a Directory? %@", [self isURLDirectory:paramURL]); 
 6 
 7     NSLog(@"Is Readable? %@", [self isURLReadable:paramURL]); 
 8 
 9     NSLog(@"Creation Date = %@",
10           [self dateOfType:NSURLCreationDateKey inURL:paramURL]);
11 
12     NSLog(@"Access Date = %@",
13     [self dateOfType:NSURLContentAccessDateKey inURL:paramURL]);
14 
15     NSLog(@"Modification Date = %@",
16               [self dateOfType:NSURLContentModificationDateKey inURL:paramURL]);
17 
18     NSLog(@"-----------------------------------");
19 }

 1 - (BOOL) application:(UIApplication *)application
 2       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
 3     NSArray *itemsInAppBundle = [self contentsOfAppBundle]; 
 4     for (NSURL *item in itemsInAppBundle){
 5             [self printURLPropertiesToConsole:item];
 6         }
 7 
 8     self.window = [[UIWindow alloc]
 9                        initWithFrame:[[UIScreen mainScreen] bounds]];
10         // Override point for customization after application launch.
11     self.window.backgroundColor = [UIColor whiteColor]; 
12     [self.window         makeKeyAndVisible];
13     return YES;
14 }

输出结果类似下列信息：

    Item name = Assets.car
    Is a Directory? No
    Is Readable? Yes
    Creation Date = 2013-06-25 16:12:53 +0000
    Access Date = 2013-06-25 16:12:53 +0000
    Modification Date = 2013-06-25 16:12:53 +0000
    -----------------------------------
    Item name = en.lproj
    Is a Directory? Yes
    Is Readable? Yes
    Creation Date = 2013-06-25 16:12:53 +0000
    Access Date = 2013-06-25 16:15:02 +0000
    Modification Date = 2013-06-25 16:12:53 +0000
    -----------------------------------
    Item name = Enumerating Files and Folders
    Is a Directory? No
    Is Readable? Yes
    Creation Date = 2013-06-25 16:15:01 +0000
    Access Date = 2013-06-25 16:15:04 +0000
    Modification Date = 2013-06-25 16:15:01 +0000
    -----------------------------------

我们来看看这段代码的一些方法：

contentsOfAppBundle
- 这个方法搜索.app文件夹的所有条目（文件、文件夹等等），并返回一个数组　　
- 数组里的所有条目都为NSURL类型，并包含了创建/最后修改日期以及其他之前提到的属性　　
stringValueOfBoolProperty:ofURL:
- 返回与BOOL类型相当的NSString（YES或NO），用来判断URL的信息　　
isURLDirectory:
- 是否是字典　　
isURLReadable:
- 是否可读　　
dateOfType:inURL:
- 日期类型

现在，你已经知道如何在一个文件夹里遍历所有条目，甚至学会了检索各个条目的不同属性。

五. 删除文件/文件夹

问题：

你想删除一些文件或文件夹

解决方案：

使用NSFileManager类的实例方法removeItemAtPath:error:（接收string）或者removeItemAtURL:error:（接收URL）

讨论

删除文件/文件夹应该是使用file manager时最简单的操作了。现在，让我们来创建5个text文件到tmp/text目录，然后进行删除操作，代码如下；

 1 /* Creates a folder at a given path */
 2 - (void) createFolder:(NSString *)paramPath{
 3     NSError *error = nil;
 4     if ([self.fileManager createDirectoryAtPath:paramPath
 5                         withIntermediateDirectories:YES
 6                                          attributes:nil
 7                                               error:&error] == NO){
 8             NSLog(@"Failed to create folder %@. Error = %@",
 9                   paramPath,
10                   error);
11     } 
12 }

 1   /* Creates 5 .txt files in the given folder, named 1.txt, 2.txt, etc */
 2 - (void) createFilesInFolder:(NSString *)paramPath{ 
 3     /* Create 10 files */
 4     for (NSUInteger counter = 0; counter < 5; counter++){
 5         NSString *fileName = [NSString stringWithFormat:@"%lu.txt", (unsigned long)counter+1];
 6         NSString *path = [paramPath stringByAppendingPathComponent:fileName]; 
 7         NSString *fileContents = [NSString stringWithFormat:@"Some text"]; 
 8         NSError *error = nil;
 9         if ([fileContents writeToFile:path
10                            atomically:YES
11                              encoding:NSUTF8StringEncoding
12                                 error:&error] == NO){
13             NSLog(@"Failed to save file to %@. Error = %@", path, error);
14         } 
15     }
16 }

 1 /* Enumerates all files/folders at a given path */
 2 - (void) enumerateFilesInFolder:(NSString *)paramPath{
 3     NSError *error = nil;
 4     NSArray *contents = [self.fileManager contentsOfDirectoryAtPath:paramPath
 5                                                               error:&error];
 6 
 7     if ([contents count] > 0 && error == nil){
 8     NSLog(@"Contents of path %@ = \n%@", paramPath, contents); 
 9     }
10     else if ([contents count] == 0 && error == nil){
11         NSLog(@"Contents of path %@ is empty!", paramPath);
12     }
13     else {
14         NSLog(@"Failed to enumerate path %@. Error = %@", paramPath, error);
15     } 
16 }

 1 /* Deletes all files/folders in a given path */
 2 - (void) deleteFilesInFolder:(NSString *)paramPath{
 3     NSError *error = nil;
 4     NSArray *contents = [self.fileManager contentsOfDirectoryAtPath:paramPath error:&error];
 5 
 6     if (error == nil){
 7          error = nil;
 8         for (NSString *fileName in contents){
 9         /* We have the file name, to delete it,
10          we have to have the full path */
11         NSString *filePath = [paramPath
12                       stringByAppendingPathComponent:fileName];
13         if ([self.fileManager removeItemAtPath:filePath error:&error] == NO){
14             NSLog(@"Failed to remove item at path %@. Error = %@", fileName, error);
15             } 
16         }
17     } else {
18         NSLog(@"Failed to enumerate path %@. Error = %@", paramPath, error);
19     } 
20 }

1  /* Deletes a folder with a given path */
2 - (void) deleteFolder:(NSString *)paramPath{
3     NSError *error = nil;
4     if ([self.fileManager removeItemAtPath:paramPath error:&error] == NO){
5             NSLog(@"Failed to remove path %@. Error = %@", paramPath, error);
6         }
7 }

1 #import "AppDelegate.h"
2 
3 @interface AppDelegate ()
4 @property (nonatomic, strong) NSFileManager *fileManager; 
5 @end
6 
7 @implementation AppDelegate
8 
9 <# Rest of your app delegate code goes here #>

示例代码结合了这一章的很多知识，下面来看一看这些方法的步骤：

1.创建了tmp/txt目录。我们知道tmp文件夹在APP安装时自动创建，但txt文件夹则需要手动创建
2.在tmp/txt目录创建5个text文件
3.在tmp/txt目录枚举所有文件
4.在tmp/txt目录删除文件
5.再次在tmp/txt目录枚举剩下的文件
6.在tmp/txt目录删除文件夹

现在你不光学会了如何创建文件/文件夹，还学会了如何在不需要时删除它们。

六. 存储对象到文件

问题：

你添加了一些新类到项目里，这时你想把这些对象作为文件存储到磁盘里，当需要时能随时读取

解决方案：

确保你的类遵从NSCoding协议，并且实现协议必要方法

讨论

iOS SDK里有两个非常方便的类来实现这一目标，在编程世界里称为marshalling，它们是：

NSKeyedArchiver
- 归档　　
NSKeyedUnarchiver
- 解档

为了实现归档/解档工作，需要遵从NSCoding协议，现在来创建一个简单的Person类，头文件如下：

1 #import <Foundation/Foundation.h>
2 
3 @interface Person : NSObject <NSCoding> 
4 
5 @property (nonatomic, copy) NSString *firstName;
6 @property (nonatomic, copy) NSString *lastName; 
7 
8 @end

协议要求必须实现两个方法：

- (void)encodeWithCoder:(NSCoder *)aCoder
- 给你一个coder，使用方法类似字典　　
- (instancetype)initWithCoder:(NSCoder *)aDecoder
- 当你试图使用NSKeyedUnarchiver进行解档时，这个方法会被调用

现在来来到实现文件，代码如下：

 1 #import "Person.h"
 2 
 3 NSString *const kFirstNameKey = @"FirstNameKey";
 4 NSString *const kLastNameKey = @"LastNameKey";
 5 
 6 @implementation Person
 7 
 8 - (void)encodeWithCoder:(NSCoder *)aCoder{
 9     [aCoder encodeObject:self.firstName forKey:kFirstNameKey];  
10     [aCoder encodeObject:self.lastName forKey:kLastNameKey];
11 }
12 
13 - (instancetype)initWithCoder:(NSCoder *)aDecoder{ self = [super init];
14     if (self != nil){
15             _firstName = [aDecoder decodeObjectForKey:kFirstNameKey];
16             _lastName = [aDecoder decodeObjectForKey:kLastNameKey];
17         }
18     return self; 
19 }
20 
21 @end

接着在AppDelegate实现如下方法：

 1 #import "AppDelegate.h"
 2 #import "Person.h"
 3 
 4 @implementation AppDelegate
 5 
 6 - (BOOL) application:(UIApplication *)application
 7       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
 8         /* Define the name and the last name we are going to set in the object */
 9     NSString *const kFirstName = @"Steven"; 
10     NSString *const kLastName = @"Jobs";
11 
12         /* Determine where we want to archive the object */
13         NSString *filePath = [NSTemporaryDirectory()
14     stringByAppendingPathComponent:@"steveJobs.txt"];
15 
16         /* Instantiate the object */
17         Person *steveJobs = [[Person alloc] init];
18         steveJobs.firstName = kFirstName;
19         steveJobs.lastName = kLastName;
20 
21         /* Archive the object to the file */
22         [NSKeyedArchiver archiveRootObject:steveJobs toFile:filePath];
23 
24         /* Now unarchive the same class into another object */
25         Person *cloneOfSteveJobs =
26         [NSKeyedUnarchiver unarchiveObjectWithFile:filePath];
27 
28         /* Check if the unarchived object has the same first name and last name
29          as the previously-archived object */
30         if ([cloneOfSteveJobs.firstName isEqualToString:kFirstName] 
31             && [cloneOfSteveJobs.lastName isEqualToString:kLastName]){ 
32             NSLog(@"Unarchiving worked");
33         } else {
34             NSLog(@"Could not read the same values back. Oh no!");
35         }
36 
37         /* We no longer need the temp file, delete it */
38         NSFileManager *fileManager = [[NSFileManager alloc] init];
39         [fileManager removeItemAtPath:filePath error:nil];
40         self.window = [[UIWindow alloc]
41                        initWithFrame:[[UIScreen mainScreen] bounds]];
42         self.window.backgroundColor = [UIColor whiteColor];
43         [self.window makeKeyAndVisible];
44         return YES; 
45 }

可见，归档只需要使用NSKeyedArchiver类的类方法archiveRootObject:toFile就能搞定，那如何解档呢？使用另外一个类方法unarchiveObjectWithFile:就行。

[iOS翻译]《iOS 7 Programming Cookbook》：iOS文件与文件夹管理（下）

码农公寓

相关文章