37、《文件操作与 “What About That File?” 应用开发》

《文件操作与 “What About That File?” 应用开发》

在文件操作的领域中，有许多强大的工具和方法可以帮助我们处理各种文件。下面将详细介绍相关的文件操作知识以及如何开发一个名为 “What About That File?” 的应用程序。

基础文件操作方法

在文件操作中，有几个关键的类和方法值得我们关注：
- 读取配置文件 ： dictionaryWithContentsOfFile: 类方法可用于从文本编辑器或 Xcode 的 plist 编辑器创建的配置文件中读取数据。此外，Cocoa 还提供了 NSPropertyListSerialization 类来处理属性列表格式。若需要以通用方式解析属性列表并进行完整的错误报告和更多控制，可以使用 propertyListWithData:options:format:error: 类方法。
- 通用文件访问 ： NSData 类提供了最通用的文件访问方式。它可以从磁盘读取任何类型的数据，并将其表示为字节数组供我们使用，这是处理二进制数据的理想方法。 NSData 甚至提供了一个选项，可将文件映射到虚拟内存中，避免一次性将大文件全部加载到内存中，示例代码如下：

NSData *myData = [NSData dataWithContentsOfFile:@"/path/to/something"
 options:NSDataReadingMappedIfSafe error: &myError];

• 文件写入方法 ：这里提到的每个类都包含一个 writeToFile:atomically: 方法，其第二个参数是一个布尔值，用于指定是否应先将数据写入辅助文件，待所有数据写入后再替换原始文件。不过， NSString 版本的此方法已被弃用，建议使用 writeToFile:atomically:encoding:error: 方法，该方法要求我们指定文本编码方式，并让我们有机会检查可能出现的错误。 NSData 提供了类似的 writeToFile:options:error: 方法，同样能让我们查看写入文件时出现的错误。

“What About That File?” 应用开发

这个应用程序允许用户选择一个文件，然后显示该文件的一些信息以及文件内容的字符串形式。如果文件包含无法表示为字符串的数据，会告知用户；否则，用户可以使用弹出列表更改从磁盘读取文件时使用的文本编码，并显示结果字符串。

代码实现

1. 创建项目 ：使用 Xcode 创建一个新的 Cocoa 应用程序，命名为 WhatAboutThatFile ，确保启用 ARC 并为项目分配类前缀 WAT 。这将创建一个简单的项目，包含 WATAppDelegate 类和 MainMenu.xib 文件。
2. 应用委托头文件（ WATAppDelegate.h ） ：该文件声明了大量用于通过 Cocoa 绑定访问值的属性，还声明了一个操作方法，允许用户从菜单中打开文件。

//
//  WATAppDelegate.h
//
#import <Cocoa/Cocoa.h>

@interface WATAppDelegate : NSObject <NSApplicationDelegate>

@property (assign) IBOutlet NSWindow *window;

@property (strong) NSFileWrapper *fileWrapper;
@property (strong) NSURL *fileURL;
@property (assign) NSStringEncoding chosenEncoding;

@property (readonly) NSDictionary *fileAttributes;
@property (readonly) NSString *filename;
@property (readonly) NSImage *fileIcon;
@property (readonly) NSImage *opensAppIcon;
@property (readonly) NSString *opensAppName;
@property (weak) NSString *stringEncodingName;
@property (readonly) NSString *fileStringValue;
@property (readonly) NSDictionary *encodingNames;

- (IBAction)chooseFile:(id)sender;

@end

3. 选择文件方法（ chooseFile: ） ：该方法使用 NSOpenPanel 类让用户选择要检查的文件。如果用户选择了文件，会根据选择设置所有实例变量。 chosenEncoding 属性初始化为 0，这不是一个有效的字符串编码类型，以便后续让系统尝试推断字符串编码类型。然后根据打开面板的选择设置 fileURL ，最后根据 fileURL 设置 fileWrapper 实例。同时，还包含了错误处理代码，以应对选择文件时可能出现的问题。

