MRestClient
示例
MRestClient 是用 swift 编写的 HTTP 客户端实现库,这是一个小巧、轻量且易于使用的用于 HTTP 通信的库。这个库的目的是通过 swift codable 对象减少调用 REST-API 的努力。这是 swift 对象的通用实现,用于请求和响应体,因此您可以直接与 codable 对象交互,无需担心 JSON 转换等。
要运行示例项目,首先克隆仓库,然后从示例目录中运行 pod install
。
要求
- Xcode 11.
- Swift 5.
- iOS 11 或更高版本。
安装
MRestClient 可通过 CocoaPods 获取。要安装它,只需将以下行添加到 Podfile 中
pod 'MRestClient'
用法
提供了HTTP方法 GET , POST , PUT & DELETE ,以下是使用示例。
以下是我们用于请求和响应的可编码类,以下我们所使用的是用于演示的这些-Demo API。
class Employee: Codable{
var profile_image: String
var employee_name: String
var employee_salary: String
var id: String
var employee_age: String
}
class Employees: Codable {
var data: [Employee]
var status: String
init(data: [Employee], status: String) {
self.data = data
self.status = status
}
}
GET URL = http://dummy.restapiexample.com/api/v1/employees
响应 JSON = Employee 对象
let base_url = "http://dummy.restapiexample.com"
let uri = "/api/v1/employees"
let rest_client = MRestClient<None, Employees>(base_url: base_url)
rest_client.get(uri: uri, sucess: {(data, response) in
// Do stuff on Success data is object of Empoyees class
}, fail: {(error) in
// Fail callback
})
POST
示例API描述可在此找到 链接
let uri = "/api/v1/create"
// First Generic is the type of object used in request body second used for Response body
let rest_Client = MRestClient<EmpDTO, EmployeeWithStatus>(base_url: base_url)
rest_Client.post(url: uri, requestData: new_employee, sucess: {(data, response)in
// Do Stuff on sucess data is object of EmployeeWithStatus
}, fail: {(error) in
//Request has fail see error
})
对于 PUT & DELETE ,请参阅示例应用程序
贡献
如果您想改进示例或以某种方式做出贡献,请通过创建pull请求来进行。我们欢迎贡献。
许可协议
MRestClient 在MIT许可协议下使用。有关更多信息,请参阅LICENSE文件。