ICE第二篇–一个”hello world”的简单例子

1 本文介绍一个hello world输出的例子。

ice应用的步骤如下：

1. 编写 Slice 定义并编译它。
2. 编写服务器并编译它。
3. 编写客户并编译它。

基本框架图示：

本文代码图示：

需要注意的概念：

servant  
servant其实是服务端实质的动作代码.一个servant 提供一个或多个Ice 对象的实质内容。实际上，servant 就是服务器开发者编写的类的实例，

对象适配器      是对象（或者说是servant）的代理。（1）包含端点地址和对象。适配器和端点地址绑定，对象是注册到对象适配器中的。（2）   只有间接代理时候，客户端才用到适配器

服务端就是   建立适配器，把对象（servant）注册进适配器的过程

客户端就是   连接适配器，获得对象（servant） 的过程

2 我们需要3个程序.

2.1 编写 Slice 定义
编写任何 Ice 应用的第一步都是要编写一个 Slice 定义,其中含有应用所用的各个接口。

module demo

{

interface Printer
{
void printString(string s);
}

};
我们把这段文本保存在叫作 Printer.ice 的文件中。
我们的 Slice 定义含有一个接口,叫作 Printer。目前,我们的接口非常简单,只提供了一个操作,叫作 printString。 printString 操作接受一个
串作为它唯一的输入参数;这个串的文本将会出现在 (可能在远地的)打印机上。

要创建我们的 C++ 应用,第一步是要编译我们的 Slice 定义,生成 C++
代理和骨架。在 UNIX 上,你可以这样编译定义:
$ slice2cpp Printer.ice
slice2cpp 编译器根据这个定义生成两个 C++ 源文件:Printer.h 和Printer.cpp。
• Printer.h
Printer.h 头文件含有与我们的 Printer 接口的 Slice 定义相对应的C++ 类型定义。在客户和服务器源码中必须包括这个头文件。
• Printer.cpp
Printer.cpp 文件含有我们的 Printer 接口的源码。所生成的源码同时为客户和服务器提供针对特定类型的运行时支持。例如,它包含了
在客户端整编参数数据 (传给 printString 操作的串)的代码,以及在服务器端解编数据的代码。我们必须编译 Printer.cpp 文件,并把它链接进客户和服务器。

2 编写和编译服务器

总结服务端代码流程：

建立适配器，建立servant。适配器和servant绑定。激活ice通信器

服务器的源码不多,下面给出了其完整代码:

#include <Ice/Ice.h>
#include <Printer.h>
using namespace std;

using namespace Demo;
class PrinterI : public Printer {
public:
virtual void printString(const string & s,
const Ice::Current &);
};//继承自slice提供了接口
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 {
ic = Ice::initialize(argc, argv);//通信器初始化，得到运行时支持
Ice::ObjectAdapterPtr adapter= ic->createObjectAdapterWithEndpoints(
"SimplePrinterAdapter", "default -p 10000");//通信器创建对象适配器，适配器接受客户请求，并把请求发送给服务器。括号中是适配器名字和监听地址-----适配器绑定端点地址
Ice::ObjectPtr object = new PrinterI;//创建一个servant，其实就是服务器对象的实质处理函数
adapter->add(object,ic->stringToIdentity("SimplePrinter"));适配器与servant绑定。括号内是servant和servant名字 或者说  把服务端对象注册进适配器中
adapter->activate();适配器激活
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();
return status;
}
$ g++ -I. -I$ICE_HOME/include -c Printer.cpp Server.cpp
c++ -o server Printer.o Server.o \   -L$ICE_HOME/lib -lIce -lIceUtil

3 客户端程序 

总结客户端代码流程：

使用servant名称和适配器地址建立代理，代理转换为继承类的servant

#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 {
ic = Ice::initialize(argc, argv); //初始化通信器
Ice::ObjectPrx base = ic->stringToProxy("SimplePrinter:default -p 10000");//获得服务器对象的代理。括号内是对象和端点地址，即在某个端点地址上的某个对象
PrinterPrx printer = PrinterPrx::checkedCast(base);//解释如下
if (!printer)
throw "Invalid proxy";
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;
}

stringToProxy 返回的代理的类型是 Ice::ObjectPrx,这种类型位于接口和类的继承树的根部。但要实际与我们的打印机交谈,我们需
要的是 Printer 接口、而不是 Object 接口的代理。为此,我们需要调用 PrinterPrx::checkedCast 进行向下转换。这个方法会发送一
条消息给服务器,实际询问 “这是 Printer 接口的代理吗?”如果是,这个调用就会返回 Printer 的一个代理;如果代理代表的是其他类型的
接口,这个调用就会返回一个空代理。

客户的编译和链接看起来与服务器很像:
$ c++ -I. -I$ICE_HOME/include -c Printer.cpp Client.cpp
$ c++ -o client Printer.o Client.o -L$ICE_HOME/lib -lIce -lIceUtil

4 运行客户和服务器
要运行客户和服务器,我们首先要在一个单独的窗口中启动服务器:
$ ./server
我们在这时不会看到任何东西,因为服务器会简单地等待客户与它连
接。我们在另外一个窗口中运行客户:
$ ./client
$
客户会运行并退出,不产生任何输出;但在服务器窗口中,我们会看到
打印机产生的 "Hello World!"。要终止服务器,我们目前的做法是在命
令行上中断它 (我们将在 10.3.1 节看到更干净的服务器终止方式)
。

 本文主要内容来自《ice分布式设计》