Swift 中的完成处理程序是什么?

swiftserver side programmingprogramming更新于 2025/10/8 2:52:17

在 Swift 中，完成处理程序是一段代码块，用于执行和处理任务的完成状态。例如，完成处理程序在使用 URLSession 类的网络请求中非常常用。基本上，完成处理程序作为函数参数传递，并在任务完成时调用。它不会影响任务是否成功完成。

您可以使用完成处理程序在 iOS 应用程序中执行不同的操作。实现完成处理程序有一些常见的做法，例如在 FileManager 操作中清理未使用的资源后返回状态、在语句块内更新多个用户界面以及完成后返回等。

在本文中，您将看到以下示例，了解如何有效地使用完成处理程序 -

使用 URLSession 类获取数据，并在从 URL 获取响应后返回完成处理程序。
过滤数组，并在成功过滤数组后返回完成处理程序。
使用电子邮件和密码执行用户身份验证的网络请求。从服务器获取响应后，返回完成处理程序。

让我们看看 Swift 中不同的完成处理程序示例 -

使用 URLSession() 类获取数据

这是一个以完成处理程序作为参数的函数示例 -

示例

func fetchData(_ completion: @escaping (_ success: Bool, _ data: Data?) -> Void) {

    // 构建 URL
    let url = URL(string: "sample_url")!
    
    // 执行网络请求
   let task = URLSession.shared.dataTask(with: url) { data, response, error in
      if let data = data {
         // 成功，使用数据调用完成处理程序
         completion(true, data)
      } else {
         // 失败，使用 nil 数据调用完成处理程序
         completion(false, nil)
      }
   }
   task.resume()
}

下面是如何使用上述函数的示例 -

self.fetchData { success, data in
   if success {        
      guard let dataObject = data else { return }
        
      // 解析数据并更新 UI
      let json = try? JSONSerialization.jsonObject(with: dataObject)
      print(json!)        
   } else {
      // 显示错误消息
      print("Network request failed")
   }
}

本例中的 fetchData() 函数接受完成处理程序作为参数。成功布尔值和网络调用传递的数据是发送给完成处理程序的两个参数。此函数发出网络请求;无论成功或失败，它都会调用完成处理程序并传递相关的成功值和数据值。

过滤数组

另一个示例是针对需要时间的操作，例如过滤数组

示例

func filterArray(_ array: [Int], completion: @escaping (_ filteredArray: [Int]) -> Void) {
   DispatchQueue.global().async {
      let filteredArray = array.filter { $0 > 5 }
      DispatchQueue.main.async {
         completion(filteredArray)
      }
   }
}

下面是如何使用上述函数的示例 -

let originalArray: [Int] = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
filterArray(originalArray) { filteredArray in
   print("Original array: \(originalArray)")
   print("Filtered array: \(filteredArray)")
}

输出

Original array: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Filtered array: [6, 7, 8, 9, 10]

用户身份验证流程

以下是一个使用完成处理程序来处理用户身份验证结果的函数示例

示例

func login(username: String, password: String, completion: @escaping (_ success: Bool, _ error: Error?) -> Void) {
	// 执行登录流程
   Auth.auth().signIn(withEmail: username, password: password) { authResult, error in
      if let error = error {
         // 登录失败，调用完成处理程序并显示错误
         completion(false, error)
      } else {
         // 登录成功，调用成功完成处理程序
         completion(true, nil)
      }
   }
}

以下是如何使用此功能的示例

login(username: "user@example.com", password: "password") { success, error in
    if success {
        // 显示主屏幕
    } else {
        // 显示错误消息
        print(error)
    }
}

此函数使用给定的邮箱地址和密码执行用户登录任务。登录过程的结果将被调用完成处理程序。如果登录过程成功，则调用完成处理程序并返回成功信息;否则，传递错误消息。

在代码中使用完成处理程序时，应记住以下几点: