当时brpc还未开源。后于同年百度对外开源了brpc。在百度内部brpc叫baidu-rpc。后来由于进入了Apache基金会进行孵化,brpc的含义做了调整,改成了better RPC。这倒也无伤大雅,众所周知,百度和腾讯是国内鲜有的C 大厂,而brpc也算是笔者见过C 开源世界里比较优秀且实用的框架了。
好了,关于brpc的溢美之词暂且按下不表,我们言归正传,赶快上手吧!另外brpc支持Mac和Linux环境。本文是基于某云的Centos实机操作纪实!brpc的版本是0.9.7。
github
brpc的github地址如下:
https://github.com/apache/incubator-brpc
我们也可以直接在本地克隆:
代码语言:javascript复制git clone https://github.com/apache/incubator-brpc.git
安装编译依赖
cmake
我习惯用cmake编译一些第三方库,这里我们安装一下cmake。云主机默认安装的cmake可能是cmake 2的版本。但由于brpc其中一个依赖gflags需要cmake3,所以我们先安装一下cmake3:
代码语言:javascript复制yum install cmake3
第三方库
- gflags
- leveldb
- protobuf (2或3均可)
- openssl
上面是brpc编译所依赖的几个第三方库,基本上在github上都能找到。除openssl外都支持cmake编译。
- https://github.com/gflags/gflags
- https://github.com/google/leveldb
- https://github.com/protocolbuffers/protobuf
- https://github.com/openssl/openssl
其中gflags、leveldb默认cmake的编译方式会编译成静态库,导致最终编译brpc时会报错:
代码语言:javascript复制/usr/local/lib/libgflags.a(gflags.cc.o): relocation R_X86_64_32S against `.rodata' can not be used
所以请注意我们需要把gflags、leveldb都编译成动态库。在下载完源码后,cd到对应目录,执行如下操作:
代码语言:javascript复制mkdir bld
cd bld
cmake3 -DBUILD_SHARED_LIBS=ON ..
make -j 8
sudo make install
也就是给cmake加上一个-DBUILD_SHARED_LIBS=ON参数。gflags、leveldb可以安装上述流程来编译。
另外关于openssl和protobuf,参照编译文档编译即可。没有什么坑点。
唯一需要提醒的是,如果是autotool编译安装的方式(要执行./configure的),最好不要自作聪明加--prefix参数来修改默认的库安装路径。因为如果安装到自定义路径下,后续其他编译如果依赖到这个库,都需要修改编译时的库检索路径,简直自找麻烦!
编译brpc
好了,准备工作做完,终于要编译brpc了。cd到brpc的下载目录中。
代码语言:javascript复制mkdir bld
cd bld
cmake3 ..
make
make install
这里我make的时候没加j8参数来开启并行编译。因为我机器上实测并行编译会编译失败,串行编译无问题。当然缺点就是编译比较慢了。我建议是在云主机上开一个tmux,在tmux会话里开始make,然后你就可以忙别的去了。
漫长等待之后,最终会编译成功。
编译example
brpc编译完成,基本上你就可以使用了。但是brpc自带的例子没有编译。我们可以编译一下,启动看看。在example目录下面。
需要提醒的是example的代码用cmake编译,可能会失败(反正我是遇到了)。没关系,我们改成普通make编译的方式。
首先要先生成config.mk,回到brpc的顶级目录:
代码语言:javascript复制sh config_brpc.sh --headers=/usr/local/include --libs=/usr/local/lib
headers和libs指定第三方库的头文件和库所在路径。这也就是我为什么说不要随意修改库的安装路径的原因了,库装在不同位置着实不便。尽量集中到一起,不在一起的时候,可以通过建立软连接,弄到一起。
生成config.mk之后,就可以去example目录编译了,比如我们编译echo_c 。
代码语言:javascript复制cd example/echo_c
make
运行echo_c
上面编译完成之后会有echo_server和echo_client的可执行文件。
我们启动server:
代码语言:javascript复制nohup ./echo_server &
echo_client 其实我一般不用。echo_client是默认的baidu_std协议。实际工作中多有使用,但作为demo测试,其实不用。因为brpc有个强大的特性是支持单端口多协议,并且号称支持协议最多的RPC框架。所以我们可以用HTTP请求的方式来请求它!
代码语言:javascript复制curl -d '{"message":"hello world"}' 127.0.0.1:8000/EchoService/Echo
端口号后面的路径和proto定义有关。查看echo.proto的定义:
代码语言:javascript复制service EchoService {
rpc Echo(EchoRequest) returns (EchoResponse);
};
好了。后面我们就可以通过调试修改这个echo_server来学习了解brpc啦。
我知道你在看哦