11.1 ibox 实例

一、 简介

IceBox服务器用于配置服务、并把对它们的管理集中在一起，服务被开发成可动态加载的组件，通过属性为IceBox服务配置它负责加载和管理的应用特有的服务。要把多个服务组合成一个应用，可以通过配置、而不是编译和链接来完成。这解除了服务和服务器的耦合，允许你按照需要组合服务或分离服务。

二、 服务管理器

除了应用服务所支持的对象，IceBox服务器还支持一个实现了IceBox.ServiceManager接口的管理对象。这个对象负责加载和初始化服务，并执行客户所要求的管理动作。为了保护这个对象的端点，不让它们受到未经授权的访问，IceBox服务器还会为这个对象创建一个对象适配器。目前，ServiceManager接口的管理能力相当有限：该接口只支持shutdown，用于终止服务、关闭IceBox服务器。

三、 端点配置

服务管理器的对象适配器的端点是用IceBox.ServiceManager.Endpoints配置属性定义的：IceBox.ServiceManager.Endpoints=tcp -p 10000因为有恶意的客户可能会向服务管理器发动 “拒绝服务”攻击，明智的做法是使用SSL端点，或用适当的防火墙配置来保护这些端点，或者两者都使用。

四、 客户配置

需要访问服务管理器的管理功能的客户可以使用属性所定义的端点来创建代理。服务管理器对象的缺省标识是ServiceManager，但你可以使用IceBox.ServiceManager.Identity属性来改变它。因此，使用缺省标识和端点的代理可以构造如下：

ServiceManager.Proxy=ServiceManager:tcp -p 10000

五、 开发服务

要编写IceBox服务，需要实现某个IceBox服务接口。下面给出的Java例子实现了IceBox.Service：

[java] view plain copy

1. module IceBox {  
2.     local interface ServiceBase {  
3.         void stop();  
4.     };  
5.     local interface Service extends ServiceBase {  
6.         void start(string name,Ice.Communicator communicator,Ice.StringSeq args)throws FailureException;  
7.     };  
8. };  

你可以看到，服务只需实现两个操作：start和stop。这些操作由服务管理器调用；start在服务加载后被调用，而stop在服务关闭时被调用。服务可以在start操作中初始化自身；这通常包括创建对象适配器和servant。name和args参数提供了来自服务的配置的信息，而communicator参数是服务管理器为供服务使用而创建的Ice.Communicator对象。取决于服务的配置，这个通信器实例可能会由同一个IceBox服务器中的其他服务共享，因此，你需要注意确保像对象适配器这样的对象的名字是唯一的。

stop操作必须回收服务所使用的任何资源。一般而言，服务会解除其对象适配器的激活，可能还需要调用对象适配器的waitForDeactivate，以确保在继续进行清理之前，所有待处理的请求都已完成。服务管理器会负责销毁通信器，缺省的行为是为每个服务创建一个新通信器。

由于下面的原因，这些接口被声明为local接口：它们代表的是服务管理器和服务之间的合约，而不是要供远地客户使用。服务与远地客户进行的任何交互都要通过服务所创建的servant来完成。

在myeclipse中创建一个java工程IceboxDemo，在工程下创建包icebox.client（存放客户端文件）、icebox.demo.slice2java（存放由slice2java命令编译生成的文件）、icebox.servant（存放servant文件）、icebox.service（存放服务）

编写Hello.ice文件，将Hello.ice文件直接存放src目录下。

[java] view plain copy

1. #ifndef HELLO_ICE  
2. #define HELLO_ICE  
3. [["java:package:icebox.demo"]]  
4. module slice2java  
5. {  
6.     interface Hello  
7.     {  
8.         void sayHello();  
9.     };  
10. };  
11. #endif  

打开终端，进入Hello.ice文件所在的目录，使用命令slice2java编译Hello.ice文件。

编译之后的生成的文件存放到IceboxDemo项目下的包icebox.demo.slice2java中。

六、 编写servant

