精华内容
参与话题
问答
  • thrift数据类型

    千次阅读 2012-12-12 16:45:23
    Thrift通过接口定义语言 (interface definition language,IDL) 来定义数据类型和服务,Thrift接口定义文件由Thrift代码编译器生成thrift目标语言的代码(目前支持C++,Java, Python, PHP, Ruby, Erlang,

    1 前言

      Thrift是facebook技术核心框架之一,不同开发语言开发的服务可以通过该框架实现通信。Thrift通过接口定义语言 (interface definition language,IDL) 来定义数据类型和服务,Thrift接口定义文件由Thrift代码编译器生成thrift目标语言的代码(目前支持C++,Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, Smalltalk和OCaml),并由生成的代码负责RPC协议层和传输层的实现。

      简而言之,开发者只需准备一份thrift脚本,通过thrift code generator(像gcc那样输入一个命令)就能生成所要求的开发语言代码。不支持windows。

      Thrift侧重点是构建跨语言的可伸缩的服务,特点就是支持的语言多,同时提供了完整的RPC service framework,可以很方便的直接构建服务,不需要做太多其他的工作。服务端可以根据需要编译成simple | thread-pool | threaded | nonblocking等方式;

      本文档参考:Thrift typesThrift IDL, Thrift:The Missing Guide.

    2 语法参考

     2.1 类型

      Thrift类型系统包括预定义基本类型,用户自定义结构体,容器类型,异常和服务定义。

     2.1.1 基本类型

    • bool: 布尔值 (true or false), one byte

    • byte: 有符号字节

    • i16: 16位有符号整型

    • i32: 32位有符号整型

    • i64: 64位有符号整型

    • double: 64位浮点型

    • string: Encoding agnostic text or binary string

    Note that: Thrift不支持无符号整型,因为Thrift目标语言没有无符号整型,无法转换。

     2.1.2 容器(Containers)

      Thrift容器与流行编程语言的容器类型相对应,采用Java泛型风格。它有3种可用容器类型:

    • list<t1>: 元素类型为t1的有序表,容许元素重复。(有序表ordered list不知道如何理解?排序的?c++的vector不排序)

    • set<t1>:元素类型为t1的无序表,不容许元素重复。

    • map<t1,t2>: 键类型为t1,值类型为t2的kv对,键不容许重复。

      容器中元素类型可以是除了service外的任何合法Thrift类型(包括结构体和异常)。

     2.1.3 结构体和异常(Structs and Exceptions)

      Thrift结构体在概念上类似于(similar to)C语言结构体类型--将相关属性封装在一起的简便方式。Thrift结构体将会被转换成面向对象语言的类。

      异常在语法和功能上类似于(equivalent to)结构体,差别是异常使用关键字exception而不是struct声明。但它在语义上不同于结构体:当定义一个RPC服务时,开发者可能需要声明一个远程方法抛出一个异常。

      结构体和异常的声明将在下一节介绍。

     2.1.4 服务(Services)

      服务的定义方法在语义(semantically)上等同于面向对象语言中的接口。Thrift编译器会产生执行这些接口的client和server stub。具体参见下一节。

     2.2 类型定义(Typedef)

      Thrift支持C/C++类型定义。

      typedef i32 MyInteger // a  typedef T ReT // b

      说明:a.  末尾没有逗号。b.   struct也可以使用typedef。

     2.3 枚举(Enums)

      很多语言都有枚举,意义都一样。比如,当定义一个消息类型时,它只能是预定义的值列表中的一个,可以用枚举实现。

    enum TweetType {TWEET, // (1)   RETWEET = 2// (2)DM = 0xa// (3)   REPLY} // (4)struct Tweet {1: required i32 userId;2: required string userName;3: required string text;4: optional Location loc;5: optional TweetType tweetType = TweetType.TWEET; // (5)16: optional string language = "english"}

      说明:

      (1).  编译器默认从0开始赋值

      (2).  可以赋予某个常量某个整数

      (3).  允许常量是十六进制整数

      (4).  末尾没有分号

      (5).  给常量赋缺省值时,使用常量的全称

      注意,不同于protocal buffer,thrift不支持枚举类嵌套,枚举常量必须是32位的正整数

     2.4 注释(Comment)

      Thrift支持shell风格, C多行风格和Java/C++单行风格。

    # This is a valid comment.// C++/Java style single-line comments work just as well.

     2.5 名字空间(Namespace)

      Thrift中的命名空间类似于C++中的namespace和java中的package,它们提供了一种组织(隔离)代码的简便方式。名字空间也可以用于解决类型定义中的名字冲突。

      由于每种语言均有自己的命名空间定义方式(如python中有module), thrift允许开发者针对特定语言定义namespace:  

    namespace cpp com.example.project // (1)namespace java com.example.project // (2)namespace php com.example.project

      (1). 转化成namespace com { namespace example { namespace project {

      (2).  转换成package com.example.project


     2.6 Includes

      便于管理、重用和提高模块性/组织性,我们常常分割Thrift定义在不同的文件中。包含文件搜索方式与c++一样。Thrift允许文件包含其它thrift文件,用户需要使用thrift文件名作为前缀访问被包含的对象,如:

    include "tweet.thrift" // (1)...struct TweetSearchResult {1: tweet.Tweet tweet; // (2)}

      说明:

      (1).  thrift文件名要用双引号包含,末尾没有逗号或者分号

      (2).  注意tweet前缀

     2.7 常量(Constant)

      Thrift允许定义跨语言使用的常量,复杂的类型和结构体可使用JSON形式表示。

    const i32 INT_CONST = 1234// (1)

      说明:

      (1) 分号可有可无。支持16进制。

     2.8 结构体定义(Defining Struct)

      struct是Thrift IDL中的基本组成块,由域组成,每个域有唯一整数标识符,类型,名字和可选的缺省参数组成。如定义一个类似于Twitter服务:

    struct Tweet {1: required i32 userId; // (1)2: required string userName; // (2)3: required string text;4: optional Location loc; // (3)16: optional string language = "english" // (4)}struct Location { // (5)1: required double latitude;2: required double longitude;}

     (1) 每个域有一个唯一的正整数标识符;

     (2) 每个域可标识为required或optional;

     (3) 结构体可以包含其它结构体

     (4) 域可有默认值,与required或optional无关。

     (5) Thrift文件可以定义多个结构体,并在同一文件中引用,也可加入文件限定词在其它Thrift文件中引用。

      如上所见,消息定义中的每个域都有一个唯一数字标签,这些数字标签在传输时用来确定域,一旦使用消息类型,标签不可改变。(随着项目的进展,可以要变更Thrift文件,最好不要改变原有的数字标签

      规范的struct定义中的每个域均会使用required或者optional关键字进行标识。如果required标识的域没有赋值,Thrift将给予提示;如果optional标识的域没有赋值,该域将不会被序列化传输;如果某个optional标识域有缺省值而用户没有新赋值,则该域的值一直为缺省值;如果某个optional标识域有缺省值或者用户已经重新赋值,而不设置它的__isset为true,也不会被序列化传输。(不被序列化传输的后果是什么?为空为零?还是默认值,下次试试)

      与services不同,结构体不支持继承。

    2.9 服务定义(Defining Services)

      在流行的序列化/反序列化框架(如protocal buffer)中,Thrift是少有的提供多语言间RPC服务的框架。这是Thrift的一大特色。

      Thrift编译器会根据选择的目标语言为server产生服务接口代码,为client产生stubs。

    service Twitter {// A method definition looks like C code. It has a return type, arguments,// and optionally a list of exceptions that it may throw. Note that argument// lists and exception list are specified using the exact same syntax as// field lists in structs.void ping(), // (1)bool postTweet(1:Tweet tweet); // (2)TweetSearchResult searchTweets(1:string query); // (3)// The 'oneway' modifier indicates that the client only makes a request and// does not wait for any response at all. Oneway methods MUST be void.oneway void zip() // (4)}
     (1) 有点乱,接口支持以逗号和分号结束;
     (2) 参数可以是基本类型和结构体;(参数是cosnt的,转换为c++语言是const&)
     (3) 返回值同参数一样;
     (4) 返回值是void,注意oneway;

    Note that:参数列表的定义与结构体一样。服务支持继承。

     

    源地址:http://www.cnblogs.com/tianhuilove/archive/2011/09/05/2167669.html 

    展开全文
  • Thrift数据类型

    2017-01-04 14:32:09
    基本类型: bool:布尔值 true或false 对应java的boolean byte:8位有符号为整数 对应java的byte i16:16位有符号为整数 对应java的short i32:32位有符号为整数 对应java的int i64:64位有符号为整数 对应...

    基本类型:

    bool:布尔值 true或false 对应java的boolean

    byte:8位有符号为整数 对应java的byte

    i16:16位有符号为整数 对应java的short

    i32:32位有符号为整数 对应java的int

    i64:64位有符号为整数 对应java的long

    double:64位浮点数 对应java的double

    string:utf-8编码的字符串 对应java的String

    结构体类型:

    struct:定义公共的对象,类似于C语言中的结构体定义,在java中是一个JavaBean

    容器类型:

    list:对应Java的ArrayList

    set:对应Java的HashSet

    map:对应Java的HashMap

    异常类型:

    exception:对应Java的Exception

    服务类型:

    service:对应服务的类

    展开全文
  • thrift 数据类型

    2012-09-05 21:06:13
    thrift通过IDL生成Client和Processor,然后调用 protocol 和 transport     Thrift有多种可选的 protocol ,transport和server   支持的protocol   TBinaryProtocol 直接的二进制格式  ...

    thrift通过IDL生成Client和Processor,然后调用 protocol 和 transport
     

     


    Thrift有多种可选的 protocol ,transport和server
     
    支持的protocol
     
    TBinaryProtocol  直接的二进制格式
     TCompactProtocol  高效和压缩的二进制格式
     TDenseProtocoal  与TCompactProtocol相比,meta信息略有不同
     TJSONProtocoal  JSON
     TDebugProtocoal  text 格式 方便调试
     

     


    支持的 transport
     
    TSocket  阻塞的io
     TFramedTransport   非阻塞io
     TFileTransport   可以将一组thrift请求写到文件中
     TMemoryTransport   使用内存 I/O
     TZlibTransport 使用zlib压缩
     

     


    支持的server
     
    TSimpleServer  单线程 阻塞
     TThreadPoolServer  多线程  阻塞
     TNonblockingServer  多线程  非阻塞
     

    THsHaServer api说是TNonblockingServer的扩展,半同步半异步,我也看晕了,望指点。。
     

     


    可定义的数据类型:
     
    基本类型:
     
    bool:布尔值,true 或 false,对应 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
     
    结构体类型:
     
    struct:定义公共的对象,类似于 C 语言中的结构体定义,在 Java 中是一个 JavaBean
     
    容器类型:
     
    list:对应 Java 的 ArrayList
     
    set:对应 Java 的 HashSet
     
    map:对应 Java 的 HashMap
     
    异常类型:
     
    exception:对应 Java 的 Exception
     
    服务类型:
     
    service:对应服务的类

    展开全文
  • Java Thrift数据类型

    2019-08-31 21:46:09
    1.基本类型(括号内为对应的Java类型) bool(boolean): 布尔类型(TRUE or FALSE) byte(byte): 8位带符号整数 i16(short): 16位带符号整数 i32(int): 32位带符号整数 i64(long): 64位带符号整数 double...

    1.基本类型(括号内为对应的Java类型)

    bool(boolean): 布尔类型(TRUE or FALSE)
    byte(byte): 8位带符号整数
    i16(short): 16位带符号整数
    i32(int): 32位带符号整数
    i64(long): 64位带符号整数
    double(double): 64位浮点数
    string(String): 采用UTF-8编码的字符串

    2.特殊类型(括号内为对应的Java类型)

    binary(ByteBuffer):未经过编码的字节流

    3.struct(结构体)
    struct定义了一个很普通的OOP对象,但是没有继承特性。

    struct UserProfile {
    1: i32 uid,
    2: string name,
    3: string blurb
    }

    如果变量有默认值,可以直接写在定义文件里:

    struct UserProfile {
    1: i32 uid = 1,
    2: string name = "User1",
    3: string blurb
    }

    4.容器

    Thrift还支持以下容器类型:

    list(java.util.ArrayList);
    set(java.util.HashSet);
    map(java.util.HashMap);

    Thrift容器与类型密切相关,它与当前流行编程语言提供的容器类型相对应,采用java泛型风格表示的。Thrift提供了3种容器类型:

    List<t1>:一系列t1类型的元素组成的有序表,元素可以重复

    Set<t1>:一系列t1类型的元素组成的无序表,元素唯一

    Map<t1,t2>:key/value对(key的类型是t1且key唯一,value类型是t2)。

    容器中的元素类型可以是除了service意外的任何合法thrift类型(包括结构体和异常)。

    用法如下:

    struct Node {
    1: i32 id,
    2: string name,
    3: list<i32> subNodeList,
    4: map<i32,string> subNodeMap,
    5: set<i32> subNodeSet
    }

    包含定义的其他Object:

    struct SubNode {
    1: i32 uid,
    2: string name,
    3: i32 pid
    }
    
    struct Node {
    1: i32 uid,
    2: string name,
    3: list<subNode> subNodes
    }

     

    展开全文
  • thrift数据类型不同引起的传输问题

    千次阅读 2014-08-29 22:49:38
    下面都是实验通过的。 (1)
  • thrift常见数据类型

    千次阅读 2017-04-12 16:12:16
    要编写Thrift定义文件,肯定要熟悉Thrift常见的数据类型: 1.基本类型(括号内为对应的Java类型): bool(boolean): 布尔类型(TRUE or FALSE) byte(byte): 8位带符号整数 i16(short): 16位带符号整数 i...
  • Thrift数据类型

    万次阅读 2015-10-23 14:42:00
    要编写Thrift定义文件,肯定要熟悉Thrift常见的数据类型: 1.基本类型(括号内为对应的Java类型): bool(boolean): 布尔类型(TRUE or FALSE) byte(byte): 8位带符号整数 i16(short): 16位带符号整数 i32...
  • Thrift基本数据类型

    2015-12-10 11:37:00
    要编写Thrift定义文件,肯定要熟悉Thrift常见的数据类型: 1.基本类型(括号内为对应的Java类型): bool(boolean): 布尔类型(TRUE or FALSE) byte(byte): 8位带符号整数 i16(short): 16位带符号整数 i...
  • Thrift数据类型

    2017-01-13 16:15:40
    ...   ...要编写Thrift定义文件,肯定要熟悉Thrift常见的数据类型: 1.基本类型(括号内为对应的Java类型):bool(boolean): 布尔类型(TRUE or FALSE)byte(byte): 8位带符号整数i16(short)...
  • Thrift数据类型系统

    千次阅读 2013-05-19 15:03:52
    Thrift类型系统目的是让编程人员尽可能的使用原生的类型,而不必关心它们所有工作的编程语言。本文的内容是基于Thrift白皮书,并且会替代其中的内容。Thrift IDL提供了用于生成每种目标语言代码的类型说明。 基本...
  • 1.数据类型和结构 http://thrift.apache.org/docs/types 总算用thrift把算法模型跑通了 之后有空再写咯
  • 我们知道,thrift/swift框架中,服务端的数据类型与client的类型是相互独立的,比如服务端有一个ClassA类型,到了client端,同样也会生成一个同名的类。服务端和client相互通信时,client的 ClassA会被转成数据流(二...
  •  Thrift类型系统目的是让编程人员尽可能的应用原生的类型,而不必关心它们所有工作的编程语言。本文的内容是基于Thrift白皮书,并且会替换其中的内容。Thrift IDL提供了用于生成每种目标语言代码的类型说明。  .....
  • 'bool' | 'byte' | 'i8' | 'i16' | 'i32' | 'i64' | 'double' | 'string' | 'binary' | 'slist'(deprecated)list | map | set 转载于:https://www.cnblogs.com/feicheninfo/p/9719087.html
  • thrift数据结构

    千次阅读 2016-06-13 10:14:50
    要编写Thrift定义文件,肯定要熟悉Thrift常见的数据类型: 1.基本类型(括号内为对应的Java类型): bool(boolean): 布尔类型(TRUE or FALSE) byte(byte): 8位带符号整数 i16(short): 16位带符号整数 i32...
  • Thrift(二)——数据类型

    千次阅读 2018-07-30 00:38:04
    Thrift采用IDL...Thrift数据类型包含以下基本数据类型、结构体、容器、枚举等。 基本数据类型 基本数据类型简单明了,包含了所有编程语言中的可用基本数据类型。 bool:布尔值(true/false) byte:8...

空空如也

1 2 3 4 5 ... 20
收藏数 509
精华内容 203
关键字:

thrift 数据类型