azure-documentdb-java: A Java repository from normalian

#Microsoft Azure DocumentDB Java SDK

This project provides a client library in Java that makes it easy to interact with Azure DocumentDB. For documentation please see the Microsoft Azure Java Developer Center and the JavaDocs.

##Download ###Option 1: Via Maven

To get the binaries of this library as distributed by Microsoft, ready for use within your project, you can use Maven.

<dependency>
	<groupId>com.microsoft.azure</groupId>
	<artifactId>azure-documentdb</artifactId>
	<version>1.0.1</version>
</dependency>

###Option 2: Source Via Git

To get the source code of the SDK via git just type:

git clone git://github.com/Azure/azure-documentdb-java.git

###Option 3: Source Zip

To download a copy of the source code, click "Download ZIP" on the right side of the page or click here.

##Minimum Requirements

Java Development Kit 7
(Optional) Maven

Dependencies

Apache Commons Lang 3.3.2 (org.apache.commons / commons-lang3 / 3.3.2)
Apache HttpClient 4.2.5 (org.apache.httpcomponents / httpclient / 4.2.5)
Jackson Data Mapper 1.8 (org.codehaus.jackson / jackson-mapper-asl / 1.8.5)
JSON 20140107 (org.json / json / 20140107)
JUnit 4.11 (junit / junit / 4.11)

Dependencies will be added automatically if Maven is used. Otherwise, please download the jars and add them to your build path.

##Usage

To use this SDK to call Azure DocumentDB, you need to first create an account.

You can follow this tutorial to help you get started.

import java.util.Collection;

import com.google.gson.Gson;
import com.microsoft.azure.documentdb.ConnectionPolicy;
import com.microsoft.azure.documentdb.ConsistencyLevel;
import com.microsoft.azure.documentdb.Database;
import com.microsoft.azure.documentdb.Document;
import com.microsoft.azure.documentdb.DocumentClient;
import com.microsoft.azure.documentdb.DocumentClientException;
import com.microsoft.azure.documentdb.DocumentCollection;

public class SampleApp {
    // Replace with your DocumentDB end point and master key.
    private static final String END_POINT = "[YOUR_ENDPOINT_HERE]";
    private static final String MASTER_KEY = "[YOUR_KEY_HERE]";

    // Define an id for your database and collection
    private static final String DATABASE_ID = "TestDB";
    private static final String COLLECTION_ID = "TestCollection";

    // We'll use Gson for POJO <=> JSON serialization for this sample.
    // Codehaus' Jackson is another great POJO <=> JSON serializer.
    private static Gson gson = new Gson();

    public static void main(String[] args) throws DocumentClientException {
        // Instantiate a DocumentClient w/ your DocumetnDB Endpoint and AuthKey.
        DocumentClient documentClient = new DocumentClient(END_POINT,
                MASTER_KEY, ConnectionPolicy.GetDefault(),
                ConsistencyLevel.Session);

        // Define a new database using the id above.
        Database myDatabase = new Database();
        myDatabase.setId(DATABASE_ID);

        // Create a new database.
        myDatabase = documentClient.createDatabase(myDatabase, null)
                .getResource();

        // Define a new collection using the id above.
        DocumentCollection myCollection = new DocumentCollection();
        myCollection.setId(COLLECTION_ID);

        // Configure the new collection performance tier to S1.
        RequestOptions requestOptions = new RequestOptions();
        requestOptions.setOfferType("S1");

        // Create a new collection.
        myCollection = documentClient.createCollection(
                myDatabase.getSelfLink(), myCollection, requestOptions).getResource();

        // Create an object, serialize it in to JSON, and wrap it in to a
        // document.
        SomePojo somePojo = new SomePojo();
        String somePojoJson = gson.toJson(somePojo);
        Document myDocument = new Document(somePojoJson);

        // Create a new document.
        myDocument = documentClient.createDocument(myCollection.getSelfLink(),
                myDocument, null, false).getResource();

    }
}

Additional samples are provided in the unit tests.

##Need Help?

Be sure to check out the Microsoft Azure Developer Forums on MSDN or the Developer Forums on Stack Overflow if you have trouble with the provided code.

##Contribute Code or Provide Feedback

If you would like to become an active contributor to this project please follow the instructions provided in Azure Projects Contribution Guidelines.

If you encounter any bugs with the library please file an issue in the Issues section of the project.

##Learn More

normalian/azure-documentdb-java

Dependencies