Thrift接口描述语言语法

1、数据类型

基本类型：

bool：布尔值，对应java的boolean

byte：8 位有符号整数，对应java的byte

i16：16 位有符号整数，对应java的short

i32：32 位有符号整数，对应java的int

i64：64 位有符号整数，对应java的long

double：64 位浮点数，对应java的double

string：字符串，对应java的String

binary：字节数组，对应java的type[]

结构体类型：

struct：定义公共的对象，类似于 C 语言中的结构体定义，在 Java 中是一个 JavaBean

struct Request {

1: string username;

2: string password;

}

枚举类型：

enum Action{

Idle,

Attack,

Run

}

容器类型：

list：对应 Java 的 ArrayList

set：对应 Java 的 HashSet

map：对应 Java 的 HashMap

异常类型：

exception：对应 Java 的 Exception

exception RequestException {

1:required i32 code;

2:optional string reason;

}

服务类型：

service：对应Java中的Interface

service HelloWordService {

string doAction(1:string name, 2:i32 age);

}

服务继承用extends关键字：

service HelloService extends BaseService{

}

2、类型定义

typedef i32 Integer

typedef i64 Long

3、常量定义

const string SERVER_IP = "127.0.0.1"

const i32 SERVER_PORT = 5900

const map<string, string> MAP_CONST = {"hello": "world", "goodnight": "moon"}

4、命名空间

namespace 语言路径

namespace java com.seasy.thrift

5、文件包含

include "global.thrift"

entity.thrift:
	namespace java com.seasy.entity
	struct RegisterEntity {
		1: string ip
		2: i32 port
		3: string description
	}

register.thrift:
	include "entity.thrift"
	namespace java com.seasy.service	  
	service RegisterService{   
		bool doRegister(1:entity.RegisterEntity regEntity) 
	}

注意：要使用entity.thrift中的结构，一定要加entity前缀，也就是文件名做为类型名的前缀。如范例中的 entity.RegisterEntity

6、注释

# 这行是注释

// 这行是注释

这行是注释

7、必选与可选

struct People{

1:required string name;

2:optional i32 age;

}

Thrift接口描述语言语法

猜你喜欢