Thrift入门及Java实例演示
作者: Michael 日期: 年 月 日 •概述
•下载配置 •基本概念
.数据类型
.服务端编码基本步骤 .客户端编码基本步骤 .数据传输协议 •实例演示(java)
. thrift生成代码
. 实现接口Iface
.TSimpleServer服务模型
.TThreadPoolServer 服务模型
.TNonblockingServer 服务模型
.THsHaServer服务模型
.异步客户端
[一]、概述 Thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发。它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, Smalltalk, and OCaml 等等编程语言间无缝结合的、高效的服务。 Thrift最初由facebook开发,07年四月开放源码,08年5月进入apache孵化器。thrift允许你定义一个简单的定义文件中的数据类型和服务接口。以作为输入文件,编译器生成代码用来方便地生成RPC客户端和服务器通信的无缝跨编程语言。 官网地址:thrift.apache.org 推荐值得一看的文章: •http://jnb.ociweb.com/jnb/jnbJun2009.html •http://wiki.apache.org/thrift
•http://thrift.apache.org/static/files/thrift-20070401.pdf
[二]、下载配置 到官网下载最新版本,截止今日(--)最新版本为0.8.0. . 如果是Maven构建项目的,直接在pom.xml 中添加如下内容: 查看源代码打印帮助
<dependency> <groupId>org.apache.thrift</groupId> <artifactId>libthrift</artifactId> <version>0.8.</version> </dependency>
.如果自己编译lib包,把下载的压缩包解压到X:盘,然后在X:\thrift-0.8.\lib\java 目录下运行ant进行自动编译,会在X:\thrift-0.8.\lib\java\build\ 目录下看到编译好的lib包:libthrift-0.8..jar [三]、基本概念 .数据类型 •基本类型:
◦bool:布尔值,true 或 false,对应 Java 的 boolean
◦byte: 位有符号整数,对应 Java 的 byte
◦i16: 位有符号整数,对应 Java 的 short
◦i32: 位有符号整数,对应 Java 的 int
◦i64: 位有符号整数,对应 Java 的 long
◦double: 位浮点数,对应 Java 的 double
◦string:utf-8编码的字符串,对应 Java 的 String
•结构体类型:
◦struct:定义公共的对象,类似于 C 语言中的结构体定义,在 Java 中是一个 JavaBean
•容器类型:
◦list:对应 Java 的 ArrayList
◦set:对应 Java 的 HashSet
◦map:对应 Java 的 HashMap
•异常类型:
◦exception:对应 Java 的 Exception
•服务类型:
◦service:对应服务的类
.服务端编码基本步骤: •实现服务处理接口impl
•创建TProcessor
•创建TServerTransport
•创建TProtocol
•创建TServer
•启动Server
.客户端编码基本步骤: •创建Transport
•创建TProtocol
•基于TTransport和TProtocol创建 Client
•调用Client的相应方法
.数据传输协议 •TBinaryProtocol : 二进制格式.
•TCompactProtocol : 压缩格式
•TJSONProtocol : JSON格式
•TSimpleJSONProtocol : 提供JSON只写协议, 生成的文件很容易通过脚本语言解析
tips:客户端和服务端的协议要一致 [四]、实例演示 . thrift生成代码 创建Thrift文件:G:\test\thrift\demoHello.thrift ,内容如下: 查看源代码打印帮助
namespace java com.micmiu.thrift.demo service HelloWorldService { string sayHello(:string username) }
目录结构如下: G:\test\thrift>tree /F
卷 other 的文件夹 PATH 列表
卷序列号为 D238-BE47
G:.
demoHello.thrift
demouser.thrift
thrift-0.8..exe 没有子文件夹thrift-0.8..exe 是官网提供的windows下编译工具,运用这个工具生成相关代码: 查看源代码打印帮助
thrift-0.8..exe -r -gen java ./demoHello.thrift
生成后的目录结构如下: G:\test\thrift>tree /F
卷 other 的文件夹 PATH 列表
卷序列号为 D238-BE47
G:.
│ demoHello.thrift
│ demouser.thrift
│ thrift-0.8..exe

