如何在Xcode中从Firestore将对象数组转换为模型

我来帮你一步步解决这个问题，要把Firestore中的对象数组转换成对应的Swift Exercise模型数组，我们需要先完善模型的协议实现，再编写数据转换逻辑：

1. 完善Exercise模型的DocumentSerializable协议实现 #

你的现有代码已经定义了协议，但还未实现初始化方法，同时dictionary属性的字段也不完整。下面是补全后的完整结构体代码：

import Foundation
import FirebaseFirestore // 注意：新版本Firebase需导入这个包，旧版本可能是Firestore

protocol DocumentSerializable {
    init?(dictionary: [String: Any])
}

struct Exercise {
    var title: String
    var language: String
    var translated: String
    var uid: String
    var userId: String
    var dueDate: Int
    var lastOpen: Int
    var words: [Any]
    
    // 补全模型转字典的属性（用于存回Firestore）
    var dictionary: [String: Any] {
        return [
            "title": title,
            "language": language,
            "translated": translated,
            "uid": uid,
            "userId": userId,
            "dueDate": dueDate,
            "lastOpen": lastOpen,
            "words": words
        ]
    }
}

// 实现DocumentSerializable协议，完成字典转模型的逻辑
extension Exercise: DocumentSerializable {
    init?(dictionary: [String: Any]) {
        // 通过guard let安全解析每个字段，若字段缺失/类型不匹配则返回nil
        guard let title = dictionary["title"] as? String,
              let language = dictionary["language"] as? String,
              let translated = dictionary["translated"] as? String,
              let uid = dictionary["uid"] as? String,
              let userId = dictionary["userId"] as? String,
              let dueDate = dictionary["dueDate"] as? Int,
              let lastOpen = dictionary["lastOpen"] as? Int,
              let words = dictionary["words"] as? [Any] else {
            return nil
        }
        
        self.title = title
        self.language = language
        self.translated = translated
        self.uid = uid
        self.userId = userId
        self.dueDate = dueDate
        self.lastOpen = lastOpen
        self.words = words
    }
}

这里的核心是通过guard let做类型安全校验，确保只有符合字段要求的数据才能转换成Exercise实例，避免因Firestore数据异常导致崩溃。

2. 从Firestore获取数据并转换为[Exercise]数组 #

假设你的练习数据存储在Firestore的exercises集合中，你可以编写如下方法来获取并转换数据：

单次获取数据 #

import FirebaseFirestore

func fetchExercises(completion: @escaping ([Exercise]?) -> Void) {
    let db = Firestore.firestore()
    db.collection("exercises").getDocuments { snapshot, error in
        guard let snapshot = snapshot, error == nil else {
            print("获取数据失败：\(error?.localizedDescription ?? "未知错误")")
            completion(nil)
            return
        }
        
        // 遍历文档，用compactMap过滤掉转换失败的nil值
        let exercises = snapshot.documents.compactMap { document in
            Exercise(dictionary: document.data())
        }
        
        completion(exercises)
    }
}

实时监听数据变化（可选） #

如果需要实时同步Firestore的数据更新，可以换成addSnapshotListener：

func listenForExercises(completion: @escaping ([Exercise]?) -> Void) {
    let db = Firestore.firestore()
    db.collection("exercises").addSnapshotListener { snapshot, error in
        guard let snapshot = snapshot, error == nil else {
            print("监听数据失败：\(error?.localizedDescription ?? "未知错误")")
            completion(nil)
            return
        }
        
        let exercises = snapshot.documents.compactMap { document in
            Exercise(dictionary: document.data())
        }
        
        completion(exercises)
    }
}

3. 使用示例 #

你可以在ViewController或ViewModel中调用上述方法，处理转换后的模型数组：

override func viewDidLoad() {
    super.viewDidLoad()
    fetchExercises { exercises in
        guard let exercises = exercises else { return }
        // 在这里处理练习数组，比如刷新UI、存储到本地等
        print("成功获取到\(exercises.count)个练习")
    }
}

内容的提问来源于stack exchange，提问作者Alexander Singh