【亲测免费】 Swift Request 项目技术文档

安装指南

使用 Swift Package Manager 安装

swift-request 可以通过 Swift Package Manager 进行安装。

在 Xcode 11 中，按照以下步骤操作：

1. 打开 Xcode，选择 File > Swift Packages > Add Package Dependency...。
2. 在弹出的窗口中，粘贴以下 URL：https://github.com/carson-katri/swift-request。
3. 点击 Next，按照提示完成安装。

安装完成后，只需在代码中 import Request，即可开始使用。

项目使用说明

快速开始

在 swift-request 中，你可以使用声明式的方式来构建和执行网络请求。以下是一个简单的示例：

Request {
    Url("https://jsonplaceholder.typicode.com/todos")
    Header.Accept(.json)
}
.onData { data in
    // 处理数据
}
.onError { error in
    // 处理错误
}
.call()

构建请求

swift-request 提供了多种工具来构建请求，包括：

• Url：设置请求的 URL，每个请求中必须包含一个 Url。
• Method：设置请求方法，默认为 .get。
• Header：设置 HTTP 头字段。
• Query：设置查询字符串。
• Body：设置请求体。
• Timeout：设置请求或资源的超时时间。
• RequestParam：添加自定义参数。

处理响应

你可以使用 .onData、.onString、.onJson 和 .onError 来处理不同的响应类型。这些方法可以链式调用，以便处理多种响应类型。

使用 Combine

Request 和 RequestGroup 都遵循 Publisher 协议，因此你可以像处理其他 Combine 发布者一样处理它们。例如：

Request {
    Url("https://jsonplaceholder.typicode.com/todos")
}
.sink(receiveCompletion: { completion in
    // 处理完成事件
}, receiveValue: { value in
    // 处理接收到的值
})

项目 API 使用文档

基本请求构建

Request {
    Url("https://example.com")
    Method(.post)
    Header.ContentType(.json)
    Body(Json([
        "title": "foo",
        "body": "bar",
        "userId": 1
    ]).stringified)
}
.onData { data in
    // 处理数据
}
.onError { error in
    // 处理错误
}
.call()

使用 Codable

你可以使用 Codable 来解析响应数据。例如：

struct Todo: Codable {
    let title: String
    let completed: Bool
    let id: Int
    let userId: Int
}

AnyRequest<[Todo]> {
    Url("https://jsonplaceholder.typicode.com/todos")
}
.onObject { todos in
    // 处理解析后的对象
}

使用 Combine

Request 提供了多种便捷的 Publisher 来简化解码过程，例如 objectPublisher：

AnyRequest<[Todo]> {
    Url("https://jsonplaceholder.typicode.com/todos")
}
.objectPublisher
.sink(receiveCompletion: { completion in
    // 处理完成事件
}, receiveValue: { todos in
    // 处理接收到的值
})

项目安装方式

使用 Swift Package Manager

在 Xcode 11 中，按照以下步骤操作：

1. 打开 Xcode，选择 File > Swift Packages > Add Package Dependency...。
2. 在弹出的窗口中，粘贴以下 URL：https://github.com/carson-katri/swift-request。
3. 点击 Next，按照提示完成安装。

安装完成后，只需在代码中 import Request，即可开始使用。