Thrift是什么,看这里:http://thrift.apache.org/
1.从官网下载thrift
Thrift官网:http://thrift.apache.org/,Windows 和 Linux请分别下载不同的版本。 在Windows上,将下载的压缩文件解压后,放到一个文件夹下,并为其配置环境变量,以便以后可以直接从命令行启用它。注意:在网上找找,将libthrift-0.9.0.jar和slfj-api-1.7.2.jar一起放入我们项目的lib文件夹下,并添加到项目的buildpath中,因为thrift生成的java文件中,将会引用到这两个包中的类。
2.编写thrift文件
thrift文件是一个文本文件,文件名自定义,后缀也自定义。但是为了方便理解,建议后缀写为:.thrift。一个thrift文件(Person.thrift)像下面这样:
namespace java com.abc.gen
struct Person{
1:i32 id;
2:string name;
3:int age;
4:bool married;
}
service PersonService {
Person getPersonById(1:i32 id) ,
bool deletePersonById(1:i32 id )
}
这个文件中,namespace描述了生成的类的包名;struct用于定义一种结构体(在Java中叫做对象),thrift将生成这个Person对象,Person对象中定义了几个基本的属性。service用于定义“服务”,这些“服务”将以接口的方式生成在类中。我们需要做的,就是待thrift为我们生成相应的文件之后,去实现这些接口。
3.用thrift生成自定义的类
使用命令:thrift -r -gen java Person.thrift 来生成我们需要的类。
其中-r表示递归,如果这个Person.thrift文件中又引用了其他thrift文件中定义的对象,那么在生成的时候,将会把引用的对象的thrift文件中定义的所有对象一起生成。
-gen Java 表示生成的是java语言的文件,最后一个参数表示定义thrift对象和服务的文件。
4.实现生成的接口
根据以上的thrift文件,生成之后的文件有Person.java和PersonService.java,其中PersonService.java类中有一个Iface接口,这个接口就是我们需要实现的。我们把这两个生成的Java类复制到我们的项目包中待用。现在,新建一个类PersonServiceImpl,这个类实现了PersonService.Iface。这里以方法getPersonById为例,为了简单起见,直接在PersonServiceImpl的getPersonById中new一个Person对象,设置相关的属性并返回。如下:
import org.apache.thrift.TException;
import com.abc.gen.Person;
import com.abc.gen.PersonService;
public class PersonServiceImpl implements PersonService.Iface {
@Override
public Person getPersonById(int id) throws TException {
Person p = new Person();
p.setId(id);
p.setAge(20);
p.setName("name");
p.isMarried(false);
return p;
}
@Override
public boolean deletePersonById(int id) throws TException {
// TODO Auto-generated method stub
return false;
}
}
其中这两个复写的接口,就是我们在Person.thrift中定义的service。
5.编写ThriftServer
import org.apache.thrift.server.TServer;
import org.apache.thrift.server.TThreadPoolServer;
import org.apache.thrift.server.TThreadPoolServer.Args;
import org.apache.thrift.transport.TServerSocket;
import org.apache.thrift.transport.TServerTransport;
import com.abc.gen.PersonService;
import com.abc.impl.PersonServiceImpl;
public class ThriftServer {
public static void main(String[] args) {
PersonService.Processor processor = new PersonService.Processor(new PersonServiceImpl());
try{
TServerTransport serverTransport = new TServerSocket( new InetSocketAddress("127.0.0.1",9999));
Args trArgs=new Args(serverTransport);
trArgs.processor(processor);
TServer server = new TThreadPoolServer(trArgs);
System.out.println("Thrift服务已开启...");
server.serve();
server.stop();
System.out.println("Thrift服务已停止...");
}catch(Exception e){
throw new RuntimeException("thrift服务启动失败"+"\n"+e.getMessage());
}
}
}
6.编写ThriftClient
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 com.abc.gen.Person;
import com.abc.gen.PersonService;
public class ThriftClient {
public static void main(String[] args) throws TException {
TTransport transport = new TSocket("127.0.0.1",9999);
long start=System.currentTimeMillis();
TProtocol protocol = new TBinaryProtocol(transport);
PersonService.Client client=new PersonService.Client(protocol);
transport.open();
System.out.println("调用开始...");
Person person = client.getPersonById(1);
System.out.println("调用结果:" + person.toString());
transport.close();
System.out.println("消耗时间:" + (System.currentTimeMillis()-start) + "ms");
}
}
7.调用
先启动ThriftServer,在启动ThriftClient,这时会看到以下内容:
Thrift服务已开启...
调用开始...
调用结果:Person(id:1, name:name, age:20, married:false)
消耗时间:115ms