Leftronic Java API

This is a simple Java API that wraps the Leftronic REST APIs documented here.

Downloading

The easiest way to get started is to just add this dependency in to your Maven build:

<dependency>
<groupId>biz.neustar</groupId>
<artifactId>leftronic</artifactId>
<version>1.0-beta-1</version>
</dependency>

If you don't use Maven, you can still find the jars in the central Maven repository. You'll also need the following dependencies:

• Jackson 1.8.5 or later
• Apache HttpClient 4.1.2 or later
• JSR 330 (aka javax.inject) for easy CI integration

Using

The API is pretty straight forward if you've read the Leftronic API docs:

LeftronicClientclient = newLeftronicClient("access_key", 4);
client.sendNumber("Number-Stream", 300);
client.sendGeoPoint("Geo-Stream", 45.8, -115.6);
Randomr = newRandom();
client.sendLeaderboard("Leader-Stream",
newLeaderboardEntry("Ian", r.nextInt(100)),
newLeaderboardEntry("Patrick", r.nextInt(100)),
newLeaderboardEntry("Barney", r.nextInt(100)));
client.sendList("Test-Stream", "Fe", "Fi", "Fo", "Fum");
client.sendText("Test-Stream", "Custom Title", "This is a new message");

You can also wire up the LeftronicClient using dependency injection frameworks such as Guice. The constructor parameters are bound to the following @Named parameters:

• @Named("leftronic.accessKey")
• @Named("leftronic.maxThreads")

Note: The client always uses SSL to make it's HTTP requests and until we hear a good reason we won't be offering an option to change this.

License

This project is licensed under the Apache 2.0 license.