17 数据持久化之文件存储

在前一篇文章中，我们讨论了 Core Data 的基本使用，这是一种强大的数据持久化框架，用于管理复杂的数据模型。在本篇文章中，我们将专注于 iOS 应用中的文件存储，了解如何在应用中以文件的形式保存和读取数据。文件存储是一种简单、直接、灵活的方式，特别适合存储轻量级数据。

文件存储的基础

文件存储允许你将数据以文件的形式保存在设备的本地存储中，这在某些情况下，比如保存图片、文档或简单文本数据时是非常有用的。在 iOS 中，文件可以被存储在几个不同的目录中：

• Documents：用户生成的文件，应该备份（例如，用户上传的内容）。
• Library：应用程序的支持文件，通常不需要备份。
• Caches：缓存文件，存储可再生成的数据，以节省网络流量和时间。

文件路径的获取

在开始文件存储之前，我们需要知道如何获取这些目录的路径。可以使用以下代码获取 Documents 目录的路径：

let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!

数据写入文件

接下来，我们来实现一个简单的示例，演示如何将文本数据写入到文件中。

示例：保存文本数据

假设我们要将一些用户输入的文本保存到文件中。下面是一个简单的保存功能的实现：

func saveTextToFile(text: String, fileName: String) {
    let fileURL = documentsDirectory.appendingPathComponent(fileName)
    
    do {
        try text.write(to: fileURL, atomically: true, encoding: .utf8)
        print("文件已成功保存到 \(fileURL.path)")
    } catch {
        print("保存文件时发生错误: \(error)")
    }
}

在上面的代码中，我们首先通过 appendingPathComponent 方法将文件名附加到 Documents 目录路径，然后使用 write 方法将文本写入到指定的文件中。

使用案例

调用上述方法可以这样进行：

let userText = "这是用户输入的文本"
saveTextToFile(text: userText, fileName: "userInput.txt")

数据读取文件

除了写入文件，我们还需要从文件中读取数据。下面是如何完成读取操作的示例：

示例：读取文本数据

以下函数从指定的文件中读取文本数据：

func readTextFromFile(fileName: String) -> String? {
    let fileURL = documentsDirectory.appendingPathComponent(fileName)
    
    do {
        let text = try String(contentsOf: fileURL, encoding: .utf8)
        return text
    } catch {
        print("读取文件时发生错误: \(error)")
        return nil
    }
}

使用案例

读取文件可以这样进行：

if let savedText = readTextFromFile(fileName: "userInput.txt") {
    print("读取到的文本: \(savedText)")
} else {
    print("无法读取文件")
}

数据的更新与删除

在实际开发中，可能需要对文件内容进行更新或删除。

更新文件

更新文件的过程可以简单地删除原有文件再写入新内容：

func updateTextInFile(newText: String, fileName: String) {
    let fileURL = documentsDirectory.appendingPathComponent(fileName)
    
    do {
        try FileManager.default.removeItem(at: fileURL) // 删除旧内容
        try newText.write(to: fileURL, atomically: true, encoding: .utf8) // 写入新内容
        print("文件已成功更新")
    } catch {
        print("更新文件时发生错误: \(error)")
    }
}

删除文件

删除文件只需一行代码：

func deleteFile(fileName: String) {
    let fileURL = documentsDirectory.appendingPathComponent(fileName)
    
    do {
        try FileManager.default.removeItem(at: fileURL)
        print("文件已成功删除")
    } catch {
        print("删除文件时发生错误: \(error)")
    }
}

总结

通过本篇文章的学习，我们了解了如何在 iOS 中实现文件存储，包括文本数据的保存、读取、更新和删除。文件存储是一种非常灵活且简单的持久化方法，适用于多种场景。接下来，我们将继续探讨 用户默认设置 的数据持久化方法，这是 iOS 中另一种方便的数据存储方式。

如果你有任何关于文件存储的疑问，请随时在评论中提出！