ICE通信之IceGrid服务（二）

一、 简介

Ice版本：3.1.1

使用iceGrid服务实现一个简单的打印系统，主要说明iceGrid的使用方法，系统部署在4台主机上，注册器和打印服务器安装在同一台主机上，如下图所示：

下图显示了一个客户端通过间接代理的初始调用，来激活目标服务器。

在这个架构当中不需要花时间手动启动服务。客户端的寻址请求提示注册器去查询节点的服务器状态并且根据需要启动它。一旦这个服务启动成功，这个寻址请求完成，并且随后客户端直接和服务端通信。

二、 配置注册器、节点1 

注册器需要一个子目录，在这个目录中创建它的数据库，由IceGrid.Registry.Data指定，此目录必须在启动注册器前已经存在 。

# Registry properties IceGrid.Registry.Client.Endpoints=tcp -p 4061 IceGrid.Registry.Server.Endpoints=tcp IceGrid.Registry.Internal.Endpoints=tcp IceGrid.Registry.AdminPermissionsVerifier=IceGrid/NullPermissionsVerifier IceGrid.Registry.PermissionsVerifier=IceGrid/NullPermissionsVerifier IceGrid.Registry.Data=F:\lhy_workspace\ICETest\src\iceGrid\registry IceGrid.Registry.Admin.Endpoints=default # Node properties IceGrid.Node.Endpoints=tcp IceGrid.Node.Name=Node1 IceGrid.Node.Data=F:\lhy_workspace\ICETest\src\iceGrid\note IceGrid.Node.CollocateRegistry=1 Ice.Default.Locator=IceGrid/Locator:tcp -p 4061

1、注册器和节点1的配置信息在同一个配置文件中，在节点1的服务器上存储该配置文件，如存放在c盘根目录下c:\config，文件名为config。

        2、将服务器应用程序以及其依赖的jar包拷贝至节点1相应的目录下，如下文中部署文件配置的C:\PrinterApp.jar。

有几个属性定义了Endpoints，但只有 icegrid.registry.client.endpoints的值需要一个固定的端口。此属性指定IceGrid定位服务的端口; IceGrid的客户端必须在他们的Ice.Default.Locator中包括这个端口。

其他的一些属性：

属性	说明
IceGrid.Registry.AdminPermissionsVerifier	这两个属性控制访问Registry的管理权限
IceGrid.Registry.PermissionsVerifier
IceGrid.Registry.Data	这个属性指定Registry的数据库目录，用于存放注册器的一些状态信息，可以任意指定。
IceGrid.Registry.DynamicRegistration	通过将此属性设置为一个非零值，我们允许服务器注册对象适配器
IceGrid.Registry.Admin.Endpoints	指定IceGrid的Admin代理端点，
IceGrid.Node.CollocateRegistry	如果值被设置为大于零的值，说明该节点和注册表运行在同一个进程中，该节点和注册器使用相同的配置文件。

在使用icegridadmin命令管理icegrid时，缺少这项配置，系统会抛出异常：

