Network.MessagePack.RPC.Client

Backend-free MessagePack RPC Client.

Config

data Config

Configuration for MessagePack RPC.

Constructors

Config

Fields

• notificationHandler :: NotificationHandler
• requestHandler :: RequestHandler
• logger :: Logger
• exceptionHandlers :: [Handler IO ()]

  Handles an exception thrown from the receiver thread, which is the only thread to receive Messages via Backend. Until exiting from the block of withClient, the receiver thread indefinitely waits for frames via backendRecv.

• formatter :: Formatter
• waitRequestHandler :: Bool

type NotificationHandler = Client -> MethodName -> [Object] -> IO ()

Notification handler. The 3rd argument is response objects.

type RequestHandler = Client -> MessageId -> MethodName -> [Object] -> IO ()

Notification handler. The 2nd argument is message id to be used for replying. The 3rd argument is response objects.

type Logger = String -> IO ()

Logger type. Should print out the message passed as a first argument somewhere.

type Formatter = Message -> String

Convert Message into a String to print out by Logger

defaultConfig :: Config

The default configuration. formatter is show. Others do nothing.

Backend

data Backend

Backend IO functions. Any receiving / sending actions are performed by calling these functions.

Constructors

Backend

Fields

• backendSend :: ByteString -> IO ()

  Sending

• backendRecv :: IO ByteString

  Receiving

• backendClose :: IO ()

  Closing

Client

data Client

A client data type for MessagePack RPC.

withClient :: Config -> Backend -> (Client -> IO a) -> IO a

Executing the action in the 3rd argument with a Client.

shutdown :: Client -> IO ()

This function cleans up the internal states including the termination of internal threads.

Call and reply

type Result = Either Object Object

Result type of a RPC call. Described as "error" and "result" of "Response Message" in the spec of MessagePack RPC.

call :: Client -> MethodName -> [Object] -> IO Result

Calling RPC.

reply :: Client -> MessageId -> Result -> IO ()

Replying RPC. This should be used in RequestHandler.