Commits

Objects are stored by doing commit on one or more objects. All objects stored in a commit are stored in one transaction. The object graph is analysed to find other referenced objects.

Object version

All objects has a version number which is incremented during commit.

Marking objects as updated

Objects can either be commit directly by passing them to commit(), or by first call updated() on the objects, followed by commit_all() and at some later point.

Traversing the object graph

API

commit

C++

MyType *object1 = ...;
MyType *object2 = ...;
AnotherType *anotherOobject = ...;

db.commit({object1, object2});
db.commit(anotherObject);

std::vector<MyType*> objects;
db.commit(objects);

Node.js

let object1 = ...;
let object2 = ...;
let anotherObject = ...;

db.commit([object1, object2]);
db.commit(anotherObject);

let objects = [o1, o2, o3,...];
db.commit(objects);

update & commit_all

C++

MyType *object1 = ...;
MyType *object2 = ...;
AnotherType *anotherOobject = ...;

db.updated({object1, object2});
db.updated(anotherObject);

std::vector<MyType*> objects;
db.commit_all();

Node.js

let object1 = ...;
let object2 = ...;
let anotherObject = ...;

db.updated([object1, object2]);
db.updated(anotherObject);

let objects = [o1, o2, o3,...];
db.commit_all();

Controlling disk sync, caching and storage behaviour

By applying a flag for the commit call the disk sync, caching and storage behaviour can be modified:

The flags are:

cache

The object data will be cached in memory in addition to being stored on disk.

C++

db.commit({object1, object2}, dboo::cache);

Node.js

db.commit([object1, object2], dboo.cache);

cache_only

Does not save the object to disk at all. Note that this should never be applied to commits of objects that are referenced by others that are stored to disk.

C++

db.commit({object1, object2}, dboo::no_store);

Node.js

db.commit([object1, object2], dboo.no_store);

no_sync

Avoids filesystem sync to disk within the transaction:

C++

db.commit({object1, object2}, dboo::no_sync);

Node.js

db.commit([object1, object2], dboo.no_sync);