苹果iOS开发中的网络数据任务API：URLSession入门实战

news2024/9/22 10:04:11

本文首发于公众号“AntDream”，欢迎微信搜索“AntDream”或扫描文章底部二维码关注，和我一起每天进步一点点

URLSession 是 iOS 开发中的一个 API，用于执行网络数据任务，如 HTTP 请求、文件下载和上传等。URLSession 提供了一种高效的方式来处理网络请求，并支持多种任务类型，如数据任务、下载任务和上传任务。

以下是详细介绍如何在 iOS 开发中使用 URLSession：

1. URLSession的基本概念

URLSession 是一个容器对象，用于创建和管理与服务器之间的数据传输任务。URLSession 提供了默认的共享会话（共享实例），也可以配置自定义会话。

URLSessionConfiguration：配置 URLSession 的行为，比如缓存策略、超时时间等。
URLSessionTask：代表一个特定的请求任务，比如数据任务、下载任务和上传任务。

2. 创建一个简单的 GET 请求

下面是一个简单的 GET 请求示例，使用 URLSession 来获取数据：

import Foundation

// 创建 URL 对象
if let url = URL(string: "https://api.example.com/data") {
    
    // 创建默认的 URLSession
    let session = URLSession.shared
    
    // 创建 data task 对象
    let task = session.dataTask(with: url) { (data, response, error) in
        // 检查错误
        if let error = error {
            print("Error occurred: \(error)")
            return
        }
        
        // 检查响应和数据
        if let httpResponse = response as? HTTPURLResponse,
           httpResponse.statusCode == 200,
           let data = data {
            // 处理数据
            if let responseString = String(data: data, encoding: .utf8) {
                print("Response data: \(responseString)")
            }
        }
    }
    
    // 启动任务
    task.resume()
}

3. 创建 POST 请求

下面是一个 POST 请求示例，使用 URLSession 发送数据到服务器：

import Foundation

// 创建 URL 对象
if let url = URL(string: "https://api.example.com/post-data") {
    
    // 创建 URLRequest 对象
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    
    // 设置请求头（如果需要）
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    
    // 设置请求体
    let body = ["key": "value"]
    request.httpBody = try? JSONSerialization.data(withJSONObject: body, options: [])
    
    // 创建默认的 URLSession
    let session = URLSession.shared
    
    // 创建 data task 对象
    let task = session.dataTask(with: request) { (data, response, error) in
        // 检查错误
        if let error = error {
            print("Error occurred: \(error)")
            return
        }
        
        // 检查响应和数据
        if let httpResponse = response as? HTTPURLResponse,
           httpResponse.statusCode == 200,
           let data = data {
            // 处理数据
            if let responseString = String(data: data, encoding: .utf8) {
                print("Response data: \(responseString)")
            }
        }
    }
    
    // 启动任务
    task.resume()
}

4. 使用 URLSessionConfiguration 自定义会话

有时候你需要自定义会话，比如设置缓存策略、超时时间等：

import Foundation

// 创建 URLSessionConfiguration 对象
let configuration = URLSessionConfiguration.default
configuration.timeoutIntervalForRequest = 30.0
configuration.requestCachePolicy = .reloadIgnoringLocalCacheData

// 创建 URLSession 对象
let session = URLSession(configuration: configuration)

// 创建 URL 对象
if let url = URL(string: "https://api.example.com/data") {
    
    // 创建 data task 对象
    let task = session.dataTask(with: url) { (data, response, error) in
        // 处理响应
        
        // 启动任务
        task.resume()
    }
}

5. URLSessionDelegate 的使用

如果你需要处理认证、重定向等操作，可以通过实现 URLSessionDelegate 和相关的协议。

import Foundation

class MyURLSessionDelegate: NSObject, URLSessionDelegate {
    
    func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
        // 处理服务器认证挑战
        let credential = URLCredential(trust: challenge.protectionSpace.serverTrust!)
        completionHandler(.useCredential, credential)
    }
}

// 创建 URLSessionConfiguration 对象
let configuration = URLSessionConfiguration.default

// 创建 URLSession 对象，指定委托
let delegate = MyURLSessionDelegate()
let session = URLSession(configuration: configuration, delegate: delegate, delegateQueue: nil)