/stackmob-java-client-sdk

The Official Java Client SDK for the StackMob Platform

Primary LanguageJavaApache License 2.0Apache-2.0

StackMob Java Client SDK

Build Status

With the StackMob Java Client SDK, you can integrate StackMob into any Java / JVM application.

Here are some example usages:

  • Connect your Android app to your StackMob app (there is also an Android SDK that provides additional Android specific functionality)
  • Connect your Java command line utility to your StackMob app
  • Connect your Tomcat, JBoss, etc... app to your StackMob app

Hopefully you can see the pattern here. With this library, you can connect almost any JVM to your StackMob app and access the same app data as with the iOS, Android and Ruby SDKs.

Getting Started

With Maven

<dependency>
    <groupId>com.stackmob</groupId>
    <artifactId>stackmob-java-client-sdk</artifactId>
    <version>1.1.2</version>
</dependency>

With SBT

libraryDependencies += "com.stackmob" % "stackmob-java-client-sdk" % "1.1.2"

Commandline (or Ant)

Download the StackMob Java SDK and the dependencies listed below and place them on your CLASSPATH:

Android

This StackMob Android SDK is based on the Java SDK, and aside from setup they function identically. Check out the Android Setup Tutorial to get started.

Using the SDK

  • Check out the full list of tutorials. They're labeled as Android, but they also apply to the Java SDK
  • Read the javadocs

Issues

We use Github to track issues with the SDK. If you find any issues, please report them here, and include as many details as possible about the issue you encountered.

Contributing

We encourage contributions to the StackMob SDK. If you'd like to contribute, fork this repository and make your changes. Before you submit a pull request to us with your changes, though, please keep the following in mind:

  1. Please be sure that your code runs on Android 2.2 and above.
  2. Please be sure to test your code against live StackMob servers. To do, make sure to set the STACKMOB_KEY and STACKMOB_SECRET env variables (or JVM vars) to your app's key & secret
  3. If your tests must run with a specific server configuration (ie: specific object model, etc...), please include a descr

Copyright

Copyright 2011 StackMob

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.