61 lines
1.5 KiB
Swift
61 lines
1.5 KiB
Swift
//
|
||
// APIEnvelope.swift
|
||
// suixinkan
|
||
//
|
||
|
||
import Foundation
|
||
|
||
/// 后端统一响应包裹实体，承载业务 code、msg 和真实 data。
|
||
struct APIEnvelope<T: Decodable>: Decodable {
|
||
let data: T?
|
||
let code: Int
|
||
let msg: String?
|
||
|
||
/// 判断后端业务 code 是否代表成功。
|
||
var isSuccess: Bool {
|
||
code == 100000
|
||
}
|
||
|
||
/// 后端统一 Envelope 的 JSON 字段映射。
|
||
enum CodingKeys: String, CodingKey {
|
||
case data
|
||
case code
|
||
case msg
|
||
}
|
||
|
||
/// 自定义解码逻辑，兼容成功响应、空 data 和 EmptyPayload。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
code = try container.decodeIfPresent(Int.self, forKey: .code) ?? 0
|
||
msg = try container.decodeIfPresent(String.self, forKey: .msg)
|
||
|
||
guard code == 100000 else {
|
||
data = nil
|
||
return
|
||
}
|
||
|
||
guard container.contains(.data), try !container.decodeNil(forKey: .data) else {
|
||
data = nil
|
||
return
|
||
}
|
||
|
||
if T.self == EmptyPayload.self {
|
||
data = EmptyPayload() as? T
|
||
return
|
||
}
|
||
|
||
data = try container.decode(T.self, forKey: .data)
|
||
}
|
||
}
|
||
|
||
/// 空响应实体，用于表示接口成功但不返回业务 data。
|
||
struct EmptyPayload: Codable {}
|
||
|
||
/// 错误响应实体，用于从 HTTP 错误体中提取服务端文案。
|
||
struct ErrorEnvelope: Decodable {
|
||
let code: Int?
|
||
let msg: String?
|
||
let message: String?
|
||
let error: String?
|
||
}
|