X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/c13b9d5300b7f778e2fc05f9d043db4122d15aa1..3f0914ec893c01440778b01620776745da2546de:/sdk/java/README diff --git a/sdk/java/README b/sdk/java/README index 4c28633013..0933b88196 100644 --- a/sdk/java/README +++ b/sdk/java/README @@ -1,116 +1,4 @@ -== Arvados Java SDK +Welcome to Arvados Java SDK. - - Using the Arvados Java SDK, you can access API server from a java program. - - - This document highlights the details as to how to use the SDK. - - - The Java SDK is used as a maven project. Hence, you would need a working - maven environment to be able to build the source code. - - If you do not have maven setup, you may find the following link useful. - - http://maven.apache.org/guides/getting-started/maven-in-five-minutes.html - - - In this document is used to refer to the directory where - arvados code is cloned in your system. - For ex: = $HOME/arvados - - -== Setting up the environment - - - The following three environment variables are required by the SDK - - ARVADOS_API_TOKEN, ARVADOS_API_HOST, ARVADOS_API_HOST_INSECURE - - -== Building the Arvados SDK - - - cd - - java -cp target/java-1.0-SNAPSHOT-jar-with-dependencies.jar org.arvados.sdk.java.Arvados call arvados v1 users.create - - java -cp target/java-1.0-SNAPSHOT-jar-with-dependencies.jar org.arvados.sdk.java.Arvados call arvados v1 pipeline_templates.list - - java -cp target/java-1.0-SNAPSHOT-jar-with-dependencies.jar org.arvados.sdk.java.Arvados call arvados v1 pipeline_templates.get - - java -cp target/java-1.0-SNAPSHOT-jar-with-dependencies.jar org.arvados.sdk.java.Arvados call arvados v1 pipeline_templates.create - - -== Implementing your code to use SDK - - - /sdk/java/ArvadosSDKJavaUser.java serves as an example - implementation using the java SDK. Please use this file to see how - you would want use the SDK from your java program. - The steps below use this java class name. - - - ArvadosSDKJavaUser.java creates an instance of Arvados SDK class and - uses it to make various "call" requests. - - - To compile ArvadosSDKJavaUser.java - - javac -cp /sdk/java/target/java-1.0-SNAPSHOT-jar-with-dependencies.jar ArvadosSDKJavaUser.java - - This results in the generation of the ArvadosSDKJavaUser.class file - in the same dir as the java file - - - To run the class file - - java -cp .:/sdk/java/target/java-1.0-SNAPSHOT-jar-with-dependencies.jar ArvadosSDKJavaUser - - -== Viewing and managing SDK logging - - - SDK uses log4j logging - - - The default location of the log file is - /sdk/java/log/arvados_sdk_java.log - - - Update log4j.properties file to change name and location of the log file. - - Modify the "log4j.appender.fileAppender.File" property in log4j.properties - file located at /sdk/java/src/main/resources - - Rebuild by running "mvn clean package" - - -== Using the SDK in eclipse - - - To develop in eclipse, you can use the SDK eclipse project. - - - Install "m2eclipse" plugin in your eclipse - - - Open the SDK project. - - File -> Import -> Existing Projects into Workspace -> Next -> Browse - and select /sdk/java +Please refer to http://doc.arvados.org/sdk/java/index.html to get started + with Arvados Java SDK.