Swift Academy · 课时

使用 async/await 调用 URLSession data(from:)

Q: 「使用 async/await 调用 URLSession data(from:)」这节课中我会学到什么？

使用现代 URLSession API 从 REST API 异步获取数据。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用现代 URLSession API 从 REST API 异步获取数据。

使用 async/await 调用 URLSession data(from:) 是 CoddyKit 上的免费 Swift Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

现代 URLSession API

Swift 5.5 及更高版本为 URLSession 提供了异步重载：data(from:delegate:) 会挂起执行，而不是使用回调。

let (data, response) = try await URLSession.shared.data(from: URL(string: "https://api.example.com/items")!)

完整的获取函数

将调用封装在异步抛出函数中，使其便于组合和测试。

func fetchItems() async throws -> [Item] {
  let url = URL(string: "https://api.example.com/items")!
  let (data, _) = try await URLSession.shared.data(from: url)
  return try JSONDecoder().decode([Item].self, from: data)
}

从 SwiftUI 调用

从 .task 修饰符中调用异步函数，或在按钮操作中使用 Task { } 调用。

struct ItemList: View {
  @State private var items: [Item] = []
  var body: some View {
    List(items, id: \.id) { Text($0.name) }
      .task { items = (try? await fetchItems()) ?? [] }
  }
}

用于自定义标头的 URLRequest

使用方法、标头和正文构建 URLRequest，然后将其传递给 data(for:)。

var request = URLRequest(url: URL(string: "https://api.example.com/login")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONEncoder().encode(LoginBody(email: "a@b.com", password: "pass"))
let (data, _) = try await URLSession.shared.data(for: request)

检查 HTTP 状态

将响应转换为 HTTPURLResponse，并在解码前验证状态代码。

let (data, response) = try await URLSession.shared.data(from: url)
guard let http = response as? HTTPURLResponse, http.statusCode == 200 else {
  throw URLError(.badServerResponse)
}
let item = try JSONDecoder().decode(Item.self, from: data)

取消操作

取消父级 Task 会自动取消正在执行的 URLSession 请求。

let task = Task {
  let items = try await fetchItems()
  // ...
}
task.cancel() // cancels URLSession request if in-flight

上传数据

使用 upload(for:from:) 异步 POST 二进制数据或表单上传内容。

var request = URLRequest(url: uploadURL)
request.httpMethod = "POST"
let (data, _) = try await URLSession.shared.upload(for: request, from: imageData)

下载文件

download(from:) 会将文件下载到磁盘上的临时 URL，而不是加载到内存中。

let (fileURL, _) = try await URLSession.shared.download(from: remoteURL)
let destURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0].appendingPathComponent("file.pdf")
try FileManager.default.moveItem(at: fileURL, to: destURL)

自定义 URLSession 配置

创建自定义会话，并设置超时时间、缓存策略和后台支持。

let config = URLSessionConfiguration.default
config.timeoutIntervalForRequest = 30
config.requestCachePolicy = .reloadIgnoringLocalCacheData
let session = URLSession(configuration: config)

使用 async bytes 进行流式处理

使用 bytes(from:) 逐行流式读取响应数据，而无需缓存整个响应。

let (stream, _) = try await URLSession.shared.bytes(from: url)
for try await line in stream.lines {
  print(line)
}

使用 URLProtocol 进行测试

通过继承 URLProtocol 并将其注入自定义会话配置，在测试中模拟网络响应。

class MockURLProtocol: URLProtocol {
  static var requestHandler: ((URLRequest) throws -> (HTTPURLResponse, Data))?
  // override canInit, startLoading, stopLoading
}

快速检查

哪个异步 URLSession 方法会将 URL 响应直接下载到磁盘上的临时文件？

课程回顾

使用 URLSession.shared.data(from:) 发起异步 GET 请求，使用带自定义 URLRequest 的 data(for:) 发起 POST/PUT 请求，使用 download(from:) 下载文件，使用 bytes(from:) 进行流式处理。在解码前始终检查 HTTP 状态代码。

常见问题解答

「使用 async/await 调用 URLSession data(from:)」课时是免费的吗？

是的 — 「使用 async/await 调用 URLSession data(from:)」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「使用 async/await 调用 URLSession data(from:)」这节课中我会学到什么？

使用现代 URLSession API 从 REST API 异步获取数据。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「使用 async/await 调用 URLSession data(from:)」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

使用 async/await 调用 URLSession data(from:)
Codable：编码与解码 JSON
错误处理与 HTTP 状态码
重试逻辑与后台 URLSession

← 返回 Swift Academy