- (IBAction)chooseFile:(id)sender
{
    NSOpenPanel *openPanel = [NSOpenPanel openPanel];
    [openPanel setCanChooseFiles:YES];
    [openPanel setCanChooseDirectories:NO];
    [openPanel setResolvesAliases:NO];
    [openPanel setAllowsMultipleSelection:NO];

    if ([openPanel runModal] == NSFileHandlingPanelOKButton) {
        self.chosenEncoding = 0;
        self.fileURL = [openPanel URL];
        NSError *fileError;
        self.fileWrapper = [[NSFileWrapper alloc] initWithURL:self.fileURL
                                                      options:0
                                                        error:&fileError];
        if (!self.fileWrapper) {
            NSRunAlertPanel(@"Couldn't access file",
                            [fileError localizedDescription], nil, nil, nil);
        }
    }
}

4. 文件名和文件图标方法 ： filename 和 fileIcon 方法将被窗口中最上层的 GUI 对象读取。这些读取操作通过 Cocoa 绑定实现，因此我们使用 keyPathsForValuesAffectingFilename 和 keyPathsForValuesAffectingFileIcon 类方法，确保当 fileURL 或 fileWrapper 值发生变化时，绑定到 filename 或 fileIcon 的视图会自动重新加载内容。

+ (NSSet *)keyPathsForValuesAffectingFilename
{
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper", nil];
}

- (NSString *)filename
{
    return [self.fileWrapper filename];
}

+ (NSSet *)keyPathsForValuesAffectingFileIcon
{
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper", nil];
}

- (NSImage *)fileIcon
{
    return [self.fileWrapper icon];
}

5. 默认打开应用信息方法 ：为了显示用户在 Finder 中双击所选文件时将启动的应用程序的信息，我们使用 NSWorkspace 类。 opensAppName 方法获取所选文件的默认打开应用程序的名称， opensAppIcon 方法获取该应用程序的图标。同样，使用 keyPathsForValuesAffectingOpensAppName 和 keyPathsForValuesAffectingOpensAppIcon 方法确保这些值在选择新文件时能正确刷新。

+ (NSSet *)keyPathsForValuesAffectingOpensAppName
{
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper", nil];
}

- (NSString *)opensAppName {
    NSWorkspace *workspace = [NSWorkspace sharedWorkspace];
    NSString *appName = nil;
    [workspace getInfoForFile:self.fileURL.path application:&appName type:NULL];
    return appName;
}

+ (NSSet *)keyPathsForValuesAffectingOpensAppIcon
{
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper", nil];
}

- (NSImage *)opensAppIcon
{
    NSWorkspace *workspace = [NSWorkspace sharedWorkspace];
    NSString *appName = nil;
    [workspace getInfoForFile:self.fileURL.path application:&appName type:NULL];
    return appName ? [workspace iconForFile:appName] : nil;
}

6. 文件属性访问方法 ： fileAttributes 访问器返回一个包含文件系统属性的字典，该字典将通过 NSDictionaryController 在 GUI 的表格视图中显示。

+ (NSSet *)keyPathsForValuesAffectingFileAttributes {
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper", nil];
}

- (NSDictionary *)fileAttributes {
    return [self.fileWrapper fileAttributes];
}

7. 字符串编码相关方法
   • 编码名称字典方法 ： encodingNames 方法提供了系统定义的所有编码名称列表，用于 GUI 中的弹出按钮，并作为编码名称与其代码级表示（ NSStringEncoding 类型）之间的内部查找机制。该字典使用每个编码的数值包装在 NSString 中作为键，因为在 Cocoa 绑定的键值观察上下文中，必须使用字符串作为键。

