Alchemy Thrift

Purpose

Part of the Alchemy collection.

This Library makes it easier to work with Thrift in Java by managing Thrift Clients, providing simple serialization and deserialization of Thrift Objects, saving some boilerplate code.

This also library also demonstrates how to integrate the Thrift Compiler with Maven, by compiling the Thrift IDL Objects during the 'generate-sources' phase.

Requirements

Java 8
Maven installation
Thrift Compiler installation (for compilation)

Building

This project requires both maven and thrift to be on the system PATH. To build, just run a mvn clean install to compile and install to your local maven repository

Download

This library is not yet available on Maven Central

To use, simply add the following maven dependency.

Release

<dependency>
	<groupId>tech.sirwellington.alchemy</groupId>
	<artifactId>alchemy-thrift</artifactId>
	<version>2.0</version>
</dependency>

Snapshot

<dependency>
	<groupId>tech.sirwellington.alchemy</groupId>
	<artifactId>alchemy-thrift</artifactId>
	<version>2.1-SNAPSHOT</version>
</dependency>

Javadocs

Examples

Closing Thrift Clients

Closing the Client releases the network resources used by the Thrift Client, such as an open socket.

BananaService.Client client = ...;
//...
Clients.closeSilently(client);

Sometimes it is preferable to use the Iface type instead of the Client type. However, the Iface type does not directly expose a means to close resources.

BananaService.Iface client = ...;
//...
//Allows closing of Iface types.
Clients.attemptClose(client);

SirWellington / alchemy-thrift