ljffi-mongo: LuaJIT FFI MongoDB Driver

Installation

Download mongo-c-driver from https://github.com/mongodb/mongo-c-driver/
Follow instructions from mongo-c-driver/README to build and install mongo-c-driver
Don't forget to run sudo ldconfig after mongo-c-driver was installed

Usage

--import ljffi-mongo driver
local mongo = import 'ljffi-mongo/mongo' ()

--Connect to server
local con = mongo.connect("localhost", 27017)

local id = con:insert("ljffi-mongo.mycoll", {foo='bar'})

For more examples see test/cases/0020-mongo.lua

Serialization

ljffi-mongo supports transparent serialization/deserialization of Lua tables to BSON and BSON to Lua tables. This serialization is possible with certain restrictions:

A table could be serialized to MongoDB document iff:

All table keys must be either string, number, or boolean. Using other types as table key will cause an error.
All table values must be either string, number, boolean, nil, or table. Using other types of values will cause an error.
All nested tables should match to restrictions #1 and #2
Recursive tables are not supported.

Serialization rules are:

Empty tables will be serialized to empty documents
nil will be serialized to null

Deserialization restrictions

A MongoDB document could be deserialized using following rules:

Numbers of any type, integer, long, or double, will be deserialized to Lua number. Type information will be lost for this values.
Boolean values will be deserialized to Lua boolean
String values will be deserialized to Lua string
Null values will be deserialized to Lua nil
Arrays will be deserialized to Lua table
Objects will be deserialized to Lua table
Dates and timestamps will be deserialized to Lua number
ObjectID will be Arrays will be deserialized to Lua string

Copyright

See the copyright information in the file named COPYRIGHT.