rpc远程调用开发

2022-09-03 09:01:57

RPC即远程过程调用，适用于集群管理，集群节点就是RPCServer，而我们发起远程调用的web服务器就是RPCClient。所以是少数rpcClient（可能一个）对多个RPCServer（集群节点）。

rpc远程调用开发

今天讲述的RPC开发希望实现这样一个效果，在RPCClient上（也就是web服务器）执行一条shell命令，要求指定的远程主机执行指定的命令。命令的格式如下

rpc_client  rpc_server_address command

比如

./ssan_client 192.168.1.1 vmstat

希望这条命令的远程执行（在RPCServer上）的结果直接在直接输出到web服务器（RPCClient）。可以先看一个执行效果。

rpc远程调用开发

rpc远程调用开发

那么要做到这样一种效果，需要借助RPC框架，这里选择Apache Thrift, 并且使用C++语言，因为不能保证节点装什么PHP或JAVA环境，希望最后得到一个与环境无关的可执行文件。

这里首先可以看到Apache官方C++教程

https://thrift.apache.org/tutorial/cpp

下面开始实现rpc。

安装thrift环境

下载相关文件

yum -y groupinstall "Development Tools"

wget http://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz

wget http://ftp.gnu.org/gnu/bison/bison-2.5.1.tar.gz

wget http://ftp.gnu.org/gnu/automake/automake-1.14.tar.gz

wget http://www.mirrorservice.org/sites/dl.sourceforge.net/pub/sourceforge/b/bo/boost/boost/1.55.0/boost_1_55_0.tar.gz

git clone https://git-wip-us.apache.org/repos/asf/thrift.git

依次安装

tar zxf autoconf-2.69.tar.gz

cd autoconf-2.69

./configure --prefix=/usr

make

sudo make install

cd ..

tar xvf bison-2.5..tar.gz

cd bison-2.5.

./configure --prefix=/usr

make

make install

cd ..

tar zxf automake-1.14.tar.gz

cd automake-1.14

./configure --prefix=/usr

make

make install

cd ..

tar zxf boost_1_55_0.tar.gz

./bootstrap.sh

./configure

make

sudo make install

cd ../thrift

./bootstrap.sh

yum install openssl openssl-devel -y

./configure

make

make install

这里在安装thrift是yum安装了openssl-dev，是为了解决这个错误

rpc远程调用开发

安装完成之后

rpc远程调用开发

编写thrift文件

编写ssan.thrift文件

namespace cpp ssan

service SSANAgent {

  string run(:string command)

}

这里定义了一个接口方法run，接收一个string类型的参数，表示要执行的命令

使用thrift生成

thrift -r --gen cpp ssan.thrift

rpc远程调用开发

生成的源代码主要在SSANAgent.cpp中，可以翻看SSANAgent.h的定义。

rpc远程调用开发

可以看到，我们只需要写一个类继承这个类，重写run方法，在run方法里实现业务，并且可以看到它帮我们添加了一个参数，这个参数用来做什么呢？用来返回结果。Thrift连这事都帮你准备好了

编写rpcServer

thrift已经为我们生成了server的模板

cp SSANAgent_server.skeleton.cpp SSANServer.cpp

之前定义的接口方法也主要定义在这个类里

rpc远程调用开发

修改SSANServer.cpp文件

// This autogenerated skeleton file illustrates how to build a server.

// You should copy it to another filename to avoid overwriting it.

#include "SSANAgent.h"

#include <sstream>

#include <thrift/protocol/TBinaryProtocol.h>

#include <thrift/server/TSimpleServer.h>

#include <thrift/transport/TServerSocket.h>

#include <thrift/transport/TBufferTransports.h>

using namespace ::apache::thrift;

using namespace ::apache::thrift::protocol;

using namespace ::apache::thrift::transport;

using namespace ::apache::thrift::server;

using boost::shared_ptr;

using namespace  ::ssan;

using namespace std;

class SSANAgentHandler : virtual public SSANAgentIf {

 public:

  SSANAgentHandler() {

    // Your initialization goes here

  }

  void run(std::string& _return, const std::string& command) {

      std::ostringstream oss;

      FILE * pp = popen(command.c_str(),"r");

      if(pp){

          char buf[];

          while(fgets(buf,sizeof(buf),pp)){

              oss << buf;

          }

          pclose(pp);

      }

      else{

          oss << "Error: No such command : " << command;

      }

      _return = oss.str();

  }

};