└─gen-java
└─com
└─micmiu
└─thrift
└─demo
HelloWorldService.java将生成的HelloWorldService.java 文件copy到自己测试的工程中,我的工程是用maven构建的,故在pom.xml中增加如下内容: 查看源代码打印帮助
<dependency> <groupId>org.apache.thrift</groupId> <artifactId>libthrift</artifactId> <version>0.8.</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.5.</version> </dependency>
. 实现接口Iface java代码:HelloWorldImpl.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TException; /** 6 * blog http://www.micmiu.com 7 * 8 * @author Michael 9 * 10 */ public class HelloWorldImpl implements HelloWorldService.Iface { public HelloWorldImpl() { } @Override public String sayHello(String username) throws TException { return "Hi," + username + " welcome to my blog www.micmiu.com"; } }
.TSimpleServer服务端 简单的单线程服务模型,一般用于测试。 编写服务端server代码:HelloServerDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.protocol.TJSONProtocol; import org.apache.thrift.protocol.TSimpleJSONProtocol; import org.apache.thrift.server.TServer; import org.apache.thrift.server.TSimpleServer; import org.apache.thrift.transport.TServerSocket; /** 13 * blog http://www.micmiu.com 14 * 15 * @author Michael 16 * 17 */ public class HelloServerDemo { public static final int SERVER_PORT = ; public void startServer() { try { System.out.println("HelloWorld TSimpleServer start ...."); TProcessor tprocessor = new HelloWorldService.Processor<HelloWorldService.Iface>( new HelloWorldImpl()); // HelloWorldService.Processor<HelloWorldService.Iface> tprocessor = // new HelloWorldService.Processor<HelloWorldService.Iface>( // new HelloWorldImpl()); // 简单的单线程服务模型,一般用于测试 TServerSocket serverTransport = new TServerSocket(SERVER_PORT); TServer.Args tArgs = new TServer.Args(serverTransport); tArgs.processor(tprocessor); tArgs.protocolFactory(new TBinaryProtocol.Factory()); // tArgs.protocolFactory(new TCompactProtocol.Factory()); // tArgs.protocolFactory(new TJSONProtocol.Factory()); TServer server = new TSimpleServer(tArgs); server.serve(); } catch (Exception e) { System.out.println("Server start error!!!"); e.printStackTrace(); } } /** 48 * @param args 49 */ public static void main(String[] args) { HelloServerDemo server = new HelloServerDemo(); server.startServer(); } }
编写客户端Client代码:HelloClientDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TException; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.protocol.TJSONProtocol; import org.apache.thrift.protocol.TProtocol; import org.apache.thrift.transport.TSocket; import org.apache.thrift.transport.TTransport; import org.apache.thrift.transport.TTransportException; /** 13 * blog http://www.micmiu.com 14 * 15 * @author Michael 16 * 17 */ public class HelloClientDemo { public static final String SERVER_IP = "localhost"; public static final int SERVER_PORT = ; public static final int TIMEOUT = ; /** 25 * 26 * @param userName 27 */ public void startClient(String userName) { TTransport transport = null; try { transport = new TSocket(SERVER_IP, SERVER_PORT, TIMEOUT); // 协议要和服务端一致 TProtocol protocol = new TBinaryProtocol(transport); // TProtocol protocol = new TCompactProtocol(transport); // TProtocol protocol = new TJSONProtocol(transport); HelloWorldService.Client client = new HelloWorldService.Client( protocol); transport.open(); String result = client.sayHello(userName); System.out.println("Thrify client result =: " + result); } catch (TTransportException e) { e.printStackTrace(); } catch (TException e) { e.printStackTrace(); } finally { if (null != transport) { transport.close(); } } } /** 53 * @param args 54 */ public static void main(String[] args) { HelloClientDemo client = new HelloClientDemo(); client.startClient("Michael"); } }
先运行服务端程序,日志如下: HelloWorld TSimpleServer start ....再运行客户端调用程序,日志如下: Thrify client result =: Hi,Michael welcome to my blog www.micmiu.com测试成功,和预期的返回信息一致。 .TThreadPoolServer 服务模型 线程池服务模型,使用标准的阻塞式IO,预先创建一组线程处理请求。 编写服务端代码:HelloServerDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.server.TServer; import org.apache.thrift.server.TThreadPoolServer; import org.apache.thrift.transport.TServerSocket; /** 10 * blog http://www.micmiu.com 11 * 12 * @author Michael 13 * 14 */ public class HelloServerDemo { public static final int SERVER_PORT = ; public void startServer() { try { System.out.println("HelloWorld TThreadPoolServer start ...."); TProcessor tprocessor = new HelloWorldService.Processor<HelloWorldService.Iface>( new HelloWorldImpl()); TServerSocket serverTransport = new TServerSocket(SERVER_PORT); TThreadPoolServer.Args ttpsArgs = new TThreadPoolServer.Args( serverTransport); ttpsArgs.processor(tprocessor); ttpsArgs.protocolFactory(new TBinaryProtocol.Factory()); // 线程池服务模型,使用标准的阻塞式IO,预先创建一组线程处理请求。 TServer server = new TThreadPoolServer(ttpsArgs); server.serve(); } catch (Exception e) { System.out.println("Server start error!!!"); e.printStackTrace(); } } /** 42 * @param args 43 */ public static void main(String[] args) { HelloServerDemo server = new HelloServerDemo(); server.startServer(); } }
客户端Client代码和之前的一样,只要数据传输的协议一致即可,客户端测试成功,结果如下: Thrify client result =: Hi,Michael welcome to my blog www.micmiu.com5.TNonblockingServer 服务模型 使用非阻塞式IO,服务端和客户端需要指定 TFramedTransport 数据传输的方式。 编写服务端代码:HelloServerDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.server.TNonblockingServer; import org.apache.thrift.server.TServer; import org.apache.thrift.transport.TFramedTransport; import org.apache.thrift.transport.TNonblockingServerSocket; /** 11 * blog http://www.micmiu.com 12 * 13 * @author Michael 14 * 15 */ public class HelloServerDemo { public static final int SERVER_PORT = ; public void startServer() { try { System.out.println("HelloWorld TNonblockingServer start ...."); TProcessor tprocessor = new HelloWorldService.Processor<HelloWorldService.Iface>( new HelloWorldImpl()); TNonblockingServerSocket tnbSocketTransport = new TNonblockingServerSocket( SERVER_PORT); TNonblockingServer.Args tnbArgs = new TNonblockingServer.Args( tnbSocketTransport); tnbArgs.processor(tprocessor); tnbArgs.transportFactory(new TFramedTransport.Factory()); tnbArgs.protocolFactory(new TCompactProtocol.Factory()); // 使用非阻塞式IO,服务端和客户端需要指定TFramedTransport数据传输的方式 TServer server = new TNonblockingServer(tnbArgs); server.serve(); } catch (Exception e) { System.out.println("Server start error!!!"); e.printStackTrace(); } } /** 45 * @param args 46 */ public static void main(String[] args) { HelloServerDemo server = new HelloServerDemo(); server.startServer(); } }
编写客户端代码:HelloClientDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TException; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.protocol.TProtocol; import org.apache.thrift.transport.TFramedTransport; import org.apache.thrift.transport.TSocket; import org.apache.thrift.transport.TTransport; import org.apache.thrift.transport.TTransportException; /** 12 * blog http://www.micmiu.com 13 * 14 * @author Michael 15 * 16 */ public class HelloClientDemo { public static final String SERVER_IP = "localhost"; public static final int SERVER_PORT = ; public static final int TIMEOUT = ; /** 24 * 25 * @param userName 26 */ public void startClient(String userName) { TTransport transport = null; try { transport = new TFramedTransport(new TSocket(SERVER_IP, SERVER_PORT, TIMEOUT)); // 协议要和服务端一致 TProtocol protocol = new TCompactProtocol(transport); HelloWorldService.Client client = new HelloWorldService.Client( protocol); transport.open(); String result = client.sayHello(userName); System.out.println("Thrify client result =: " + result); } catch (TTransportException e) { e.printStackTrace(); } catch (TException e) { e.printStackTrace(); } finally { if (null != transport) { transport.close(); } } } /** 51 * @param args 52 */ public static void main(String[] args) { HelloClientDemo client = new HelloClientDemo(); client.startClient("Michael"); } }
客户端的测试成功,结果如下: Thrify client result =: Hi,Michael welcome to my blog www.micmiu.com6.THsHaServer服务模型 半同步半异步的服务端模型,需要指定为: TFramedTransport 数据传输的方式。 编写服务端代码:HelloServerDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.server.THsHaServer; import org.apache.thrift.server.TNonblockingServer; import org.apache.thrift.server.TServer; import org.apache.thrift.server.TSimpleServer; import org.apache.thrift.server.TThreadPoolServer; import org.apache.thrift.transport.TFramedTransport; import org.apache.thrift.transport.TNonblockingServerSocket; import org.apache.thrift.transport.TServerSocket; /** 16 * blog http://www.micmiu.com 17 * 18 * @author Michael 19 * 20 */ public class HelloServerDemo { public static final int SERVER_PORT = ; public void startServer() { try { System.out.println("HelloWorld THsHaServer start ...."); TProcessor tprocessor = new HelloWorldService.Processor<HelloWorldService.Iface>( new HelloWorldImpl()); TNonblockingServerSocket tnbSocketTransport = new TNonblockingServerSocket( SERVER_PORT); THsHaServer.Args thhsArgs = new THsHaServer.Args(tnbSocketTransport); thhsArgs.processor(tprocessor); thhsArgs.transportFactory(new TFramedTransport.Factory()); thhsArgs.protocolFactory(new TBinaryProtocol.Factory()); //半同步半异步的服务模型 TServer server = new THsHaServer(thhsArgs); server.serve(); } catch (Exception e) { System.out.println("Server start error!!!"); e.printStackTrace(); } } /** 49 * @param args 50 */ public static void main(String[] args) { HelloServerDemo server = new HelloServerDemo(); server.startServer(); } }
客户端代码和上面 中的类似,只要注意传输协议一致以及指定传输方式为TFramedTransport。 .异步客户端 编写服务端代码:HelloServerDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.server.TNonblockingServer; import org.apache.thrift.server.TServer; import org.apache.thrift.transport.TFramedTransport; import org.apache.thrift.transport.TNonblockingServerSocket; /** 11 * blog http://www.micmiu.com 12 * 13 * @author Michael 14 * 15 */ public class HelloServerDemo { public static final int SERVER_PORT = ; public void startServer() { try { System.out.println("HelloWorld TNonblockingServer start ...."); TProcessor tprocessor = new HelloWorldService.Processor<HelloWorldService.Iface>( new HelloWorldImpl()); TNonblockingServerSocket tnbSocketTransport = new TNonblockingServerSocket( SERVER_PORT); TNonblockingServer.Args tnbArgs = new TNonblockingServer.Args( tnbSocketTransport); tnbArgs.processor(tprocessor); tnbArgs.transportFactory(new TFramedTransport.Factory()); tnbArgs.protocolFactory(new TCompactProtocol.Factory()); // 使用非阻塞式IO,服务端和客户端需要指定TFramedTransport数据传输的方式 TServer server = new TNonblockingServer(tnbArgs); server.serve(); } catch (Exception e) { System.out.println("Server start error!!!"); e.printStackTrace(); } } /** 45 * @param args 46 */ public static void main(String[] args) { HelloServerDemo server = new HelloServerDemo(); server.startServer(); } }
编写客户端Client代码:HelloAsynClientDemo.java 查看源代码打印帮助
package com.micmiu.thrift.demo; import java.util.concurrent.CountDownLatch; import java.util.concurrent.TimeUnit; import org.apache.thrift.TException; import org.apache.thrift.async.AsyncMethodCallback; import org.apache.thrift.async.TAsyncClientManager; import org.apache.thrift.protocol.TCompactProtocol; import org.apache.thrift.protocol.TProtocolFactory; import org.apache.thrift.transport.TNonblockingSocket; import org.apache.thrift.transport.TNonblockingTransport; import com.micmiu.thrift.demo.HelloWorldService.AsyncClient.sayHello_call; /** 17 * blog http://www.micmiu.com 18 * 19 * @author Michael 20 * 21 */ public class HelloAsynClientDemo { public static final String SERVER_IP = "localhost"; public static final int SERVER_PORT = ; public static final int TIMEOUT = ; /** 29 * 30 * @param userName 31 */ public void startClient(String userName) { try { TAsyncClientManager clientManager = new TAsyncClientManager(); TNonblockingTransport transport = new TNonblockingSocket(SERVER_IP, SERVER_PORT, TIMEOUT); TProtocolFactory tprotocol = new TCompactProtocol.Factory(); HelloWorldService.AsyncClient asyncClient = new HelloWorldService.AsyncClient( tprotocol, clientManager, transport); System.out.println("Client start ....."); CountDownLatch latch = new CountDownLatch(); AsynCallback callBack = new AsynCallback(latch); System.out.println("call method sayHello start ..."); asyncClient.sayHello(userName, callBack); System.out.println("call method sayHello .... end"); boolean wait = latch.await(, TimeUnit.SECONDS); System.out.println("latch.await =:" + wait); } catch (Exception e) { e.printStackTrace(); } System.out.println("startClient end."); } public class AsynCallback implements AsyncMethodCallback<sayHello_call> { private CountDownLatch latch; public AsynCallback(CountDownLatch latch) { this.latch = latch; } @Override public void onComplete(sayHello_call response) { System.out.println("onComplete"); try { // Thread.sleep(1000L * 1); System.out.println("AsynCall result =:" + response.getResult().toString()); } catch (TException e) { e.printStackTrace(); } catch (Exception e) { e.printStackTrace(); } finally { latch.countDown(); } } @Override public void onError(Exception exception) { System.out.println("onError :" + exception.getMessage()); latch.countDown(); } } /** 87 * @param args 88 */ public static void main(String[] args) { HelloAsynClientDemo client = new HelloAsynClientDemo(); client.startClient("Michael"); } }
先运行服务程序,再运行客户端程序,测试结果如下: Client start .....
call method sayHello start ...
call method sayHello .... end
onComplete
AsynCall result =:Hi,Michael welcome to my blog www.micmiu.com
latch.await =:true
startClient end.———— 原创文章,转载请注明: 转载自micmiu – 软件开发+生活点滴[ http://www.micmiu.com/ ] 本文链接地址: http://www.micmiu.com/soa/rpc/thrift-sample/

Thrift入门及Java实例演示<转载备用>的更多相关文章

  1. Thrift入门及Java实例演示

    目录: 概述 下载配置 基本概念 数据类型 服务端编码基本步骤 客户端编码基本步骤 数据传输协议 实例演示(java) thrift生成代码 实现接口Iface TSimpleServer服务模型 T ...

  2. Thrift入门及Java实例演示【转】

    概述 Thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发.它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++.Java.Python.PHP.Ruby.Erlang.Perl.Ha ...

  3. Apache Thrift学习之一(入门及Java实例演示)

    目录: 概述 下载配置 基本概念 数据类型 服务端编码基本步骤 客户端编码基本步骤 数据传输协议 实例演示(java) thrift生成代码 实现接口Iface TSimpleServer服务模型 T ...

  4. Apache Thrift with Java Quickstart(thrift入门及Java实例)

    thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发.它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++, Java, Python, PHP, Ruby, Erlang, Perl ...

  5. iOS架构入门 - MVC模式实例演示

    MVC模式的目的是实现一种动态的程序设计,使后续对程序的修改和扩展简化,并且使程序某一部分的重复利用成为可能.除此之外,此模式通过对复杂度的简化,使程序结构更加直观 控制器(Controller)-- ...

  6. 【thrift】thrift入门初探--thrift安装及java入门实例

    转载:https://www.cnblogs.com/fingerboy/p/6424248.html 公司的一些平台服务框架底层封装了thrift提供服务,最近项目不是很紧,于是研究了一下,刚刚入门 ...

  7. Thrift入门初探--thrift安装及java入门实例

    什么是thrift? 简单来说,是Facebook公布的一款开源跨语言的RPC框架. 那么问题来了. 什么是RPC框架? RPC全称为Remote Procedure Call,意为远程过程调用. 假 ...

  8. RPC学习----Thrift快速入门和Java简单示例

    一.什么是RPC? RPC(Remote Procedure Call Protocol)——远程过程调用协议,它是一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的协议. RPC协议 ...

  9. JAVA之旅(十二)——Thread,run和start的特点,线程运行状态,获取线程对象和名称,多线程实例演示,使用Runnable接口

    JAVA之旅(十二)--Thread,run和start的特点,线程运行状态,获取线程对象和名称,多线程实例演示,使用Runnable接口 开始挑战一些难度了,线程和I/O方面的操作了,继续坚持 一. ...

随机推荐

  1. 个人项目制作(PSP)

    计划: 软件的此功能的实现,个人估算需要一个周的时间. 开发阶段: 需求分析: 1> 运动员希望软件可以记录自己的得分项. 2> 运动员希望软件可以记录自己的得分具体细节. 3>运动 ...

  2. Codeforces Round #389 (Div. 2, Rated, Based on Technocup 2017 - Elimination Round 3) B

    Description Santa Claus decided to disassemble his keyboard to clean it. After he returned all the k ...

  3. jquery.Huploadify 上传

    html <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3 ...

  4. sudo: no tty present and no askpass program specified(转)

    sudo: no tty present and no askpass program specified 2012-11-30 09:30 5040人阅读 评论(1) 收藏 举报 修改sudo配置文 ...

  5. 读《编写可维护的JavaScript》第七章总结

      第七章 事件处理 7.1 典型用法 作者首先给了个我们一个处理事件的方法.看起来也没啥俩样,不过后来给出的优化方法很值得学习: // 不好的写法 function handleClick(even ...

  6. [转]抓取安卓APP内接口的方法--Charles

    http://blog.csdn.net/yyh352091626/article/details/52759294

  7. MySQL索引原理及慢查询优化 转载

    原文地址: http://tech.meituan.com/mysql-index.html MySQL凭借着出色的性能.低廉的成本.丰富的资源,已经成为绝大多数互联网公司的首选关系型数据库.虽然性能 ...

  8. U盘修复

    方法一: 1.点开始-运行-输入cmd-format f: /fs: FAT32 (这里f:是指U盘所在盘符) 2.打开控制面板-管理工具-计算机管理-磁盘管理-找到U盘的所在的盘符--点右键--删除 ...

  9. JS 之JSON

    JSON是Javascript中的对象,其简单理解为下:

  10. File system needs to be upgraded. You have version null and I want version 7

    安装hbase时候报错: File system needs to be upgraded. You have version null and I want version 7 注: 我安装的hba ...