- (NSDictionary *)encodingNames
{
    static NSDictionary *encodingNames = nil;
    if (!encodingNames) {
        encodingNames = @{@"1" : @"NSASCIIStringEncoding",
                          @"2" : @"NSNEXTSTEPStringEncoding",
                          @"3" : @"NSJapaneseEUCStringEncoding",
                          @"4" : @"NSUTF8StringEncoding",
                          @"5" : @"NSISOLatin1StringEncoding",
                          @"6" : @"NSSymbolStringEncoding",
                          @"7" : @"NSNonLossyASCIIStringEncoding",
                          @"8" : @"NSShiftJISStringEncoding",
                          @"9" : @"NSISOLatin2StringEncoding",
                          @"10" : @"NSUnicodeStringEncoding",
                          @"11" : @"NSWindowsCP1251StringEncoding",
                          @"12" : @"NSWindowsCP1252StringEncoding",
                          @"13" : @"NSWindowsCP1253StringEncoding",
                          @"14" : @"NSWindowsCP1254StringEncoding",
                          @"15" : @"NSWindowsCP1250StringEncoding",
                          @"21" : @"NSISO2022JPStringEncoding",
                          @"30" : @"NSMacOSRomanStringEncoding",
                          @"2415919360" : @"NSUTF16BigEndianStringEncoding",
                          @"2483028224" : @"NSUTF16LittleEndianStringEncoding",
                          @"2348810496" : @"NSUTF32StringEncoding",
                          @"2550137088" : @"NSUTF32BigEndianStringEncoding",
                          @"2617245952" : @"NSUTF32LittleEndianStringEncoding"};
    }
    return encodingNames;
}

- **字符串编码名称访问器**：`stringEncodingName` 方法有两个主要执行路径。如果 `chosenEncoding` 已设置（即用户从弹出列表中选择了编码），则在之前定义的字典中查找所选编码的名称；否则，使用 `stringWithContentsOfFile:usedEncoding:error:` 方法读取文件内容，并根据结果编码查找发现的编码名称（若未检测到编码，则返回问题描述）。`setStringEncodingName:` 方法用于在用户在弹出列表中选择编码名称时，在字典中进行反向查找以找到对应的编码键，并设置 `chosenEncoding` 属性。

+ (NSSet *)keyPathsForValuesAffectingStringEncodingName
{
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper",
            @"chosenEncoding", nil];
}

- (NSString *)stringEncodingName
{
    if (!self.fileURL) return nil;
    if (self.chosenEncoding != 0) {
        return [[self encodingNames] objectForKey:
                @(self.chosenEncoding).stringValue];
    } else {
        NSStringEncoding encoding = 0;
        NSError *err = nil;
        [NSString stringWithContentsOfFile:self.fileURL.path
                              usedEncoding:&encoding error:&err];
        if (encoding==0) {
            return @"No encoding detected.  Perhaps a binary file?";
        }
        return [[self encodingNames] objectForKey:
                @(self.chosenEncoding).stringValue];
    }
}

- (void)setStringEncodingName:(NSString *)name
{
    NSString *key = [[[self encodingNames] allKeysForObject:name]
                     lastObject];
    self.chosenEncoding = [key longLongValue];
}

- **文件字符串值方法**：`fileStringValue` 方法也有两个主要代码路径。如果 `chosenEncoding` 已设置，则使用所选编码从所选文件中读取字符串值；否则，让系统尝试推断编码并读取字符串值。在两种情况下，都会进行错误检查，若遇到特定的字符串编码错误，将显示警报面板。

+ (NSSet *)keyPathsForValuesAffectingFileStringValue
{
    return [NSSet setWithObjects:@"fileURL", @"fileWrapper",
            @"chosenEncoding", nil];
}

- (NSString *)fileStringValue
{
    if (!self.fileURL) return nil;
    NSError *err = nil;
    NSString *value = nil;
    if (self.chosenEncoding != 0) {
        value = [NSString stringWithContentsOfFile:self.fileURL.path
                                          encoding:self.chosenEncoding error:&err];
    } else {
        NSStringEncoding encoding = 0;
        value = [NSString stringWithContentsOfFile:self.fileURL.path
                                      usedEncoding:&encoding error:&err];
    }
    if (err)  {
        if ([err code]==NSFileReadInapplicableStringEncodingError &&
            [[err domain] isEqual:NSCocoaErrorDomain]) {
            NSRunAlertPanel(@"Invalid string encoding",
                            [err localizedDescription], nil, nil, nil);
        }
        NSLog(@"encountered error: %@", err);
    }
    return value;
}

GUI 设置

