RCF—用于C++的进程间通讯(1)

导言
RCFRemote Call Framework,远程调用框架)是一个C++的框架。这个框架用来为实现C++程序进程间调用提供一个简单和一致(consistent)的方法。这个框架基于强类型的C/S接口概念,类似于用户所熟悉的CORBADCOM这样的中间件。然而,因为RCF只应用于C++,所以可以充分利用C++特性,从而提供一个以相对简单和整洁的方式实现进程间调用。
这是RCF库的第二个版本,第一个版本也可以在CodeProject上找到。
中国有句老话,一例胜千言(我咋没听过?)。所以将以一系列的例子来组织这篇文章,这些例子会覆盖RCF的特性。
基础
我们从一个标准的echo服务器和客户端的例子来开始,这样的例子可以在几乎所有的网络和IPC示例中见到。我们暴露(expose)然后调用一个函数,这个函数接受一个字符串,并且返回一个相同的字符串,使用RCF,服务器端的代码是这样的:
# include  RCF Idl.hpp
#include 
RCF RcfServer.hpp
#include 
RCF TcpEndpoint.hpp

RCF_BEGIN(I_Echo, 
I_Echo )
    RCF_METHOD_R1(std::
string , echo,  const  std:: string   & )
RCF_END(I_Echo)

class  Echo
{
public:
    std::
string echo(const std::string &s)
    
{
        
return s;
    }

}
;

int  main()
{
    Echo echo;
    RCF::RcfServer server(RCF::TcpEndpoint(
50001));
    server.bind
<I_Echo>(echo);
    server.startInThisThread();
    
return 0;
}


... 客户端代码如下:
#include  < RCF / Idl.hpp >

#include 
< RCF / TcpEndpoint.hpp >


RCF_BEGIN(I_Echo, 
" I_Echo " )
    RCF_METHOD_R1(std::
string , echo,  const  std:: string   & )
RCF_END(I_Echo)

int  main()
{
    RcfClient
<I_Echo> echoClient(RCF::TcpEndpoint("localhost"50001));
    std::
string s = echoClient.echo(RCF::Twoway, "what's up");
    
return 0;
}

I_Echo是用RCF_BEGIN/RCF_METHOD/RCF_END宏进行定义的一个接口。这些接口对应于CORBA里的IDL定义,但是在这里,接口定义是被放在C++的源代码里,所以并不需要另外的编译步骤。服务器端和客户端代码简单地包含这些接口,然后和其他的代码一起编译。
客户端桩(stub)中的参数RCF::Twoway用来告诉RCF采用一个two-way方式的客户端调用,这种方式下,客户端发送一个请求并且等待响应,如果在一定时间内没有收到响应(这个时间是可配的),将会抛出一个异常。另一个选项是RCF::Oneway,这种方式下,如果服务端没有发送响应,客户端调用桩会立即把控制返回给用户。
在客户端调用中,把这个双向实参(directional argument)作为第一个参数,可以在代码里清楚地知道远程调用是采用哪种方式。一般说来,远程调用都会被规划为看起来像本地调用一样(正统的RPC观点),但在我看来,透明更重要一些。然而,如果你愿意,通过不传递那个双向实参(directional argument)从而以RPC风格来进行一个远程调用(这时调用是以two-way方式进行的)。
客户端桩时没有进行任何同步操作,所以应该在同一个线程里进行访问。服务端尽管是支持多线程,但在上面的例子中,还是以一个线程来运行的。RcfServer::startInThisThread()劫持了调用线程,并把它变为一个工作线程。
可以通过调用RcfServer::start(false)然后重复调用RcfServer::cycle()来达到相同的效果。在多线程版本中,也可以调用RcfServer::start(),然后驱动服务器的现场将会被自动创建。多线程版本需要Boost.Threads库,并且要定义RCF_USE_BOOST_THREADS预处理符号。
我们也可以用UDP协议来重写上面的客户端和服务器端。这次我们让服务器端和客户端程序运行在一个进程的不同线程里。
#include  < RCF / Idl.hpp >
#include 
< RCF / RcfServer.hpp >
#include 
< RCF / UdpEndpoint.hpp >

#ifndef RCF_USE_BOOST_THREADS
#error  Need to build with RCF_USE_BOOST_THREADS
#endif

