No description, website, or topics provided.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
contract
docker
ds3-interfaces
ds3-metadata
ds3-sdk-integration
ds3-sdk-samples
ds3-sdk
ds3-utils
gradle
.gitattributes
.gitignore
.travis.yml
LICENSE.md
README.md
SETUP.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

ds3_java_sdk

Build Status Coverity Scan Build Status Download Apache V2 License Open Hub project report for ds3_java_sdk

Contact Us

Join us at our Google Groups forum to ask questions, or see frequently asked questions.

Setup

See our Setup Guide which explains how to setup Eclipse with all the dependencies that you will need to build the sdk from source.

If using Intellij, simply import the project as a Gradle project.

Install

To install the latest ds3_java_sdk either download the latest release jar file from the Releases page or clone the repository with git clone https://github.com/SpectraLogic/ds3_java_sdk.git, cd to ds3_java_sdk and run ./gradlew clean ds3-sdk:install to install the sdk into your local maven repository. It is compatible with Java 8.

The SDK can also be included directly into a Maven or Gradle build. There is also a fatjar version that you can optionally use with the all classifier, take a look at the commented out code in the examples below. To include the SDK into maven add the following to the pom.xml file:

<project>
  ...
  <repositories>
    <repository>
      <id>Spectra-Github</id>
      <url>http://dl.bintray.com/spectralogic/ds3</url>
    </repository>
  </repositories>
  ...
    <dependencies>
      ...
      <dependency>
        <groupId>com.spectralogic.ds3</groupId>
        <artifactId>ds3-sdk</artifactId>
        <version>5.0.4</version>
        <!-- <classifier>all</classifier> -->
      </dependency>
    ...
    </dependencies>
</project>

To include the sdk into Gradle include the following in the build.gradle file:

repositories {
    ...
    maven {
        url 'http://dl.bintray.com/spectralogic/ds3'
    }
    ...
}

dependencies {
    ...
    compile 'com.spectralogic.ds3:ds3-sdk:5.0.4'
    // compile 'com.spectralogic.ds3:ds3-sdk:5.0.4:all'
    ...
}

Javadoc

The latest javadoc is located at http://spectralogic.github.io/ds3_java_sdk/javadoc/

Contributing

If you would like to contribute to the source code, sign the Contributors Agreement and make sure that your source conforms to our Java Style Guide. For an overview of how we use Github, please review our Github Workflow.

Examples

All the examples are listed in the ds3-sdk-samples module.

Logging

The ds3_java_sdk uses SLF4J for logging. Because of this, a consumer of the sdk can use many different logging implementations and so long as the correct SLF4J bridge is installed, have the sdk logs appear. For more information on SLF4J and how to add different logging bridges, please see SLF4j.org.

Tests

In addition to unit tests in the main ds3-sdk module, there are additional integration tests in the ds3-integration module. Please see the integration README for details on running the tests. To just run the SDK's unit tests use:

./gradlew clean ds3-sdk:test

Publishing

Before a user can publish the SDK they must first have Bintray API credentials and access to our organization to upload. Once a user has access they can set their credentials on the command line by issuing:

$ export BINTRAY_USER="userName"
$ export BINTRAY_KEY="api_key"

After the credentials have been set, to publish the SDK to Bintray, issue the following from the command line run: ./gradlew clean bintrayUpload