no suitable endpoint available for proxy `IceGrid/Admin -t'

三、 配置节点2 

IceGrid.Node.Endpoints=tcp IceGrid.Node.Name=Node2 IceGrid.Node.Data=F:\lhy_workspace\ICETest\src\iceGrid\note2 Ice.Default.Locator=IceGrid/Locator:tcp -h 192.168.1.193 -p 4061

1、在节点2的服务器上存储该配置文件，如存放在c盘根目录下c:\config，文件名为config。

      2、将服务器应用程序以及其依赖的jar包拷贝至节点2相应的目录下，如下文中部署文件配置的C:\PrinterApp.jar。

属性	说明
IceGrid.Node.Endpoints	配置节点的端点，不需要指定固定的端口
IceGrid.Node.Name	为节点定义一个不同的名字
IceGrid.Node.CollocateRegistry	不能有两个节点都配置这个属性只能有一个主Registry，所以此属性在这个节点中不需要再配置
IceGrid.Node.Data	指定该节点的数据目录，用于存储该节点的状态信息，可以任意指定

四、 Slice脚本

打印服务器的Slice脚本如下

module Demo {
	interface Printer {
		string printString(string s);
	};
};

打印服务器实现简单的打印功能，服务端接收客户端的打印信息，并负责将信息打印到终端，打印完成之后，返回给客户端一个打印完成的提示信息。

五、 Servant代码

package iceGrid.sampleAdapterLocator.servant;

public class PrinterI extends Demo._PrinterDisp {
	public String printString(String s, Ice.Current current) {
		System.out.println(s);
		try {
			Thread.sleep(5000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		return "打印完成";
	}
}

六、 服务端代码

package iceGrid.sampleAdapterLocator.server;

import iceGrid.sampleAdapterLocator.servant.PrinterI;

public class Server extends Ice.Application {

	public int run(String[] args) {
		//创建名为SimplePrinterAdapter的适配器，       
        Ice.ObjectAdapter adapter = communicator().createObjectAdapter("PrinterAdapter");
        //实例化一个PrinterI对象，为Printer接口创建一个服务对象
        Ice.Object object = new PrinterI();
        //将服务单元增加到适配器中，并给服务对象指定名称为SimplePrinter，该名称用于唯一确定一个服务单元
        adapter.add(object, Ice.Util.stringToIdentity("SimplePrinter"));
        //激活适配器，这样做的好处是可以等到所有资源就位后再触发
        adapter.activate();
        //让服务在退出之前，一直持续对请求的监听
        communicator().waitForShutdown();
		return 0;
	}
	public static void main(String[] args) {
		Server app = new Server();
		System.out.println("服务器已经启动！");
		System.exit(app.main("Server", args));
	}
}

七、 客户端代码

package iceGrid.sampleAdapterLocator.client;

public class Client extends Ice.Application {
	
	public int run(String[] args) {
		//获取Printer的远程代理，这里使用的stringToProxy方式
		Ice.ObjectPrx base = communicator().stringToProxy("SimplePrinter");
        //通过checkedCast向下转换，获取Printer接口的远程，并同时检测根据传入的名称获取的服务单元是否Printer的代理接口，如果不是则返回null对象
        Demo.PrinterPrx printer = Demo.PrinterPrxHelper.checkedCast(base);
        if (printer == null) throw new Error("Invalid proxy");
        //把Hello World传给服务端，让服务端打印出来，因为这个方法最终会在服务端上执行
        for(int i = 0;i<10;i++){
        	String ret = printer.printString("Hello World!哈哈");
            System.out.println(ret);
        }
		return 0;
	}

	public static void main(String[] args) {
		Client app = new Client();
		System.exit(app.main("Server", args,"C:\\client.conf"));
	}
}

客户端使用stringToProxy("SimplePrinter")方式，获取服务单元在本地的代理对象，仅仅使用服务单元的对象标识SimplePrinter，客户端不需要指定请求的服务器以及对象适配器的端点信息，客户端使用标识第一次发送请求到注册器，由注册器根据这个唯一的标识，给客户端分配一个对象适配器端点，然后客户端在与端点建立连接。

客户端调用 checkedCast 是在这个printer对象上的第一个远程调用，因此，这个定位请求在这个调用过程中被执行。随后调用 printString是直接发送给服务器而没有IceGrid的进一步参与。

八、 配置客户端

Ice.Default.Locator=IceGrid/Locator:tcp -h 192.168.1.193 -p 4061

客户端要与注册器建立连接，首先要在客户端配置注册器的位置信息。客户端配置文件存放在C:\client.conf，

属性	说明
Ice.Default.Locator	用于客户端Ice run time定位服务代理。在IceGrid中 ，定位服务是由注册器承担，定位对象位于注册器的client endpoionts。此属性的端口值参考注册器配置文件中的 IceGrid.Registry.Client.Endpoints， -h指定注册器所在的主机IP地址，定位对象默认为 IceGrid/Locator

九、 部署配置文件