Apache Thrift 官方JAVA教程

逃离我推掉我的手 2021-09-22 05:22 298阅读 0赞

本文所使用的开发环境是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，显示如下：

![Center][]

**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文件，文件结构如下：

![Center 1][]

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

**4.client和server**

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

[http://thrift.apache.org/tutorial/java][http_thrift.apache.org_tutorial_java]

这里还涉及到另一个类——[CalculatorHandler][]，但是并没有在同一个界面，我们在下面的界面可以找到：[http://thrift.apache.org/][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][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中，修改路径和密码，做好这些之后，程序就能启动了。

看下我现在的项目结构：

![Center 2][]

**7.测试**

启动JavaServer后：  
![Center 3][]

运行JavaClient后：  
![Center 4][]

此时JavaServer：

![Center 5][]  
参考：

[http://jacksongblack.blog.51cto.com/6378693/1175661][http_jacksongblack.blog.51cto.com_6378693_1175661]

[http://blog.csdn.net/colouroo/article/details/38588297][http_blog.csdn.net_colouroo_article_details_38588297]

[http://blog.csdn.net/azhao\_dn/article/details/8896832][http_blog.csdn.net_azhao_dn_article_details_8896832]

[http://thrift.apache.org/tutorial/java][http_thrift.apache.org_tutorial_java]

[http://sleepingxu.iteye.com/blog/1745688][http_sleepingxu.iteye.com_blog_1745688]

[http://www.it610.com/article/441314.htm][http_www.it610.com_article_441314.htm]

[http://blog.csdn.net/isea533/article/details/48574961][http_blog.csdn.net_isea533_article_details_48574961]

[Center]: /images/20210920/249ebbc2bbe74650847736f620ad7282.png
[Center 1]: /images/20210920/aa058db9f6c440328244b998c19129e8.png
[http_thrift.apache.org_tutorial_java]: http://thrift.apache.org/tutorial/java
[CalculatorHandler]: https://git1-us-west.apache.org/repos/asf?p=thrift.git;a=blob_plain;f=tutorial/java/src/CalculatorHandler.java;hb=HEAD
[http_thrift.apache.org]: 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]: https://git1-us-west.apache.org/repos/asf?p=thrift.git;a=tree;f=tutorial/java/src;h=d56632301e9f9ff6c4ae5a5fd0f09bbb1c481ad3;hb=HEAD
[Center 2]: /images/20210920/5575031d7af045059e750a581cdc75ae.png
[Center 3]: /images/20210920/4c345872ec89480b8128ee42593c8333.png
[Center 4]: /images/20210920/8a1eabc831794583a8395a08e7b23e8b.png
[Center 5]: /images/20210920/3b19ec40d6cb4842afe59228fd3748c4.png
[http_jacksongblack.blog.51cto.com_6378693_1175661]: http://jacksongblack.blog.51cto.com/6378693/1175661
[http_blog.csdn.net_colouroo_article_details_38588297]: http://blog.csdn.net/colouroo/article/details/38588297
[http_blog.csdn.net_azhao_dn_article_details_8896832]: http://blog.csdn.net/azhao_dn/article/details/8896832
[http_sleepingxu.iteye.com_blog_1745688]: http://sleepingxu.iteye.com/blog/1745688
[http_www.it610.com_article_441314.htm]: http://www.it610.com/article/441314.htm
[http_blog.csdn.net_isea533_article_details_48574961]: http://blog.csdn.net/isea533/article/details/48574961