iOS版Cloud Firestore入门

最新推荐文章于 2021-03-17 13:36:45 发布

cunjie3951

最新推荐文章于 2021-03-17 13:36:45 发布

阅读量571

点赞数 1

文章标签：数据库 python java 大数据数据分析

多年来，移动编码人员一直在利用Google的移动后端即服务（MBaaS）平台Firebase实时数据库，从而帮助他们专注于为自己的应用程序构建功能，而不必担心后端基础结构和数据库。通过简化在云中存储和持久存储数据并确保身份验证和安全性，Firebase允许编码人员将精力集中在客户端上。

去年，Google宣布了又一个后端数据库解决方案Cloud Firestore ，该解决方案是从头开始构建的，具有更大的可扩展性和直观性。但是，这相对于Google已经存在的旗舰产品Firebase Realtime Database而言，引起了一些困惑。本教程将概述两个平台之间的差异以及每个平台的独特优势。您将通过构建简单的提醒应用程序来学习如何使用Firestore文档参考以及实时读取，写入，更新和删除数据。

本教程的目标

本教程将向您介绍Cloud Firestore 。您将学习如何利用该平台实现实时数据库持久性和同步。我们将讨论以下主题：

什么是Cloud Firestore
Firestore数据模型
设置Cloud Firestore
创建和使用Cloud Firestore参考
从Cloud Firestore实时读取数据
创建，更新和删除数据
过滤和复合查询

假设知识

本教程假定您已接触过Firebase，并具有使用Swift和Xcode进行开发的背景知识。

什么是Cloud Firestore？

与Firebase Realtime Database一样，Firestore为移动和Web开发人员提供了一个跨平台的云解决方案，无论网络延迟或Internet连接如何，都可以实时持久存储数据，并且可以与Google Cloud Platform产品套件无缝集成。伴随着这些相似之处，存在着明显的优缺点，它们彼此区别。

资料模型

从根本上讲，实时数据库将数据存储为一棵大的整体式分层JSON树，而Firestore将数据组织在文档，集合和子集合中。这需要较少的非规范化。在处理简单数据需求时，将数据存储在一个JSON树中具有简化的好处。但是，在处理更复杂的分层数据时，规模化变得更加麻烦。

离线支援

两种产品都提供离线支持，在没有潜在的或没有网络连接的情况下主动将数据缓存在队列中—尽可能将本地更改同步回后端。 Firestore除了支持移动应用程序外，还支持Web应用程序的脱机同步，而Realtime Database仅支持移动同步。

查询和交易

实时数据库仅支持有限的排序和过滤功能-您只能在单个查询中在属性级别上进行排序或过滤，而不能同时在两者上进行排序或过滤。查询也很深，这意味着它们会返回结果的大子树。该产品仅支持需要完成回调的简单写入和事务操作。

另一方面，Firestore引入了具有复合排序和筛选功能的索引查询，使您可以组合操作以创建链式筛选器和排序功能。您也可以执行浅层查询，以返回子集合来代替使用实时数据库获得的整个集合。事务本质上是原子的，无论您发送批处理操作还是单次发送，事务都会自动重复直到结束。此外，实时数据库仅支持单个写入事务，而Firestore原子地提供批处理操作。

性能和可伸缩性

正如您所期望的那样，实时数据库非常健壮并且具有低延迟。但是，根据区域可用性，数据库仅限于单个区域。另一方面，Firestore可在多个区域和区域中水平放置数据，以确保真正的全局可用性，可伸缩性和可靠性。实际上，谷歌已经承诺Firestore会比实时数据库更可靠。

实时数据库的另一个缺点是限制了100,000个并发用户（单个数据库中有100,000个并发连接和1,000次写入/秒），之后您必须将数据库分片（将数据库拆分成多个数据库）以支持更多用户。 Firestore无需干预即可自动跨多个实例扩展。

Firestore从头开始设计，考虑到可伸缩性，它具有新的原理图体系结构，可跨多个区域复制数据，进行身份验证并在其客户端SDK中处理所有与安全性有关的事务。它的新数据模型比Firebase更直观，与其他类似的NoSQL数据库解决方案（如MongoDB）更相似，同时提供了更强大的查询引擎。

