thrift idl 语言基础学习

include,他的作用是用作 idl 的模块化编程的

idl 复制代码
include "include_test.thrift"
# 单行注释

// 单行注释

/**
* 多行注释
**/


// 指定生成好的代码包,其中 namespace 是固定的,后面的是语言,可以是Java 也可以是其他的,后面的是包路径
namespace java com.rpc.thrift
namespace go com.rpc.thrift
namespace py com.rpc.thrift

// 数据类型
# 基本数据类型
# i8     有符号的 8 位整数 对应 Java byte
# i16    有符号的 16 位整数    对应 Java short
# i32    有符号的 32 位整数    对应 Java int
# i64    有符号的 64 位整数    对应 Java long
# double 64 位的浮点数        对应 Java 的 double
# bool   布尔类型             对应 Java 的 boolean
# string 字符串              对应  Java 的 String 可以使用单引号也可以是双引号,只能使用 UTF-8


# 集合类型
# list<T>        有序可重复数组   对应 Java 的 java.util.List
# set<T>         无需不可重复     对应 Java 的 java.util.Set
# map<K, V>      k-v           对应 Java 的 java.util.Map

# 集合举例
# 备注,只有常量才可以定义在外面,但是如果是结构体内的定义是可以不是 const 的
const map<i32, string> sex = {1: 'female', 2: 'male'}
const list<string> skus = ['1', '2', '3']
const set<i8> ages = [];

# 自定义类型 【结构体】
# struct 是不可以继承的,字段的分割可以使用,或者;
# 结构体的每一个字段都要做编号,编号的起始必须是 1
# 语法为 编号 冒号 [optional] [required] 类型 命名
# optional 代表可选的,默认给每一个成员都会加入这个关键字,可选的含义就是如果这个值没有值就不做序列化,如果加了就会做序列化操作
# required 这个也是可选的,这个代表这个字段是必须要做序列化,如果没有值也会做序列化的操作
struct User {
    1: required i32 id,
    2: optional string name = 'xl-9527',
    3: i32 age,
    4: list<string> hobby = ['codeing', '足球', '篮球'],
    5: string school
}

# 枚举类型, 枚举是不支持嵌套的,这里等于后面如果是数字,,虽然在 Thrift 中可以有 i8 ~ i64 但是这里默认是 i32
enum SEASON {
    SPRING = 1,
    SUMMERT = 2,
}

# 异常的定义,一般我们都只会定义两个异常属性
exception RuntimeException {
    1: i8 code,
    2: string errorMsg
}

# service 这里比较重要的第二个就是 service 的定义,他的定义类似于 Java 中的接口
service UserService {
    bool loginIn(1:string username, 2: string password) throws (1:RuntimeException e);
    void register(1: User user); // 这里的 User 起始对应一个 struct
    // oneway 他表示客户端不会等待服务端响应直接结束请求,类似于 Java 的异步操作,并且他只能配合 void 使用
    oneway void loginOut();
}

# 服务是继承的
service Parent {
    void pMethod();
}


service Child extends Parent{
    void cMethod()
}

struct IncludeTest {
       1:include_test.IncludeChild child
}
相关推荐
wuxuanok5 分钟前
Web后端开发-分层解耦
java·笔记·后端·学习
sword devil9006 分钟前
PYQT实战:智能家居中控
python·智能家居·pyqt
NetX行者7 分钟前
FastMCP:用于构建MCP服务器的开源Python框架
服务器·python·开源
超龄超能程序猿11 分钟前
(3)机器学习小白入门 YOLOv: 解锁图片分类新技能
python·numpy·pandas·scipy
kyle~37 分钟前
C/C++字面量
java·c语言·c++
waynaqua38 分钟前
FastAPI开发AI应用一:实现连续多轮对话
python·openai
纨妙42 分钟前
python打卡day59
开发语言·python
waynaqua42 分钟前
FastAPI开发AI应用二:多厂商模型使用指南
python·openai
neoooo1 小时前
别慌,Java只有值传递——一次搞懂“为啥我改了它还不变”!
java·后端·spring
秋难降1 小时前
Python 知识 “八股”:给有 C 和 Java 基础的你😁😁😁
java·python·c