本文主要介绍ZeroC IceBox的相关知识，以及如何构建一个IceBox的demo程序。

1. IceBox介绍

IceBox是为Ice服务提供的一个易用框架。

待补充...

2. demo构建

说明：本文介绍的demo程序是在Centos 7上、使用C++语言开发的，对应的ice、icebox版本为3.6.4。

沿用前文《ZeroC Ice介绍与简单demo构建》中已编写的基础框架文件（即Hello.ice、Hello.h、Hello.cpp、HelloI.h、HelloI.cpp），我们继续编写IceBox需要的其他文件。

2.5 编写IceBox服务器实例代码

说明：本节继承了前文《ZeroC Ice介绍与简单demo构建》的部分内容，所以本节直接以2.5小节开始计数。

要将一个Ice服务（IceBox服务器实例）封装到IceBox服务器中，需要让这个Ice服务的服务实现类继承IceBox定义的Service接口。

Ice服务的服务实现类HelloServiceI的声明代码（HelloServiceI.h）如下：

#ifndef __HELLOSERVICEI_H__ #define __HELLOSERVICEI_H__ #include <IceBox/IceBox.h> class HelloServiceI : public ::IceBox::Service { public: HelloServiceI(); virtual ~HelloServiceI(); virtual void start(const ::std::string&, const ::Ice::CommunicatorPtr&, const ::Ice::StringSeq&); virtual void stop(); private: ::Ice::ObjectAdapterPtr _adapter; }; #endif 

Ice服务的服务实现类HelloServiceI的具体实现代码（HelloServiceI.cpp）如下：

讯享网#include <Ice/Ice.h> #include <HelloServiceI.h> #include <HelloI.h> using namespace std; HelloServiceI::HelloServiceI() { } HelloServiceI::~HelloServiceI() { } void HelloServiceI::start(const string& name, const Ice::CommunicatorPtr& communicator, const Ice::StringSeq& /*args*/) { _adapter = communicator->createObjectAdapter(name); Demo::HelloPtr object = new HelloI; _adapter->add(object, communicator->stringToIdentity("hello")); _adapter->activate(); } void HelloServiceI::stop() { _adapter->destroy(); } 

服务实现类HelloServiceI对应的Ice服务的入口点“entry_point”代码（HelloService.cpp）如下：

#include <Ice/Ice.h> #include <HelloServiceI.h> extern "C" { // // Factory function // ICE_DECLSPEC_EXPORT IceBox::Service* create(Ice::CommunicatorPtr) { return new HelloServiceI; } } 

注意：本文到现在为止，介绍的几个文件（Hello.ice、Hello.h、Hello.cpp、HelloI.h、HelloI.cpp、HelloServiceI.h、HelloServiceI.cpp、HelloService.cpp）为搭建IceBox的demo时需要使用的基础框架文件，对于其他需要用到IceBox技术进行demo搭建的文章，如无特殊说明，均沿用了这八个基础文件。相关的demo搭建链接如下：

• 只搭建IceBox的demo，不涉及其他技术，请参考本文后续部分。
• 使用IceBox搭建IceGrid的demo环境，相关文章点击此处。

2.6 编写客户端代码

客户端代码通过IceBox中的Ice服务提供的Ice对象ID连接服务端，并调用（与该Ice对象ID）相关的方法。

客户端代码（client.cpp）如下：

讯享网#include <Ice/Ice.h> #include <Hello.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("hello:default -p 10000"); HelloPrx hello = HelloPrx::checkedCast(base); if (!hello) { throw "Invalid proxy"; } string result = ""; result = hello->SayHello("liitdar"); cout << "[icebox] client's result: " << result << endl; } 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; } 

2.7 编译生成客户端和IceBox的服务

讯享网

编译生成客户端应用程序（client），命令如下：

g++ -o client -I. client.cpp Hello.cpp -lIce -lIceUtil -lpthread

编译生成IceBox的服务（libHelloService.so），命令如下：

讯享网g++ -shared -fPIC -o libHelloService.so -I. HelloService.cpp HelloServiceI.cpp HelloI.cpp Hello.cpp -lIce

2.8 编写IceBox及其服务的配置文件

IceBox的配置文件（config.icebox）内容如下：

# # The hello service # IceBox.Service.Hello=./HelloService:create --Ice.Config=config.service

通过使用一个单独的IceBox.Service属性，将一个Ice服务配置到IceBox服务器中。IceBox.Service属性的格式如下：

讯享网IceBox.Service.name=entry_point [args]

• 本例中添加到IceBox服务器中的Ice服务的名字定义为“Hello”，此值会作为HelloServiceI::start函数的name参数、被传入到服务实现类HelloServiceI的start函数中，在start函数中，我们使用name参数作为了对象适配器的名字。
  说明：在本例中，Ice服务的名字与服务实现类HelloServiceI的对象适配器的名字相同，但从目前来看，这些名字对外部客户端调用IceBox服务器中的方法没什么关系（外部客户端通过Ice对象ID调用相关的方法），可理解为IceBox的内部一些逻辑关系需要。
• Ice服务“Hello”对应的入口点为“./HelloService:create”，即调用HelloService程序（so）的create方法。
• 参数args以“--key=value”的形式出现，所以Ice服务“Hello”运行时将读取配置文件config.service的内容，主要作用是为对象适配器“Hello”（同时也是Ice服务）设置端点。

IceBox封装的Ice服务的配置文件（config.service）内容如下：

# # The service creates one single object adapter with the name of the # service. The following line sets the endpoints for this adapter. # Hello.Endpoints=tcp -h localhost -p 10000

上述配置主要是为对象适配器“Hello”（同时也是Ice服务）设置端点，供客户端进行寻址连接。

2.9 运行IceBox服务器及客户端

在一个终端中，运行如下命令，启动IceBox服务器：

讯享网icebox --Ice.Config=config.icebox

在另外一个终端中，运行客户端，如下：

./client

正常情况下，我们能够在上面的两个终端中看到IceBox服务器中的Ice服务与客户端的信息交互情况，如下：

【IceBox服务器】：

【客户端】：

如果两个终端中出现了上述信息，说明IceBox的demo程序部署成功了。