import SwiftJSONRPC
import PromiseKit
class UserService: JSONRPCService {
func vote(rating: Int) -> Promise<Int> {
return invoke("vote", params: ["rating": rating])
}
func create(name: String) -> Promise<UserModel> {
return invoke("create", params: ["name": name])
}
// And other JSON-RPC methods
}You can define as many services as you want depending on your requirements.
// Init JSON-RPC client
let url = URL(string: "http://example.com/rpc")!
let client = RPCClient(url: url)
// Init JSON-RPC service
let service = MyService(client: client)
// Perform request
service.vote(rating: 5)SwiftJSONRPC uses PromiseKit to return result.
service.vote(rating: 5)
.done { newRating in
// Handle result
}
.catch { error in
// Handle error
}SwiftJSONRPC provides built-in result serialization for Int, String, Bool types.
To serialize your custom type result from JSON you can implement Parcelable protocol.
protocol Parcelable {
init(params: [String: Any]) throws
}For example:
struct UserModel: Parcelable {
let id: String
let name: String
required init(params: [String: Any]) throws {
// Parse params to struct
// ...
}
}You can use libraries like ObjectMapper, MAPPER or other to adapt
Parcelableprotocol. Or you can adapt Swift 4Decodable.
After that use this struct as RPCService.Result generic parameter:
class UserService: JSONRPCService {
func create(name: String) -> Promise<UserModel> {
return invoke("create", params: ["name": name])
}
}service.create(name: "testuser").done { user in
print("User created with ID = \(user.id)")
}Using array of Parcelable objects is also supported:
extension UserService {
func allUsers() -> Promise<[UserModel]> {
return invoke("all_users")
}
}SwiftJSONRPC is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "SwiftJSONRPC"github "kolyasev/SwiftJSONRPC"dependencies: [
.package(url: "https://github.com/kolyasev/SwiftJSONRPC.git", .upToNextMajor(from: "0.7.0"))
]- Add support for notification request object without an "id" member.
- Remove
Parcelableprotocol and useDecodable.
Denis Kolyasev, kolyasev@gmail.com
SwiftJSONRPC is available under the MIT license. See the LICENSE file for more info.