thrift系列 - 快速入门

1.简介
            Thrift是当前流行的RPC框架之一，它有强大的代码生成引擎，可以跨语言，轻松解决程序间的通信问题。

本文旨在帮助大家快速入门，若想深入原理，请参见thrift官网：http://thrift.apache.org/。（大家都很忙，少说废话）

2.下载windows版的IDL compiler

     访问地址：http://www.apache.org/dyn/closer.cgi?path=/thrift/0.9.3/thrift-0.9.3.exe，在打开的页面中，任选一个资源下载。
      下载完成后，假设我把thrift-0.9.3.exe文件移到"F:\test\thrift\bin"（你想移到哪儿你随意） 这个文件夹下。

3.定义接口文件

      新建一个名为test.thrift的文件。以下是该文件里的内容：
      

namespace java test.thrift_test

service TestService {
  string getStruct(1: i32 num,2: string name)
}

           这就是一个很简单的接口文件。thrift的引擎（此处你可以理解为thrift-0.9.3.exe），就要利用test.thrift生成你指定的语言的代码。这个接口有两个参数，一个是32位的整数，一个是一个字符串，返回值的类型也是一个字符串。关于接口文件定义的方式，请参见下一篇文章《thrift类型定义》。

4.利用接口文件生成代码

     打开windows的命令行（这个你不要问我）。切换到"F:\test\thrift\bin"（第2步的时候说过）
     使用命令：thrift-0.9.3.exe -r --gen java test.thrift
     打开"F:\test\thrift\bin"这个目录，你会发现有一个名为"gen-java"的文件夹，该文件夹下就是生成的java代码。

5.搭建maven环境

     利用你的Java IDE构建一个maven工程。这里是pom.xml中需要添加的内容：

<dependency>
	<groupId>org.apache.thrift</groupId>
	<artifactId>libthrift</artifactId>
	<version>0.9.3</version>
</dependency>

        这里面有thrift运行时所需要的所有依赖jar。

    注意，请把gen-java文件夹下的代码粘贴到工程中去！

6.java版demo

     首先把首先实现TestService接口：

package test.thrift_test;

import org.apache.thrift.TException;

import test.thrift_test.TestService.Iface;

//我们定义的test.thrift的接口的具体实现
class TestServiceHandler implements Iface{

	public String getStruct(int num, String name) throws TException {
		return name + num;
	}
	
}

         Thrift是CS的通信方式，即有一个server端，和一个client端。

     以下是Server端的示例代码：

package test.thrift_test;

import org.apache.thrift.server.TServer;
import org.apache.thrift.server.TServer.Args;
import org.apache.thrift.server.TSimpleServer;
import org.apache.thrift.transport.TServerSocket;
import org.apache.thrift.transport.TServerTransport;
import org.apache.thrift.transport.TTransportException;

public class Server 
{
	public static void main( String[] args ){
    	try {
    		TestService.Processor processor = new TestService.Processor(new TestServiceHandler());
    		
		TServerTransport serverTransport = new TServerSocket(9090);
		TServer server = new TSimpleServer(new Args(serverTransport).processor(processor));
		server.serve();
		    
	} catch (TTransportException e) {
		e.printStackTrace();
	}
    }
}

      

        以下是Client端的示例代码：

package test.thrift_test;

import org.apache.thrift.TException;
import org.apache.thrift.protocol.TBinaryProtocol;
import org.apache.thrift.protocol.TProtocol;
import org.apache.thrift.transport.TSocket;
import org.apache.thrift.transport.TTransport;
import org.apache.thrift.transport.TTransportException;

public class Client {
	public static void main(String[] args) {
		TTransport transport = new TSocket("localhost", 9090);
		try {
			transport.open();
			TProtocol protocol = new TBinaryProtocol(transport);
			TestService.Client client = new TestService.Client(protocol);

			String result = client.getStruct(123, "test");
			System.out.println(result);
			transport.close();
		} catch (TTransportException e) {
			e.printStackTrace();
		} catch (TException e) {
			e.printStackTrace();
		}
	}
}

              启动的时候，先运行 Server.java，再运行Client.java。正常情况下，控制台输出结果为：test123

        本文内容参考如下：

        【1】http://thrift.apache.org/

        注意：
        如您发现本文档中有明显错误的地方，
        或者您发现本文档中引用了他人的资料而未进行说明时，请联系我进行更正。
        转载或使用本文档时，请作醒目说明。
        必要时请联系作者，否则将追究相应的法律责任。

        note:
        If you find this document with any error ,
        Or if you find any illegal citations , please contact me correct.
        Reprint or use of this document,Please explain for striking. 
        Please contact the author if necessary, or they will pursue the corresponding legal responsibility.