CouchConf-Chicago-Couchbase-Mobile-on-Android

Couchbase Mobile on AndroidMarty Schoch @mschoch

Q&A Panel with Couchbase Experts Submit your questions for ourCouchbase Q&A at the end of the conference to:couchconfchicago@couchbase.com…or write them down and hand them to anyone from Couchbase.

Q&A Panel with Couchbase Experts Submit your questions for ourCouchbase Q&A at the end of the conference to:couchconfchicago@couchbase.com …or write them down and hand them to anyone from Couchbase.

Mobile CouchDB? CC BY-SA 2.0 gruntzooki @ Flickr

Couchbase Mobile• Apache CouchDB on the phone• “Work Locally, Sync Globally” • Application talks to 127.0.0.1 • Sync when online• Power of the _changes feed

Android• Current Status: Developer Preview• Supports Android 2.1 and newer• Application Footprint (EmtpyApp - 4MB)• Startup Time (Most devices ~ 5s)

Getting Startedhttp://www.couchbase.org/get/couchbase-mobile-for-android

Download and Unzip

Add Files to Your Project

Run the Ant ScriptBUILD SUCCESSFULTotal time: 1 second

Refresh Your Project

Create a Delegateprivate ICouchbaseDelegate delegate = new ICouchbaseDelegate() { public void couchbaseStarted( String host, int port) {} public void exit(String error) {}};

Start Couchbasepublic void onCreate(Bundle state) { super.onCreate(savedInstanceState); ApplicationContext appCtx = getApplicationContext(); CouchbaseMobile couch = new CouchbaseMobile(appCtx, delegate); couchServiceConnection = couch.startCouchbase();

Relax$ adb -e logcat | grep Couch[info] [<0.43.0>] Apache CouchDB has startedon http://0.0.0.0:47374/ CC BY-SA 2.0 cbowns @ Flickr

Using Couchbase with Ektorp• http://ektorp.org/• Mature CouchDB library for JAVA• Couchbase contributions to improve Android support in 1.2.2 release

Connect to ServerHttpClient client = new AndroidHttpClient.Builder() .host(host) .port(port) .build();CouchDbInstance instance = new StdCouchDbInstance(client);

Select a DatabaseCouchDbConnector connector = instance.createConnector("database", true);

Mapping Documents• Map<String, Object>• JsonNode (Jackson JSON Processor)• POJO with Annotations

Annotated POJO@JsonProperty("_id")private String id;@JsonProperty("_rev")private String rev;

Annotated POJO@JsonProperty("_id")private String id;@JsonProperty("_rev")private String rev; orextend org.ektorp.support.CouchDbDocument

Unmapped Fields@JsonAnyGetterpublic Map<String, Object> getOther()@JsonAnySetterpublic void setOther(String k, Object v)

Unmapped Fields@JsonAnyGetterpublic Map<String, Object> getOther()@JsonAnySetterpublic void setOther(String k, Object v) orextend org.ektorp.support.OpenCouchDbDocument

Sample Documentpublic class GroceryItem extends OpenCouchDbDocument { private String name; public void setName(String n) { name = n; } public String getName() { return name; }}

CREATEGroceryItem document = new GroceryItem();document.setName(“Cookies”);couchDbConnector.create(document);String id = document.getId();String rev = document.getRev();

UPDATEdocument.setName(“Chocolate Chip Cookies”);couchDbConnector.update(document);

Exceptions- DbAccessException - DocumentNotFoundException - UpdateConflictException - ViewResultException

READGroceryItem latest =couchDbConnector.get(GroceryItem.class, id);

DELETEcouchDbConnector.delete(latest);

View QueryViewQuery query = new ViewQuery() .designDocId(designDoc) .viewName(viewName) .includeDocs(false) .skip(0) .limit(10) .descending(true);

View ResultViewResult result = connector.queryView(query);Iterator<Row> iterator = result.iterator();while(iterator.hasNext()) { Row row = iterator.next(); JsonNode key = row.getKeyAsNode(); JsonNode value = row.getValueAsNode(); JsonNode doc = row.getDocAsNode();}

Changes FeedChangesCommand cmd = new ChangesCommand.Builder() .since(lastUpdateView) .includeDocs(false) .continuous(true) .build();feed = connector.changesFeed(cmd);while(feed.isAlive()) { DocumentChange change = feed.next();}

ReplicationReplicationCommand command = new ReplicationCommand.Builder() .source(SOURCE)) .target(TARGET) .continuous(true) .build();dbInstance.replicate(command);

Ektorp is Synchronous

EktorpAsyncTaskEktorpAsyncTask task = new EktorpAsyncTask() { @Override protected void doInBackground() {} @Override protected void onSuccess() {}}

ChangesFeedAsyncTaskChangesFeedAsyncTask task = newChangesFeedAsyncTask(connector, changesCmd) { @Override protected void handleDocumentChange(DocumentChange c) { }};

List View

ViewListAdapterCouchbaseViewListAdapter adapter =new CouchbaseViewListAdapter(connector, viewQuery, true) { @Override public View getView(int pos, View convertView, ViewGroup parent) { Row row = getRow(position); }

Grocery Sync Grocery Synchttps://github.com/couchbaselabs/AndroidGrocerySync

Mobile Challenges• Network status and capabilities change • Resuming stalled replications • Replicating the right subset of data• Performing Administrative Tasks • User Administration • Database Compaction

Next Steps• Beta Release • Automated Quality Control Process • Improved Documentation• Support ARMv6 and earlier CPUs• Add support for Replication DB to Ektorp• Java View Server (like Objective-C on iOS)• Provide Admin Party Alternative

Real ApplicationsMobile Futon Group Complete by Dale Harvey by Radical Dynamic

Resourceshttp://www.couchbase.org/get/couchbase-mobile-for-android• Google Group • http://groups.google.com/group/couchbase• Ektorp by Henrik Lundgren • http://ektorp.org• Marty Schoch • marty@couchbase.com • @mschoch

CouchConf-Chicago-Couchbase-Mobile-on-Android

by Couchbase on Nov 17, 2011

Accessibility

Categories

Upload Details

Usage Rights

Statistics

CouchConf-Chicago-Couchbase-Mobile-on-Android Presentation Transcript