Swift CouchbaseLite Cheat Sheet

Here is how to use CouchbaseLite in your Swift app. To get started read the docs.

Bridging header

Add all necessary files to your bridging header.

#import "CouchbaseLite.framework/Headers/CouchbaseLite.h"

Creating a manager

var manager = CBLManager.sharedInstance()

Opening a database

do {
	let db = try manager.databaseNamed("mydb")
} catch {
	print(error)
}

Creating documents

do {
	let properties = [
		"name": "mirco",
		"email": "[email protected]",
		"repo": "swift-couchbaselite-cheatsheet"
	]

	let doc = db.createDocument()
	try doc.putProperties(properties)
} catch {
	print(error)
}

Creating and initializing views

let view = db.viewNamed("name")
let block: CBLMapBlock = { (doc, emit) in
  emit(doc["name"], nil)
}

view.setMapBlock(block, version: "1")

Querying views

do {
	let query = db.viewNamed("name").createQuery()
	query.keys = ["mirco"]
	let result = try query.run()

	let count = Int(result.count)

	for var index = 0; index < count; ++index {
		print(result.rowAtIndex(UInt(index)).document)
	}
} catch {
	print(error)
}

For some reason a for-in loop doesn't work.

for row in result {
  println(row.value)
}

Xcode starts to freak out and throws errors.

Query by timestamp

Add document with timestamp.

let timestamp = NSDate().timeIntervalSince1970 * 1000 as Double

let person: Dictionary[String, String]> = [
    "timestamp": timestamp,
    "type": "person",
    "name": "mirco"
]

Now query the view and get all persons in the order they were added to db.

let db = getDatabase("people")
let view = db.viewNamed("persons")
let map: CBLMapBlock = { (doc, emit) in
    if doc["type"] {
        if doc["type"] as NSString == "person" {
            emit(doc["timestamp"] as Double, nil)
        }
    }
}
view.setMapBlock(map, version: "1")

// get all moves between date in the future
// 2999-12-31 = 32503593600000
// and date in the past
// 2013-01-01 = 1356998400000

do {
	let query = db.viewNamed("persons").createQuery()
	query.startKey = 1356998400000 as Double
	query.endKey = 32503593600000 as Double
	let data = try query.run()
} catch {
	print(error)
}

Updating a document

var db = getDatabase("people")
var personDocument = db.documentWithID(personId)

do {
	try personDocument.update({ (newRev: CBLUnsavedRevision!) in
	    newRev["name"] = "john"
	    return true
	})
} catch {
	print(error)
}

Replication

var url = NSURL(string: "http://127.0.0.1:5984/test")
var push = db.createPushReplication(url)
var pull = db.createPullReplication(url)
push.continuous = true
pull.continuous = true

push.start()
pull.start()

License

MIT