`

ICE学习笔记(05):Slice规范

    博客分类:
  • Ice
阅读更多

按语:本文是DPWI第4章的笔记。在3.3.1版的1~9章中与1.3.0版马维达先生中译本相应章节的内容基本相同,变化比较小,可以参考马维达 先生的译本。

 

Slice 在客户与服务器之间建立合约,描述应用程序所使用的各种类型及对象接口。这种描述与语言实现无关。Slice 定义由编译器编译到特定的实现语言,编译算法称之为语言映射。编译器把与语言无关的定义翻译成针对特定语言的类型定义和API。开发者使用这些类型和API 来提供应用功能,并与Ice 交互。Ice 目前支持C++,Java, C#, Python,PHP,Ruby的语言映射。



    

例如:
/*
  Printer Slice
*/
#ifndef SIMPLE_ICE
#define SIMPLE_ICE

module Demo
{

    interface Printer
    {
        void printString(string s); //打印字符串
    };

};

#endif
Slice 关键字小写,只有Object、LocalObject首字母大写。
标识符大小写不敏感,不能有下划线。标识符必须保持拼写一致。以Ice开头的标识符被保留。将Slice关键字用作标识符,使用反斜线转义。如 /dictionary。

模块 : Slice所有定义嵌套进模块中。
module ZeroC {
    module Client {
        // Definitions here...
    };
    module Server {
        // Definitions here...
    };
};
重新打开模块:
module ZeroC {
    // Definitions here...
};
// Possibly in a different source file:
module ZeroC { // OK, reopened module
    // More definitions here...
};

 

Slice 数据类型

 

类型

映射类型的范围

映射类型的大小

bool

flase / true

 1 位

byte

-128~127

≥ 8 位

short

-215 ~215

 16

int

-231 ~231 -1

≥ 32 位

long

-263 ~263 -1

≥ 64 位

float

IEEE 单精度类型

≥ 32 位

double

IEEE 双精度类型

≥ 64 位

string

所有Unicode 字符,除了所有位为零的字符。

可变长度


Slice 提供了整数类型short、int,以及long,没有提供无符号类型。
Slice 串使用的是Unicode 字符集。唯一一个不能出现在串中的字符是零字符。

Slice 的byte 类型是一种(至少) 8 位的类型,当在地址空间之间传送时,它保证不会发生任何改变。

枚举: 
enum Fruit { Apple, Pear, Orange };
Slice没有定义枚举的顺序值。

结构: 
struct TimeOfDay {
    short hour; // 0 - 23
    short minute; // 0 - 59
    short second; // 0 - 59
};
Slice类型定义,除模块外不能嵌套;因此结构不能嵌套定义,但可以这样定义:
struct Point {
    short x;
    short y;
};
struct TwoPoints { // Legal (and cleaner!)
    Point coord1;
    Point coord2;
};

序列: 变长的元素向量
sequence<Fruit> FruitPlatter;
sequence<FruitPlatter> FruitBanquet;

词典: 从键类型到值类型的映射
dictionary<long, Employee> EmployeeMap;
词典的键类型无需为整型
dictionary<string, string> WeekdaysEnglishToGerman;
不能使用浮点值或嵌套结构作键

接口: 
interface Clock {
    TimeOfDay getTime();
    void setTime(TimeOfDay time);
};

参数: 
定义的操作既有输入参数,又有输出参数,输出参数必须放在输入参数的后面:
void changeSleepPeriod( TimeOfDay startTime,
                        TimeOfDay stopTime,
                    out TimeOfDay prevStartTime,
                    out TimeOfDay prevStopTime);
 

Slice 不支持既是输入、又是输出参数的参数。
Slice 不支持操作重载,同一接口中的各个操作必须具有不同的名称。

幂等操作: 多次执行同一操作,结果不变,关键字idempotent
interface Clock {
    idempotent TimeOfDay getTime();
    idempotent void setTime(TimeOfDay time);
};

用户异常:

exception Error {}; // 异常可以为空

exception RangeError {
    TimeOfDay errorTime;
    TimeOfDay minTime;
    TimeOfDay maxTime;
};

interface Clock {
    idempotent TimeOfDay getTime();
    idempotent void setTime(TimeOfDay time) throws RangeError, Error;
};
异常可以继承。在运行时,可以抛出任何与异常规范中列出的异常类型兼容的异常。
如果客户端不识别接收的派生异常,只识别基异常,就将接收的异常切成基异常。

Ice:Exception → LocalException → Run-time Exception

 

                      ↘UserException

主要的运行时异常:
a• ObjectNotExistException:找不到对象
b• FacetNotExistException:找不到层面
c• OperationNotExistException:找到服务者,但找不到操作。

服务器端错误产生的一般异常:
UnknownUserException:抛出的Slice异常没有在异常规范中声明。
UnknownLocalException:上述a,b,c三种异常之外的运行时异常
UnknownException:非Ice异常,如C++异常。

代理: 
interface Clock {
    idempotent TimeOfDay getTime();
    idempotent void setTime(TimeOfDay time);
};
dictionary<string, Clock*> TimeMap; // 时区 — 时钟

interface WorldTime {
    idempotent void addZone(string zoneName, Clock* zoneClock);
    void removeZone(string zoneName) throws BadZoneName;
    idempotent Clock* findZone(string zoneName) throws BadZoneName;
    idempotent TimeMap listZones();
    idempotent void setZones(TimeMap zones);
};
Clock* —> 接口* —> 代理:类似C++对象指针
* 称为代理操作符,*号左边必须是接口/类


接口继承: 
interface AlarmClock extends Clock {
    idempotent TimeOfDay getAlarmTime();
    idempotent void setAlarmTime(TimeOfDay alarmTime);
};
接口可以多继承:
interface RadioClock extends Radio, AlarmClock ....
多个接口不能含有同名操作。即如果Radio中有set操作,AlarmClock中有set操作,则
RadioClock不能从两个接口继承。

所有接口最终都派生自Object。
Ice支持null代理。
不要定义空接口,在设计上是错误的。

类: 
类允许你在客户端实现行为,而接口只允许你在服务器端实现行为。
不要定义空类,在设计上是错误的。

class TimeOfDay {...}
class DateTime extends TimeOfDay {...}
类只支持单继承,下面的定义是错误的:
class DateTime extends TimeOfDay, Date {...} 
派生类不能重新定义基类数据成员。

类的操作是本地操作,调用类上的操作并不会产生远程过程调用。在线上传输类时,Ice运行时只整编类的数据成员。接收者在自己的地址空间里实例化这个类,负责为类提供操作的实现代码。即提供一个类工厂。

要记住,一旦你使用了有操作的类,你实际上就是在使用客户端原生代码,因此,你不再能享受到接口所提供的实现透明性。建议最好使用接口和没有操作的类。

class Clock implements Time {...} 类实现接口
class RadioClock implements Time, Radio {...} 类实现多个接口
class RadioAlarmClock extends Clock implements AlarmClock, Radio {...}类继承及实现
类不能重定义基接口或基类继承的操作或数据成员。

interface Example {
    TimeOfDay* get(); 
};
get返回TimeOfDay类代理。客户可以通过这个代理调用操作,但不能访问数据成员。这是因为代理没有数据成员的概念。

定义操作时,将接口作为参数,使得接口以传值方式传递。由于接口在实现时是抽象的,因此实参应该传入实现接口的类。

提前声明: 
interface Time;
class TimeOfDay;

类型ID
::MyModule::Child;

Object的操作
ice_ping 测试某个对象是否可到达
ice_isA  测试目标对象是否支持指定的类型
ice_id   接口的派生层次最深的类型ID
ice_ids  含有某个接口所支持的所有类型ID的序列

本地类型: 
local关键字定义了只在本地访问的API。Slice 编译器不会为相应的类型生成整编代码。这意味着,本地类型永远不能从远程访问,因为它不能在客户和服务器之间传送。

local 主要用于Ice运行时的各种API。

名字与作用域: 
如果两个标识符只有大小写不同,将被认为是相同的。Slice 编译器还要求你在使用标识符时,始终使用同样的大小写。否则会产生编译错误。

元数据指令: 
["java:type:java.util.LinkedList"] sequence <int> IntSeq;
指示编译Java程序时,使用LinkedList表示序列。

全局元数据指令:
[["java:package:com.acme"]]
所有使用本Slice定义的Java程序,引入包名com.acme

废弃的Slice定义:
["deprecated:....."]
冒号跟着警告消息,可忽略。

Slice检查和: 
检查C/S两端的Slice定义是否一致:
#include <Ice/SliceChecksumDict.ice>
interface MyServer {
    idempotent Ice::SliceChecksumDict getSliceChecksums();
    // ...
};

词典类型:dictionary<string, string> SliceChecksumDict;
词典中每个元素的键是一个Slice类型ID,并且值是该类型的检查和。

  • 大小: 63.8 KB
分享到:
评论

相关推荐

    Matlab学习笔记三:绘图 (图片)

    本篇学习笔记将深入探讨Matlab的绘图功能,特别是如何利用它来创建高质量的结果图。 1. **基本图形类型** - **线图**(Line Plots): 用于展示数据点之间的连续关系,如`plot(x, y)`命令,其中x和y是对应的数据...

    ZeroC Ice3.7 官方手册英文版加注中文书签

    - **Slice(Ice 规范语言)**:Slice 是一种用于定义接口和数据类型的语言。它被用来描述服务端和客户端之间通信所需的接口,是Ice的核心组成部分之一。 - **语言映射概述(Overview of the Language Mappings)**...

    Zeroc ICE中间件slice2java的ant脚本(v1u0_0)

    `slice2java`是ICE提供的一个工具,它可以将`slice`文件转换为Java语言的接口和数据类型实现。 在这个名为"Zeroc ICE中间件slice2java的ant脚本(v1u0_0)"的资源中,包含了一个Ant构建脚本`slice2java.xml`。Ant是...

    slice-ios:Slice iOS SDK

    Slice iOS SDK 通过开发人员可以访问用户的在线购买历史记录。 它通过处理电子邮件回执来工作,并且涉及商户和产品类别。 可用的资源包括订单,物料,装运等。 SliceSDK是在iOS上使用Slice API的便捷框架。 注意...

    一个ICE的简单应用(客户端,服务端都有)

    这个“一个ICE的简单应用(客户端,服务端都有)”的压缩包提供了一个快速上手ICE的实例,非常适合初学者进行学习。 ICE支持C++,Java,Python等多种编程语言,而这里标签明确指出了"ICE c++",所以我们将重点讨论...

    Zeroc ICE中间件slice2java的ant脚本

    “slice2java”是Ice工具集的一部分,用于将 Slice 语言编写的接口定义转换为 Java 代码。Slice是一种接口定义语言,类似于IDL(Interface Definition Language),用于描述服务的接口和数据类型。通过slice2java,...

    ICE中文编程指南

    - **语法和API**:Ice采用了更为简洁明了的API设计,降低了学习曲线。 - **跨语言支持**:Ice提供了更多编程语言的支持,包括Java、C++、Python等。 - **性能**:Ice通常比CORBA表现出更好的性能。 #### 三、...

    点云深度学习系列五: RSNet:Recurrent Slice Networks for 3D Segmentati

    RSNet是在CVPR 2018上发表的一种网络架构,专为3D点云分割任务设计。它结合了递归神经网络(RNN)和切片池化操作,...RSNet的核心是其创新的“Recurrent Slice”机制,能够在点云数据的三维空间中进行有效的特征学习。

    Ice 分布式程序设计

    #### 第一部分:Ice 综述 **Ice 综述** - **Ice 架构** - Ice 是一种用于构建分布式应用程序的中间件平台,它支持跨多种网络环境和操作系统之间的通信。Ice 的核心组件包括: - **Ice 运行时**:提供了一个轻量...

    Ice_1.3.0中文文档

    - 通过学习Slice语言和Ice的核心概念,开发者可以更好地利用Ice来构建复杂的分布式系统。 以上内容涵盖了Ice 1.3.0版本的核心知识点,旨在帮助读者深入了解Ice的架构、设计理念及其在分布式计算领域的应用。

    ICE框架 C++示例程序

    3. **接口定义语言(IDL)**:ICE使用称为“Slice”的接口定义语言来描述服务接口, Slice文件可以被编译成不同语言的客户端和服务器端代码。 4. **自动类型映射**:ICE支持基本数据类型和自定义类型的自动序列化和...

    学习笔记 学习笔记 学习笔记 学习笔记 学习笔记 学习笔记 学习笔记 学习笔记

    【标题】: "DWS学习笔记" 【描述】: "DWS(Data Warehouse System,数据仓库系统)是用于企业数据分析的重要工具,它整合了来自不同业务系统的数据,为决策支持提供高效、一致的信息。这份学习笔记主要涵盖了DWS的...

    npm-slice2js:Slice到JavaScript编译器的Npm软件包

    slice2js 将Slice文件编译为JavaScript。 安装 npm install slice2js --save-dev 用法 var slice2js = require ( 'slice2js' ) ; 方法 slice2js.compile(args [, options]) 返回一个对象。 args Array 传递给...

    zeroc ice教程 ice环境配置 Ice中文教程 C++ ICE java ICE ICE入门 ice基础教程 ice开发文档

    总结来说,文档为开发者提供了一个全面的ICE学习指南,从ICE的基础知识到实际的编程应用,再到配置和性能优化,覆盖了ICE开发的各个方面。通过阅读这份文档,开发者能够掌握ICE的使用方法,并能在实际项目中有效应用...

    ICE中间件教程

    - **1.2.1 客户端和服务器**:ICE支持典型的客户端/服务器模型,其中客户端发起请求,服务器处理请求并返回结果。 - **1.2.2 Ice核心**:这是ICE的基础组件,负责处理网络通信和对象定位等核心任务。 - **1.2.3 Ice ...

    Go 学习笔记 第四版 pdf

    根据提供的信息,我们可以总结出这份文档是关于Go语言学习笔记的部分内容,主要涵盖了Go语言的基础概念、语法结构、数据类型以及并发模型等关键知识点。以下是对这些知识点的详细解析: ### Go语言概述 Go(也称作...

    Slice-docs:Slice项目的文档

    【标题】:“Slice-docs: Slice项目的文档” 【描述】中的“切片文档”和“Slice项目的文档”指的是一个名为“Slice”的项目,该项目可能是一个软件工具或框架,专门涉及数据切片、处理或者管理方面的功能。文档...

    zeroc ice微服务架构用户手册

    zeroc ice微服务架构用户手册 zeroc ice是一款功能强大且灵活的微服务架构解决方案,旨在提供一种简洁、可靠、可扩展的...*灵活性:Ice 架构模型具有高度的灵活性,允许开发者根据不同的应用场景选择合适的架构模型。

    Ice-1.3.0-中文文档.pdf

    根据提供的文档内容,我们可以提炼出以下知识点: 1. Ice分布式程序设计: - Ice是Internet Communications Engine的缩写,它是一个用于构建分布式应用程序...对于学习和应用Ice技术,以上内容是理解和掌握的关键点。

Global site tag (gtag.js) - Google Analytics