iOS Token 刷新处理教程
在 iOS 应用开发中，处理 token 刷新是确保用户能够持续访问安全资源的关键。本文将指导你如何实现 token 刷新处理。我们将详细解说整个流程、每一步的实现以及相关代码示例。
流程概览
在实现 token 刷新的过程中，我们需要遵循以下步骤，下面的表格总结了这些步骤：
| 步骤 | 描述 |
|---------------|-------------------------------------|
| 1. 用户认证 | 用户通过用户名和密码进行认证。 |
| 2. 获取 Token | 服务器返回 access token 和 refresh token。 |
| 3. 使用 Token | 在api请求中使用 access token。 |
| 4. 检查 Token | 检查 access token 是否过期。 |
| 5. 刷新 Token | 如果 token 过期，通过 refresh token 刷新。 |
| 6. 更新 Token | 更新 local storage 中保存的 token。 |
步骤详解
步骤 1: 用户认证
在用户登录时，你需要收集用户的凭据（例如用户名和密码），并将其发送到服务端进行认证。
func login(username: String, password: String) {
let url = URL(string: "
var request = URLRequest(url: url)
request.httpMethod = "POST"
let parameters: [String: Any] = ["username": username, "password": password]
request.httpBody = try? JSONSerialization.data(withJSONObject: parameters)
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
// 处理返回结果
}
task.resume()
}
步骤 2: 获取 Token
成功认证后，服务器将返回一个包含 access token 和 refresh token 的响应。
// 假设我们得到的 JSON 响应是这样的：
// { "access_token": "abc123", "refresh_token": "xyz456" }
func handleLoginResponse(data: Data) {
do {
if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any] {
let accessToken = json["access_token"] as? String
let refreshToken = json["refresh_token"] as? String
// 保存 token
saveTokens(accessToken: accessToken, refreshToken: refreshToken)
}
} catch {
print("JSON 解析失败: \(error)")
}
}
func saveTokens(accessToken: String?, refreshToken: String?) {
// 将 token 保存到 UserDefaults 中
UserDefaults.standard.set(accessToken, forKey: "accessToken")
UserDefaults.standard.set(refreshToken, forKey: "refreshToken")
}
步骤 3: 使用 Token
在 API 请求中使用 access token。确保在请求头中包含 token。
func fetchData() {
guard let accessToken = UserDefaults.standard.string(forKey: "accessToken") else { return }
let url = URL(string: "
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer \(accessToken)", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
// 处理返回结果
}
task.resume()
}
步骤 4: 检查 Token
检查 access token 是否过期。可以根据自己的规则来判断，例如设定一个过期的时间点。
func isAccessTokenExpired() -> Bool {
// 假设 token 有效期是 60 分钟
let expirationDate = Date(timeIntervalSinceNow: -60 * 60) // 1小时前
return Date() > expirationDate
}
步骤 5: 刷新 Token
如果 Access token 过期，则需要使用 Refresh token 刷新。
func refreshAccessToken() {
guard let refreshToken = UserDefaults.standard.string(forKey: "refreshToken") else { return }
let url = URL(string: "
var request = URLRequest(url: url)
request.httpMethod = "POST"
let parameters: [String: Any] = ["refresh_token": refreshToken]
request.httpBody = try? JSONSerialization.data(withJSONObject: parameters)
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
// 处理响应
handleRefreshTokenResponse(data: data)
}
task.resume()
}
func handleRefreshTokenResponse(data: Data?) {
guard let data = data else { return }
do {
if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any] {
let newAccessToken = json["access_token"] as? String
// 更新 Access token
UserDefaults.standard.set(newAccessToken, forKey: "accessToken")
}
} catch {
print("刷新 Token 失败: \(error)")
}
}
步骤 6: 更新 Token
当成功刷新 token 后，确保将新的 access token 存储在本地，以便后续使用。
数据流分布图
pie
title Token 流程分布
"用户认证": 10
"获取 Token": 25
"使用 Token": 20
"检查 Token": 15
"刷新 Token": 20
"更新 Token": 10
总结
在本文中，我们详细介绍了 iOS 中 token 刷新的处理流程，包括用户认证、获取、使用、检查、刷新和更新 token 的每个步骤，以及相关代码的实现。通过这些步骤，你可以确保用户在应用程序中的持续身份验证，从而提高用户体验和安全性。希望这些信息能够帮助你在 iOS 应用开发中顺利集成 token 刷新机制。
