TouchDB Ektorp Views

It may not be obvious at first how you can use TouchDB Views (implemented in Java) with the standard Ektorp API. Below is small example of how it can be done.

1. First set up your TDServer as described in the page Getting Started

2. Next, define a view with design document name and view name you want.

    String dDocName = "ddoc";
    String viewName = "people";
    TDView view = db.getViewNamed(String.format("%s/%s", dDocName, viewName));

3. Next, add the map/reduce implementation blocks for this view.

    view.setMapReduceBlocks(new TDViewMapBlock() {

        @Override
        public void map(Map<String, Object> document, TDViewMapEmitBlock emitter) {
            String type = (String)document.get("type");
            if("person".equals(type)) {
                emitter.emit(null, document.get("_id"));
            }
        }
    }, null, "1.0");

4. Now you can query this view using the normal Ektorp API:

    ViewQuery viewQuery = new ViewQuery().designDocId(dDocName).viewName(viewName);
    ViewResult viewResult = couchDbConnector.queryView(viewQuery);

5. If you follow these steps, custom CouchDbDocument subclasses and the repository support classes should also work.