BigML.io Java bindings

In this repository you'll find an open source Java client that gives you a simple binding to interact with BigML. You can use it to easily create, retrieve, list, update, and delete BigML resources (i.e., sources, datasets, models, ensembles, clusters, predictions, centroids, batch predictions, batch centroids, evaluations).

This client is licensed under the Apache License, Version 2.0.

See all the changes history here.

Support

Please, report problems and bugs to BigML.io-Java issue tracker

You can send us an email at BigML email support

You can join us in Campfire chatroom

Integrating Maven

Add the following dependency to your project's pom.xml file:

<dependency>
    <groupId>org.bigml</groupId>
    <artifactId>bigml-binding</artifactId>
    <version>1.4.1</version>
</dependency>

Add the following lines to your project's pom.xml file if you want to use the SNAPSHOT versions of the library:

<repositories>
    <repository>
        <id>osshr-snapshots</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        <snapshots><enabled>true</enabled></snapshots>
        <releases><enabled>false</enabled></releases>
    </repository>
</repositories>

Requirements

You will find in the binding.properties file where to setup your BigML credentials BIGML_USERNAME and BIGML_API_KEY, and the BIGML_SEED to be used by BigML to make deterministic samples and models. They can be overwritten passing the values as JVM variables with -D.

The project uses Maven as project manager.

Running the Tests

There is a test suite using Cucumber available, you may want to run it by execute:

$ mvn test

or this way, if you want to debug the tests

$ mvn -Dmaven.surefire.debug="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 -Xnoagent -Djava.compiler=NONE" test

Generated JAR file of the bindings

Since version 1.1 the name of the JAR file is bigml-binding.