ICE笔记(02)：Hello World 分析

【 colorado 】

说明文档位于DPWI第3章，程序位于Ice 3.3.1发布${ICE_HOME}/demo/book/printer。

1、Slice文件
Printer.ice 定义如下：
#ifndef SIMPLE_ICE
#define SIMPLE_ICE

module Demo
{

interface Printer
{
void printString(string s);
};

};

#endif

本Slice文件定义了模块Demo，它含有Printer接口，定义了printString操作，printString 操作接受一个字符串。程序功能是客户端调用printString发送字符串给服务器，服务器将字符串打印出来。

编译本slice文件：
slice2cpp Printer.ice
生成 Printer.h/Printer.cpp 文件，定义了接口的规范，实现了运行时支持的类型以及类型的整编与解编。在我们编写的C/S程序中引用了这些文件，以便使用接口。

2、服务器端
Server.cpp：

//必须包含Ice.h文件，以支持Ice运行时
#include <Ice/Ice.h>
//必须包含Printer.h，以使用Slice规范
#include <Printer.h>

using namespace std;
using namespace Demo;

/*
骨架类Printer根据Printer.ice定义由Slice2cpp编译器生成，
它的printString是纯虚方法，骨架类不能被实例化。
服务者PrinterI类继承自骨架类Printer，提供了printString纯虚方法的实现。
*/
class PrinterI : public Printer {
public:
virtual void printString(const string & s,const Ice::Current &);
};

/*
Ice:Current对象为服务器中操作的实现提供了有关当前执行请求的信息，
如适配器，连接，标识，层面，操作，操作模式，上下文，请求ID等。
*/
void PrinterI::printString(const string & s, const Ice::Current &)
{
cout << s << endl;
}

int
main(int argc, char* argv[])
{
int status = 0;
Ice::CommunicatorPtr ic;
try {
//初始化Ice，获取通讯器，智能指针
ic = Ice::initialize(argc, argv);

//在通讯器ic上创建对象适配器SimplePrinterAdapter，缺省协议(TCP)，在端口10000上监听
Ice::ObjectAdapterPtr adapter
= ic->createObjectAdapterWithEndpoints("SimplePrinterAdapter", "default -p 10000");

//创建服务者类PrinterI
Ice::ObjectPtr object = new PrinterI;

//将服务者类PrinterI加入对象适配器，服务者类的名称是SimplePrinter，
//客户端必须使用此名称的请求标识来请求服务者的操作。
adapter->add(object,ic->stringToIdentity("SimplePrinter"));

//激活对象适配器，客户端请求现在可以分派给服务者类PrinterI。
adapter->activate();
//挂起当前主函数所在线程，等待通讯器关闭
ic->waitForShutdown();
} catch (const Ice::Exception & e) { //捕捉Ice运行时抛出的异常
cerr << e << endl;
status = 1;
} catch (const char * msg) {//捕捉致命错误，输出错误串
cerr << msg << endl;
status = 1;
}
//通讯器必须初始化过，否则不能调用destroy
if (ic) {
try {
ic->destroy();//销毁通讯器
} catch (const Ice::Exception & e) {
cerr << e << endl;
status = 1;
}
}
return status;
}

3、客户端
#include <Ice/Ice.h>
#include <Printer.h>

using namespace std;
using namespace Demo;

int
main(int argc, char * argv[])
{
int status = 0;
Ice::CommunicatorPtr ic;
try {
//初始化Ice，获取通讯器，智能指针
ic = Ice::initialize(argc, argv);

//创建通讯器的代理基类，该代理使用的请求标识为SimplePrinter，端口号：10000，协议：默认(TCP)
Ice::ObjectPrx base = ic->stringToProxy("SimplePrinter:default -p 10000");

//代理基类向下转型为PrinterPrx代理类，调用本操作会向服务器发送请求。
//如果转型成功就返回Printer接口的代理，如果转型失败就返回null代理。
PrinterPrx printer = PrinterPrx::checkedCast(base);

//不是Printer接口的代理，抛出异常
if (!printer)
throw "Invalid proxy";

//是Printer接口的代理，调用代理的操作printString
printer->printString("Hello World!");
} catch (const Ice::Exception & ex) {//捕获Ice运行时异常
cerr << ex << endl;
status = 1;
} catch (const char * msg) {//捕捉致命错误，输出错误串
cerr << msg << endl;
status = 1;
}
//通讯器必须初始化过，否则不能调用destroy
if (ic) {
try {
ic->destroy();//销毁通讯器
} catch (const Ice::Exception & ex) {
cerr << ex << endl;
status = 1;
}
}
return status;
}

4、运行
客户端和服务器使用VC++的工程文件完成编译，然后先运行Server，再运行Client。关闭时，以Ctrl+C结束Server程序。

5、说明

${ICE_HOME}/demo/Ice/minimal是一个与此例非常类似的最小Ice应用程序。不同之处在于minimal的服务器定义了对强制关闭信号的处理，如对Ctrl+C定义了：IceUtil::CtrlCHandler ctrCHandler(onCtrlC);然后实现了static void onCtrlC(int)函数，对接收到Ctrl+C信号进行了处理。另外minimal程序用单独的helloI文件实现了hello接口的sayHello操作规范。

本文所展示的程序比马维达先生中译本(Ice 1.3.0)的程序在异常处理方面有所增强，请读者注意。