Swift开发WanAndroid客户端：接口调试翻车现场和抽象模型

2023-09-08 01:38:57

万安安卓（WanAndroid）是一个流行的安卓开发知识平台，拥有丰富的API接口。作为一名热衷于Swift的开发者，我决定创建一个WanAndroid客户端来探索其功能。在这个过程中，我遇到了一个接口调试翻车现场，促使我深入思考抽象模型的重要性。

调试翻车现场

一开始，我尝试调试一个获取个人积分的接口。代码很简单，但响应却出人意料：

let request = URLRequest(url: URL(string: "https://www.wanandroid.com/user/lg/userinfo/json")!)
URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        do {
            let json = try JSONDecoder().decode(UserInfoResponse.self, from: data)
            print(json.data.coinCount)
        } catch {
            print(error)
        }
    }
}.resume()

编译和运行后，控制台输出以下错误：

Error Domain=NSCocoaErrorDomain Code=3840 "Bad Request" UserInfo={NSLocalizedDescription=Bad Request}

我感到困惑，因为接口文档明确指出这是一个GET请求，我并没有发送任何参数。经过一番排查，我发现问题出在接口地址中：

let request = URLRequest(url: URL(string: "https://www.wanandroid.com/user/lg/userinfo/json")!)

正确的地址应该是：

let request = URLRequest(url: URL(string: "https://www.wanandroid.com/user/lg/userinfo/share"))

原来，我误将"json"写成了"share"。一个小小的拼写错误导致了我一个小时的调试时间。

抽象模型

这次翻车事故让我意识到抽象模型的重要性。抽象模型可以将数据从具体实现中分离出来，使代码更易于维护和扩展。

对于WanAndroid客户端，我创建了一个抽象模型来表示接口响应。这个模型定义了接口返回数据的类型和结构，并提供了访问这些数据的属性和方法：

struct UserInfoResponse: Decodable {
    let data: UserInfoData
}

struct UserInfoData: Decodable {
    let coinCount: Int
}

使用抽象模型后，我的接口请求代码变得更简洁：

let request = URLRequest(url: URL(string: "https://www.wanandroid.com/user/lg/userinfo/share")!)
URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        do {
            let json = try JSONDecoder().decode(UserInfoResponse.self, from: data)
            print(json.data.coinCount)
        } catch {
            print(error)
        }
    }
}.resume()