thrift0.5入门操作
在探索未知的程序之前,我们往往会使用“Hello World”这个经典的输出作为测试,为了遵循这个惯例,作为thrift菜鸟都不算的一员,决定跑一下“Hello world”正式进入菜鸟的行列。
thrift通过一个跨语言的定义文件的方式定义数据类型和服务接口,这个文件作为RPC客户端和服务器通信的标准,所谓跨语言,就是客户端和服务器端的语言是没有限制的,可以相同也可以不同,本质上定义的服务和接口都是一样的。
下面是我用intellij跑的java的例子:
环境配置:
1. ubuntu 13
2. thrift 0.5.0
3. Intellij 13
1.在Intellij中创建maven项目,在pom.xml中添加项目需要的依赖:
<dependencies> <dependency> <groupId>org.apache.thrift</groupId> <artifactId>libthrift</artifactId> <version>0.5.0-cdh</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.7</version> </dependency> </dependencies>
2.在resources目录下新建helloworld.thrift文件,内容如下:
namespace java com.qiao.thrift.hello
service IHelloWorldService {
string sayHello(1:string username)
}
3.在命令端打开helloworld.thrift文件所在的目录,执行下面的命令:
thrift -r --gen java hello_world.thrift
这时目录下会产生gen-java目录,目录下就是thrift自动生成的代码。
4. 使用cp -r命令将com/tom/thrift/hello/IHelloWorldService.java目录连同文件copy到Maven模块的src/java/main下面。
5.在Maven模块中,自定义IHelloWorldService的实现类HelloWorldService,需要实现IHelloWorldService.Iface接口,不出意料,果然仅仅需要实现sayHello方法,类定义如下:
public class HelloWorldService implements IHelloWorldService.Iface { @Override public String sayHello(String username) throws TException { return "Hi,"+username+",Welcome to the thrift world"; } }
6.自定义单线程模式的ThriftServer用于响应客户端的rpc请求,注意一点,IHelloWorldService.Iface的实现类在服务器端进行了实例化:
public class HelloWorldSimpleServer { public static final int SERVER_PORT=8090; public void startServer(){ try{ System.out.println("Hello World TSimpleServer start..."); TProcessor tp=new IHelloWorldService.Processor(new HelloWorldService()); TServerTransport sT=new TServerSocket(SERVER_PORT); TServer server=new TSimpleServer(tp,sT); System.out.println("Starting the server"); server.serve(); }catch (Exception e){ System.out.println("Server start error!!"); e.printStackTrace(); } System.out.println("done."); } public static void main(String[] args){ HelloWorldSimpleServer server=new HelloWorldSimpleServer(); server.startServer(); } }
7.自定义HelloWorld的客户端,用于远程调用第6步Thrift Server提供的IHelloWorldService服务
public class HelloWorldSimpleClient { public void startClient(String userName) { TTransport transport = null; try { transport = new TSocket("localhost", 8090); TProtocol protocol = new TBinaryProtocol(transport); IHelloWorldService.Client client = new IHelloWorldService.Client(protocol); transport.open(); String res = client.sayHello(userName); System.out.println("Thrift result =:" + res); } catch (Exception x) { System.out.println("Start client Error!"); x.printStackTrace(); } finally { if (transport != null) { transport.close(); } } } public static void main(String[] args){ HelloWorldSimpleClient client=new HelloWorldSimpleClient(); client.startClient("qiao"); } }
8.启动HelloWorldSimpleServer,控制台输出HelloWorld TSimpleServer start ....,同时,HelloWorldSimpleServer作为Server一直处于运行过程中;启动HelloWorldSimpleClient,控制台输出Thrift client result =: Hi, Tom, Welcome to the Thrift world, enjoy it! 执行完后,客户端进程结束。
另外在运行过程中出现下面的警告:
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
原因是org.slf4j.impl.StaticLoggerBinder
无法载入到内存,原因是没有找到合适的绑定SLF4J,需要添加所列举的包中的某一个。解决方案是手动下载一个slf4j-nop.jar,然后添加到路径中就可以了。
另外比较全的代码例子为:https://github.com/mariusae/thrift-0.5.0-finagle.git