https://github.com/chxuan/czrpc
A modern RPC framework based on protobuf
https://github.com/chxuan/czrpc
asio mondern protobuf rpc
Last synced: 9 months ago
JSON representation
A modern RPC framework based on protobuf
- Host: GitHub
- URL: https://github.com/chxuan/czrpc
- Owner: chxuan
- License: mit
- Created: 2017-01-23T09:23:42.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-07-30T12:45:30.000Z (over 8 years ago)
- Last Synced: 2025-06-11T07:51:49.478Z (10 months ago)
- Topics: asio, mondern, protobuf, rpc
- Language: C++
- Homepage: https://github.com/chxuan/czrpc
- Size: 206 KB
- Stars: 7
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
A modern RPC framework based on protobuf
===============================================
> czrpc是一个纯c++14开发，header-only，使用方便的RPC库。
![License][1]
## Getting started
首先下载czrpc：
git clone https://github.com/chxuan/czrpc.git
下载过后包含czrpc头文件即可使用。
## Tutorial
* **Simple server**
```cpp
#include
#include "czrpc/server/server.hpp"
#include "common.pb.h"
void echo(const czrpc::message::request_ptr& req, const czrpc::message::response_ptr& rsp)
{
rsp->set_response(req->message());
}
int main()
{
// 1.创建rpc服务器对象
czrpc::server::server server;
try
{
// 2.绑定echo函数
server.bind("echo", &echo);
// 3.配置监听参数并启动事件循环（非阻塞）
// 服务端默认启动一个ios线程和一个work线程
server.listen("0.0.0.0:50051").run();
}
catch (std::exception& e)
{
std::cout << e.what() << std::endl;
return 0;
}
std::cin.get();
return 0;
}
```
* **Simple client**
```cpp
#include
#include "czrpc/client/client.hpp"
#include "common.pb.h"
int main()
{
// 1.创建rpc客户端对象
czrpc::client::rpc_client client;
try
{
// 2.配置连接参数并启动事件循环（非阻塞）
client.connect("127.0.0.1:50051").run();
auto req = std::make_shared();
req->set_echo_str("Hello world");
req->set_echo_num(100);
// 3.同步调用echo函数
auto rsp = client.call("echo", req);
}
catch (std::exception& e)
{
std::cout << e.what() << std::endl;
return 0;
}
std::cin.get();
return 0;
}
```
更多例子请查看[samples][2]。
## 开发平台
* Ubuntu16.04 LTS gcc5.3.1
* MSVC2015
## 依赖性
* boost
* protobuf
* c++14
## DONE
* TCP长连接。
* 同步调用。
* 异步调用。
* 日志记录。
* worker线程池处理任务。
* 客户端超时处理。
* 支持原始数据发送。
* 支持发布/订阅模式。
* 数据重发功能。
## TODO
* 服务注册、发现。
* 支持HTTP/HTTPS协议。
## License
This software is licensed under the [MIT license][3]. © 2017 chxuan
[1]: http://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
[2]: https://github.com/chxuan/czrpc/tree/master/samples
[3]: https://github.com/chxuan/czrpc/blob/master/LICENSE