Apache Thrift 官方JAVA教程

2022-04-15 22:37:40

本文所使用的开发环境是windows环境，利用的资源是官网给出的，只是网上搜了很多文章，都不是很明白，我把我自己的经历写出来分享给大家，大家互相学习，有好的建议，希望不吝赐教

1.下载需要的文件
地址：http://thrift.apache.org/download
exe和tg文件都要下载
2.设置自己的环境变量
2.1将下载的exe文件改名改成thrift.exe放在一个目录下（不是必须的，只是这样用起来比较方便）
2.2设置环境，在path这个里面加入刚才exe文件放的目录位置，比我的D:\thrift
2.3 打开cmd输入thrift，显示如下：

3.编译接口文件

把刚才下载的那个thrift-0.10.0.tar.gz文件解压
找到你需要用到的语言，我用的是java，我的路径是"D:\thrift\thrift-0.10.0\lib\java"
生成thrift文件，在此目录下执行语法：thrift -r --gen java tutorial.thrift
注意他的第二个参数-gen java可以换成你的语言，而我们测试用的文件名字叫tutorial.thrift （官网给了一个example：http://thrift.apache.org/tutorial/java，将里面的shared.thrift和tutorial.thrift都下载到本地），如果自己写也可以换成自己文件名字只是后缀必须是.thrift
执行后会出现一个gen-Java文件夹，里面包含两个包，每个包都有几个生成的Java文件，文件结构如下：

Apache Thrift 官方JAVA教程

现在我们可以利用生成的java文件创建java项目了

4.client和server

client和server代码都来自官网地址：

http://thrift.apache.org/tutorial/java

这里还涉及到另一个类——CalculatorHandler，但是并没有在同一个界面，我们在下面的界面可以找到：http://thrift.apache.org/

如果不知道怎么办，也可以直接从官方源码地址获取：

https://git1-us-west.apache.org/repos/asf?p=thrift.git;a=tree;f=tutorial/java/src;h=d56632301e9f9ff6c4ae5a5fd0f09bbb1c481ad3;hb=HEAD

5.编译需要的jar包

需要使用ant和ivy两个软件，ant配置不说了，将ivy解压后，将ivy-xx.jar拷贝到ant的lib目录下，然后在“D:\thrift\thrift-0.10.0\lib\java”（这是我的解压路径）下执行：
ant
java文件夹内会多出build文件夹，里面会包含一些jar包和class文件，以后就可以直接使用在build文件夹里的生成的jar包：libthrift-xx.jar，以及lib下的关联jar包
我们创建好java项目后就把需要的jar导入就行了。

6.生成TSSL的私钥和公钥

官方教程中启动服务器提供了两种方式，一般方式(simple)和TSSL方式(secure)。
simple方式很简单就能运行，但是TSSL方式需要用到安全证书。
你可以看看官方教程源码，其中服务端有下面一行代码

params.setKeyStore("../../lib/java/test/.keystore","thrift", null, null);

这里的.keystore是私钥，"thrift"是私钥的口令。
在客户端中：

params.setTrustStore("../../lib/java/test/.truststore","thrift","SunX509","JKS");

这里的.truststore是公钥，"SunX509"是公钥的口令，我们需要通过key-tool工具来生成私钥和公钥。
整个使用key-tool工具的过程如下：
输入下面的命令生成私钥，这里的私钥名字是.keystore，名字可以随便写，但是整个过程都要保持名字一致

keytool -genkeypair -alias certificatekey -keyalg RSA -validity 365 -keystore .keystore

输入上面的命令后按照提示进行操作。这里需要注意，最后一步的certificatekey的口令最好和上面的口令一致，否则可能会遇到其他问题。
输入下面的命令生成server.cer证书

keytool -export -alias certificatekey -keystore .keystore -rfc -file server.cer

输入下面的命令生成.truststore

keytool -import -alias certificatekey -file server.cer -keystore .truststore

上面的过程仅仅是为了生成我们需要的.keystore和.truststore，更多的细节可以自己查询。
为了帮助大家理解，我把我输入的三句命令列出来

keytool -genkeypair -alias thrift -keyalg RSA -validity 365 -keystore .keystore
keytool -export -alias thrift -keystore .keystore -rfc -file server.cer
keytool -import -alias thrift -file server.cer -keystore .truststore

生成后将这两个文件分别放到server和client中，修改路径和密码，做好这些之后，程序就能启动了。

看下我现在的项目结构：