IDL:接口描述语言
这里使用thrift-0.8.0-xsb这个版本来介绍IDL的定义以及简单实例分析。
1. namespace 定义包名
2.struct 结构体,定义服务接口的参数和返回值用到的类结构。基本类型不需要使用struct.
3.service 定义接口:demo.thrift
namespace java com.thrift.demo struct Parameter {
1: required i32 id;
2: required string name;
} service DemoService {
i32 demoMethod(1:string param1, 2:Parameter param2, 3:map<string,string> param3);
}
命令行执行 thrift -r --gen java demo.thrift,生成gen-java文件夹,在eclipse下创建名为gen-java的工程,然后将生成的gen-java放入eclipse的工作空间,即可关联成为一个gen-java工程(也可以自定义一个java工程,然后将生成的代码导入,此时只有JRE-System Library,java文件均报错。手动创建一个新的文件夹将Thrift工程需要的jar包以及libthrift-0.8.0.jar放置到文件夹下,同时在Java Build Path中添加引用。我这里直接使用eclipse自动fixed setup 导入,然后就出现了Refferenced Libraries文件夹,文件夹中包含了libthrift-0.8.0.jar等需要的jar包。如下图所示:
可见:每个struct会单独生成一个类,每个service也会生成一个类。下面着重看下生成的Demoservice.java。
如上图所示,Demoservice.java中主要由5部分组成:
1.接口类型:Iface(同步调用) AsyncIface(异步调用)
2.客户端类型:Client AsynClient
3.方法参数封装类类型:demoMethod_args (方法名_args)
4.返回结果封装类类型:demoMethod_result(方法名_result)
5.Processor