ICE——1.Printer

一：打印机

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;

}