slice2java编译Printer.ice生成文件说明.doc

参考Ice 分布式程序设计 马维达 译，冯立彬的博客1、 Ice文件定义 Printer.ice文件内容如下：module demo interface Printer void printString(string s); 在命令行终端，进入到Printer.ice文件所在的目录，使用如下命令编译ice文件：slice2java printer.ice。会在目录下面生成一个demo文件夹，里面生成了一些java文件，如下图示：2、 类图结构 这些文件的类图结构如下：- 3、 文件说明 这里对生成的一些文件做些解释，分为两部份，服务端类文件及客户端类文件：1. 服务器文件l .java这个源文件声明在ICE文件中定的接口名称的Java接口，如这里是Printer。l _Operations.javal _OperationsNC.java这两个接口文件都会被接口文件_.java继承。 这是两个定义操作的接口文件，每个接口文件中定义了一个操作实现，定义的操作与Slice接口中定义的操作相一致，_PrinterOperationsNC中操作：void printString(String s)，只是在_Operations.java中定义的方法多了一个参数“Ice.Current _current”，_PrinterOperations中的操作：void printString(String s, Ice.Current _current)，这个参数的作用是可以允许我们访问 “正在执行的请求”和 “服务器中的操作的实现”等信息，通过它可以访问如下对象：1、adapter 通过adapter 成员，你可以访问负责分派当前请求的对象适配器。通过适配器，你又可以访问它的通信器（通过getCommunicator 操作）。2、id id 成员提供当前请求的对象标识。如：Ice.Current cIce.Identity idCopy = new Ice.Identity();/new一个对象标示符idCopy对象idC = ;/通过Current获取当前请求的servant对象标示符的nameidCopy.category = c.id.category;/对象标示符的category 每个Ice 对象都有一个唯一的对象标识。对象标识是用于把一个对象与其他所有对象区别开来的标识值。Ice 对象模型假定对象标识是全局唯一的，也就是说，在一个Ice 通信域中，不会有两个对象具有相同的对象标识。对象标示Identity只有两个成员，name和category成员。3、facet 通过facet 成员，你可以访问请求的facet 。4、operation operation 成员含有正在被调用的操作的名字。注意，这个操作名可能是Ice:Object上的操作的名字，比如ice_ping 或ice_isA。如：public class PrinterI extends _PrinterDisp public void printString(String s, Ice.Current current) System.out.println(current.operation);/输出结果：printString5、mode mode 成员含有操作的调用模式（Normal、Idempotent，或Nonmutating）。6、ctx ctx 成员含有这个调用的当前上下文，上下文就是一系列名- 值对，如果客户在上下文中放入一些名- 值对，并在发出调用时使用这个上下文，服务器就将能使用客户所发送的这些名- 值对。在服务器端，操作的实现可以通过Ice.Current 的ctx 成员访问接收到的Context ，并提取客户所发送的名- 值对。l _Disp.java 这个文件包含的是服务器端骨架类的定义，所用接口定义都要继承这个东西，这里的接口指供客户端调用的接口，如上图中的PrinterI.java。l Holder.java 为接口定义的holder 类，是对应Out参数使用的。一般参数都是值传递，这个类的作用是使参数通过引用传递。此类可以存放服务器返回给客户端的信息。 客户端使用out 参数传递holder 类的实例，并在调用完成时检查每个out 参数的value 成员。下面的Slice定义，所有的参数都是作为out 参数传递的：struct NumberAndString int x; string str;sequence StringSeq;dictionary StringTable;interface ServerToClient void op1(out int i, out float f, out bool b, out string s); void op2(out NumberAndString ns,out StringSeq ss,out StringTable st); void op3(out ServerToClient* proxy); Slice 编译器为这个定义生成了以下out参数代码：public interface ClientToServerPrx extends Ice.ObjectPrx public void op1(Ice.IntHolder i, Ice.FloatHolder f, Ice.BooleanHolder b,Ice.StringHolder s);public void op2(NumberAndStringHolder ns, StringSeqHolder ss,StringTableHolder st);public void op3(ClientToServerPrxHolder proxy); 假定我们有一个代理，指向的是ServerToClient 接口，客户代码可以这样传递参数：ClientToServerPrx p = .; / Get proxy.Ice.IntHolder ih = new Ice.IntHolder();Ice.FloatHolder fh = new Ice.FloatHolder();Ice.BooleanHolder bh = new Ice.BooleanHolder();Ice.StringHolder sh = new Ice.StringHolder();p.op1(ih, fh, bh, sh);NumberAndStringHolder nsh = new NumberAndString();StringSeqHolder ssh = new StringSeqHolder();StringTableHolder sth = new StringTableHolder();p.op2(nsh, ssh, sth);ServerToClientPrxHolder stcph = new ServerToClientPrxHolder();p.op3(stcph);System.out.writeln(ih.value); 一旦操作调用完成，值就会出现在各个holder 实例中，你可以通过每个实例的value 成员访问这些值。2. 客户端文件l Prx.java 这个是代理接口。例如PrinterPrx，在客户的地址空间中， PrinterPrx 的实例是“远地的服务器中的Printer接口的实例”的“本地大使”。与服务器端对象有关的所有细节，比如其地址、所用协议、对象标识，都封装在该实例中。 这个类的方法调用都是远程服务端的调用，执行printString()方法的具体实现是在远程服务端执行的。l PrxHolder.java 代理定义holder 类，用法参考Holder.javal PrxHelper.java 这个是接口的代理定义助手类，客户端要得到服务端的servant的代理类,客户端不能通过new Prx（）方式来获取代理对象，只能通过这个助手类，帮你获得代理对象。经常用的就两个方法checkedCast 和 uncheckedCast，这两个方法实现的都是向下转换。 注意， checkedCast 会联系服务器。这是必要的，因为只有服务器中的代理实现确切地知道某个对象的类型。所以checkedCast 可能会抛出ConnectTimeoutException 或ObjectNotExistException（这也解释了为何需要助手类：ICE在运行时必须联系服务器，所以我们不能使用Java 的向下转换）。 与此相反， uncheckedCast 不会联系服务器，而是会无条件地返回具有所请求的类型的代理 。但是，如果你要使用uncheckedCast，你必须确定这个代理真的支持你想要转换到的类型；而如果你弄错了，你很可能会在调用代理上的操作时，引发运行时异常。对于这样的类型失配，最后可能会引发OperationN