一:打印机
1、Slice定义:
interface Printer
{
void printString(string s);
};
我们的Slice定义含有一个接口,叫作Printer。目前,我们的接口非常
简单,只提供了一个操作,叫作printString。该定义保存为Printer.ice
2、要创建我们的C++应用,第一步是要编译我们的Slice定义,生成C++代理和骨架。在UNIX上,你可以这样编译定义:
$ slice2cpp Printer.ice
slice2cpp编译器根据这个定义生成两个C++源文件:Printer.h和Printer.cpp。
Printer.h头文件含有与我们的Printer接口的Slice定义相对应的C++类型定义。在客户和服务器源码中必须包括这个头文件。
Printer.cpp文件含有我们的Printer接口的源码。所生成的源码同时为客户和服务器提供针对特定类型的运行时支持。例如,它包含了在客户端整编参数数据 (传给printString操作的串)的代码,以及在服务器端解编数据的代码。
3.server.cpp
#include <Ice/Ice.h> //Ice.h中包含了Ice run time的各种定义
#include <Printer.h> //生成的Printer.h
using namespace std;
class PrinterI : public Printer {
public:
//virtual C++定义虚函数的关键字
/*
*注意,printString有第二个参数,类型是Ice::Current。从Printer::printString的定 *义你可以看到,Slice编译器会为这个形参生成缺省的实参,所以在我们的实现中 *可以不使用它 (我们将在后面介绍)。
*/
virtual void printString(const string & s, const Ice::Current &);
};
/*
*Printer骨架类定义是由Slice编译器生成的 (注意,printString是纯虚方法,所以这个 *骨架类不能被实例化)。我们的servant类继承自骨架类,提供了printString纯虚方法 *的实现 (按照惯例,我们用I后缀表示这个类实现了一个接口)
*/
void PrinterI::printString(const string & s, const Ice::Current &)
{
cout << s << endl;
}
int main(int argc, char* argv[])
{
/*
*main的主体声明了两个变量status和ic。status变量含有程序的退出状态,而类型 *为Ice::Communicator的ic变量含有Ice run time的主句柄。
*/
int status = 0;
Ice::CommunicatorPtr ic;
/*
try{
程序执行错误,抛出异常
}catch(异常1){
捕捉try模块抛出的异常,如果是异常1的话进入此模块
}catch(异常2){
捕捉try模块抛出的异常,如果是异常2的话进入此模块
}
*/
try {
/*
*Ice::initialize,初始化Ice run time(我们之所以把argc和argv传给这个调用, *是因为服务器可能有run time感兴趣的命令行参数;就这个例子 而言,服*务器不需要任何命令行参数)。initialize调用返回的是一个智能指针,指向一*个Ice::Communicator对象,这个指针是Ice run time的主句柄。
*/
ic = Ice::initialize(argc, argv);
/*
*我们调用Communicator实例上的createObjectAdapterWithEndpoints,创建一 *个对象适配器。我们传入的参数是"SimplePrinterAdapter"(适配器的名字) *和"default -p 10000",后者是要适配器用缺省协议(TCP/IP)在端口10000 *处侦听到来的请求。
*/
Ice::ObjectAdapterPtr adapter = ic->createObjectAdapterWithEndpoints(
"SimplePrinterAdapter", "default -p 10000");
/*
*这时,服务器端run time已经初始化,我们实例化一个PrinterI对象,为我们 *的Printer接口创建一个servant。
*/
Ice::ObjectPtr object = new PrinterI;
/*
*我们调用适配器的add,告诉它有了一个新的servant;传给add的参数是我 *们刚才实例化的servant,再加上一个标识符。在这里,"SimplePrinter"串是 *servant的名字(如果我们有多个打印机,每个打印机都可以有不同的名字, *更正确的说法是,都有不同的对象标识)。
*/
adapter->add(object, Ice::stringToIdentity("SimplePrinter"));
/*
*接下来,我们调用适配器的activate方法激活适配器 (适配器一开始是在扣 *留(holding)状态创建的;这种做法在下面这样的情况下很有用:我们有多 *个servant,它们共享同一个适配器,而在所有servant实例化之前我们不想处 *理请求)。一旦适配器被激活,服务器就会开始处理来自客户的请求。
*/
adapter->activate();
/*
*最后,我们调用waitForShutdown。这个方法挂起发出调用的线程,直到服务 *器实现终止为止——或者是通过发出一个调用关闭run time,或者是对某个 *信号作出响应 (目前,当我们不再需要服务器时,我们会简单地在命令行上 *中断它)。
*/
ic->waitForShutdown();
} catch (const Ice::Exception & e) {
cerr << e << endl;
status = 1;
} catch (const char * msg) {
cerr << msg << endl;
status = 1;
}
if (ic)
ic->destroy(); //确保Ice run time得以执行结束工作(前提是通信器进行过初始化)
return status;
}
4.编译server.cpp
$ c++ -I. -I$ICE_HOME/include -c Printer.cpp Server.cpp
这条命令编译我们的应用代码,以及Slice编译器生成的代码。我们假定ICE_HOME环境变量被设成Ice run time所在的顶层目录 (例如,如果你把Ice安装在/opt/Ice中,就把ICE_HOME 设成该路径)。取决于你的平台,你可能需要给编译器增加额外的包括指令或其他选项 (比如增加包括STLport头的指令,或是对模板实例化进行控制);要了解详情,请参考随Ice发布的演示程序。
最后,我们需要把服务器链接成可执行程序:
$c++ -o server Printer.o Server.o -L $ICE_HOME/lib -lIce -lIceUtil
取决于你的平台,你需要链接的库可能会更多。随Ice发布的演示程序含有所有的细节。在此,需要提及一个要点:Ice run time是在两个库中:libIce和libIceUtil。
6. client.cpp
#include <Ice/Ice.h>
#include <Printer.h>
using namespace std;
int main(int argc, char * argv[])
{
int status = 0;
Ice::CommunicatorPtr ic;
try {
ic = Ice::initialize(argc, argv);
/*
*获取远地打印机的代理。我们调用通信器的stringToProxy创建一个代理,所 *用参数是"SimplePrinter:default -p 10000"。注意,这个串包含的是对象标识和 *服务器所用的端口号(显然,在应用中硬编码对象标识和端口号,是一种糟 *糕的做法,但它目前很有效;我们将在后面看到在架构上更加合理的做法)。 */
Ice::ObjectPrx base = ic->stringToProxy("SimplePrinter:default -p 10000");
/*
*stringToProxy返回的代理的类型是Ice::ObjectPrx,这种类型位于接口和类的 *继承树的根部。但要实际与我们的打印机交谈,我们需要的是Printer接口、 *而不是Object接口的代理。为此,我们需要调用PrinterPrx::checkedCast进行 *向下转换。这个方法会发送一条消息给服务器,实际询问 “这是Printer接 *口的代理吗?”如果是,这个调用就会返回Printer的一个代理;如果代理代 *表的是其他类型的接口,这个调用就会返回一个空代理。
*/
PrinterPrx printer = PrinterPrx::checkedCast(base);
/*我们测试向下转换是否成功,如果不成功,就抛出出错消息,终止客户。*/
if (!printer)
throw "Invalid proxy";
/*
*现在,我们在我们的地址空间里有了一个活的代理,可以调用printString方 *法,把享誉已久的 "Hello World!"串传给它。服务器会在它的终端上打印这 *个串。
*/
printer->printString("Hello World!");
} catch (const Ice::Exception & ex) {
cerr << ex << endl;
status = 1;
} catch (const char * msg) {
cerr << msg << endl;
status = 1;
}
if (ic)
ic->destroy();
return status;
}