tag	f193e2abe1d423e7b51e2878f20f3d12e70666f1
tagger	Tom Chan <tchan@prediction.io>	Fri Sep 26 18:05:17 2014 -0700
object	98dba2b91ec5532c47544b58f39876a8a577eaa6

commit	98dba2b91ec5532c47544b58f39876a8a577eaa6	[log] [tgz]
author	Tom Chan <tchan@prediction.io>	Fri Sep 26 17:53:03 2014 -0700
committer	Tom Chan <tchan@prediction.io>	Fri Sep 26 17:53:03 2014 -0700
tree	810df2fa2c881d5c0c9bd6ddddc5b513aec3d524
parent	201a1796312bf4ada1f0eba0b832aa9447838d59 [diff]
parent	463715ecf2a41050833c5d6cd8f180ac1d112623 [diff]

tree: 810df2fa2c881d5c0c9bd6ddddc5b513aec3d524

README.md

PredictionIO Java SDK

Getting Started

By Maven

If you have a Maven project, simply add the dependency to your pom.xml.

<project ...>
    ...
    <dependencies>
        <dependency>
            <groupId>io.prediction</groupId>
            <artifactId>client</artifactId>
            <version>0.8.0</version>
        </dependency>
    </dependencies>
    ...

By Ivy

If you use Ivy, simply add the dependency to your ivy.xml.

<ivy-module ...>
    ...
    <dependencies>
        <dependency org="io.prediction" name="client" rev="0.8.0" />
        ...
    </dependencies>
    ...

sbt

If you have an sbt project, add the library dependency to your build definition.

libraryDependencies += "io.prediction" % "client" % "0.8.0"

Building from Source

Assuming you are cloning to your home directory.

cd ~
git clone git://github.com/PredictionIO/PredictionIO-Java-SDK.git

To build this SDK you will need Maven 3+. Run the following to publish the module to your local Maven repository.

cd ~/PredictionIO-Java-SDK
mvn clean install

Run the following to generate API documentation.

cd ~/PredictionIO-Java-SDK
mvn clean javadoc:javadoc

Examples

Download Source

If you have not already cloned the repository from the section above, do

cd ~
git clone git://github.com/PredictionIO/PredictionIO-Java-SDK.git

Running CLI Examples

Building

If your PredictionIO server is not at localhost, edit the source and replace API URLs with your PredictionIO server host.

To build these examples you will need Maven 3+. Run the following in each example's directory, e.g.

cd ~/PredictionIO-Java-SDK/examples/quickstart_import
mvn clean compile assembly:single
cd ~/PredictionIO-Java-SDK/examples/quickstart_show
mvn clean compile assembly:single
cd ~/PredictionIO-Java-SDK/examples/import
mvn clean compile assembly:single

These will create JAR files with all dependencies built in.

Try It Now

For running the quick start example (quickstart_import and quickstart_show), please refer to the “Quick Start” page of the PredictionIO documentation.

To import the provided small sample data for the import example using asynchronous calls:

cd ~/PredictionIO-Java-SDK/examples/import
java -jar target/sample-import-<latest version>-jar-with-dependencies.jar <your appId here> sampledata/sample1.txt

To check the data is imported properly, run

curl -i -X GET http://localhost:7070/events.json?appId=<your appId here>

Enjoy!

Support

Forum

https://groups.google.com/group/predictionio-user

Issue Tracker

https://predictionio.atlassian.net

If you are unsure whether a behavior is an issue, bringing it up in the forum is highly encouraged.