Ice个人整理资料

Ice个人整理资料

1.客户与服务器（Clients and Servers）

2.Ice 对象（Ice Objects ）

3.代理（Proxies ）

4.串化代理（Stringified Proxies ）代理中的信息可以用串的形式表示。例如：SimplePrinter:default -p 10000

5.直接代理（Direct Proxies ）协议标识符（比如TCP/IP 或UDP）针对具体协议的地址（比如主机名和端口号）

6.间接代理（Indirect Proxies）

7. 同步方法调用（Synchronous Method Invocation）

8. 异步方法调用（Asynchronous Method Invocation）

9. 异步方法分派（Asynchronous Method Dispatch）

10. 单向方法调用（Oneway Method Invocation ）

11. 成批的单向方法调用（Batched Oneway Method Invocation ）

12. 数据报调用（Datagram Invocations）

13. 成批的数据报调用（Batched Datagram Invocations）

14. 运行时异常（Run-Time Exceptions ）

15. 用户异常（User Exceptions ）

16. 属性（Properties ）

17. 骨架（skeleton）代码也是根据你的Slice 定义生成的，因此，与你用Slice 定义的对象和数据的类型是对应的。骨架代码是客户端代理代码的服务器端等价物：它提供了向上调用（up-call）接口，允许Ice runtime 把控制线程转交给你编写的应用代码。骨架也含有整编和解编代码，所以服务器可以接收客户发送的参数，并把参数和异常返回给客户。

18. 对象适配器（object adapter）是专用于服务器端的Ice API 的一部分：只有服务器才使用对象适配器。对象适配器有若干功能：

19. Ice 协议

Ice 提供了一种RPC 协议，既可以把TCP/IP、也可以把UDP 用作底层传输机制。此外，Ice 还允许你把SSL 用作传输机制，让客户与服务器间的所有通信都进行加密。

20.

IcePack

我们在第12 页提到过，IcePack 是Ice 的定位服务，用于在使用间接绑定时把符号性的（symbolic）适配器名解析为协议－地址对。除了这样的定位服务，IcePack 还提供了其他特性：

?IcePack 允许你注册服务器，进行自动启动：当客户发出请求时，服务器无需在运行，IcePack 会在第一个客户请求到达时，随需启动服务器。

?IcePack 支持部署描述符（deployment descriptors），能让你轻松地配置含有若干服务器的复杂应用。

?IcePack 提供了一种简单的对象查找服务，客户可用来获取它们感兴趣的对象的代理。21. IceBox

IceBox 是一种简单的应用服务器，可用于协调许多应用组件的启动和停止。应用组件可以作为动态库、而不是进程进行部署。例如，你可以在单个Java 虚拟机中运行若干应用组件，而无需使用多个拥有自己的虚拟机的进程，从而减轻整个系统的负担。

22. IceStorm

IceStorm 是一种发布－订阅服务，能够解除客户与服务器的耦合。在本质上，IceStorm 充当的是事件分发交换机。发布者把事件发给这个服务，由它发给订阅者。

23. IcePatch

IcePatch 是一种软件修补服务。你可以用它来轻松地把软件更新分发给客户。客户可以简单地连接到IcePatch，请求获得特定应用的更新。这个服务会自动检查客户的软件的版本，并以一种压缩形式下载任何更新过的应用组件，从而节省带宽。你可以用Glacier 服务来保护软件补丁，只让得到授权的客户下载软件补丁。

24. Glacier

Glacier 是Ice 防火墙服务：它能让客户与服务器通过防火墙安全地进行通信，且又不牺牲安全性。客户－服务器之间的通信数据使用公钥证书进行了完全的加密，并且是双向的。Glacier 支持相互认证，以及安全的会话

管理。

25. Slice （Ice 规范语言）

每个Ice 对象都有一个接口，该接口具有一些操作。接口、操作，还有在客户及服务器间交换的数据的类型，都是用Slice 语言定义的。Slice 允许你以一种独立于特定编程语言（比如C++ 或Java）的方式定义客户－服务器的合约。Slice 定义由一个编译器编译成特定编程语言的API，也就是说，与你所定义的接口和类型对应的那一部分API，会由生成的代码组成。

26. 编写和编译服务器

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

#include

#include

using namespace std;

class PrinterI : public Printer {

public:

virtual void printString(const string & s,

const Ice::Current &);

};

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;

adapter->add(object,

Ice::stringToIdentity("SimplePrinter"));

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;

}