Servant类名为HelloI,只是简单的实现“Hello World!”的打印功能。

[java] view plain copy

1. package icebox.servant;  
2.   
3. import icebox.demo.slice2java._HelloDisp;  
4.   
5. public class HelloI extends _HelloDisp  
6. {  
7.     public void sayHello(Ice.Current current)  
8.     {  
9.         System.out.println("Hello World!");  
10.     }  
11. }  

七、 Java实现服务

我们的服务的类定义如下，存放在icebox.service包中。

[java] view plain copy

1. package icebox.service;  
2.   
3. import icebox.servant.HelloI;  
4.   
5. public class HelloServiceI implements  
6.         IceBox.Service {  
7.     public void start(String name, Ice.Communicator communicator, String[] args) {  
8.         for(int i = 0;i<args.length;i++){  
9.             System.out.println("args["+i+"]="+args[i]);  
10.         }  
11.         _adapter = communicator.createObjectAdapter(name);  
12.         _adapter.add(new HelloI(), communicator.stringToIdentity("Hello"));  
13.         _adapter.activate();  
14.     }  
15.   
16.     public void stop() {  
17.         _adapter.deactivate();  
18.     }  
19.   
20.     private Ice.ObjectAdapter _adapter;  
21. }  

首先要注意，start方法用和服务名相同的名字创建一个对象适配器，激活一个类型为HelloI的servant，并激活对象适配器。stop简单地解除对象适配器的激活。

服务管理器要求服务的实现拥有缺省构造器。这是Java IceBox服务的进入点；也就是说，服务管理器会动态加载服务实现类，并调用构造器来获取服务的实例。

八、 编写客户端

客户端类名为Client，存放在icebox.client包中。

[java] view plain copy

1. package icebox.client;  
2.   
3. import icebox.demo.slice2java.*;  
4.   
5. public class Client {  
6.     public static void main(String[] args) {  
7.         int status = 0;  
8.         Ice.Communicator ic = null;  
9.         try {  
10.             //初使化  
11.             ic = Ice.Util.initialize(args);  
12.             //传入远程服务单元的名称、网络协议、IP及端口，获取Hello的远程代理，这里使用的stringToProxy方式  
13.             Ice.ObjectPrx base = ic.stringToProxy("Hello:tcp -p 10000");  
14.             //通过checkedCast向下转换，获取Hello接口的远程，并同时检测根据传入的名称获取的服务单元是否Hello的代理接口，如果不是则返回null对象  
15.             HelloPrx printer = HelloPrxHelper.checkedCast(base);  
16.             if (printer == null) throw new Error("Invalid proxy");  
17.             //调用服务端HelloI打印出来，因为这个方法最终会在服务端上执行  
18.             printer.sayHello();  
19.         } catch (Ice.LocalException e) {  
20.             e.printStackTrace();  
21.             status = 1;  
22.         } catch (Exception e) {  
23.             System.err.println(e.getMessage());  
24.             status = 1;  
25.         }  
26.         if (ic != null) {  
27.             // Clean up  
28.             //  
29.             try {  
30.                 ic.destroy();  
31.             } catch (Exception e) {  
32.                 System.err.println(e.getMessage());  
33.                 status = 1;  
34.             }  
35.         }  
36.         System.exit(status);  
37.     }  
38. }  

九、 配置服务器

要把服务配置进IceBox服务器中，只需使用一个属性。这个属性的用途有好几个：它定义服务的名字，它向服务管理器提供服务进入点，它还定义用于服务的属性和参数。下面是这个属性的格式：

IceBox.Service.name=entry_point [args]

属性键的name部分是服务名。这个名字会传给服务的start操作，在配置进同一个IceBox服务器的所有服务中必须是唯一的。用不同的名字加载同一个服务的两个或多个实例是可能的，尽管你很少需要这么做。属性值的第一个参数用于指定进入点。

