Thrift IDL基本语法
简言:介绍Thrift的IDL基本语法,初次使用或多或少的会有很有"坑"要踩,但是我们要遇山挖山,遇海填海,在学习的道路上坚定的走下去,方可日后吹牛B!
IDL
Thrift 采用IDL(Interface Definition Language)来定义通用的服务接口,然后通过Thrift提供的编译器,可以将服务接口编译成不同语言编写的代码,通过这个方式来实现跨语言的功能。
基本类型
bool: 布尔值 对应Java中的boolean
byte: 有符号字节 对应Java中的byte
i16: 16位有符号整型 对应Java中的short
i32: 32位有符号整型 对应Java中的int
i64: 64位有符号整型 对应Java中的long
double: 64位浮点型 对应Java中的double
string: 字符串 对应Java中的String
binary: Blob 类型 对应Java中的byte[]
struct 结构体
struct有以下一些约束:
1.struct不能继承,但是可以嵌套,不能嵌套自己。(0.12.0版本可以支持嵌套自己本身)
2.其成员都是有明确类型
3.成员是被正整数编号过的,其中的编号使不能重复的,这个是为了在传输过程中编码使用。
4.成员分割符可以是逗号(,)或是分号(;),而且可以混用
5.字段会有optional和required之分和protobuf一样,但是如果不指定则为无类型–可以不填充该值,但是在序列化传输的时候也会序列化进去,optional是不填充则部序列化,required是必须填充也必须序列化。
6.每个字段可以设置默认值
7.同一文件可以定义多个struct,也可以定义在不同的文件,进行include引入。
举个"栗"子:
struct User{1: required string name, //改字段必须填写2: optional i32 age = 0; //默认值3: bool gender //默认字段类型为optional
}
规则:
如果required标识的域没有赋值,Thrift将给予提示;
如果optional标识的域没有赋值,该域将不会被序列化传输;
如果某个optional标识域有缺省值而用户没有重新赋值,则该域的值一直为缺省值;
如果某个optional标识域有缺省值或者用户已经重新赋值,而不设置它的__isset为true,也不会被序列化传输。
Container (容器)
有3种可用容器类型:
list: 元素类型为t的有序表,容许元素重复。对应c++的vector,java的ArrayList或者其他语言的数组
set: 元素类型为t的无序表,不容许元素重复。对应c++中的set,java中的HashSet,python中的set,php中没有set,则转换为list类型了
map<t, t>: 键类型为t,值类型为t的kv对,键不容许重复。对用c++中的map, Java的HashMap, PHP 对应 array, Python/Ruby 的dictionary
举个"栗"子:
struct Test {1: map<string, User> usermap,2: set<i32> intset,3: list<double> doublelist
}
enum (枚举)
约束:
1.编译器默认从0开始赋值
2.可以赋予某个常量某个整数
3.允许常量是十六进制整数
4.末尾没有分号
5.给常量赋缺省值时,使用常量的全称
规则:
Thrift不支持枚举类嵌套,枚举常量必须是32位的正整数
举个"栗"子
enum HttpStatus {OK = 200,NOTFOUND=404
}
常量定义
使用方法:在变量前面加上const
举个"栗"子
const i32 const_int = 1;
类型定义
Thrift支持C/C++类型定义
举个"栗"子
typedef i32 myint
typedef i64 usernumber
规则:
末尾没有逗号
Exception (异常)
异常在语法和功能上类似于结构体,差别是异常使用关键字exception,而且异常是继承每种语言的基础异常类。
举个"栗"子
exception MyException {1: i32 errorCode,2: string message
}
Service (服务定义类型)
服务的定义方法在语义上等同于面向对象语言中的接口。
service HelloService {i32 sayInt(1:i32 param)string sayString(1:string param)bool sayBoolean(1:bool param)void sayVoid()
}
编译后的Java代码
public class HelloService {public interface Iface {public int sayInt(int param) throws org.apache.thrift.TException;public java.lang.String sayString(java.lang.String param) throws org.apache.thrift.TException;public boolean sayBoolean(boolean param) throws org.apache.thrift.TException;public void sayVoid() throws org.apache.thrift.TException;}// ... 省略超级多超级多代码
}
Namespace (名字空间)
Thrift中的命名空间类似于C++中的namespace和java中的package,它们提供了一种组织(隔离)代码的简便方式。名字空间也可以用于解决类型定义中的名字冲突。
由于每种语言均有自己的命名空间定义方式(如python中有module), thrift允许开发者针对特定语言定义namespace:
举个"栗"子
namespace java com.example.test
转换成:
package com.example.test
Comment (注释)
Thrift支持C多行风格和Java/C++单行风格。
举个"栗"子
/** * This is a multi-line comment. * Just like in C. */// C++/Java style single-line comments work just as well.
Include
便于管理、重用和提高模块性/组织性,我们常常分割Thrift定义在不同的文件中。包含文件搜索方式与c++一样。Thrift允许文件包含其它thrift文件,用户需要使用thrift文件名作为前缀访问被包含的对象,
举个"栗"子
include "test.thrift"
...
struct StSearchResult {1: in32 uid;...
}
thrift文件名要用双引号包含,末尾没有逗号或者分号
参考文章
Apache Thrift - 可伸缩的跨语言服务开发框架:https://www.ibm.com/developerworks/cn/java/j-lo-apachethrift/index.html
转载于:https://www.cnblogs.com/xzy-/p/11131407.html
Thrift IDL基本语法相关推荐
- thrift IDL
参考资料: [1] Thrift 入门 [2] Thrift入门及Java实例演示 [3] Thrift使用指南及语法介绍 [4] Thrift RPC 系列教程(1)--Thrift语言 [5] J ...
- Thrift简介及语法
本文介绍thrift如何定义及编写接口描述文档*.thrift 文章目录 1. 简介 2. 语法 2.1 头部 2.1.1 thrift头文件 2.1.2 C++头文件 2.1.3 namesp ...
- Thrift IDL示例文件
Java 示例1: 在src下新建thrift目录,在此目录下新建MyData.thrift文件 namespace java thrift.generatedtypedef i16 short ty ...
- Thrift使用教程(Java版本)
Thrift简介 Thrift是一个跨语言的服务部署框架,最初由Facebook于2007年开发,2008年进入Apache开源项目.Thrift通过一个中间语言(IDL, 接口定义语言)来定义RPC ...
- Thrift使用指南及语法介绍
Thrift使用指南及语法介绍 1. 数据类型(Types) 基本类型(Basic types) 容器(Containers) 结构体和异常(Structs and Exceptions) 服务(Se ...
- OMG IDL语法规则
OMG IDL语法规则 (本文转载自软件工程专家网www.21cmm.com) 苏洋 OMG IDL文件概述 从本质上讲,OMG IDL接口定义语言不是作为程序设计语言体现在CORBA体系结构中的,而 ...
- python thrift demo
简介 Thrift最初由Facebook研发,主要用于各个服务之间的RPC通信,支持跨语言,常用的语言比如C++, Java, Python, PHP, Ruby, Erlang, Perl, Has ...
- Thrift 在Windows环境下的编译与简单C++应用
前言 Thrift是Facebook提供的一个跨语言的服务部署框架,可以实现客户端和服务器远程过程调用.相较于Google的grpc框架,Thrift对三方库依赖更少,编译更简单,并且运行效率也更高. ...
- 开源组件系列(5):数据的序列化(Thrift、Protobuf、Avro)
(一)数据序列化的意义 当我们需要将采集的日志存入文件或者是传输到下一个系统时,需要将数据对象转化为字节流格式,也就是数据的序列化过程.通常情况下,搭建一套数据仓库系统,会经历如下四个阶段: 1.没有 ...
最新文章
- python搭建环境是什么_python虚拟环境是什么?python虚拟环境的介绍
- 1.23 实例:查询个人信息
- Android中关于setLatestEventInfo()过时以及构建Notification的解决方法
- CUBRID学习笔记 31 通过select创建表
- 一步一步配置aspnetdb数据库
- 发送编辑器里面的内容_【公众号运营技巧7】编辑器不会用?365微信公众号编辑器操作指南!#鱼神微电商创业#...
- 云班课计算机第二阶段测试卷,云班课测试题答案
- 为什么在Java中收到NoClassDefFoundError?
- docker教程_2 docker常见命令
- NetworkX使用手册
- javascript学习笔记最全
- C语言编程练习----2021级山东理工大学ACM实验二题解
- java读文件在页面输出_Java读取html页面以文件流方式输出显示在页面
- 女性最容易出轨的8种职业
- 小新pro13睡眠后无法唤醒_东芝笔记本睡眠后无法唤醒怎么办
- 快速画出哈夫曼树/霍夫曼树/最优树
- base64 加密有空格 换行_[编码解码] Base64 编码换行和+号遍空格的处理
- Codeforces Round #657 (Div. 2)B. Dubious Cyrpto
- PY_matplotlib
- AR(增强现实)技术是什么,未来发展会怎样
热门文章
- 每天一道LeetCode-----判断两个二叉树是否相同
- java 队列已满_java – ThreadPoolExecutor当队列已满时阻塞?
- UBoot讲解和实践-------------讲解(二)
- C语言中main函数的研究,以及对代码断点调试的研究(王爽老师 汇编语言)
- Python常见数据结构整理
- vector的基本操作
- java6_64.tar配置_centos6.5_64 java 环境变量配置
- C++内存泄露几种常见原因
- Linux基础-1.0共享文件夹创建
- centos 编译nginx php mariadb,centos7安装nginx+mariadb+php-fpm