对于一个只打印一个串的服务器而言，这里的代码似乎有很多。不要担心这一点：大多数代码都是不会变化的公式化代码。对于这个非常简单的服务器而言，其代码几乎就由这些公式化代码组成。每个Slice 源文件的一开始都有一条用于包括Ice.h 的指令，在Ice.h 中包含了Ice run time 的各种定义。我们还包括了由Slice 编译器生成的Printer.h，其中含有我们的打印机接口的C++ 定义；为了使以后的代码保持简洁，我们还导入了std 名字空间的内容：

#include

#include

using namespace std;

我们的服务器实现了一个打印机servant，其类型是PrinterI。我们查看Printer.h 中的生成的代码，发现了以下内容（为去掉无关细节，进行了整理）：

class Printer : virtual public Ice::Object {

public:

virtual void printString(const std::string &,

const Ice::Current & = Ice::Current()

) = 0;

};

Printer 骨架类定义是由Slice 编译器生成的（注意，printString 是纯虚方法，所以这个骨架类不能被实例化）。我们的servant 类继承自骨架类，提供了printString 纯虚方法的实现（按照惯例，我们用I 后缀表示这个类实现了一个接口）。

class PrinterI : public Printer {

public:

virtual void printString(const string & s,

const Ice::Current &);

};

printString 方法的实现很简单：它会简单地把它的串参数写到

stdout：

void

PrinterI::

printString(const string & s, const Ice::Current &)

{

cout << s << endl;

}

注意，printString 有第二个参数，类型是Ice::Current。从Printer::printString 的定义你可以看到，Slice 编译器会为这个形参生成缺省的实参，所以在我们的实现中可以不使用它（我们将在16.5 节考察Ice::Current 的用途）。接下来是服务器的主程序。注意这段代码的总体结构：

int

main(int argc, char* argv[])

{

int status = 0;

Ice::CommunicatorPtr ic;

try {

// Server implementation here...

} 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;

}

main的主体声明了两个变量status和ic。status变量含有程序的退出状态，而类型为Ice::Communicator 的ic 变量含有Ice run time 的主句柄。在声明的后面是一个try 块，我们把所有的服务器代码都放在其中；然后是两个catch 处理器。第一个处理器捕捉Ice run time 可能抛出的所有异常，其意图是，如果代码在任何地方遇到意料之外的Ice 运行时异常，栈会一直回绕到main，打印出异常，然后把失败返回给操作系统。第二个处理器捕捉串常量，其意图是，如果我们在代码某处遇到致命错误，我们可以简单地抛出带有出错消息的串文本。这也会使栈回绕到main，打印出出错消息，然后把失败返回给操作系统。在try 块的后面，我们看到一行清理代码调用通信器的destroy 方法（前提是通信器进行过初始化）。清理调用之所以在try 块的外部，原因是：不管代码是正常终止，还是由于异常而终止，我们都必须确保Ice runtime 得以执行结束工作（finalized）

我们的try 块的主体含有实际的服务器代码：

38 Hello World 应用

ic = Ice::initialize(argc, argv);

Ice::ObjectAdapterPtr adapter

= ic->createObjectAdapterWithEndpoints(

"SimplePrinterAdapter", "default -p 10000");

Ice::ObjectPtr object = new PrinterI;

adapter->add(object,

Ice::stringToIdentity("SimplePrinter"));

adapter->activate();

ic->waitForShutdown();

这段代码包含以下步骤：

1. 我们调用Ice::initialize，初始化Ice run time （我们之所以把argc和argv传给这个调用，是因为服务器可能有run time感兴趣的命令行参数；就这个例子而言，服务器不需要任何命令行参数）。initialize 调用返回的是一个智能指针，指向一个Ice::Communi-cator 对象，这个指针是Ice run time 的主句柄。

2. 我们调用Communicator 实例上的createObjectAdapterWithEndpoints，创建一个对象适配器。我们传入的参数是" SimplePrinterAdapter " （适配器的名字）和" default -p 10000 " ，后者是要适配器用缺省协议（TCP/IP）在端口10000 处侦听到来的请求。

3. 这时，服务器端run time 已经初始化，我们实例化一个PrinterI 对象，为我们的Printer 接口创建一个servant。

4. 我们调用适配器的add，告诉它有了一个新的servant ；传给add 的参数是我们刚才实例化的servant，再加上一个标识符。在这里，" SimplePrinter " 串是servant 的名字（如果我们有多个打印机，每个打印机都可以有不同的名字，更正确的说法是，都有不同的对象标识）。