安全

Firestore数据模型

Firestore是基于NoSQL文档的数据库，由文档集合组成，每个文档集合都包含数据。由于它是NoSQL数据库，因此您将不会在关系数据库中找到表，行和其他元素，而会在文档中找到键/值对的集合。

您可以通过将数据分配给文档来隐式创建文档和集合，如果该文档或集合不存在，则将自动为您创建文档或集合，因为该集合始终必须是根（第一个）节点。这是您不久将要处理的项目的简单Tasks示例架构，它由Tasks集合以及包含两个字段（名称（字符串）和是否完成任务的标志）的大量文档组成（布尔）。

让我们分解每个元素，以便您可以更好地理解它们。

馆藏

集合与SQL世界中的数据库表同义，集合包含一个或多个文档。集合必须是架构中的根元素，并且只能包含文档，而不能包含其他集合。但是，您可以引用文档，而文档又引用集合（子集合）。

在上图中，任务包含两个基本字段（名称和完成）以及一个子集合（子任务），该子集合包含其自身的两个基本字段。

文件资料

文档由键/值对组成，值具有以下类型之一：

基本字段（例如字符串，数字，布尔值）
复杂的嵌套对象（基元的列表或数组）
子集合

嵌套对象也称为地图，可以在文档中表示如下。以下是分别嵌套对象和数组的示例：

ID: 2422892 //primitive
name: “Remember to buy milk” 
detail: //nested object
    notes: "This is a task to buy milk from the store"
	created: 2017-04-09
	due: 2017-04-10
done: false
notify: ["2F22-89R2", "L092-G623", "H00V-T4S1"]
...

有关受支持的数据类型的更多信息，请参阅Google的数据类型文档。接下来，您将设置一个项目以与Cloud Firestore一起使用。

设置项目

如果您以前曾经使用过Firebase，那么您应该对此很熟悉。否则，您将需要在Firebase中创建一个帐户，并按照之前教程“ iOS的Firebase身份验证入门 ”中“设置项目”部分中的说明进行操作。

要继续学习本教程，请克隆教程项目repo 。接下来，通过以下方式添加Firestore库将以下内容添加到您的Podfile中 ：

pod 'Firebase/Core' 
pod 'Firebase/Firestore'

在终端中输入以下内容以构建库：

pod install

接下来，切换到Xcode并打开.xcworkspace文件。导航到AppDelegate.swift文件，然后在application:didFinishLaunchingWithOptions:方法中输入以下内容：

FirebaseApp.configure()

在浏览器中，转到Firebase控制台，然后选择左侧的“ 数据库”选项卡。

确保选择“ 在测试模式下启动 ”选项，以便在我们进行实验时不会遇到任何安全问题，并且在将应用程序移入生产环境时请注意安全提示。现在您可以创建一个集合和一些示例文档。

添加收集和样本文档

首先，通过选择Add Collection按钮并命名该集合来创建一个初始集合Tasks ，如下所示：

对于第一个文档，您将文档ID保留为空白，这将为您自动生成一个ID。该文档将仅包含两个字段： name和done 。

保存文档，您应该能够确认集合和文档以及自动生成的ID：

在云中使用示例文档设置数据库之后，您就可以开始在Xcode中实现Firestore SDK了。

创建和使用数据库引用

在Xcode中打开MasterViewController.swift文件，并添加以下行以导入库：

import Firebase

class MasterViewController: UITableViewController {
    @IBOutlet weak var addButton: UIBarButtonItem!
    
    private var documents: [DocumentSnapshot] = []
    public var tasks: [Task] = []
    private var listener : ListenerRegistration!
   ...

在这里，您只是创建一个侦听器变量，当发生更改时，该变量将允许您实时触发与数据库的连接。您还将创建一个DocumentSnapshot引用，该引用将保存临时数据快照。

在继续使用视图控制器之前，创建另一个swift文件Task.swift ，它将代表您的数据模型：

import Foundation

struct Task{
    var name:String
    var done: Bool
    var id: String
    
