Optimizely Java SDK

This repository houses the Java SDK for Optimizely's Full Stack product.

Getting Started

Installing the SDK

Gradle

The SDK is available through Bintray and is created with source and target compatibility of 1.7. The core-api and httpclient Bintray packages are optimizely-sdk-core-api and optimizely-sdk-httpclient respectively. To install, place the following in your build.gradle and substitute VERSION for the latest SDK version available via Bintray:

repositories {
  jcenter()
}

dependencies {
  compile 'com.optimizely.ab:core-api:{VERSION}'
  compile 'com.optimizely.ab:core-httpclient-impl:{VERSION}'
  // The SDK integrates with multiple JSON parsers, here we use
  // Jackson.
  compile 'com.fasterxml.jackson.core:jackson-core:2.7.1'
  compile 'com.fasterxml.jackson.core:jackson-annotations:2.7.1'
  compile 'com.fasterxml.jackson.core:jackson-databind:2.7.1'
}

Dependencies

core-api requires org.slf4j:slf4j-api:1.7.16 and a supported JSON parser. We currently integrate with Jackson, GSON, json.org, and json-simple; if any of those packages are available at runtime, they will be used by core-api. If none of those packages are already provided in your project's classpath, one will need to be added. core-httpclient-impl is an optional dependency that implements the event dispatcher and requires org.apache.httpcomponents:httpclient:4.5.2. The supplied pom files on Bintray define module dependencies.

Feature Management Access

To access the Feature Management configuration in the Optimizely dashboard, please contact your Optimizely account executive.

Using the SDK

See the Optimizely Full Stack developer documentation to learn how to set up your first Java project and use the SDK.

Development

Building the SDK

To build local jars which are outputted into the respective modules' build/lib directories:

./gradlew build

Unit tests

Running all tests

You can run all unit tests with:

./gradlew test

Checking for bugs

We utilize FindBugs to identify possible bugs in the SDK. To run the check:

./gradlew check

Benchmarking

JMH benchmarks can be run through gradle:

./gradlew core-api:jmh

Results are generated in $buildDir/reports/jmh.

Contributing

Please see CONTRIBUTING.

Credits

First-party code (under core-api/ and core-httpclient-impl) is copyright Optimizely, Inc. and contributors, licensed under Apache 2.0.

Additional Code

This software incorporates code from the following open source projects:

core-api module

SLF4J https://www.slf4j.org
Copyright © 2004-2017 QOS.ch
License (MIT): https://www.slf4j.org/license.html

Jackson Annotations https://github.com/FasterXML/jackson-annotations
License (Apache 2.0): https://github.com/FasterXML/jackson-annotations/blob/master/src/main/resources/META-INF/LICENSE

Gson https://github.com/google/gson
Copyright © 2008 Google Inc. License (Apache 2.0): https://github.com/google/gson/blob/master/LICENSE

JSON-java https://github.com/stleary/JSON-java
Copyright © 2002 JSON.org License (The JSON License): https://github.com/stleary/JSON-java/blob/master/LICENSE

JSON.simple https://code.google.com/archive/p/json-simple/
Copyright © January 2004
License (Apache 2.0): https://github.com/fangyidong/json-simple/blob/master/LICENSE.txt

Jackson Databind https://github.com/FasterXML/jackson-databind
License (Apache 2.0): https://github.com/FasterXML/jackson-databind/blob/master/src/main/resources/META-INF/LICENSE

core-httpclient-impl module

Gson https://github.com/google/gson
Copyright © 2008 Google Inc. License (Apache 2.0): https://github.com/google/gson/blob/master/LICENSE

Apache HttpClient https://hc.apache.org/httpcomponents-client-ga/index.html
Copyright © January 2004 License (Apache 2.0): https://github.com/apache/httpcomponents-client/blob/master/LICENSE.txt