完成代码编写后，接下来要设置 GUI。具体步骤如下：
1. 连接菜单操作 ：打开 MainMenu.xib 文件，在主笔尖编辑区域打开菜单，进入 “File” 菜单，按住 Ctrl 键从 “Open” 菜单项拖动到主笔尖窗口中代表应用委托的图标，然后从弹出的小菜单中选择 chooseFile: 方法。
2. 窗口设置与绑定
- 顶部组件设置 ：在窗口顶部放置两个标签，将左侧标签的标题改为 “Selected File:”，然后在它们之间放置一个 NSImageView 。通过菜单 Edit ➤ Format ➤ Font ➤ Bold 将左侧标签设置为粗体，并拉伸右侧标签使其几乎延伸到窗口右边缘。选择 NSImageView ，使用属性检查器将其边框设置为无，并将缩放方式设置为 “Proportionally Up or Down”。接着，使用绑定检查器将 NSImageView 的 Value 绑定到应用委托的 self.fileIcon 键路径，将右侧标签的 Value 绑定到应用委托的 self.filename 键路径。
- 重复组件设置 ：通过拖动框选择上述三个对象，按下 ⌘D 复制对象并将新对象拖到下方排列。将新左侧标签的标题改为 “Opens Application:” 并调整其位置。重新配置新 NSImageView 的绑定，将其 Value 连接到应用委托的 self.opensAppIcon 键路径，将右侧标签的 Value 连接到应用委托的 self.opensAppName 键路径。
- 表格视图设置 ：从库中拖动一个表格视图到窗口并加宽以匹配要求。从库中搜索 NSDictionaryController 并拖动到 Interface Builder 停靠区，将其重命名为 attrDict 。使用绑定检查器将其 Content Dictionary 绑定到应用委托的 self.fileAttributes 键路径。然后，将表格视图的左列 Value 绑定到 attrDict ，使用 arrangedObjects 作为控制器键， key 作为键路径；将右列 Value 绑定到 attrDict ，使用 arrangedObjects 作为控制器键， value 作为模型键路径。
- 文本视图设置 ：从库中拖动一个 NSTextView 到窗口底部，调整表格视图和文本视图的高度，使它们舒适地排列在一起，并确保下方有足够空间。将文本视图的宽度调整为与表格视图相同。由于拖动的文本视图包含在滚动视图中，额外点击以选择滚动视图内的文本视图，使用属性检查器关闭 “Editable” 和 “Rich Text” 复选框。选择表格视图和文本视图（滚动视图），通过菜单 Editor ➤ Embed In ➤ Split View 将它们嵌入到分割视图中。最后，使用绑定检查器将文本视图的 Value 绑定到应用委托的 self.fileStringValue 键路径。
- 编码选择组件设置 ：从库中获取一个标签和一个弹出按钮，按照要求布局，确保弹出按钮足够宽以显示长编码名称。从库中拖动另一个 NSDictionaryController 到笔尖窗口，重命名为 strEncs ，将其 Content Dictionary 绑定到应用委托的 self.encodingNames 键路径。将弹出按钮的 Content 绑定到 strEncs ，使用 arrangedObjects 作为控制器键， value 作为模型键路径。将弹出按钮的 Selected Object 绑定到应用委托的 self.stringEncodingName 键路径。

完成上述所有设置后，保存更改并构建运行应用程序。我们将看到构建的 GUI，包括一个 “File ➤ Open” 菜单项，可让我们选择文件并显示文件属性和内容。从弹出列表中选择另一种编码将使应用程序使用所选编码重新显示文本视图中的数据。

通过以上步骤，我们完成了 “What About That File?” 应用程序的开发，涵盖了文件操作的基础知识和 GUI 设计的详细过程。这个应用程序不仅展示了如何读取和处理文件，还展示了如何使用 Cocoa 绑定来实现动态的用户界面。

《文件操作与 “What About That File?” 应用开发》

技术点分析

文件操作类的选择

在文件操作中，不同的类适用于不同的场景，以下是详细的对比分析：

字符串编码处理

字符串编码是文件操作中一个重要的问题，不同的编码方式可能会导致文件内容显示不正确。在 “What About That File?” 应用中，我们通过以下几个步骤来处理字符串编码：
1. 提供编码名称列表 ：通过 encodingNames 方法提供系统定义的所有编码名称列表，用于 GUI 中的弹出按钮，方便用户选择不同的编码方式。
2. 推断编码 ：在用户未选择编码时，使用 stringWithContentsOfFile:usedEncoding:error: 方法读取文件内容并自动推断编码。
3. 手动选择编码 ：用户可以从弹出列表中选择编码，应用程序会使用所选编码重新读取文件内容。