    var dictionary: [String: Any] {
        return [
            "name": name,
            "done": done
        ]
    }
}

extension Task{
    init?(dictionary: [String : Any], id: String) {
        guard   let name = dictionary["name"] as? String,
            let done = dictionary["done"] as? Bool
            else { return nil }
        
        self.init(name: name, done: done, id: id)
    }
}

上面的代码段包含一个便捷属性（字典）和方法（init），这将使填充模型对象更加容易。切换回视图控制器，并声明一个全局设置器变量，它将基本查询限制在任务列表的前50个条目中。设置查询变量后，还将删除监听器，如下面的didSet属性所示：

fileprivate func baseQuery() -> Query {
        return Firestore.firestore().collection("Tasks").limit(to: 50)
    }
    
    fileprivate var query: Query? {
        didSet {
            if let listener = listener {
                listener.remove()
            }
        }
    }

override func viewDidLoad() {
        super.viewDidLoad()
        self.query = baseQuery()
    }

 override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        self.listener.remove()
    }

从Cloud Firestore实时读取数据

在文档参考就位的情况下，在viewWillAppear(_animated: Bool) ，将您先前创建的侦听器与查询快照的结果相关联，并检索文档列表。这是通过调用Firestore方法query?.addSnapshotListener ：

self.listener =  query?.addSnapshotListener { (documents, error) in
            guard let snapshot = documents else {
                print("Error fetching documents results: \(error!)")
                return
            }
            
            let results = snapshot.documents.map { (document) -> Task in
                if let task = Task(dictionary: document.data(), id: document.documentID) {
                    return task
                } else {
                    fatalError("Unable to initialize type \(Task.self) with dictionary \(document.data())")
                }
            }
            
            self.tasks = results
            self.documents = snapshot.documents
            self.tableView.reloadData()
            
        }

上述分配封闭件的snapshot.documents通过迭代映射所述阵列和它缠绕到一个新的Task模型实例对象快照中的每个数据项。因此，仅需几行，您就成功地从云中读取了所有任务并将它们分配给全局tasks 数组。

要显示结果，请填充以下内容 TableView 委托方法：

override func numberOfSections(in tableView: UITableView) -> Int {
        return 1
    }
    
    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return tasks.count
    }
    
    
    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        
        let item = tasks[indexPath.row]
        
        cell.textLabel!.text = item.name
        cell.textLabel!.textColor = item.done == false ? UIColor.black : UIColor.lightGray
        
        return cell
    }

在这一阶段，构建并运行项目，并且在Simulator中您应该能够观察实时出现的数据。通过Firebase控制台添加数据，您应该看到它立即出现在应用程序模拟器中。

创建，更新和删除数据

从后端成功读取内容后，接下来，您将创建，更新和删除数据。下一个示例将使用一个人为设计的示例来说明如何更新数据，在该示例中，该应用仅允许您通过点击单元格将项目标记为完成。请注意collection.document( item.id ).updateData(["done": !item.done])关闭属性，该属性仅引用特定的文档ID，从而更新字典中的每个字段：

override func tableView(_ tableView: UITableView,
                            didSelectRowAt indexPath: IndexPath) {

        let item = tasks[indexPath.row]
        let collection = Firestore.firestore().collection("Tasks")

        collection.document(item.id).updateData([
            "done": !item.done,
            ]) { err in
                if let err = err {
                    print("Error updating document: \(err)")
                } else {
                    print("Document successfully updated")
                }
        }

        tableView.reloadRows(at: [indexPath], with: .automatic)
        
    }

要删除项目，请调用document( item.id ).delete()方法：

override func tableView(_ tableView: UITableView, canEditRowAt indexPath: IndexPath) -> Bool {
        return true
    }
override func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCellEditingStyle, forRowAt indexPath: IndexPath) {

        if (editingStyle == .delete){
            let item = tasks[indexPath.row]
            _ = Firestore.firestore().collection("Tasks").document(item.id).delete()
        }

    }