5. 接下来，我们调用适配器的activate 方法激活适配器（适配器一开始是在扣留（holding）状态创建的；这种做法在下面这样的情况下很有用：我们有多个servant，它们共享同一个适配器，而在所有servant实例化之前我们不想处理请求）。一旦适配器被激活，服务器就会开始处理来自客户的请求。

6. 最后，我们调用waitForShutdown。这个方法挂起发出调用的线程，直到服务器实现终止为止——或者是通过发出一个调用关闭run time，1. 如果在程序退出之前没有调用通信器的destroy ，就会造成不确定的行为。或者是对某个信号作出响应（目前，当我们不再需要服务器时，我们会简单地在命令行上中断它）。注意，尽管这里的代码不算少，但它们对所有的服务器都是一样的。你可以把这些代码放在一个辅助类里，然后就无需再为它费心了（Ice 提供了这样的辅助类，叫作Ice::Application，参见10.3.1 节）。就实际的应用代码而言，服务器只有几行代码：六行代码定义PrinterI 类，再加上三2 行代码实例化一个PrinterI 对象，并向对象适配器注册它。假定我们的服务器代码放在一个叫作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。

编写和编译客户

客户代码看起来与服务器非常像。下面是完整的代码：

#include

#include

using namespace std;

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;

}

注意，总体的代码布局与服务器是一样的：我们包括Ice run time 的头和Slice 编译器生成的头，我们用同样的try 块和catch 处理器处理错误。

try 块中的代码所做的事情是：

1. 和在服务器中一样，我们调用Ice::initialize 初始化Ice runtime。

2. 下一步是获取远地打印机的代理。我们调用通信器的stringToProxy创建一个代理，所用参数是" SimplePrinter:default -p 10000 " 。注意，这个串包含的是对象标识和服务器所用的端口号（显然，在应用中硬编码对象标识和端口号，是一种糟糕的做法，但它目前很有效；我们将在第20 章看到在架构上更加合理的做法）。

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

4. 我们测试向下转换是否成功，如果不成功，就抛出出错消息，终止客

户。

5. 现在，我们在我们的地址空间里有了一个活的代理，可以调用printString 方法，把享誉已久的" Hello World! " 串传给它。服务器会在它的终端上打印这个串。

客户的编译和链接看起来与服务器很像：

$ c++ -I. -I$ICE_HOME/include -c Printer.cpp Client.cpp

$ c++ -o client Printer.o Client.o -L$ICE_HOME/lib -lIce -lIceUtil

运行客户和服务器要运行客户和服务器，我们首先要在一个单独的窗口中启动服务器：$ ./server我们在这时不会看到任何东西，因为服务器会简单地等待客户与它连接。我们在另外一个窗口中运行客户：$ ./client$客户会运行并退出，不产生任何输出；但在服务器窗口中，我们会看到打印机产生的" Hello World! " 。要终止服务器，我们目前的做法是在命令行上中断它（我们将在10.3.1 节看到更干净的服务器终止方式）。如果出现任何错误，客户会打印一条出错消息。例如，如果我们没有先启动服务器就运行客户，我们会得到：Network.cpp:471: Ice::ConnectFailedException:connect failed: Connection refused注意，要想成功运行客户和服务器，你必须设置一些取决于平台的环境变量。例如，在Linux 上，你需要把Ice 库目录增加到你的LD_LIBRARY_PATH。请看一看随Ice 发布的演示应用，以了解与你的平台相关的各种细节。

27.

28. try

{

//程序中抛出异常

throw value;

}

catch(valuetype v)

{

//例外处理程序段

}

语法小结：throw抛出值，catch接受，当然，throw必须在“try语句块”中才有效。

29.枚举：C++中的枚举类型定义：enum Fruit{Apple,Pear,Orange};

30.结构：Slice 支持含有一个或多个有名称的成员的结构，这些成员可以具有任

意类型，包括用户定义的复杂类型。

例如struct uctTimeOfDay{

Short hour;

Short minute;

Short second;

};

在结构内部，只能出现数据成员定义，这些定义必须使用有名字的类

型。例如，你不可能在结构内定义结构：

Struct TwoPoints{

Struct Point{

Short x;

Short y;

};

Point coord1;

Point coord2;

};

31:Slice 不支持任何形式操作的重载。

32. 异常继承

异常支持继承。例如：

exception ErrorBase {

string reason;

};

33. 接口继承

接口支持继承。例如，我们可以扩展我们的世界时间服务器，支持闹钟的概念：

interface AlarmClock extends Clock {

nonmutating TimeOfDay getAlarmTime();

idempotent void setAlarmTime(TimeOfDay alarmTime)

throws BadTimeVal;

};