Skip to content

A Node.js data layer supporting a variety of data sources using a single SQL based query syntax

Notifications You must be signed in to change notification settings

Protolus/protolus-data

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

protolus-data.js

A Node.js data layer supporting mysql/mongo/rabbit using a single SQL based query syntax

Usage

First you'll need to register at least one datasource:

var MySQLDatasource = require('protolus-data/sources/mysql');
new MySQLDatasource({
    name : 'maindatabase',
    host : 'localhost',
    user : 'dbuser',
    password : 'P455W0RD',
    database : 'mysqldbname'
});

The basic data pattern looks like:

var Data = require('protolus-data');
var MyObject = Data.Container({
    initialize : function MyObject(key){
        this.fields = [
            'id',
            'somefield',
            'anotherfield'
        ];
        this.parent({
            name : 'user',
            datasource : 'maindatabase'
        });
        if(key) this.load(key);
    }
});
Data.register('MyObject', MyObject);
module.exports = MyObject;

You would use this class like this:

var MyObject = Data.require('MyObject');
var myInstance = new MyObject();
myInstance.set('somefield', 'somevalue');
myInstance.set('anotherfield', 49);
myInstance.save();

And you would search for a set using:

Data.search('MyObject', "somefield == 'searchvalue' || (somefield > 24 && somefield < 38)");

or if you only wanted the data payload (not a set of objects)

Data.query('MyObject', "somefield == 'searchvalue' || (somefield > 24 && somefield < 38)");

One thing to note: This data layer is designed to discourage both streaming data sets and joins while normalizing query syntax across datasources. If you need these features or you find this level of indirection uncomfortable you should probably manipulate the DB directly and skip the whole data layer (or even better, interface with an API).

Virtuals

Sometimes you want to address a field as another field (we use this feature with mongo so you can address the primary key as 'id' rather than '_id'), but you want that reference to be symbolic as far as the DB is concerned. This is simply accomplished:

object.virtualAlias(virtualName, fieldName);

Direct Access

Other Datasource specific features (for example MapReduce under mongo) must be accessed from the DB driver which may be accessed directly:

var Data = require('protolus-data');
Data.Source.get('myAwesomeDatasource').connection;

But when you do this you are circumventing the data layer (other than letting protolus negotiate the connection for you).

Testing

Tests use mocha/should to execute the tests from root

mocha

If you find any rough edges, please submit a bug!

Enjoy,

-Abbey Hawk Sparrow

About

A Node.js data layer supporting a variety of data sources using a single SQL based query syntax

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published