对于Java服务，进入点就是服务实现类的完整类名 （包括任何package）。这个类必须位于IceBox服务器的类路径上。跟在entry_point后面的任何参数都会被检查。如果某个参数的形式是--name=value，它就会被解释为属性定义，将会出现在传给服务的start操作的通信器的属性集中。这些参数将被移除，剩下的参数会放在args参数中传给start操作。

将配置文件直接存放在src目录下，文件名为config.icebox，完整的配置文件内容如下：

[plain] view plain copy

1. IceBox.InstanceName=DemoIceBox  
2.   
3. # The IceBox server endpoint configuration  
4. IceBox.ServiceManager.Endpoints=tcp -p 9998  
5.   
6. # The hello service  
7.   
8. #创建一个名为Hello的服务，这个服务应当位于icebox.service包中的HelloServiceI类  
9.   

10. IceBox.Service.Hello=icebox.service.HelloServiceI  --Ice.Config=config.hello --Ice.Trace.Network=1 hello there

11.   
12. # The server creates one single object adapter with the name of  
13. # the service. The following line sets the endpoints for this  
14. # adapter.  
15. # Warn about connection exceptions  
16. #  
17. Ice.Warn.Connections=1  

IceBox.Service.Hello=icebox.service.HelloServiceI --Ice.Trace.Network=1 hello there，使用这个配置，将会创建一个名为Hello的服务。这个服务应当位于icebox.service.HelloServiceI类中。参数--Ice.Trace.Network=1（网络跟踪级别，1代表跟踪连接的建立和关闭）被转换成属性定义，交给start方法中的Communicator通信器处理，参数hello和there则会成为传给start方法的args序列参数中的两个元素，参数在此文章的例子中没有作用。

另外一个配置文件：config.hello

Hello.Endpoints=tcp -p 10019:udp -p 10012

十、 共享一个通信器

你可以用下面的属性对服务管理器进行配置，让它的所有服务共享一个

通信器实例：IceBox.UseSharedCommunicator=1

如果没有定义这个属性，缺省的行为是为每个服务创建一个新通信器。但是，如果你想要对服务进行并置优化，就必须使用一个共享的通信器实例。

十一、 加载服务

在缺省情况下，服务管理器加载服务的次序是不确定的，也就是说，同一个IceBox服务器中的各个服务不应该相互依赖。如果多个服务必须按照特定的次序加载，可以使用IceBox.LoadOrder属性：

IceBox.LoadOrder=Service1,Service2

在这个例子中，Service1首先加载，接着是Service2。剩下的其他服务在Service2之后以不确定的次序加载。在IceBox.LoadOrder中提到的每个服务都必须有相匹配的IceBox.Service属性。

十二、 运行客户和服务器

1.1. 运行IceBox服务器

把我们在前面讨论的内容结合在一起，我们现在可以配置并启动IceBox服务器了。

进入点的指定：

IceBox.ServiceManager.Endpoints=tcp -p 9998

IceBox.Service.Hello= icebox.service.HelloServiceI

Hello.Endpoints=tcp -p 10000

我们已经将这些属性写入config.icebox的配置文件中，我们可以使用类似这样命令启动Java IceBox服务器：

$ java IceBox.Server --Ice.Config= config.icebox

IceBox.Server是IceBox服务器的主类，该类位于Icebox.jar包中，所以执行该命令时，classpath环境变量必须指定IceBox.jar包所在位置。

config.icebox是启动IceBox服务器所需要的配置，我们已经存放在java工程IceboxDemo的resources目录下。

1、首先打开一个命令行终端，进入config.icebox配置文件存放的目录下，如下图：

此处的路径并不是我们前面提到IceboxDemo工程的src目录下，而是myeclipse编译源文件之后的class文件所在的bin目录下，bin目录下存放的是项目所有的class文件和配置文件。

2、执行以下命令

java  IceBox.Server --Ice.Config=E:\config.icebox

执行完成以后，如下图所示：

以上大部分信息都是网络跟踪日志信息。

1.2. 运行客户端

在myeclipse中运行Client客户端，

终端打印出“Hello World!”信息。