创建一个新任务将涉及在情节提要中添加一个新按钮，并将其IBAction连接到视图控制器，并创建一个addTask(_ sender:)方法。当用户按下按钮时，它将弹出一个警报表，用户可以在其中添加新的任务名称：

collection("Tasks").addDocument
    (data: ["name": textFieldReminder.text ?? 
        "empty task", "done": false])

输入以下内容，完成应用程序的最后一部分：

@IBAction func addTask(_ sender: Any) {
        
        let alertVC : UIAlertController = UIAlertController(title: "New Task", message: "What do you want to remember?", preferredStyle: .alert)
        
        alertVC.addTextField { (UITextField) in
            
        }
        
        let cancelAction = UIAlertAction.init(title: "Cancel", style: .destructive, handler: nil)
        
        alertVC.addAction(cancelAction)
        
        //Alert action closure
        let addAction = UIAlertAction.init(title: "Add", style: .default) { (UIAlertAction) -> Void in
            
            let textFieldReminder = (alertVC.textFields?.first)! as UITextField
            
            let db = Firestore.firestore()
            var docRef: DocumentReference? = nil
            docRef = db.collection("Tasks").addDocument(data: [
                "name": textFieldReminder.text ?? "empty task",
                "done": false
            ]) { err in
                if let err = err {
                    print("Error adding document: \(err)")
                } else {
                    print("Document added with ID: \(docRef!.documentID)")
                }
            }
            
        }
    
        alertVC.addAction(addAction)
        present(alertVC, animated: true, completion: nil)
        
    }

再次构建并运行该应用程序，并在出现模拟器时尝试添加一些任务，以及将一些任务标记为已完成，最后通过删除一些任务来测试删除功能。您可以通过切换到Firebase数据库控制台并观察集合和文档来确认已实时更新存储的数据。

筛选和复合查询

到目前为止，您仅使用简单的查询，而没有任何特定的过滤功能。要创建更健壮的查询，可以使用whereField子句按特定值进行过滤：

docRef.whereField(“name”, isEqualTo: searchString)

您可以通过使用order(by: )和limit(to: ) ：）方法limit(to: )对查询数据进行order(by: )和limit(to: ) ，如下所示：

docRef.order(by: "name").limit(5)

在FirebaseDo应用程序中，您已经在基本查询中使用了limit 。在上面的代码片段中，您还利用了复合查询的另一个功能，即顺序和限制都链接在一起。您可以根据需要链接任意数量的查询，例如以下示例：

docRef
    .whereField(“name”, isEqualTo: searchString)
	.whereField(“done”, isEqualTo: false)
	.order(by: "name")
	.limit(5)

结论

在本教程中，您探索了Google的新MBaaS产品Cloud Firestore ，并在此过程中创建了一个简单的任务提醒应用程序，该应用程序演示了在云中持久，同步和查询数据的难易程度。您了解了与Firebase实时数据库相比Firestore的数据架构结构，以及如何实时读写数据以及更新和删除数据。您还学习了如何执行简单查询以及复合查询，以及如何过滤数据。

创建Cloud Firestore的目的是提供Firebase实时数据库的鲁棒性，而没有移动开发人员必须忍受的许多限制，尤其是在可伸缩性和查询方面。我们只是从头开始了解Firestore可以完成的工作，因此当然值得探索一些更高级的概念，例如使用查询游标对数据进行分页，管理索引和保护数据。

翻译自: https://code.tutsplus.com/tutorials/getting-started-with-cloud-firestore-for-ios--cms-30910

cunjie3951

关注

1
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
iOS版Cloud Firestore入门

多年来，移动编码人员一直在利用Google的移动后端即服务（MBaaS）平台Firebase实时数据库，从而帮助他们专注于为自己的应用程序构建功能，而不必担心后端基础结构和数据库。通过简化在云中存储和持久存储数据并确保身份验证和安全性，Firebase允许编码人员将精力集中在客户端上。去年，Google宣布了又一个后端数据库解决方案Cloud Firestore ，该解决方案是从头...
复制链接

扫一扫