int main(int argc, char **argv) {

  int port = ;

  shared_ptr<SSANAgentHandler> handler(new SSANAgentHandler());

  shared_ptr<TProcessor> processor(new SSANAgentProcessor(handler));

  shared_ptr<TServerTransport> serverTransport(new TServerSocket(port));

  shared_ptr<TTransportFactory> transportFactory(new TBufferedTransportFactory());

  shared_ptr<TProtocolFactory> protocolFactory(new TBinaryProtocolFactory());

  TSimpleServer server(processor, serverTransport, transportFactory, protocolFactory);

  cout << "Start SSAN Server ..." << endl;

  server.serve();

  cout << "Done" << endl;

  return ;

}

主要是在run方法里处理业务

生成rpcServer

先不借助Makefile，依次执行下面的命令编译

g++ -Wall -I/usr/local/include/thrift -c SSANAgent.cpp

g++ -Wall -I/usr/local/include/thrift -c SSANServer.cpp

g++ -Wall -I/usr/local/include/thrift -c ssan_constants.cpp

g++ -Wall -I/usr/local/include/thrift -c ssan_types.cpp

链接文件生成rpcServer，注意这里是动态链接

g++ -L/usr/local/lib *.o -o ssan_server –lthrift

链接后运行出现这个错误

rpc远程调用开发

这个文件其实已经存在了，不过在目录/usr/local/lib/下，而程序运行时再/usr/lib下搜索动态库文件，所以建立一个软链接

ln -s /usr/local/lib/libthrift-1.0.-dev.so /usr/lib/libthrift-1.0.-dev.so

rpc远程调用开发

再执行就成功启动了

rpc远程调用开发

编写rpcClient

rpcClient代码需要自己创建，头文件除了server部分，其他地方照抄就是了

#include "SSANAgent.h"

#include <ostream>

#include <sstream>

#include <thrift/protocol/TBinaryProtocol.h>

#include <thrift/transport/TServerSocket.h>

#include <thrift/transport/TBufferTransports.h>

#include <thrift/transport/TSocket.h>

using namespace ::apache::thrift;

using namespace ::apache::thrift::protocol;

using namespace ::apache::thrift::transport;

using namespace ssan;

using namespace std;

int main(int argc,char ** argv){

    if(argc < ){

        printf("Usage: %s ip-address command ...\n",argv[]);

        return -;

    }

    //  处理输入参数

    ostringstream command,address;

    address << argv[];

    if(argc > ){

        command << argv[];

        for(int i=;i < argc;i++){

            command << " " << argv[i];

        }

    }

    //  访问rpc server执行命令

    boost::shared_ptr<TSocket> socket(new TSocket(address.str().c_str(),));

    boost::shared_ptr<TTransport> transport(new TBufferedTransport(socket));

    boost::shared_ptr<TProtocol> protocol(new TBinaryProtocol(transport));

    SSANAgentClient client(protocol);

    string output;

    transport->open();

    client.run(output,command.str());

    cout << output << endl;

    transport->close();

    return ;

}

这里实例化了一个SSANAgentClient，它也定义在SSANAgent.h文件中，并且也继承自SSANAgentIf，所以它也有run方法，并且可以看到它的run方法做了两件事情，将命令发送给server执行，接收server返回的结果。

rpc远程调用开发

生成rpcClient

编译

g++ -Wall -I/usr/local/include/thrift -c SSANClient.cpp

链接

g++ -L/usr/local/lib SSANClient.o SSANAgent.o ssan_constants.o ssan_types.o -o ssan_client -lthrift

这部分基本没出什么大问题

编写Makefile编译

为了更方便的调试代码，还是需要写一个Makefile文件。时间有限，这个是临时写的，后面会继续完善

LIB_INC     =-L/usr/local/lib

SHARE_OBJ   =ssan_constants.o ssan_types.o

all : server client

server: SSANAgent.o SSANServer.o $(SHARE_OBJ)

    g++ $(LIB_INC) $^ -o ssan_server -lthrift

    @echo ssan_server created.

client: SSANAgent.o SSANClient.o $(SHARE_OBJ)

    g++ $(LIB_INC) $^ -o ssan_client -lthrift

    @echo ssan_client created.

#default:server client

clean :

    -rm *.o ssan_client ssan_server

    @echo cleanup done;

执行make，可以看到这样的效果

rpc远程调用开发

至此，RPCServer和RPCClient都已经生成了，下一步就是解决静态编译的问题。因为时间有限，这个将会在下一篇博客中PHP对RPC服务的调用封装中写出

上一篇：HashMap原理详解


下一篇：【C语言】指针数组