[CMIS-507] OpenCMIS client for Android devices

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: OpenCMIS 0.6.0
• Fix Version/s: OpenCMIS 0.8.0
• Component/s: opencmis-client, opencmis-client-bindings, opencmis-commons
• Labels: android client mobile opencmis

Environment

All Android devices

• Assignee: Florian Müller
• Reporter: Jean Marie PASCAL
• Created: 22/Feb/12 16:21
• Updated: 23/May/12 15:17
• Resolved: 23/May/12 15:16

Description

Hello Chemistry,

As new employee of Alfresco Mobile team, I just start a project to port OpenCMIS into Android devices.
Indeed, OpenCMIS as is doesn't work on android device due to the fact that Android SDK is different than JDK. They share some common package but clearly not all and clearly not all for using OpenCMIS in android.

So after few days of work, I created a "partial/draft" client version of OpenCMIS called chemistry-opencmis-android.

What's chemistry-opencmis-android ?
It's a maven project that create an android opencmis client into a single jar file : chemistry-opencmis-android.jar
This library is a merge of opencmis-client-* and opencmis-commons-* dependencies into one jar. Some of them have been modified (More informations below).
The project has 2 external dependencies : android.jar (for specific android dependencies) and simple-json (browser binding)
I tested this project into Ice Cream Sandwich and Honeycomb android device. Major part of opencmis services (repository, navigation, object...) works pretty well but there are still some "functional holes" (extension parameters, ACL, versionning...). Yes it's draft version

What I did...
In general,

• Merged opencmis-client-* and opencmis-commons-* package into one.
• removed all webservices binding references
• removed jaxb dependency (replaced it by opencmis data object)
• modified atompubparser to use xmlpullparser provided by android.
• commented or deleted all external dependencies that was not provided by android like commons-logging, osgi...

In details,

• chemistry-opencmis-commons-api :
  • • add a file : AtomPropertyType.java

• chemistry-opencmis-commons-impl :
  • • remove converter, JaxbHelper files and tube packges
    • add AtomPubConverter

• chemistry-opencmis-client-api : nothing

• chemistry-opencmis-client-impl
  • • remove osgi package

• chemistry-opencmis-client-bindings
  • • deleted webservices + local package
    • removed commons-logging and jaxb dependencies
    • rewrite atompubparser and atomentrywriter to use xmlpullparser
    • rewrite all services to use only opencmis object
    • create an atompubconverter : to create opencmis object after a parsing phase

So my final questions :
What do you think about this approach ?
and if it's correct could I share, contribute and improve this version into chemistry and have some extra dev hands to help me in this task ?

And the last How to build my project ?
You need

• maven 3.x +
• android.jar as artifact in your maven repository. I used https://github.com/mosabua/maven-android-sdk-deployer to deploy android sdk into my local repository
  then simply run a mvn install. You will have a single jar that you can incorporate to any android application as any dependency.

Thanks for all.

Issue Links

• requires: CMIS-525 Replace Commons Logging with SLF4J