Databox Java SDK

The Java SDK for interacting with the Databox Push API v 2.3.

Installation

For Gradle users. Add this to your gradle.build:

repositories {
  jcenter()
  maven { url "http://dl.bintray.com/databox/databox" }
}

dependencies {
  ...
  compile 'com.databox:databox-java:2.3'
  ...
}

For Maven users. Get your settings.xml at Bintray.

Or check out the sample/ directory for both Maven and Gradle samples. You can build them like:

mvn clean install mvn exec:java -Dexec.mainClass="com.databox.sdk.sample.DataboxSample"

gradle build

Requirements

Java >= 1.7 or later,
Maven >= 3.0.3 OR Gradle 2.x

Usage

String TOKEN = "your_token_goes_here";
Databox databox = new Databox(TOKEN);
try {
	SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.getDefault());
	databox.push("kitchen_light", 341d, sdf.parse("2015-12-25 00:00:00"));
} catch (Exception e) {
	logger.error(e.getLocalizedMessage(), e);
}

Usage (with attributes)

String TOKEN = "your_token_goes_here";
Databox databox = new Databox(TOKEN);
try {
	SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.getDefault());
	Databox.KPI kpi = new Databox.KPI()
		.setKey("switch")
		.setValue(0d)
		.addAttribute("kitchen", 125)
		.addAttribute("living_room", 412);
		
	databox.push(kpi);
} catch (Exception e) {
	logger.error(e.getLocalizedMessage(), e);
}

Sending multiple metrics at once

String TOKEN = "your_token_goes_here";
Databox databox = new Databox(TOKEN);
try {
	List<Databox.KPI> kpis = new ArrayList<Databox.KPI>();
	kpis.add(new Databox.KPI().setKey("my_first_key").setValue(1201.41));
	kpis.add(new Databox.KPI().setKey("my_second_key").setValue(8249));
	databox.push(kpis);
} catch (Exception e) {
	logger.error(e.getLocalizedMessage(), e);
}

Retrieving last pushes

Databox databox = new Databox(TOKEN);
try {
    StringBuffer lastPush = databox.lastPush(); // just last one
    System.out.println(lastPush);
    
    StringBuffer lastPushes = databox.lastPushes(5); // last 5 pushes
    System.out.println(lastPushes);    
} catch (Exception e) {
	logger.error(e.getLocalizedMessage(), e);
}

License

Licensed under the MIT License.

databox/databox-java