ufbycd/libpbrpc

libpbrpc is one of the smallest C++ Protobuf RPC library

C++MIT

libpbrpc

The aim is to build a minimal protobuf RPC lib using Google's Protocol Buffers.

libpbrpc is flexible as it is not bound to the http server, it's a lightweight middleware.

Dependencies

The only dependency is Protocol Buffers.

How to use

To use this lib is really simple. First define ServiceManager some where in your code.

ServiceManager srvMan;

Then the ServiceManager only provides two functions:

Register a service:
```
void regService(Service *service);
```
Handle the RPC message:
```
void handleRPC(const char *data, const size_t len, string &ret);
```
- data is the raw Protobuf binary,
- len is the length of the data,
- ret is the result generated, you can send it back directly. (Note: use ret.length() to get the correct length.)

How it's made

The over all design is really simple:

Protocol. The RPC protocol is defined in the "pbrpc.proto" file. The protocol took the JSON RPC 2.0 as a reference.
Services. The RPC server provides several Services, and each Service has some Methods.
Methods. Each Method should have input(params) and output(results).

Examples

Please take a look of my other repository pbrpc as a demo which implements a simple RPC server.

Limitations

One major limitation of this library is it's synchronous. It is possible to adapt task queue for asynchronous message handling.