eXo Platform 3.5

## Chapter 5. CMIS Usage code examples

The following examples of CMIS usage may be useful for developers who needs to access a repository. CMIS access code snippets build using Apache HTTP Client for Java or using Google gadgets (gadgets.io) for JavaScript examples. For the cURL examples look at http://code.google.com/p/xcmis/wiki/xCMISusesWithCurl.

### Login to repository

### Note

CMIS service uses default authentication in general case, but it can be overridden in case of embedding CMIS into an Application Service. In these examples only Basic HTTP authentication covered.

#### Using java

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.UsernamePasswordCredentials;

     import org.apache.commons.httpclient.auth.AuthScope;

     import org.apache.commons.httpclient.methods.GetMethod;

     HttpClient client = new HttpClient();

     client.getState().setCredentials(

         new AuthScope("localhost", 8080, "realm"),

         new UsernamePasswordCredentials("root", "exo");

     ....

### Listing of documents (folder, files)

There are a several methods to get the documents listings, such as getChildren(), getFolderTree() and getDescentants(), their usage will be described below. The difference between them is in usage of different URL segments to get a data ("/children" for getChildren(), "/foldertree" for getFolderTree(), "/descendants" for getDescentants()), and a different kind of results (getChildren() returns a flat structure, while a getFolderTree() and getDescentants() has a tree of items in response).

#### Using java

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.methods.GetMethod;

     import org.apache.commons.httpclient.MultiThreadedHttpConnectionManager;

     String url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/children/";

     url += obj_id;

     HttpClient client = new HttpClient(new MultiThreadedHttpConnectionManager());

     client.getHttpConnectionManager().

     getParams().setConnectionTimeout(10000);

     GetMethod get = new GetMethod(url);

     try {

     int result = client.executeMethod(get);

     final String strResponse = get.getResponseBodyAsString();

     } finally {

       get.releaseConnection();

     }

#### Using JavaScript

Creating an URL to make a request (consists of repository name, the method name, e.g. "/children/", and folderID to get children from):

     var url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/children/";

     url += obj_id;

performing request:

     var params = {};

     params[gadgets.io.RequestParameters.METHOD] = gadgets.io.MethodType.GET;

     params[gadgets.io.RequestParameters.CONTENT_TYPE] = gadgets.io.ContentType.FEED;

     gadgets.io.makeRequest(url, handler, params);

processing results (code located in the handler specified while making a request, the same way it might be used for all examples in this chapter):

    var handler = function(resp) {

      var data = eval(resp.data.Entry);

       for (var i = 0; i < data.length; i++) {

         var doc = data[i];

         alert(doc.Title);

         alert(doc.Date);

          ...etc..

       }

    }

### Read document properties and content-stream

Reading of Document properties and content stream it are two separate operations. Getting of content stream is possible after the properties set have been read and the content stream ID extracted from it.

#### Using java

Get document properties.

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.methods.GetMethod;

     import org.apache.commons.httpclient.MultiThreadedHttpConnectionManager;

     String url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/object/";

     url += obj_id;

     HttpClient client = new HttpClient(new MultiThreadedHttpConnectionManager());

     client.getHttpConnectionManager().

     getParams().setConnectionTimeout(10000);

     GetMethod get = new GetMethod(url);

     try {

       int result = client.executeMethod(get);

       final String strResponse = get.getResponseBodyAsString();

       // use response...

     } finally {

       get.releaseConnection();

     }

Get document content-stream.

To get a Document's content stream, an URL must contain "/file" part, object ID, and optionally the content stream ID, which can be used, for example, to obtain renditions. If no stream ID is specified, a default stream will be returned.

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.methods.PostMethod;

     String url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/file/";

     url += obj_id;

     //Optionally

     url += "?";

     url += "streamid=";

     url += streamID;

     HttpClient client = new HttpClient();

     client.getHttpConnectionManager().

     getParams().setConnectionTimeout(10000);

     GetMethod get = new GetMethod(url);

     try {

       int result = client.executeMethod(get);

       final InputStream stream = get.getResponseBodyAsStream();

       try {

       // use stream...

       int dataByte = stream.read();

       } finally {

         stream.close();

       }

     } finally {

       get.releaseConnection();

     }

#### Using JavaScript

Get document properties.

Creating an URL to make a request (consists of repository name, method name, e.g. "/children/", and folder ID to get the children from):

     var url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/object/";

     url += obj_id;

performing request:

     var params = {};

     params[gadgets.io.RequestParameters.METHOD] = gadgets.io.MethodType.GET;

     params[gadgets.io.RequestParameters.CONTENT_TYPE] = gadgets.io.ContentType.FEED;

     gadgets.io.makeRequest(url, handler, params);

You can also use the ContentType.DOM parameter to parse the feed in your application (Using DOMParser for example).

Get document content-stream.

### Note

Performing a content stream request in JavaScript will cause the browser dialog for a file download.

     var url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/file/";

     url += obj_id;

     //Optionally

     url += "?";

     url += "streamid=";

     url += streamID;

### Search of data and syntax examples

CMIS supports SQL queries for more handful content search. Query service can handle both GET and POST requests. URL for query consists of repository name and method name "/query". GET request must contain query as a parameter named "q", in case of POST request query must be located in a request body.

For more detailed instructions how to construct queries please refer to "Query examples" chapter.

#### Using java

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.methods.PostMethod;

     import org.apache.commons.httpclient.methods.StringRequestEntity;

     String url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/query/";

     HttpClient client = new HttpClient();

     client.getHttpConnectionManager().

     getParams().setConnectionTimeout(10000);

     PostMethod post = new PostMethod(url);

     String s = "<?xml version='1.0' encoding='utf-8'?>"

             + "<cmis:query xmlns='http://www.w3.org/2005/Atom' xmlns:cmis='http://docs.oasis-open.org/ns/cmis/core/200908/'>"

             + "<cmis:statement>SELECT * FROM cmis:document</cmis:statement>"

             + "<cmis:maxItems>10</cmis:maxItems>"

             + "<cmis:skipCount>0</cmis:skipCount>"

             + "<cmis:searchAllVersions>true</cmis:searchAllVersions>"

             + "<cmis:includeAllowableActions>true</cmis:includeAllowableActions>"

             + "</cmis:query>";

     RequestEntity entity = new StringRequestEntity(s, "text/xml","utf-8");

     try {

       post.setRequestEntity(entity);

       int result = client.executeMethod(post);

       final String strResponse = post.getResponseBodyAsString();

       // use response...

     } finally {

       post.releaseConnection();

     }

#### Using JavaScript

     var url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/query/";

     var params = {};

     params[gadgets.io.RequestParameters.METHOD] = gadgets.io.MethodType.POST;

     params[gadgets.io.RequestParameters.POST_DATA] = gadgets.io.encodeValues(someQuery);

     gadgets.io.makeRequest(url, handler, params);

### Modification of document properties or content

Command of property update uses PUT method. The URL is the same as for a reading of properties, the difference is only in HTTP method used. Body of the request must be an Atom document with the properties specified (see spec. 2.2.4.12 for details constructing document).

Sending of content stream can be executed via PUT or POST requests. Content-type of the request must be an "multipart/form-data".

#### Using java

Update properties:

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.methods.StringRequestEntity;

     import org.apache.commons.httpclient.methods.PostMethod;

     import org.apache.commons.httpclient.methods.RequestEntity;

     String url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/object/";

     url += obj_id;

     HttpClient client = new HttpClient();

     client.getHttpConnectionManager().

     getParams().setConnectionTimeout(10000);

    String atomDoc = "<?xml version='1.0' encoding='utf-8'?>"

             + "<entry xmlns='http://www.w3.org/2005/Atom'"

             + " xmlns:cmis='http://docs.oasis-open.org/ns/cmis/core/200908/'"

             + " xmlns:cmisra='http://docs.oasis-open.org/ns/cmis/restatom/200908/'>"

             + "<cmisra:object><cmis:properties>"

             + "<cmis:propertyString queryName='cmis:name' localName='cmis:name' propertyDefinitionId='cmis:name'>"

             + "<cmis:value>newName</cmis:value>"

             + "</cmis:propertyString>"

             + "</cmis:properties></cmisra:object>"

             + "</entry>";

     PutMethod put = new PutMethod(url);

     RequestEntity entity = new StringRequestEntity(atomDoc, "text/xml", "utf-8");

     put.setRequestEntity(entity);

     try {

       int result = client.executeMethod(put);

       final String strResponse = put.getResponseBodyAsString();

     } finally {

       put.releaseConnection();

     }

Set content stream:

     import org.apache.commons.httpclient.HttpClient;

     import org.apache.commons.httpclient.methods.InputStreamRequestEntity;

     import org.apache.commons.httpclient.methods.PostMethod;

     import org.apache.commons.httpclient.methods.RequestEntity;

     String url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/file/";

     url += obj_id;

     HttpClient client = new HttpClient();

     client.getHttpConnectionManager().

     getParams().setConnectionTimeout(10000);

     PostMethod post = new PostMethod(url);

     RequestEntity entity = new InputStreamRequestEntity(inputStream, "text/xml; charset=ISO-8859-1");

     post.setRequestEntity(entity);

     try {

       int result = client.executeMethod(post);

       final String strResponse = post.getResponseBodyAsString();

     } finally {

       post.releaseConnection();

     }

#### Using JavaScript

Update properties:

     var url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/object/";

     url += obj_id;

    //constructing document

     String atomDoc = "<?xml version='1.0' encoding='utf-8'?>";

           atomDoc += "<entry xmlns='http://www.w3.org/2005/Atom'";

           atomDoc += " xmlns:cmis='http://docs.oasis-open.org/ns/cmis/core/200908/'";

           atomDoc += " xmlns:cmisra='http://docs.oasis-open.org/ns/cmis/restatom/200908/'>";

           atomDoc += "<cmisra:object><cmis:properties>";

           atomDoc += "<cmis:propertyString queryName='cmis:name' localName='cmis:name' propertyDefinitionId='cmis:name'>";

           atomDoc += "<cmis:value>newName</cmis:value>";

           atomDoc += "</cmis:propertyString>";

           atomDoc += "</cmis:properties></cmisra:object></entry>";

     var params = {};

     params[gadgets.io.RequestParameters.METHOD] = gadgets.io.MethodType.PUT;

     params[gadgets.io.RequestParameters.POST_DATA] = atomDoc;

     gadgets.io.makeRequest(url, handler, params);

Set content stream:

     var url = "http://localhost:8080/rest/private/cmisatom/";

     url += repository;

     url += "/file/";

     url += obj_id;

     var params = {};

     params[gadgets.io.RequestParameters.METHOD] = gadgets.io.MethodType.POST;

     params[gadgets.io.RequestParameters.CONTENT_TYPE] = "multipart/form-data";

     params[gadgets.io.RequestParameters.POST_DATA] = contentStream;

     gadgets.io.makeRequest(url, handler, params);