以下是处理字符串编码的关键代码：

- (NSDictionary *)encodingNames
{
    static NSDictionary *encodingNames = nil;
    if (!encodingNames) {
        encodingNames = @{@"1" : @"NSASCIIStringEncoding",
                          @"2" : @"NSNEXTSTEPStringEncoding",
                          @"3" : @"NSJapaneseEUCStringEncoding",
                          @"4" : @"NSUTF8StringEncoding",
                          @"5" : @"NSISOLatin1StringEncoding",
                          @"6" : @"NSSymbolStringEncoding",
                          @"7" : @"NSNonLossyASCIIStringEncoding",
                          @"8" : @"NSShiftJISStringEncoding",
                          @"9" : @"NSISOLatin2StringEncoding",
                          @"10" : @"NSUnicodeStringEncoding",
                          @"11" : @"NSWindowsCP1251StringEncoding",
                          @"12" : @"NSWindowsCP1252StringEncoding",
                          @"13" : @"NSWindowsCP1253StringEncoding",
                          @"14" : @"NSWindowsCP1254StringEncoding",
                          @"15" : @"NSWindowsCP1250StringEncoding",
                          @"21" : @"NSISO2022JPStringEncoding",
                          @"30" : @"NSMacOSRomanStringEncoding",
                          @"2415919360" : @"NSUTF16BigEndianStringEncoding",
                          @"2483028224" : @"NSUTF16LittleEndianStringEncoding",
                          @"2348810496" : @"NSUTF32StringEncoding",
                          @"2550137088" : @"NSUTF32BigEndianStringEncoding",
                          @"2617245952" : @"NSUTF32LittleEndianStringEncoding"};
    }
    return encodingNames;
}

- (NSString *)stringEncodingName
{
    if (!self.fileURL) return nil;
    if (self.chosenEncoding != 0) {
        return [[self encodingNames] objectForKey:
                @(self.chosenEncoding).stringValue];
    } else {
        NSStringEncoding encoding = 0;
        NSError *err = nil;
        [NSString stringWithContentsOfFile:self.fileURL.path
                              usedEncoding:&encoding error:&err];
        if (encoding==0) {
            return @"No encoding detected.  Perhaps a binary file?";
        }
        return [[self encodingNames] objectForKey:
                @(encoding).stringValue];
    }
}

- (void)setStringEncodingName:(NSString *)name
{
    NSString *key = [[[self encodingNames] allKeysForObject:name]
                     lastObject];
    self.chosenEncoding = [key longLongValue];
}

Cocoa 绑定的使用

Cocoa 绑定是一种强大的机制，它可以将视图和模型数据自动关联起来，实现数据的动态更新。在 “What About That File?” 应用中，我们广泛使用了 Cocoa 绑定来实现 GUI 的动态更新，以下是 Cocoa 绑定的操作流程：

graph TD;
    A[创建控制器类] --> B[定义属性和方法];
    B --> C[在 Interface Builder 中设置绑定];
    C --> D[选择绑定对象];
    D --> E[设置绑定的键路径];
    E --> F[实现键路径对应的属性或方法];
    F --> G[数据变化时自动更新视图];

具体的绑定示例如下：
- 将 NSImageView 的 Value 绑定到应用委托的 self.fileIcon 键路径，实现文件图标的动态显示。
- 将表格视图的列绑定到 NSDictionaryController ，通过 arrangedObjects 作为控制器键， key 和 value 作为键路径，实现文件属性的动态显示。

总结

通过开发 “What About That File?” 应用程序，我们深入学习了文件操作的相关知识，包括文件的读取、写入、元数据获取以及字符串编码处理。同时，我们还掌握了 Cocoa 绑定的使用方法，通过绑定机制实现了 GUI 的动态更新，提高了开发效率和用户体验。

在实际开发中，我们可以根据具体的需求选择合适的文件操作类和编码方式，同时合理运用 Cocoa 绑定来简化界面开发。希望本文能对大家在文件操作和应用开发方面有所帮助。

如果你对文件操作和应用开发有更多的疑问或想法，欢迎在评论区留言讨论。