Page History

...

The SDK consists of several parts:

• API containing the SDK's interface declarations (with Javadoc online and Javadoc download)
• standard Java implementation to use in a regular Java VM
• Android implementation to use when building Android apps

To use the SDK, download the API jar and the implementation matching your environment. When upgrading, make sure the versions of both jars match.

The SDK source is available on GitHub.

Dependencies

Dependencies for the SDK depend on the implementation you are planning to use:. You can manually set up the dependencies or configure Maven to do it for you.

Regular Java VM

Using Maven

Add the following dependency and dependency management entries:

  <dependencies>
      ...
      <dependency>
          <groupId>com.belladati</groupId>
          <artifactId>sdk-java</artifactId>
          <version>0.9.1</version>
      </dependency>
  </dependencies>
  <dependencyManagement>
      <dependencies>
          ...
          <dependency>
              <groupId>org.apache.httpcomponents</groupId>
              <artifactId>httpclient</artifactId>
              <version>4.3.1</version>
          </dependency>
          <dependency>
              <groupId>org.apache.httpcomponents</groupId>
              <artifactId>httpcore</artifactId>
              <version>4.3</version>
          </dependency>
      </dependencies>
  </dependencyManagement>

Manual Setup

Download and add the following libraries to your classpath:

• Jackson 2.2.x core, annotations and databind libraries
• Signpost 1.2.x core and Commons HTTP implementation
• Apache HttpClient 4.3.x and its dependencies (jars fluent-hc and httpmime are not needed)

Android

Using Maven

Coming soon.

Manual Setup

Download and add the following libraries to your project:

• Jackson 2.2.x core, annotations and databind libraries
• Signpost 1.2.x core
• Re-packaged Apache HttpClient for Android provided by BellaDati

Server Setup

...

You can save a user's active session for later use by serializing your BellaDatiService instance and storing it in your application. When the user wants to continue working with your application, you can restore the instance and the user doesn't need to authenticate again until the access token used by the SDK expires.