RCF_BEGIN(I_Echo, 
" I_Echo " )
    RCF_METHOD_R1(std::
string , echo,  const  std:: string   & )
RCF_END(I_Echo)

class  Echo
{
public:
    std::
string echo(const std::string &s)
    
{
        
return s;
    }

}
;

int  main()
{
    Echo echo;
    RCF::RcfServer server(RCF::UdpEndpoint(
50001));
    server.bind
<I_Echo>(echo);
    server.start();
    RcfClient
<I_Echo> echoClient(RCF::UdpEndpoint("127.0.0.1"50001));
    std::
string s = echoClient.echo(RCF::Twoway, "what's up");
    server.stop(); 
// would happen anyway as server object goes out of scope

    
return 0;
}

和TCP不同的是UDP是无状态的。数据包不能保证是发送时的顺序被接收到,也不能保证所有的发送的数据包都会被接收到。在像上面的例子的本地连接中,使用two-way方式一般来说是能够正常工作的,因为这些数据包并没有从变幻莫测的真实网络中传输。通常,这种情况应该用one-way方式。
接口
接口定义宏的功能和之前一个版本的RCF是完全一致的。RCF_BEGIN()宏用给定的名字和运行时描述来开始一个接口的定义,RCF_END()宏来结束接口定义。在两者中间,用RCF_METHOD_xx()宏可以定义一共25个接口的成员方法。
RCF_METHOD_xx()宏的后两个字母表示参数的个数和返回类型是否是一个void。比如说,RCF_METHOD_V3用来定义一个三个参数返回值类型为void的方法。
使用这些宏定义了RcfClient<type>类,这里的type是这个接口的名字。这个类直接用作客户端的客户端桩,间接地用作服务器端的服务桩。RCF的接口也可以定义在任意的名字空间内:
namespace  A
{
    
namespace B
    
{
        RCF_BEGIN(I_X, 
"I_X")
        RCF_METHOD_V0(
void, func1)
        RCF_METHOD_R5(
int, func2, intintintintint)
        RCF_METHOD_R0(std::auto_ptr
<std::string>, func3)
        RCF_METHOD_V2(
void, func4,
           
const boost::shared_ptr<std::string> &,
           boost::shared_ptr
<std::string> &)
        
// ..

        RCF_END(I_X)
    }

}


int  main()
{
    A::B::RcfClient
<A::B::I_X> client;
    
// or

    A::B::I_X::RcfClient client;
    
// ...

}

服务器绑定
在服务器端,接口需要绑定到一个具体的实现上。通过RcfServer::bind()方法来实现这个绑定。根据内存管理方式的不同,绑定有几种变化。下面的几种调用都可以实现一模一样的事情:把一个Echo对象绑定到I_Echo接口上。
{
    
// bind to an object...

    Echo echo;
    server.bind
<I_Echo>(echo);

    
// or to a std::auto_ptr<>...

    std::auto_ptr
<Echo> echoAutoPtr(new Echo());
    server.bind
<I_Echo>(echoAutoPtr);

    
// or to a boost::shared_ptr<>...

    boost::shared_ptr
<Echo> echoPtr(new Echo());
    server.bind
<I_Echo>(echoPtr);

    
// or to a boost::weak_ptr<>...

    boost::weak_ptr
<Echo> echoWeakPtr(echoPtr);
    server.bind
<I_Echo>(echoWeakPtr);
}


默认情况下,客户端可以通过接口的名字来使用绑定。服务器端可以通过同一个接口暴露(expose)多个服务器端对象,但是在这种情况下,需要明确指定每个对象的名字:
{
    RcfServer server(endpoint);

    
// bind first object

    Echo echo1;
    server.bind
<I_Echo>(echo1, "Echo1");

    
// bind second object

    Echo echo2;
    server.bind
<I_Echo>(echo2, "Echo2");

    server.start();

    RcfClient
<I_Echo> echoClient(endpoint);

    echoClient.getClientStub().setServerBindingName(
"Echo1");
    std::cout 
<< echoClient.echo("this was echoed by the echo1 object");

    echoClient.getClientStub().setServerBindingName(
"Echo2");
    std::cout 
<< echoClient.echo("this was echoed by the echo2 object");
}

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值