thrift/swift:codegen-thrift java代码生成器

codegen-thrift 是最近我完成的一个java代码生成程序,实现从普通接口类型生成基于thrift/swift框架的service/client 端封装java代码.这个工具可以让你在不修改现有的接口定义的情况下，自动生成基于现有接口的thrift service /client代码，实现client端通过网络对服务端接口的透明调用。

支持byte[],Date,float,Float,URI,URL类型的自动转换.

执行 java -jar target/codegen-thrift-1.0.0-SNAPSHOT-standalone.jar -help 显示运行参数说明.
参数说明

	-ic,--interface-class 要生成thrift代码的接口类名
	-rc,--reference-class 实现interface-class接口的一个类名(可选),如果不指定,生成的接口方法中参数名为arg1,arg2... 
	-p,--package <arg> 输出代码的包名
	-o,--output <arg> 代码输出位置
	-gt,--task-type 生成代码的类型:CLIENT,SERVICE

下面以thrift.test.original.TestInterface类为例，说明代码生成的过程

生成service端代码

java -jar target\codegen-thrift-1.0.0-SNAPSHOT-standalone.jar ^
	-ic thrift.test.original.TestInterface ^ 
	-rc thrift.test.original.TestInterface$BaseImpl ^
	-p thrift.test.service ^
	-o J:\codegen\codegen-thrift\src\test\java ^
	-gt SERVICE

生成代码中https://gitee.com/l0km/codegen/blob/master/codegen-thrift/src/test/java/thrift/test/service/TestInterfaceThriftDecorator.java 为thrift.test.original.TestInterface对应thrift service端实现类。

生成thrift client代码

生成IDL文件

gen-thrift.bat

https://gitee.com/l0km/codegen/blob/master/codegen-thrift/gen-thrift.bat

生成thrift client端数据类型及接口定义

gen-client.bat

https://gitee.com/l0km/codegen/blob/master/codegen-thrift/gen-client.bat
##生成 client代码:

java -jar target\codegen-thrift-1.0.0-SNAPSHOT-standalone.jar ^
	-ic thrift.test.original.TestInterface ^
	-rc thrift.test.original.TestInterface$BaseImpl ^
	-p thrift.test.client ^
	-o J:\codegen\codegen-thrift\src\test\java ^
	--thrift-package thrift.test.client.thrift ^
	-gt CLIENT

生成的代码中https://gitee.com/l0km/codegen/blob/master/codegen-thrift/src/test/java/thrift/test/client/TestInterfaceThriftClient.java为thrift.test.original.TestInterface接口对应的 thrift client端实现。

启动服务

因为已经基于TestInterface接口自动生成了对应的service服务实现TestInterfaceThriftDecorator，所以将一个TestInterface接口实例启动为thrift服务就非常简单了：

	InternalLoggerFactory.setDefaultFactory(new Slf4JLoggerFactory());
	ThriftServerService service = ThriftServerService.bulider()
			.withServices(new TestInterfaceThriftDecorator(new TestInterface.BaseImpl()))
			.setServerPort(32232)
			.build();
	service.startAsync();

client 端创建thrift 接口实例

因为client的TestInterfaceThriftClient基于thrift框架实现了TestInterface接口,只要创建了TestInterfaceThriftClient实例，就可以像普通的接口实例一样调用，网络传输，数据类型转换等工作都由TestInterfaceThriftClient自动完成。

	// TestInterface 的thrift client实例
	TestInterface clientInstance = ClientFactory
			.builder()
			.setHostAndPort("127.0.0.1", 32232)
			.build(TestInterface.class, TestInterfaceThriftClient.class);
	// 调用接口
	clientInstance.test(null, 0, null, null, null);

生成代码的依赖

<dependency>
	<groupId>com.gitee.l0km</groupId>
	<artifactId>common-thrift</artifactId>
	<version>1.0.3-SNAPSHOT</version>
</dependency>

依赖库git仓库https://gitee.com/l0km/common-java/tree/master/common-thrift