Class RpcHandler RpcHandler

The entry point for RPCs, both requesting them via make(_:data:) and providing them via provide(_:listener:)

Methods

class func make(_ rpcName: String, data: Any) -> RpcResult

Create a remote procedure call. This requires a rpc name for routing, a JSON serializable object for any associated arguments and a callback to notify you with the rpc result or potential error.

Show example...

let result = client.rpc.make("increment", 1)

class func provide(_ rpcName: String, rpcRequestedListener: RpcRequestedListener) -> Void

Registers a RpcRequestedListener as a RPC provider. If another connected client calls make(name, data) the request will be routed to the supplied listener.

Only one listener can be registered for a RPC at a time.

Please note: Deepstream tries to deliver data in its original format. Data passed to make(name, data) as a String will arrive as a String, numbers or implicitly JSON serialized objects will arrive in their respective format as well.

Show example...

final class IncrementRpcRequestedListener : NSObject, RpcRequestedListener {
    func onRPCRequested(_ rpcName: String!, data: Any!, response: RpcResponse!) {
        response.send((Int) data + 1)
    }
}
client.rpc.provide("increment", rpcRequestedListener: IncrementRpcRequestedListener())

class func unprovide(_ rpcName: String) -> Void

Unregister a RpcRequestedListener registered via Rpc provide(_:listener:)