SeanXiao1988 / koa-waterline

A middleware for your hose

koa-waterline

Middleware for your hose

npm install koa-waterline

Usage

//see example.js

function* (){
  var ctx            = this;
  var message        = 'This is an example';
  var commentCreated = yield ctx._waterline.collections.comments.create({message: message});
  // You can yield to the CRUD waterline functions because they are written as promises.
  console.log(commentCreated);
}

// OR

function* () {
  var waterline      = yield Waterline.init(injection);
  var message        = 'This is an example';
  var commentCreated = yield waterline.collections.comments.create({message: message});
}

• The model attributes of connection and adp must match the connection and adapter naming conventions when setting up your environment to inject into the middleware.

Example

var connections = {
  couch: {
    adapter: "couch",
    host: '127.0.0.1',
    port: '5984',
    username: '',
    password: ''
  },
  mongo: {
    adapter: "mongo",
    host: 'localhost',
    port: '27017',
    user: '',
    password: '',
    database: 'waterline'
  },
  cassandra: {
    adapter: "cassandra",
    host: '',
    password: '',
    contactPoints: ['127.0.0.1'],
    keyspace: 'dev'
  }
};

var adapters = {
  couch:     require('sails-couchdb-orm'),
  mongo:     require('sails-mongo'),
  cassandra: require('sails-cassandra')
};

var models = {
    "comments": {
      "model": true,
      "adp": "couch",
      "connection": "couch",
      "properties": {
        "archived": {
            "type": "boolean",
            "defaultValue": false
        },
        "message": {
            "type": "string"
        }
      }
    },
    "history": {
      "model" : true,
      "adp": "mongo",
      "connection": "mongo",
      "properties": {
        "year": {
          "type": "string"
        }
      }
    },
    "tweet": {
      "adp": "cassandra",
      "connection": "cassandra",
      "index": ['tweet_body'],
      "properties": {
        "tweet_body": {
          "type": "string"
        }
      }
    },
    "error": {
      "model": false,
      "properties": {
        "erro": {
          "type": "string"
        }
      }
    }
  };

var injection               = {};
injection.methods           = false;
injection.models            = models;
injection.adapters          = adapters;
injection.connections       = connections;

app.use(waterline(injection));

##Attributes Models - Required

- Models must have an adp, connection, and the properties attributes with the same design pattern in the example above. There is an optional model flag that can be added inside the model that should be set to true or false; this allows you to not instiatiate specific models in waterline.

Adapters - Required

- The adapters refer to the connection adapters; this is required and while seeming redundant it is required to run waterline

Connections - Required

- The connection attributes are the setting parameters for the data models to create the waterline.

Methods - Optional

 - The methods attribute allows the injection of functions for virtual methods inside the model. An example of such an injection would something like this:

Methods Example:

 var methods = {
     history: function(){
     //virtual methods specific to the history model
     },
     comments: function(){
     //virtual methods specific to the comments model
     }
};

Notes

- Sails Cassandra fails the next time it's initialized because it attempts to over-ride; restart the service again until the actual sails-cassandra has been fixed

Debug

- DEBUG=koa-waterline node --harmony example.js

Authors

• Peter A Tariche

License

MIT