From 9782bd1b3be31bbadc31e687aa18d301cde9d177 Mon Sep 17 00:00:00 2001 From: Doug Martin Date: Tue, 28 Aug 2012 16:02:07 -0500 Subject: [PATCH 1/3] updated docs and bug fixes --- docs-md/coverage.html | 461 ++++++++++--------- docs-md/querying.md | 2 +- docs/coverage.html | 461 ++++++++++--------- docs/patio.html | 6 +- docs/patio_Dataset.html | 152 +++++-- docs/querying.html | 730 +++++++++++++++--------------- lib/dataset/index.js | 18 + lib/dataset/query.js | 24 + lib/dataset/sql.js | 149 +++--- lib/model.js | 7 +- test/model.test.js | 26 +- test/plugins/columnMapper.test.js | 1 - 12 files changed, 1110 insertions(+), 927 deletions(-) diff --git a/docs-md/coverage.html b/docs-md/coverage.html index c6344a66..70d5468b 100644 --- a/docs-md/coverage.html +++ b/docs-md/coverage.html @@ -256,10 +256,10 @@
- Coverage89.22 - SLOC21912 - LOC5351 - Missed577 + Coverage89.21 + SLOC21921 + LOC5357 + Missed578
@@ -943,10 +943,10 @@
- Coverage72.53 - SLOC1076 - LOC91 - Missed25 + Coverage71.74 + SLOC1078 + LOC92 + Missed26
@@ -1682,8 +1682,10 @@
  • * @param opts
  • */
  • configureLogging:function (opts) {
    • -
  • 0 comb.logger.configure();
    • -
  • 0 LOGGER.level = "info";
    • +
  • 0 comb.logger.configure(opts);
    • +
  • 0 if (!opts) {
    • +
  • 0 LOGGER.level = "info";
    • +
  • }
  • },
  • /**
    • @@ -2519,7 +2521,7 @@
  • },
  • _quotedIdentifier:function (c) {
    • -
  • 25927 return format('"%s"', c);
    • +
  • 26239 return format('"%s"', c);
  • },
  • __fullTextStringJoin:function (cols) {
    • @@ -2573,12 +2575,12 @@
  • 3048 var cols = [];
  • 3048 if (rows && rows.length) {
  • 2543 cols = this.__columns = fields && fields.length ? fields.map(function (f) {
    • -
  • 18922 return f.name;
    • +
  • 18560 return f.name;
  • }) : Object.keys(rows[0]);
  • //the pg driver does auto type coercion
  • 2543 cols = cols.map(function (c) {
    • -
  • 18922 return [oi(c), function (o) {
    • -
  • 28420 return o;
    • +
  • 18560 return [oi(c), function (o) {
    • +
  • 27740 return o;
  • }, c];
  • }, this);
  • }
    • @@ -2605,7 +2607,7 @@
  • 3654 var h = {};
  • 3654 var row = rows[index];
  • 3654 cols.forEach(function (col) {
    • -
  • 28420 h[col[0]] = col[1](row[col[2]]);
    • +
  • 27740 h[col[0]] = col[1](row[col[2]]);
  • }, this);
  • 3654 when(cb(h)).then(function (val) {
    • @@ -2657,15 +2659,15 @@
  • },
  • supportsDistinctOn:function () {
    • -
  • 12670 return true;
    • +
  • 12996 return true;
  • },
  • supportsModifyingJoins:function () {
    • -
  • 15114 return true;
    • +
  • 15440 return true;
  • },
  • supportsTimestampTimezones:function () {
    • -
  • 12668 return true;
    • +
  • 12994 return true;
  • }
  • }
    • @@ -3743,13 +3745,13 @@
  • * @return the typecasted value.
  • * */
  • typecastValue:function (columnType, value) {
    • -
  • 32725 if (isNull(value) || isUndefined(value)) {
    • +
  • 32726 if (isNull(value) || isUndefined(value)) {
  • 5793 return null;
  • }
    • -
  • 26932 var meth = "__typecastValue" + columnType.charAt(0).toUpperCase() + columnType.substr(1).toLowerCase();
    • -
  • 26932 try {
    • -
  • 26932 if (isFunction(this[meth])) {
    • -
  • 26932 return this[meth](value);
    • +
  • 26933 var meth = "__typecastValue" + columnType.charAt(0).toUpperCase() + columnType.substr(1).toLowerCase();
    • +
  • 26933 try {
    • +
  • 26933 if (isFunction(this[meth])) {
    • +
  • 26933 return this[meth](value);
  • } else {
  • 0 return value;
  • }
    • @@ -3915,7 +3917,7 @@
  • // Typecast the value to a String
  • __typecastValueString:function (value) {
    • -
  • 19607 return "" + value;
    • +
  • 19608 return "" + value;
  • }
  • },
    • @@ -6274,9 +6276,9 @@
    - Coverage88.36 - SLOC1061 - LOC318 + Coverage88.51 + SLOC1067 + LOC322 Missed37
    @@ -6474,24 +6476,24 @@
  • * @borrows patio.Dataset#leftJoin as leftJoin
  • * */
  • constructor:function (options, fromDb) {
    • -
  • 3218 if (this.synced) {
    • -
  • 3218 this.__emitter = new EventEmitter();
    • -
  • 3218 this._super(arguments);
    • -
  • 3218 this.patio = patio || require("./index");
    • -
  • 3218 fromDb = isBoolean(fromDb) ? fromDb : false;
    • -
  • 3218 this.__changed = {};
    • -
  • 3218 this.__values = {};
    • -
  • 3218 if (fromDb) {
    • -
  • 1753 this._hook("pre", "load");
    • -
  • 1753 this.__isNew = false;
    • -
  • 1753 this.__setFromDb(options, true);
    • -
  • 1753 if (this._static.emitOnLoad) {
    • -
  • 1753 this.emit("load", this);
    • -
  • 1753 this._static.emit("load", this);
    • +
  • 3111 if (this.synced) {
    • +
  • 3111 this.__emitter = new EventEmitter();
    • +
  • 3111 this._super(arguments);
    • +
  • 3111 this.patio = patio || require("./index");
    • +
  • 3111 fromDb = isBoolean(fromDb) ? fromDb : false;
    • +
  • 3111 this.__changed = {};
    • +
  • 3111 this.__values = {};
    • +
  • 3111 if (fromDb) {
    • +
  • 1754 this._hook("pre", "load");
    • +
  • 1754 this.__isNew = false;
    • +
  • 1754 this.__setFromDb(options, true);
    • +
  • 1754 if (this._static.emitOnLoad) {
    • +
  • 1754 this.emit("load", this);
    • +
  • 1754 this._static.emit("load", this);
  • }
  • } else {
    • -
  • 1465 this.__isNew = true;
    • -
  • 1465 this.__set(options);
    • +
  • 1357 this.__isNew = true;
    • +
  • 1357 this.__set(options);
  • }
  • } else {
  • 0 throw new ModelError("Model " + this.tableName + " has not been synced");
    • @@ -6499,26 +6501,32 @@
  • },
  • __set:function (values, ignore) {
    • -
  • 1587 values = values || {};
    • -
  • 1587 this.__ignore = ignore === true;
    • -
  • 1587 Object.keys(values).forEach(function (attribute) {
    • +
  • 1479 values = values || {};
    • +
  • 1479 this.__ignore = ignore === true;
    • +
  • 1479 Object.keys(values).forEach(function (attribute) {
  • 6632 var value = values[attribute];
  • //check if the column is a constrained value and is allowed to be set
  • 6632 !ignore && this._checkIfColumnIsConstrained(attribute);
  • 6632 this[attribute] = value;
  • }, this);
    • -
  • 1587 this.__ignore = false;
    • +
  • 1479 this.__ignore = false;
  • },
  • __setFromDb:function (values, ignore) {
    • -
  • 3056 values = values || {};
    • -
  • 3056 this.__ignore = ignore === true;
    • -
  • 3056 Object.keys(values).forEach(function (column) {
    • -
  • 25828 var value = values[column];
    • +
  • 3057 values = values || {};
    • +
  • 3057 this.__ignore = ignore === true;
    • +
  • 3057 var schema = this.schema;
    • +
  • 3057 Object.keys(values).forEach(function (column) {
    • +
  • 25150 var value = values[column];
  • // Typecast value retrieved from db
    • -
  • 25828 this.__values[column] = this._typeCastValue(column, value, ignore);
    • +
  • 25150 if (schema.hasOwnProperty(column)) {
    • +
  • 25149 this.__values[column] = this._typeCastValue(column, value, ignore);
    • +
  • } else {
    • +
  • 1 console.log(column);
    • +
  • 1 this[column] = value;
    • +
  • }
  • }, this);
    • -
  • 3056 this.__ignore = false;
    • +
  • 3057 this.__ignore = false;
  • },
    • @@ -6576,11 +6584,11 @@
  • },
  • _getColumnValue:function (name) {
    • -
  • 5426 var val = this.__values[name];
    • -
  • 5426 var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
    • -
  • 5426 var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
    • +
  • 5427 var val = this.__values[name];
    • +
  • 5427 var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
    • +
  • 5427 var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
    • -
  • 5426 return columnValue;
    • +
  • 5427 return columnValue;
  • },
  • _setColumnValue:function (name, val) {
    • @@ -6600,25 +6608,25 @@
  • //typecast_value method, so database adapters can override/augment the handling
  • //for database specific column types.
  • _typeCastValue:function (column, value, fromDatabase) {
    • -
  • 33384 var colSchema, clazz = this._static;
    • -
  • 33384 if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
    • -
  • 32704 var type = colSchema.type;
    • -
  • 32704 if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
    • +
  • 32705 var colSchema, clazz = this._static;
    • +
  • 32705 if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
    • +
  • 32705 var type = colSchema.type;
    • +
  • 32705 if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
  • 3 value = null;
  • }
    • -
  • 32704 var raiseOnError = clazz.raiseOnTypecastError;
    • -
  • 32704 if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
    • +
  • 32705 var raiseOnError = clazz.raiseOnTypecastError;
    • +
  • 32705 if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
  • 0 throw new ModelError("null is not allowed for the " + column + " column.");
  • }
    • -
  • 32704 try {
    • -
  • 32704 value = clazz.db.typecastValue(type, value);
    • +
  • 32705 try {
    • +
  • 32705 value = clazz.db.typecastValue(type, value);
  • } catch (e) {
  • 0 if (raiseOnError === true) {
  • 0 throw e;
  • }
  • }
  • }
    • -
  • 33384 return value;
    • +
  • 32705 return value;
  • },
  • /**
    • @@ -6690,8 +6698,8 @@
  • 0 return emitter.listeners.apply(emitter, arguments);
  • },
  • emit:function () {
    • -
  • 11119 var emitter = this.__emitter;
    • -
  • 11119 return emitter.emit.apply(emitter, arguments);
    • +
  • 11120 var emitter = this.__emitter;
    • +
  • 11120 return emitter.emit.apply(emitter, arguments);
  • },
    • @@ -6732,7 +6740,7 @@
  • },
  • schema:function () {
    • -
  • 73400 return this._static.schema;
    • +
  • 75099 return this._static.schema;
  • },
  • columns:function () {
    • @@ -6740,7 +6748,7 @@
  • },
  • synced:function () {
    • -
  • 12891 return this._static.synced;
    • +
  • 12784 return this._static.synced;
  • }
  • }
    • @@ -7049,7 +7057,7 @@
  • _defineColumnGetter:function (name) {
  • 779 this.prototype.__defineGetter__(name, function () {
    • -
  • 5426 return this._getColumnValue(name);
    • +
  • 5427 return this._getColumnValue(name);
  • });
  • },
    • @@ -7105,14 +7113,14 @@
  • * @type patio.Database
  • */
  • db:function () {
    • -
  • 46373 var db = this.__db;
    • -
  • 46373 if (!db) {
    • +
  • 46374 var db = this.__db;
    • +
  • 46374 if (!db) {
  • 86 db = this.__db = patio.defaultDatabase;
  • }
    • -
  • 46373 if (!db) {
    • +
  • 46374 if (!db) {
  • 0 throw new ModelError("patio has not been connected to a database");
  • }
    • -
  • 46373 return db;
    • +
  • 46374 return db;
  • },
  • /**
    • @@ -7159,8 +7167,8 @@
  • * @type Object
  • */
  • schema:function () {
    • -
  • 73404 if (this.synced) {
    • -
  • 73404 return this.__schema;
    • +
  • 75103 if (this.synced) {
    • +
  • 75103 return this.__schema;
  • } else {
  • 0 throw new ModelError("Model has not been synced yet");
  • }
    • @@ -7353,9 +7361,9 @@
    - Coverage89.05 - SLOC308 - LOC137 + Coverage89.13 + SLOC309 + LOC138 Missed15
    @@ -7418,7 +7426,8 @@
  • 0 ds = ds.apply(parent, [parent]);
  • }
  • 326 if (!ds) {
    • -
  • 326 ds = this.model.dataset.naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
    • +
  • 326 ds = this.model.dataset;
    • +
  • 326 ds = ds.select(ds.firstSourceAlias.all()).naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
  • 326 return sql.stringToIdentifier(k);
  • })).concat(zip(keys[0], this.parentPrimaryKey.map(function (k) {
  • 326 return parent[k];
    • @@ -9060,21 +9069,21 @@
  • 1var virtualRow = function (name) {
    • -
  • 1069 var WILDCARD = new LiteralString('*');
    • -
  • 1069 var QUESTION_MARK = new LiteralString('?');
    • -
  • 1069 var COMMA_SEPARATOR = new LiteralString(', ');
    • -
  • 1069 var DOUBLE_UNDERSCORE = '__';
    • -
    • -
  • 1069 var parts = name.split(DOUBLE_UNDERSCORE);
    • -
  • 1069 var table = parts[0], column = parts[1];
    • -
  • 1069 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • -
  • 1069 var prox = methodMissing(ident, function (m) {
    • +
  • 874 var WILDCARD = new LiteralString('*');
    • +
  • 874 var QUESTION_MARK = new LiteralString('?');
    • +
  • 874 var COMMA_SEPARATOR = new LiteralString(', ');
    • +
  • 874 var DOUBLE_UNDERSCORE = '__';
    • +
    • +
  • 874 var parts = name.split(DOUBLE_UNDERSCORE);
    • +
  • 874 var table = parts[0], column = parts[1];
    • +
  • 874 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • +
  • 874 var prox = methodMissing(ident, function (m) {
  • 4 return function () {
  • 3 var args = argsToArray(arguments);
  • 3 return SQLFunction.fromArgs([m, name].concat(args));
  • }
  • }, column ? QualifiedIdentifier : Identifier);
    • -
  • 1069 var ret = createFunctionWrapper(prox, function (m) {
    • +
  • 874 var ret = createFunctionWrapper(prox, function (m) {
  • 548 var args = argsToArray(arguments);
  • 548 if (args.length) {
  • 542 return SQLFunction.fromArgs([name].concat(args));
    • @@ -9084,8 +9093,8 @@
  • }, function () {
  • 0 return SQLFunction.fromArgs(arguments);
  • });
    • -
  • 1069 ret.__proto__ = ident;
    • -
  • 1069 return ret;
    • +
  • 874 ret.__proto__ = ident;
    • +
  • 874 return ret;
  • };
  • 1var DATE_METHODS = ["getDate", "getDay", "getFullYear", "getHours", "getMilliseconds", "getMinutes", "getMonth", "getSeconds",
    • @@ -9537,7 +9546,7 @@
  • });
  • 1exports.sql = methodMissing(sql, function (name) {
    • -
  • 1069 return virtualRow(name);
    • +
  • 874 return virtualRow(name);
  • });
  • 1var OPERTATOR_INVERSIONS = {
    • @@ -10189,7 +10198,7 @@
  • * @return {patio.sql.ColumnAll}
  • */
  • all:function () {
    • -
  • 3 return new ColumnAll(this);
    • +
  • 329 return new ColumnAll(this);
  • }
    • @@ -10347,13 +10356,13 @@
  • * @return {patio.sql.Expression} an expression.
  • */
  • fromArgs:function (args) {
    • -
  • 2410 var ret;
    • -
  • 2410 try {
    • -
  • 2410 ret = new this();
    • +
  • 2215 var ret;
    • +
  • 2215 try {
    • +
  • 2215 ret = new this();
  • } catch (ignore) {
  • }
    • -
  • 2410 this.apply(ret, args);
    • -
  • 2410 return ret;
    • +
  • 2215 this.apply(ret, args);
    • +
  • 2215 return ret;
  • },
  • /**
    • @@ -10545,7 +10554,7 @@
  • * @property table the table this all column expression represents.
  • */
  • constructor:function (table) {
    • -
  • 20 this.table = table;
    • +
  • 346 this.table = table;
  • },
  • /**
    • @@ -10557,9 +10566,9 @@
  • * @return String the SQL columnAll expression fragment.
  • */
  • toString:function (ds) {
    • -
  • 19 !Dataset && (Dataset = require("./dataset"));
    • -
  • 19 ds = ds || new Dataset();
    • -
  • 19 return ds.columnAllSql(this);
    • +
  • 345 !Dataset && (Dataset = require("./dataset"));
    • +
  • 345 ds = ds || new Dataset();
    • +
  • 345 return ds.columnAllSql(this);
  • }
  • }
  • }).as(sql, "ColumnAll");
    • @@ -11156,7 +11165,7 @@
  • * @property {String} value <b>READ ONLY</b> the column or table this identifier represents.
  • */
  • constructor:function (value) {
    • -
  • 16802 this.__value = value;
    • +
  • 16412 this.__value = value;
  • },
  • /**
    • @@ -11176,7 +11185,7 @@
  • /**@ignore*/
  • getters:{
  • value:function () {
    • -
  • 25154 return this.__value;
    • +
  • 25480 return this.__value;
  • }
  • }
  • }
    • @@ -11733,7 +11742,7 @@
  • 1var addStringMethod = function (op) {
  • 24 return function () {
    • -
  • 4294 return this.__str[op].apply(this.__str, arguments);
    • +
  • 3968 return this.__str[op].apply(this.__str, arguments);
  • }
  • };
    • @@ -11756,7 +11765,7 @@
  • * @param {String} str the literal string.
  • */
  • constructor:function (str) {
    • -
  • 3677 this.__str = str;
    • +
  • 3092 this.__str = str;
  • }
  • }
  • }).as(sql, "LiteralString");
    • @@ -12660,14 +12669,14 @@
  • * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions.
  • */
  • constructor:function (db, opts) {
    • -
  • 29216 this._super(arguments);
    • -
  • 29216 this.db = db;
    • -
  • 29216 this.__opts = {};
    • -
  • 29216 this.__rowCb = null;
    • -
  • 29216 if (db) {
    • -
  • 15039 this.__quoteIdentifiers = db.quoteIdentifiers;
    • -
  • 15039 this.__identifierInputMethod = db.identifierInputMethod;
    • -
  • 15039 this.__identifierOutputMethod = db.identifierOutputMethod;
    • +
  • 29542 this._super(arguments);
    • +
  • 29542 this.db = db;
    • +
  • 29542 this.__opts = {};
    • +
  • 29542 this.__rowCb = null;
    • +
  • 29542 if (db) {
    • +
  • 15365 this.__quoteIdentifiers = db.quoteIdentifiers;
    • +
  • 15365 this.__identifierInputMethod = db.identifierInputMethod;
    • +
  • 15365 this.__identifierOutputMethod = db.identifierOutputMethod;
  • }
  • },
    • @@ -12682,22 +12691,22 @@
  • * @return [patio.Dataset] a cloned dataset with the merged options
  • **/
  • mergeOptions:function (opts) {
    • -
  • 14948 opts = isUndefined(opts) ? {} : opts;
    • -
  • 14948 var ds = new this._static(this.db, {});
    • -
  • 14948 ds.rowCb = this.rowCb;
    • -
  • 14948 this._static.FEATURES.forEach(function (f) {
    • -
  • 209272 ds[f] = this[f];
    • +
  • 15274 opts = isUndefined(opts) ? {} : opts;
    • +
  • 15274 var ds = new this._static(this.db, {});
    • +
  • 15274 ds.rowCb = this.rowCb;
    • +
  • 15274 this._static.FEATURES.forEach(function (f) {
    • +
  • 213836 ds[f] = this[f];
  • }, this);
    • -
  • 14948 ds.__opts = merge({}, this.__opts, opts);
    • -
  • 14948 ds.identifierInputMethod = this.identifierInputMethod;
    • -
  • 14948 ds.identifierOutputMethod = this.identifierOutputMethod;
    • -
  • 14948 var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
    • -
  • 14948 if (Object.keys(opts).some(function (o) {
    • -
  • 13536 return columnChangeOpts.indexOf(o) != -1;
    • +
  • 15274 ds.__opts = merge({}, this.__opts, opts);
    • +
  • 15274 ds.identifierInputMethod = this.identifierInputMethod;
    • +
  • 15274 ds.identifierOutputMethod = this.identifierOutputMethod;
    • +
  • 15274 var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
    • +
  • 15274 if (Object.keys(opts).some(function (o) {
    • +
  • 13862 return columnChangeOpts.indexOf(o) != -1;
  • })) {
    • -
  • 2456 ds.__opts.columns = null;
    • +
  • 2782 ds.__opts.columns = null;
  • }
    • -
  • 14948 return ds;
    • +
  • 15274 return ds;
  • },
    • @@ -12784,31 +12793,31 @@
  • getters:{
  • rowCb:function () {
    • -
  • 23052 return this.__rowCb;
    • +
  • 23378 return this.__rowCb;
  • },
  • identifierInputMethod:function () {
    • -
  • 14948 return this.__identifierInputMethod;
    • +
  • 15274 return this.__identifierInputMethod;
  • },
  • identifierOutputMethod:function () {
    • -
  • 14948 return this.__identifierOutputMethod;
    • +
  • 15274 return this.__identifierOutputMethod;
  • },
  • firstSourceAlias:function () {
    • -
  • 579 var source = this.__opts.from;
    • -
  • 579 if (isUndefinedOrNull(source) || !source.length) {
    • +
  • 905 var source = this.__opts.from;
    • +
  • 905 if (isUndefinedOrNull(source) || !source.length) {
  • 2 throw new DatasetError("No source specified for the query");
  • }
    • -
  • 577 source = source[0];
    • -
  • 577 if (isInstanceOf(source, AliasedExpression)) {
    • +
  • 903 source = source[0];
    • +
  • 903 if (isInstanceOf(source, AliasedExpression)) {
  • 20 return source.alias;
    • -
  • 557 } else if (isString(source)) {
    • +
  • 883 } else if (isString(source)) {
  • 0 var parts = this._splitString(source);
  • 0 var alias = parts[2];
  • 0 return alias ? alias : source;
  • } else {
    • -
  • 557 return source;
    • +
  • 883 return source;
  • }
  • },
    • @@ -12836,16 +12845,16 @@
  • /**@lends patio.Dataset.prototype*/
  • identifierInputMethod:function (meth) {
    • -
  • 15038 this.__identifierInputMethod = meth;
    • +
  • 15364 this.__identifierInputMethod = meth;
  • },
  • identifierOutputMethod:function (meth) {
    • -
  • 15038 this.__identifierOutputMethod = meth;
    • +
  • 15364 this.__identifierOutputMethod = meth;
  • },
  • rowCb:function (cb) {
    • -
  • 18564 if (isFunction(cb) || isNull(cb)) {
    • -
  • 18559 this.__rowCb = cb;
    • +
  • 18890 if (isFunction(cb) || isNull(cb)) {
    • +
  • 18885 this.__rowCb = cb;
  • } else {
  • 5 throw new DatasetError("rowCb mus be a function");
  • }
    • @@ -13976,9 +13985,9 @@
  • constructor:function () {
  • //We initialize these here because otherwise
  • //the will be blank because of recursive dependencies.
    • -
  • 29216 !patio && (patio = require("../index"));
    • -
  • 29216 !Dataset && (Dataset = patio.Dataset);
    • -
  • 29216 this._super(arguments);
    • +
  • 29542 !patio && (patio = require("../index"));
    • +
  • 29542 !Dataset && (Dataset = patio.Dataset);
    • +
  • 29542 this._super(arguments);
  • },
  • /**
    • @@ -14263,15 +14272,15 @@
  • * @return {String} a literal representation of the value.
  • */
  • literal:function (v) {
    • -
  • 44422 if (isInstanceOf(v, LiteralString)) {
    • +
  • 44748 if (isInstanceOf(v, LiteralString)) {
  • 204 return "" + v;
    • -
  • 44218 } else if (isString(v)) {
    • +
  • 44544 } else if (isString(v)) {
  • 6110 return this._literalString(v);
    • -
  • 38108 } else if (isNumber(v)) {
    • +
  • 38434 } else if (isNumber(v)) {
  • 6997 return this._literalNumber(v);
  • }
    • -
  • 31111 else if (isInstanceOf(v, Expression)) {
    • -
  • 28577 return this._literalExpression(v);
    • +
  • 31437 else if (isInstanceOf(v, Expression)) {
    • +
  • 28903 return this._literalExpression(v);
  • }
  • 2534 else if (isInstanceOf(v, Dataset)) {
  • 104 return this._literalDataset(v);
    • @@ -14583,7 +14592,7 @@
  • * SQL fragment for specifying all columns in a given table
  • **/
  • columnAllSql:function (ca) {
    • -
  • 19 return string.format("%s.*", this.quoteSchemaTable(ca.table));
    • +
  • 345 return string.format("%s.*", this.quoteSchemaTable(ca.table));
  • },
  • /**
    • @@ -14789,18 +14798,18 @@
  • * quote the name with {@link patio.dataset._Sql#_quotedIdentifier}.
  • */
  • quoteIdentifier:function (name) {
    • -
  • 33767 if (isInstanceOf(name, LiteralString)) {
    • +
  • 34093 if (isInstanceOf(name, LiteralString)) {
  • 260 return name;
  • } else {
    • -
  • 33507 if (isInstanceOf(name, Identifier)) {
    • +
  • 33833 if (isInstanceOf(name, Identifier)) {
  • 22237 name = name.value;
  • }
    • -
  • 33507 name = this.inputIdentifier(name);
    • -
  • 33507 if (this.quoteIdentifiers) {
    • -
  • 26311 name = this._quotedIdentifier(name)
    • +
  • 33833 name = this.inputIdentifier(name);
    • +
  • 33833 if (this.quoteIdentifiers) {
    • +
  • 26623 name = this._quotedIdentifier(name)
  • }
  • }
    • -
  • 33507 return name;
    • +
  • 33833 return name;
  • },
  • /**
    • @@ -14810,9 +14819,9 @@
  • * identifierOutputMethod.
  • */
  • inputIdentifier:function (v) {
    • -
  • 33693 var i = this.__identifierInputMethod;
    • -
  • 33693 v = v.toString(this);
    • -
  • 33693 return !isUndefinedOrNull(i) ?
    • +
  • 34019 var i = this.__identifierInputMethod;
    • +
  • 34019 v = v.toString(this);
    • +
  • 34019 return !isUndefinedOrNull(i) ?
  • isFunction(v[i]) ?
  • v[i]() :
  • isFunction(comb[i]) ?
    • @@ -14828,9 +14837,9 @@
  • * identifierOutputMethod.
  • */
  • outputIdentifier:function (v) {
    • -
  • 19885 (v == '' && (v = 'untitled'));
    • -
  • 19885 var i = this.__identifierOutputMethod;
    • -
  • 19885 return !isUndefinedOrNull(i) ?
    • +
  • 19523 (v == '' && (v = 'untitled'));
    • +
  • 19523 var i = this.__identifierOutputMethod;
    • +
  • 19523 return !isUndefinedOrNull(i) ?
  • isFunction(v[i]) ?
  • v[i]() :
  • isFunction(comb[i]) ?
    • @@ -14846,10 +14855,10 @@
  • * quoted (if quoting identifiers)
  • */
  • quoteSchemaTable:function (table) {
    • -
  • 2231 var parts = this.schemaAndTable(table);
    • -
  • 2231 var schema = parts[0];
    • -
  • 2231 table = parts[1];
    • -
  • 2231 return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
    • +
  • 2557 var parts = this.schemaAndTable(table);
    • +
  • 2557 var schema = parts[0];
    • +
  • 2557 table = parts[1];
    • +
  • 2557 return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
  • },
    • @@ -14858,15 +14867,15 @@
  • * Split the schema information from the table
  • */
  • schemaAndTable:function (tableName) {
    • -
  • 2475 var sch = this.db ? this.db.defaultSchema || null : null;
    • -
  • 2475 if (isString(tableName)) {
    • +
  • 2801 var sch = this.db ? this.db.defaultSchema || null : null;
    • +
  • 2801 if (isString(tableName)) {
  • 1008 var parts = this._splitString(tableName);
  • 1008 var s = parts[0], table = parts[1];
  • 1008 return [s || sch, table];
    • -
  • 1467 } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
    • +
  • 1793 } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
  • 3 return [tableName.table, tableName.column]
    • -
  • 1464 } else if (isInstanceOf(tableName, Identifier)) {
    • -
  • 1464 return [null, tableName.value];
    • +
  • 1790 } else if (isInstanceOf(tableName, Identifier)) {
    • +
  • 1790 return [null, tableName.value];
  • } else {
  • 0 throw new QueryError("table should be a QualifiedIdentifier, Identifier, or String");
  • }
    • @@ -14915,7 +14924,7 @@
  • * expressions.
  • */
  • __expressionList:function (columns) {
    • -
  • 4284 return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
    • +
  • 4610 return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
  • },
  • //Format the timestamp based on the default_timestamp_format, with a couple
    • @@ -15037,7 +15046,7 @@
  • * @return SQL fragment for SQL::Expression, result depends on the specific type of expression.
  • * */
  • _literalExpression:function (v) {
    • -
  • 28587 return v.toString(this);
    • +
  • 28913 return v.toString(this);
  • },
  • /**
    • @@ -15703,7 +15712,7 @@
  • * @type String
  • */
  • identifierInputMethod:function () {
    • -
  • 15038 return this.__identifierInputMethod;
    • +
  • 15364 return this.__identifierInputMethod;
  • },
  • /**
    • @@ -15715,7 +15724,7 @@
  • * @type String
  • */
  • identifierOutputMethod:function () {
    • -
  • 15038 return this.__identifierOutputMethod;
    • +
  • 15364 return this.__identifierOutputMethod;
  • },
  • /**
    • @@ -15728,7 +15737,7 @@
  • * @default true
  • */
  • quoteIdentifiers:function () {
    • -
  • 15004 return this.__quoteIdentifiers;
    • +
  • 15330 return this.__quoteIdentifiers;
  • }
  • },
    • @@ -15871,10 +15880,10 @@
  • /**@ignore*/
  • constructor:function () {
    • -
  • 29216 if (!Dataset) {
    • +
  • 29542 if (!Dataset) {
  • 1 Dataset = require("../index").Dataset;
  • }
    • -
  • 29216 this._super(arguments);
    • +
  • 29542 this._super(arguments);
  • },
    • @@ -15904,7 +15913,7 @@
  • 2734 var a = [];
  • 2734 var ret = new Promise().classic(cb);
  • 2734 this.forEach(hitch(this, function (r) {
    • -
  • 2936 a.push(r);
    • +
  • 2934 a.push(r);
  • })).then(hitch(this, function () {
  • 2731 this.postLoad(a);
  • 2731 if (block) {
    • @@ -17150,10 +17159,10 @@
  • *
  • */
  • constructor:function () {
    • -
  • 3218 if (comb.isUndefinedOrNull(this.__associations)) {
    • -
  • 3055 this.__associations = {};
    • +
  • 3111 if (comb.isUndefinedOrNull(this.__associations)) {
    • +
  • 3002 this.__associations = {};
  • }
    • -
  • 3218 this._super(arguments);
    • +
  • 3111 this._super(arguments);
  • },
  • reload:function () {
    • @@ -18392,17 +18401,17 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29216 this._super(arguments);
    • -
  • 29216 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 204512 if (!this[type + "Join"]) {
    • -
  • 204512 this[type + "Join"] = conditionedJoin.bind(this, type);
    • +
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29542 this._super(arguments);
    • +
  • 29542 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 206794 if (!this[type + "Join"]) {
    • +
  • 206794 this[type + "Join"] = conditionedJoin.bind(this, type);
  • }
  • }, this);
    • -
  • 29216 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 146080 if (!this[type + "Join"]) {
    • -
  • 146080 this[type + "Join"] = unConditionJoin.bind(this, type);
    • +
  • 29542 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 147710 if (!this[type + "Join"]) {
    • +
  • 147710 this[type + "Join"] = unConditionJoin.bind(this, type);
  • }
  • }, this);
    • @@ -19814,29 +19823,29 @@
  • * @return {patio.Dataset} a cloned dataset with the columns selected changed.
  • */
  • select:function (args) {
    • -
  • 535 args = flatten(argsToArray(arguments));
    • -
  • 535 var columns = [];
    • -
  • 535 args.forEach(function (c) {
    • -
  • 955 if (isFunction(c)) {
    • +
  • 861 args = flatten(argsToArray(arguments));
    • +
  • 861 var columns = [];
    • +
  • 861 args.forEach(function (c) {
    • +
  • 1281 if (isFunction(c)) {
  • 23 var res = c.apply(sql, [sql]);
  • 23 columns = columns.concat(isArray(res) ? res : [res]);
  • } else {
    • -
  • 932 columns.push(c);
    • +
  • 1258 columns.push(c);
  • }
  • });
    • -
  • 535 var select = [];
    • -
  • 535 columns.forEach(function (c) {
    • -
  • 958 if (isHash(c)) {
    • +
  • 861 var select = [];
    • +
  • 861 columns.forEach(function (c) {
    • +
  • 1284 if (isHash(c)) {
  • 3 for (var i in c) {
  • 4 select.push(new AliasedExpression(new Identifier(i), c[i]));
  • }
    • -
  • 955 } else if (isString(c)) {
    • +
  • 1281 } else if (isString(c)) {
  • 406 select.push(this.stringToIdentifier(c));
  • } else {
    • -
  • 549 select.push(c);
    • +
  • 875 select.push(c);
  • }
  • }, this);
    • -
  • 535 return this.mergeOptions({select:select});
    • +
  • 861 return this.mergeOptions({select:select});
  • },
    • @@ -21117,7 +21126,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(){
    • -
  • 48455 return this.__quoteIdentifiers;
    • +
  • 49107 return this.__quoteIdentifiers;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21125,20 +21134,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(){
    • -
  • 14948 return this.__providesAccurateRowsMatched;
    • +
  • 15274 return this.__providesAccurateRowsMatched;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(){
    • -
  • 14955 return this.__requiresSqlStandardDateTimes;
    • +
  • 15281 return this.__requiresSqlStandardDateTimes;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(){
    • -
  • 14961 return this.__supportsCte;
    • +
  • 15287 return this.__supportsCte;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21150,25 +21159,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(){
    • -
  • 14984 return this.__supportsIntersectExcept;
    • +
  • 15310 return this.__supportsIntersectExcept;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(){
    • -
  • 14960 return this.__supportsIntersectExceptAll;
    • +
  • 15286 return this.__supportsIntersectExceptAll;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(){
    • -
  • 15217 return this.__supportsIsTrue;
    • +
  • 15543 return this.__supportsIsTrue;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(){
    • -
  • 14959 return this.__supportsJoinUsing;
    • +
  • 15285 return this.__supportsJoinUsing;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21180,7 +21189,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(){
    • -
  • 14952 return this.__supportsMultipleColumnIn;
    • +
  • 15278 return this.__supportsMultipleColumnIn;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21192,13 +21201,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(){
    • -
  • 14948 return this.__supportsTimestampUsecs;
    • +
  • 15274 return this.__supportsTimestampUsecs;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(){
    • -
  • 14948 return this.__supportsWindowFunctions;
    • +
  • 15274 return this.__supportsWindowFunctions;
  • }
  • },
    • @@ -21209,7 +21218,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(val){
    • -
  • 14960 this.__quoteIdentifiers = val;
    • +
  • 15286 this.__quoteIdentifiers = val;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21217,20 +21226,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(val){
    • -
  • 14948 this.__providesAccurateRowsMatched = val;
    • +
  • 15274 this.__providesAccurateRowsMatched = val;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(val){
    • -
  • 14948 this.__requiresSqlStandardDateTimes = val;
    • +
  • 15274 this.__requiresSqlStandardDateTimes = val;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(val){
    • -
  • 14949 this.__supportsCte = val;
    • +
  • 15275 this.__supportsCte = val;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21242,25 +21251,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(val){
    • -
  • 14950 this.__supportsIntersectExcept = val;
    • +
  • 15276 this.__supportsIntersectExcept = val;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(val){
    • -
  • 14950 this.__supportsIntersectExceptAll = val;
    • +
  • 15276 this.__supportsIntersectExceptAll = val;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(val){
    • -
  • 14948 this.__supportsIsTrue = val;
    • +
  • 15274 this.__supportsIsTrue = val;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(val){
    • -
  • 14950 this.__supportsJoinUsing = val;
    • +
  • 15276 this.__supportsJoinUsing = val;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21272,7 +21281,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(val){
    • -
  • 14948 this.__supportsMultipleColumnIn = val;
    • +
  • 15274 this.__supportsMultipleColumnIn = val;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21284,13 +21293,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(val){
    • -
  • 14948 this.__supportsTimestampUsecs = val;
    • +
  • 15274 this.__supportsTimestampUsecs = val;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(val){
    • -
  • 14948 this.__supportsWindowFunctions = val;
    • +
  • 15274 this.__supportsWindowFunctions = val;
  • }
  • }
    • @@ -21384,8 +21393,8 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29216 this._super(arguments);
    • +
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29542 this._super(arguments);
  • },
  • /**
    • diff --git a/docs-md/querying.md b/docs-md/querying.md index 9e988d34..72baa7d3 100644 --- a/docs-md/querying.md +++ b/docs-md/querying.md @@ -265,7 +265,7 @@ If there are multiple arguments in the hash, the filters are `AND`ed together: ``` //SELECT * FROM user WHERE id IN (1, 2, 3) AND name ~ 'Bo$' User.filter({id : [1,2,3], name : /Bo$/}); -`` +``` This works the same as if you used two separate filter calls: diff --git a/docs/coverage.html b/docs/coverage.html index c6344a66..70d5468b 100644 --- a/docs/coverage.html +++ b/docs/coverage.html @@ -256,10 +256,10 @@
    - Coverage89.22 - SLOC21912 - LOC5351 - Missed577 + Coverage89.21 + SLOC21921 + LOC5357 + Missed578
    @@ -943,10 +943,10 @@
    - Coverage72.53 - SLOC1076 - LOC91 - Missed25 + Coverage71.74 + SLOC1078 + LOC92 + Missed26
    @@ -1682,8 +1682,10 @@
  • * @param opts
  • */
  • configureLogging:function (opts) {
    • -
  • 0 comb.logger.configure();
    • -
  • 0 LOGGER.level = "info";
    • +
  • 0 comb.logger.configure(opts);
    • +
  • 0 if (!opts) {
    • +
  • 0 LOGGER.level = "info";
    • +
  • }
  • },
  • /**
    • @@ -2519,7 +2521,7 @@
  • },
  • _quotedIdentifier:function (c) {
    • -
  • 25927 return format('"%s"', c);
    • +
  • 26239 return format('"%s"', c);
  • },
  • __fullTextStringJoin:function (cols) {
    • @@ -2573,12 +2575,12 @@
  • 3048 var cols = [];
  • 3048 if (rows && rows.length) {
  • 2543 cols = this.__columns = fields && fields.length ? fields.map(function (f) {
    • -
  • 18922 return f.name;
    • +
  • 18560 return f.name;
  • }) : Object.keys(rows[0]);
  • //the pg driver does auto type coercion
  • 2543 cols = cols.map(function (c) {
    • -
  • 18922 return [oi(c), function (o) {
    • -
  • 28420 return o;
    • +
  • 18560 return [oi(c), function (o) {
    • +
  • 27740 return o;
  • }, c];
  • }, this);
  • }
    • @@ -2605,7 +2607,7 @@
  • 3654 var h = {};
  • 3654 var row = rows[index];
  • 3654 cols.forEach(function (col) {
    • -
  • 28420 h[col[0]] = col[1](row[col[2]]);
    • +
  • 27740 h[col[0]] = col[1](row[col[2]]);
  • }, this);
  • 3654 when(cb(h)).then(function (val) {
    • @@ -2657,15 +2659,15 @@
  • },
  • supportsDistinctOn:function () {
    • -
  • 12670 return true;
    • +
  • 12996 return true;
  • },
  • supportsModifyingJoins:function () {
    • -
  • 15114 return true;
    • +
  • 15440 return true;
  • },
  • supportsTimestampTimezones:function () {
    • -
  • 12668 return true;
    • +
  • 12994 return true;
  • }
  • }
    • @@ -3743,13 +3745,13 @@
  • * @return the typecasted value.
  • * */
  • typecastValue:function (columnType, value) {
    • -
  • 32725 if (isNull(value) || isUndefined(value)) {
    • +
  • 32726 if (isNull(value) || isUndefined(value)) {
  • 5793 return null;
  • }
    • -
  • 26932 var meth = "__typecastValue" + columnType.charAt(0).toUpperCase() + columnType.substr(1).toLowerCase();
    • -
  • 26932 try {
    • -
  • 26932 if (isFunction(this[meth])) {
    • -
  • 26932 return this[meth](value);
    • +
  • 26933 var meth = "__typecastValue" + columnType.charAt(0).toUpperCase() + columnType.substr(1).toLowerCase();
    • +
  • 26933 try {
    • +
  • 26933 if (isFunction(this[meth])) {
    • +
  • 26933 return this[meth](value);
  • } else {
  • 0 return value;
  • }
    • @@ -3915,7 +3917,7 @@
  • // Typecast the value to a String
  • __typecastValueString:function (value) {
    • -
  • 19607 return "" + value;
    • +
  • 19608 return "" + value;
  • }
  • },
    • @@ -6274,9 +6276,9 @@
    - Coverage88.36 - SLOC1061 - LOC318 + Coverage88.51 + SLOC1067 + LOC322 Missed37
    @@ -6474,24 +6476,24 @@
  • * @borrows patio.Dataset#leftJoin as leftJoin
  • * */
  • constructor:function (options, fromDb) {
    • -
  • 3218 if (this.synced) {
    • -
  • 3218 this.__emitter = new EventEmitter();
    • -
  • 3218 this._super(arguments);
    • -
  • 3218 this.patio = patio || require("./index");
    • -
  • 3218 fromDb = isBoolean(fromDb) ? fromDb : false;
    • -
  • 3218 this.__changed = {};
    • -
  • 3218 this.__values = {};
    • -
  • 3218 if (fromDb) {
    • -
  • 1753 this._hook("pre", "load");
    • -
  • 1753 this.__isNew = false;
    • -
  • 1753 this.__setFromDb(options, true);
    • -
  • 1753 if (this._static.emitOnLoad) {
    • -
  • 1753 this.emit("load", this);
    • -
  • 1753 this._static.emit("load", this);
    • +
  • 3111 if (this.synced) {
    • +
  • 3111 this.__emitter = new EventEmitter();
    • +
  • 3111 this._super(arguments);
    • +
  • 3111 this.patio = patio || require("./index");
    • +
  • 3111 fromDb = isBoolean(fromDb) ? fromDb : false;
    • +
  • 3111 this.__changed = {};
    • +
  • 3111 this.__values = {};
    • +
  • 3111 if (fromDb) {
    • +
  • 1754 this._hook("pre", "load");
    • +
  • 1754 this.__isNew = false;
    • +
  • 1754 this.__setFromDb(options, true);
    • +
  • 1754 if (this._static.emitOnLoad) {
    • +
  • 1754 this.emit("load", this);
    • +
  • 1754 this._static.emit("load", this);
  • }
  • } else {
    • -
  • 1465 this.__isNew = true;
    • -
  • 1465 this.__set(options);
    • +
  • 1357 this.__isNew = true;
    • +
  • 1357 this.__set(options);
  • }
  • } else {
  • 0 throw new ModelError("Model " + this.tableName + " has not been synced");
    • @@ -6499,26 +6501,32 @@
  • },
  • __set:function (values, ignore) {
    • -
  • 1587 values = values || {};
    • -
  • 1587 this.__ignore = ignore === true;
    • -
  • 1587 Object.keys(values).forEach(function (attribute) {
    • +
  • 1479 values = values || {};
    • +
  • 1479 this.__ignore = ignore === true;
    • +
  • 1479 Object.keys(values).forEach(function (attribute) {
  • 6632 var value = values[attribute];
  • //check if the column is a constrained value and is allowed to be set
  • 6632 !ignore && this._checkIfColumnIsConstrained(attribute);
  • 6632 this[attribute] = value;
  • }, this);
    • -
  • 1587 this.__ignore = false;
    • +
  • 1479 this.__ignore = false;
  • },
  • __setFromDb:function (values, ignore) {
    • -
  • 3056 values = values || {};
    • -
  • 3056 this.__ignore = ignore === true;
    • -
  • 3056 Object.keys(values).forEach(function (column) {
    • -
  • 25828 var value = values[column];
    • +
  • 3057 values = values || {};
    • +
  • 3057 this.__ignore = ignore === true;
    • +
  • 3057 var schema = this.schema;
    • +
  • 3057 Object.keys(values).forEach(function (column) {
    • +
  • 25150 var value = values[column];
  • // Typecast value retrieved from db
    • -
  • 25828 this.__values[column] = this._typeCastValue(column, value, ignore);
    • +
  • 25150 if (schema.hasOwnProperty(column)) {
    • +
  • 25149 this.__values[column] = this._typeCastValue(column, value, ignore);
    • +
  • } else {
    • +
  • 1 console.log(column);
    • +
  • 1 this[column] = value;
    • +
  • }
  • }, this);
    • -
  • 3056 this.__ignore = false;
    • +
  • 3057 this.__ignore = false;
  • },
    • @@ -6576,11 +6584,11 @@
  • },
  • _getColumnValue:function (name) {
    • -
  • 5426 var val = this.__values[name];
    • -
  • 5426 var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
    • -
  • 5426 var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
    • +
  • 5427 var val = this.__values[name];
    • +
  • 5427 var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
    • +
  • 5427 var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
    • -
  • 5426 return columnValue;
    • +
  • 5427 return columnValue;
  • },
  • _setColumnValue:function (name, val) {
    • @@ -6600,25 +6608,25 @@
  • //typecast_value method, so database adapters can override/augment the handling
  • //for database specific column types.
  • _typeCastValue:function (column, value, fromDatabase) {
    • -
  • 33384 var colSchema, clazz = this._static;
    • -
  • 33384 if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
    • -
  • 32704 var type = colSchema.type;
    • -
  • 32704 if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
    • +
  • 32705 var colSchema, clazz = this._static;
    • +
  • 32705 if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
    • +
  • 32705 var type = colSchema.type;
    • +
  • 32705 if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
  • 3 value = null;
  • }
    • -
  • 32704 var raiseOnError = clazz.raiseOnTypecastError;
    • -
  • 32704 if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
    • +
  • 32705 var raiseOnError = clazz.raiseOnTypecastError;
    • +
  • 32705 if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
  • 0 throw new ModelError("null is not allowed for the " + column + " column.");
  • }
    • -
  • 32704 try {
    • -
  • 32704 value = clazz.db.typecastValue(type, value);
    • +
  • 32705 try {
    • +
  • 32705 value = clazz.db.typecastValue(type, value);
  • } catch (e) {
  • 0 if (raiseOnError === true) {
  • 0 throw e;
  • }
  • }
  • }
    • -
  • 33384 return value;
    • +
  • 32705 return value;
  • },
  • /**
    • @@ -6690,8 +6698,8 @@
  • 0 return emitter.listeners.apply(emitter, arguments);
  • },
  • emit:function () {
    • -
  • 11119 var emitter = this.__emitter;
    • -
  • 11119 return emitter.emit.apply(emitter, arguments);
    • +
  • 11120 var emitter = this.__emitter;
    • +
  • 11120 return emitter.emit.apply(emitter, arguments);
  • },
    • @@ -6732,7 +6740,7 @@
  • },
  • schema:function () {
    • -
  • 73400 return this._static.schema;
    • +
  • 75099 return this._static.schema;
  • },
  • columns:function () {
    • @@ -6740,7 +6748,7 @@
  • },
  • synced:function () {
    • -
  • 12891 return this._static.synced;
    • +
  • 12784 return this._static.synced;
  • }
  • }
    • @@ -7049,7 +7057,7 @@
  • _defineColumnGetter:function (name) {
  • 779 this.prototype.__defineGetter__(name, function () {
    • -
  • 5426 return this._getColumnValue(name);
    • +
  • 5427 return this._getColumnValue(name);
  • });
  • },
    • @@ -7105,14 +7113,14 @@
  • * @type patio.Database
  • */
  • db:function () {
    • -
  • 46373 var db = this.__db;
    • -
  • 46373 if (!db) {
    • +
  • 46374 var db = this.__db;
    • +
  • 46374 if (!db) {
  • 86 db = this.__db = patio.defaultDatabase;
  • }
    • -
  • 46373 if (!db) {
    • +
  • 46374 if (!db) {
  • 0 throw new ModelError("patio has not been connected to a database");
  • }
    • -
  • 46373 return db;
    • +
  • 46374 return db;
  • },
  • /**
    • @@ -7159,8 +7167,8 @@
  • * @type Object
  • */
  • schema:function () {
    • -
  • 73404 if (this.synced) {
    • -
  • 73404 return this.__schema;
    • +
  • 75103 if (this.synced) {
    • +
  • 75103 return this.__schema;
  • } else {
  • 0 throw new ModelError("Model has not been synced yet");
  • }
    • @@ -7353,9 +7361,9 @@
    - Coverage89.05 - SLOC308 - LOC137 + Coverage89.13 + SLOC309 + LOC138 Missed15
    @@ -7418,7 +7426,8 @@
  • 0 ds = ds.apply(parent, [parent]);
  • }
  • 326 if (!ds) {
    • -
  • 326 ds = this.model.dataset.naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
    • +
  • 326 ds = this.model.dataset;
    • +
  • 326 ds = ds.select(ds.firstSourceAlias.all()).naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
  • 326 return sql.stringToIdentifier(k);
  • })).concat(zip(keys[0], this.parentPrimaryKey.map(function (k) {
  • 326 return parent[k];
    • @@ -9060,21 +9069,21 @@
  • 1var virtualRow = function (name) {
    • -
  • 1069 var WILDCARD = new LiteralString('*');
    • -
  • 1069 var QUESTION_MARK = new LiteralString('?');
    • -
  • 1069 var COMMA_SEPARATOR = new LiteralString(', ');
    • -
  • 1069 var DOUBLE_UNDERSCORE = '__';
    • -
    • -
  • 1069 var parts = name.split(DOUBLE_UNDERSCORE);
    • -
  • 1069 var table = parts[0], column = parts[1];
    • -
  • 1069 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • -
  • 1069 var prox = methodMissing(ident, function (m) {
    • +
  • 874 var WILDCARD = new LiteralString('*');
    • +
  • 874 var QUESTION_MARK = new LiteralString('?');
    • +
  • 874 var COMMA_SEPARATOR = new LiteralString(', ');
    • +
  • 874 var DOUBLE_UNDERSCORE = '__';
    • +
    • +
  • 874 var parts = name.split(DOUBLE_UNDERSCORE);
    • +
  • 874 var table = parts[0], column = parts[1];
    • +
  • 874 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • +
  • 874 var prox = methodMissing(ident, function (m) {
  • 4 return function () {
  • 3 var args = argsToArray(arguments);
  • 3 return SQLFunction.fromArgs([m, name].concat(args));
  • }
  • }, column ? QualifiedIdentifier : Identifier);
    • -
  • 1069 var ret = createFunctionWrapper(prox, function (m) {
    • +
  • 874 var ret = createFunctionWrapper(prox, function (m) {
  • 548 var args = argsToArray(arguments);
  • 548 if (args.length) {
  • 542 return SQLFunction.fromArgs([name].concat(args));
    • @@ -9084,8 +9093,8 @@
  • }, function () {
  • 0 return SQLFunction.fromArgs(arguments);
  • });
    • -
  • 1069 ret.__proto__ = ident;
    • -
  • 1069 return ret;
    • +
  • 874 ret.__proto__ = ident;
    • +
  • 874 return ret;
  • };
  • 1var DATE_METHODS = ["getDate", "getDay", "getFullYear", "getHours", "getMilliseconds", "getMinutes", "getMonth", "getSeconds",
    • @@ -9537,7 +9546,7 @@
  • });
  • 1exports.sql = methodMissing(sql, function (name) {
    • -
  • 1069 return virtualRow(name);
    • +
  • 874 return virtualRow(name);
  • });
  • 1var OPERTATOR_INVERSIONS = {
    • @@ -10189,7 +10198,7 @@
  • * @return {patio.sql.ColumnAll}
  • */
  • all:function () {
    • -
  • 3 return new ColumnAll(this);
    • +
  • 329 return new ColumnAll(this);
  • }
    • @@ -10347,13 +10356,13 @@
  • * @return {patio.sql.Expression} an expression.
  • */
  • fromArgs:function (args) {
    • -
  • 2410 var ret;
    • -
  • 2410 try {
    • -
  • 2410 ret = new this();
    • +
  • 2215 var ret;
    • +
  • 2215 try {
    • +
  • 2215 ret = new this();
  • } catch (ignore) {
  • }
    • -
  • 2410 this.apply(ret, args);
    • -
  • 2410 return ret;
    • +
  • 2215 this.apply(ret, args);
    • +
  • 2215 return ret;
  • },
  • /**
    • @@ -10545,7 +10554,7 @@
  • * @property table the table this all column expression represents.
  • */
  • constructor:function (table) {
    • -
  • 20 this.table = table;
    • +
  • 346 this.table = table;
  • },
  • /**
    • @@ -10557,9 +10566,9 @@
  • * @return String the SQL columnAll expression fragment.
  • */
  • toString:function (ds) {
    • -
  • 19 !Dataset && (Dataset = require("./dataset"));
    • -
  • 19 ds = ds || new Dataset();
    • -
  • 19 return ds.columnAllSql(this);
    • +
  • 345 !Dataset && (Dataset = require("./dataset"));
    • +
  • 345 ds = ds || new Dataset();
    • +
  • 345 return ds.columnAllSql(this);
  • }
  • }
  • }).as(sql, "ColumnAll");
    • @@ -11156,7 +11165,7 @@
  • * @property {String} value <b>READ ONLY</b> the column or table this identifier represents.
  • */
  • constructor:function (value) {
    • -
  • 16802 this.__value = value;
    • +
  • 16412 this.__value = value;
  • },
  • /**
    • @@ -11176,7 +11185,7 @@
  • /**@ignore*/
  • getters:{
  • value:function () {
    • -
  • 25154 return this.__value;
    • +
  • 25480 return this.__value;
  • }
  • }
  • }
    • @@ -11733,7 +11742,7 @@
  • 1var addStringMethod = function (op) {
  • 24 return function () {
    • -
  • 4294 return this.__str[op].apply(this.__str, arguments);
    • +
  • 3968 return this.__str[op].apply(this.__str, arguments);
  • }
  • };
    • @@ -11756,7 +11765,7 @@
  • * @param {String} str the literal string.
  • */
  • constructor:function (str) {
    • -
  • 3677 this.__str = str;
    • +
  • 3092 this.__str = str;
  • }
  • }
  • }).as(sql, "LiteralString");
    • @@ -12660,14 +12669,14 @@
  • * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions.
  • */
  • constructor:function (db, opts) {
    • -
  • 29216 this._super(arguments);
    • -
  • 29216 this.db = db;
    • -
  • 29216 this.__opts = {};
    • -
  • 29216 this.__rowCb = null;
    • -
  • 29216 if (db) {
    • -
  • 15039 this.__quoteIdentifiers = db.quoteIdentifiers;
    • -
  • 15039 this.__identifierInputMethod = db.identifierInputMethod;
    • -
  • 15039 this.__identifierOutputMethod = db.identifierOutputMethod;
    • +
  • 29542 this._super(arguments);
    • +
  • 29542 this.db = db;
    • +
  • 29542 this.__opts = {};
    • +
  • 29542 this.__rowCb = null;
    • +
  • 29542 if (db) {
    • +
  • 15365 this.__quoteIdentifiers = db.quoteIdentifiers;
    • +
  • 15365 this.__identifierInputMethod = db.identifierInputMethod;
    • +
  • 15365 this.__identifierOutputMethod = db.identifierOutputMethod;
  • }
  • },
    • @@ -12682,22 +12691,22 @@
  • * @return [patio.Dataset] a cloned dataset with the merged options
  • **/
  • mergeOptions:function (opts) {
    • -
  • 14948 opts = isUndefined(opts) ? {} : opts;
    • -
  • 14948 var ds = new this._static(this.db, {});
    • -
  • 14948 ds.rowCb = this.rowCb;
    • -
  • 14948 this._static.FEATURES.forEach(function (f) {
    • -
  • 209272 ds[f] = this[f];
    • +
  • 15274 opts = isUndefined(opts) ? {} : opts;
    • +
  • 15274 var ds = new this._static(this.db, {});
    • +
  • 15274 ds.rowCb = this.rowCb;
    • +
  • 15274 this._static.FEATURES.forEach(function (f) {
    • +
  • 213836 ds[f] = this[f];
  • }, this);
    • -
  • 14948 ds.__opts = merge({}, this.__opts, opts);
    • -
  • 14948 ds.identifierInputMethod = this.identifierInputMethod;
    • -
  • 14948 ds.identifierOutputMethod = this.identifierOutputMethod;
    • -
  • 14948 var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
    • -
  • 14948 if (Object.keys(opts).some(function (o) {
    • -
  • 13536 return columnChangeOpts.indexOf(o) != -1;
    • +
  • 15274 ds.__opts = merge({}, this.__opts, opts);
    • +
  • 15274 ds.identifierInputMethod = this.identifierInputMethod;
    • +
  • 15274 ds.identifierOutputMethod = this.identifierOutputMethod;
    • +
  • 15274 var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
    • +
  • 15274 if (Object.keys(opts).some(function (o) {
    • +
  • 13862 return columnChangeOpts.indexOf(o) != -1;
  • })) {
    • -
  • 2456 ds.__opts.columns = null;
    • +
  • 2782 ds.__opts.columns = null;
  • }
    • -
  • 14948 return ds;
    • +
  • 15274 return ds;
  • },
    • @@ -12784,31 +12793,31 @@
  • getters:{
  • rowCb:function () {
    • -
  • 23052 return this.__rowCb;
    • +
  • 23378 return this.__rowCb;
  • },
  • identifierInputMethod:function () {
    • -
  • 14948 return this.__identifierInputMethod;
    • +
  • 15274 return this.__identifierInputMethod;
  • },
  • identifierOutputMethod:function () {
    • -
  • 14948 return this.__identifierOutputMethod;
    • +
  • 15274 return this.__identifierOutputMethod;
  • },
  • firstSourceAlias:function () {
    • -
  • 579 var source = this.__opts.from;
    • -
  • 579 if (isUndefinedOrNull(source) || !source.length) {
    • +
  • 905 var source = this.__opts.from;
    • +
  • 905 if (isUndefinedOrNull(source) || !source.length) {
  • 2 throw new DatasetError("No source specified for the query");
  • }
    • -
  • 577 source = source[0];
    • -
  • 577 if (isInstanceOf(source, AliasedExpression)) {
    • +
  • 903 source = source[0];
    • +
  • 903 if (isInstanceOf(source, AliasedExpression)) {
  • 20 return source.alias;
    • -
  • 557 } else if (isString(source)) {
    • +
  • 883 } else if (isString(source)) {
  • 0 var parts = this._splitString(source);
  • 0 var alias = parts[2];
  • 0 return alias ? alias : source;
  • } else {
    • -
  • 557 return source;
    • +
  • 883 return source;
  • }
  • },
    • @@ -12836,16 +12845,16 @@
  • /**@lends patio.Dataset.prototype*/
  • identifierInputMethod:function (meth) {
    • -
  • 15038 this.__identifierInputMethod = meth;
    • +
  • 15364 this.__identifierInputMethod = meth;
  • },
  • identifierOutputMethod:function (meth) {
    • -
  • 15038 this.__identifierOutputMethod = meth;
    • +
  • 15364 this.__identifierOutputMethod = meth;
  • },
  • rowCb:function (cb) {
    • -
  • 18564 if (isFunction(cb) || isNull(cb)) {
    • -
  • 18559 this.__rowCb = cb;
    • +
  • 18890 if (isFunction(cb) || isNull(cb)) {
    • +
  • 18885 this.__rowCb = cb;
  • } else {
  • 5 throw new DatasetError("rowCb mus be a function");
  • }
    • @@ -13976,9 +13985,9 @@
  • constructor:function () {
  • //We initialize these here because otherwise
  • //the will be blank because of recursive dependencies.
    • -
  • 29216 !patio && (patio = require("../index"));
    • -
  • 29216 !Dataset && (Dataset = patio.Dataset);
    • -
  • 29216 this._super(arguments);
    • +
  • 29542 !patio && (patio = require("../index"));
    • +
  • 29542 !Dataset && (Dataset = patio.Dataset);
    • +
  • 29542 this._super(arguments);
  • },
  • /**
    • @@ -14263,15 +14272,15 @@
  • * @return {String} a literal representation of the value.
  • */
  • literal:function (v) {
    • -
  • 44422 if (isInstanceOf(v, LiteralString)) {
    • +
  • 44748 if (isInstanceOf(v, LiteralString)) {
  • 204 return "" + v;
    • -
  • 44218 } else if (isString(v)) {
    • +
  • 44544 } else if (isString(v)) {
  • 6110 return this._literalString(v);
    • -
  • 38108 } else if (isNumber(v)) {
    • +
  • 38434 } else if (isNumber(v)) {
  • 6997 return this._literalNumber(v);
  • }
    • -
  • 31111 else if (isInstanceOf(v, Expression)) {
    • -
  • 28577 return this._literalExpression(v);
    • +
  • 31437 else if (isInstanceOf(v, Expression)) {
    • +
  • 28903 return this._literalExpression(v);
  • }
  • 2534 else if (isInstanceOf(v, Dataset)) {
  • 104 return this._literalDataset(v);
    • @@ -14583,7 +14592,7 @@
  • * SQL fragment for specifying all columns in a given table
  • **/
  • columnAllSql:function (ca) {
    • -
  • 19 return string.format("%s.*", this.quoteSchemaTable(ca.table));
    • +
  • 345 return string.format("%s.*", this.quoteSchemaTable(ca.table));
  • },
  • /**
    • @@ -14789,18 +14798,18 @@
  • * quote the name with {@link patio.dataset._Sql#_quotedIdentifier}.
  • */
  • quoteIdentifier:function (name) {
    • -
  • 33767 if (isInstanceOf(name, LiteralString)) {
    • +
  • 34093 if (isInstanceOf(name, LiteralString)) {
  • 260 return name;
  • } else {
    • -
  • 33507 if (isInstanceOf(name, Identifier)) {
    • +
  • 33833 if (isInstanceOf(name, Identifier)) {
  • 22237 name = name.value;
  • }
    • -
  • 33507 name = this.inputIdentifier(name);
    • -
  • 33507 if (this.quoteIdentifiers) {
    • -
  • 26311 name = this._quotedIdentifier(name)
    • +
  • 33833 name = this.inputIdentifier(name);
    • +
  • 33833 if (this.quoteIdentifiers) {
    • +
  • 26623 name = this._quotedIdentifier(name)
  • }
  • }
    • -
  • 33507 return name;
    • +
  • 33833 return name;
  • },
  • /**
    • @@ -14810,9 +14819,9 @@
  • * identifierOutputMethod.
  • */
  • inputIdentifier:function (v) {
    • -
  • 33693 var i = this.__identifierInputMethod;
    • -
  • 33693 v = v.toString(this);
    • -
  • 33693 return !isUndefinedOrNull(i) ?
    • +
  • 34019 var i = this.__identifierInputMethod;
    • +
  • 34019 v = v.toString(this);
    • +
  • 34019 return !isUndefinedOrNull(i) ?
  • isFunction(v[i]) ?
  • v[i]() :
  • isFunction(comb[i]) ?
    • @@ -14828,9 +14837,9 @@
  • * identifierOutputMethod.
  • */
  • outputIdentifier:function (v) {
    • -
  • 19885 (v == '' && (v = 'untitled'));
    • -
  • 19885 var i = this.__identifierOutputMethod;
    • -
  • 19885 return !isUndefinedOrNull(i) ?
    • +
  • 19523 (v == '' && (v = 'untitled'));
    • +
  • 19523 var i = this.__identifierOutputMethod;
    • +
  • 19523 return !isUndefinedOrNull(i) ?
  • isFunction(v[i]) ?
  • v[i]() :
  • isFunction(comb[i]) ?
    • @@ -14846,10 +14855,10 @@
  • * quoted (if quoting identifiers)
  • */
  • quoteSchemaTable:function (table) {
    • -
  • 2231 var parts = this.schemaAndTable(table);
    • -
  • 2231 var schema = parts[0];
    • -
  • 2231 table = parts[1];
    • -
  • 2231 return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
    • +
  • 2557 var parts = this.schemaAndTable(table);
    • +
  • 2557 var schema = parts[0];
    • +
  • 2557 table = parts[1];
    • +
  • 2557 return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
  • },
    • @@ -14858,15 +14867,15 @@
  • * Split the schema information from the table
  • */
  • schemaAndTable:function (tableName) {
    • -
  • 2475 var sch = this.db ? this.db.defaultSchema || null : null;
    • -
  • 2475 if (isString(tableName)) {
    • +
  • 2801 var sch = this.db ? this.db.defaultSchema || null : null;
    • +
  • 2801 if (isString(tableName)) {
  • 1008 var parts = this._splitString(tableName);
  • 1008 var s = parts[0], table = parts[1];
  • 1008 return [s || sch, table];
    • -
  • 1467 } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
    • +
  • 1793 } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
  • 3 return [tableName.table, tableName.column]
    • -
  • 1464 } else if (isInstanceOf(tableName, Identifier)) {
    • -
  • 1464 return [null, tableName.value];
    • +
  • 1790 } else if (isInstanceOf(tableName, Identifier)) {
    • +
  • 1790 return [null, tableName.value];
  • } else {
  • 0 throw new QueryError("table should be a QualifiedIdentifier, Identifier, or String");
  • }
    • @@ -14915,7 +14924,7 @@
  • * expressions.
  • */
  • __expressionList:function (columns) {
    • -
  • 4284 return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
    • +
  • 4610 return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
  • },
  • //Format the timestamp based on the default_timestamp_format, with a couple
    • @@ -15037,7 +15046,7 @@
  • * @return SQL fragment for SQL::Expression, result depends on the specific type of expression.
  • * */
  • _literalExpression:function (v) {
    • -
  • 28587 return v.toString(this);
    • +
  • 28913 return v.toString(this);
  • },
  • /**
    • @@ -15703,7 +15712,7 @@
  • * @type String
  • */
  • identifierInputMethod:function () {
    • -
  • 15038 return this.__identifierInputMethod;
    • +
  • 15364 return this.__identifierInputMethod;
  • },
  • /**
    • @@ -15715,7 +15724,7 @@
  • * @type String
  • */
  • identifierOutputMethod:function () {
    • -
  • 15038 return this.__identifierOutputMethod;
    • +
  • 15364 return this.__identifierOutputMethod;
  • },
  • /**
    • @@ -15728,7 +15737,7 @@
  • * @default true
  • */
  • quoteIdentifiers:function () {
    • -
  • 15004 return this.__quoteIdentifiers;
    • +
  • 15330 return this.__quoteIdentifiers;
  • }
  • },
    • @@ -15871,10 +15880,10 @@
  • /**@ignore*/
  • constructor:function () {
    • -
  • 29216 if (!Dataset) {
    • +
  • 29542 if (!Dataset) {
  • 1 Dataset = require("../index").Dataset;
  • }
    • -
  • 29216 this._super(arguments);
    • +
  • 29542 this._super(arguments);
  • },
    • @@ -15904,7 +15913,7 @@
  • 2734 var a = [];
  • 2734 var ret = new Promise().classic(cb);
  • 2734 this.forEach(hitch(this, function (r) {
    • -
  • 2936 a.push(r);
    • +
  • 2934 a.push(r);
  • })).then(hitch(this, function () {
  • 2731 this.postLoad(a);
  • 2731 if (block) {
    • @@ -17150,10 +17159,10 @@
  • *
  • */
  • constructor:function () {
    • -
  • 3218 if (comb.isUndefinedOrNull(this.__associations)) {
    • -
  • 3055 this.__associations = {};
    • +
  • 3111 if (comb.isUndefinedOrNull(this.__associations)) {
    • +
  • 3002 this.__associations = {};
  • }
    • -
  • 3218 this._super(arguments);
    • +
  • 3111 this._super(arguments);
  • },
  • reload:function () {
    • @@ -18392,17 +18401,17 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29216 this._super(arguments);
    • -
  • 29216 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 204512 if (!this[type + "Join"]) {
    • -
  • 204512 this[type + "Join"] = conditionedJoin.bind(this, type);
    • +
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29542 this._super(arguments);
    • +
  • 29542 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 206794 if (!this[type + "Join"]) {
    • +
  • 206794 this[type + "Join"] = conditionedJoin.bind(this, type);
  • }
  • }, this);
    • -
  • 29216 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 146080 if (!this[type + "Join"]) {
    • -
  • 146080 this[type + "Join"] = unConditionJoin.bind(this, type);
    • +
  • 29542 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 147710 if (!this[type + "Join"]) {
    • +
  • 147710 this[type + "Join"] = unConditionJoin.bind(this, type);
  • }
  • }, this);
    • @@ -19814,29 +19823,29 @@
  • * @return {patio.Dataset} a cloned dataset with the columns selected changed.
  • */
  • select:function (args) {
    • -
  • 535 args = flatten(argsToArray(arguments));
    • -
  • 535 var columns = [];
    • -
  • 535 args.forEach(function (c) {
    • -
  • 955 if (isFunction(c)) {
    • +
  • 861 args = flatten(argsToArray(arguments));
    • +
  • 861 var columns = [];
    • +
  • 861 args.forEach(function (c) {
    • +
  • 1281 if (isFunction(c)) {
  • 23 var res = c.apply(sql, [sql]);
  • 23 columns = columns.concat(isArray(res) ? res : [res]);
  • } else {
    • -
  • 932 columns.push(c);
    • +
  • 1258 columns.push(c);
  • }
  • });
    • -
  • 535 var select = [];
    • -
  • 535 columns.forEach(function (c) {
    • -
  • 958 if (isHash(c)) {
    • +
  • 861 var select = [];
    • +
  • 861 columns.forEach(function (c) {
    • +
  • 1284 if (isHash(c)) {
  • 3 for (var i in c) {
  • 4 select.push(new AliasedExpression(new Identifier(i), c[i]));
  • }
    • -
  • 955 } else if (isString(c)) {
    • +
  • 1281 } else if (isString(c)) {
  • 406 select.push(this.stringToIdentifier(c));
  • } else {
    • -
  • 549 select.push(c);
    • +
  • 875 select.push(c);
  • }
  • }, this);
    • -
  • 535 return this.mergeOptions({select:select});
    • +
  • 861 return this.mergeOptions({select:select});
  • },
    • @@ -21117,7 +21126,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(){
    • -
  • 48455 return this.__quoteIdentifiers;
    • +
  • 49107 return this.__quoteIdentifiers;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21125,20 +21134,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(){
    • -
  • 14948 return this.__providesAccurateRowsMatched;
    • +
  • 15274 return this.__providesAccurateRowsMatched;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(){
    • -
  • 14955 return this.__requiresSqlStandardDateTimes;
    • +
  • 15281 return this.__requiresSqlStandardDateTimes;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(){
    • -
  • 14961 return this.__supportsCte;
    • +
  • 15287 return this.__supportsCte;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21150,25 +21159,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(){
    • -
  • 14984 return this.__supportsIntersectExcept;
    • +
  • 15310 return this.__supportsIntersectExcept;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(){
    • -
  • 14960 return this.__supportsIntersectExceptAll;
    • +
  • 15286 return this.__supportsIntersectExceptAll;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(){
    • -
  • 15217 return this.__supportsIsTrue;
    • +
  • 15543 return this.__supportsIsTrue;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(){
    • -
  • 14959 return this.__supportsJoinUsing;
    • +
  • 15285 return this.__supportsJoinUsing;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21180,7 +21189,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(){
    • -
  • 14952 return this.__supportsMultipleColumnIn;
    • +
  • 15278 return this.__supportsMultipleColumnIn;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21192,13 +21201,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(){
    • -
  • 14948 return this.__supportsTimestampUsecs;
    • +
  • 15274 return this.__supportsTimestampUsecs;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(){
    • -
  • 14948 return this.__supportsWindowFunctions;
    • +
  • 15274 return this.__supportsWindowFunctions;
  • }
  • },
    • @@ -21209,7 +21218,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(val){
    • -
  • 14960 this.__quoteIdentifiers = val;
    • +
  • 15286 this.__quoteIdentifiers = val;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21217,20 +21226,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(val){
    • -
  • 14948 this.__providesAccurateRowsMatched = val;
    • +
  • 15274 this.__providesAccurateRowsMatched = val;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(val){
    • -
  • 14948 this.__requiresSqlStandardDateTimes = val;
    • +
  • 15274 this.__requiresSqlStandardDateTimes = val;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(val){
    • -
  • 14949 this.__supportsCte = val;
    • +
  • 15275 this.__supportsCte = val;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21242,25 +21251,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(val){
    • -
  • 14950 this.__supportsIntersectExcept = val;
    • +
  • 15276 this.__supportsIntersectExcept = val;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(val){
    • -
  • 14950 this.__supportsIntersectExceptAll = val;
    • +
  • 15276 this.__supportsIntersectExceptAll = val;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(val){
    • -
  • 14948 this.__supportsIsTrue = val;
    • +
  • 15274 this.__supportsIsTrue = val;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(val){
    • -
  • 14950 this.__supportsJoinUsing = val;
    • +
  • 15276 this.__supportsJoinUsing = val;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21272,7 +21281,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(val){
    • -
  • 14948 this.__supportsMultipleColumnIn = val;
    • +
  • 15274 this.__supportsMultipleColumnIn = val;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21284,13 +21293,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(val){
    • -
  • 14948 this.__supportsTimestampUsecs = val;
    • +
  • 15274 this.__supportsTimestampUsecs = val;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(val){
    • -
  • 14948 this.__supportsWindowFunctions = val;
    • +
  • 15274 this.__supportsWindowFunctions = val;
  • }
  • }
    • @@ -21384,8 +21393,8 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29216 this._super(arguments);
    • +
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29542 this._super(arguments);
  • },
  • /**
    • diff --git a/docs/patio.html b/docs/patio.html index cb1c74bb..9625917a 100644 --- a/docs/patio.html +++ b/docs/patio.html @@ -959,8 +959,10 @@

    Source 
     function (opts){
-   comb.logger.configure();
-   LOGGER.level = "info";
+   comb.logger.configure(opts);
+   if (!opts) {
+       LOGGER.level = "info";
+   }
            
 }
    diff --git a/docs/patio_Dataset.html b/docs/patio_Dataset.html index 71c7ccc9..a1c82fc1 100644 --- a/docs/patio_Dataset.html +++ b/docs/patio_Dataset.html @@ -2624,6 +2624,20 @@ +
  • + + + F + + + + P + + + selectIfNoSource + +
    • +
  • @@ -3298,9 +3312,11 @@

    Actions

    }firstSourceAliasString

    The first source (primary table) for this dataset. If the table is aliased, returns the aliased name. throws a {patio.DatasetError} tf the dataset doesn't have a table. 

       DB.from("table").firstSourceAlias;   //=> "table"    DB.from("table___t").firstSourceAlias;   //=> "t"

    firstSourceTableString

    The first source (primary table) for this dataset. If the dataset doesn't have a table, raises a patio.erros.DatasetError. 

       DB.from("table").firstSourceTable;         //=> "table"   DB.from("table___t").firstSourceTable;         //=> "t"

    +hasSelectSourceBoolean

    true if this dataset already has a select sources.

    identifierInputMethodString

    this is the method that will be called on each identifier returned from the database. This value will be defaulted to whatever the identifierInputMethod is on the database used in initialization.

    identifierOutputMethodString

    this is the method that will be called on each identifier sent to the database. This value will be defaulted to whatever the identifierOutputMethod is on the database used in initialization.

    isSimpleSelectAllBoolean

    Returns true if this dataset is a simple SELECT * FROM {table}, otherwise false. 

         DB.from("items").isSimpleSelectAll; //=> true     DB.from("items").filter({a : 1}).isSimpleSelectAll; //=> false

    +joinSourceListpatio.sql.Identifier[][]

    a list of join sources

    providesAccurateRowsMatchedbooleantrue

    Whether this dataset will provide accurate number of rows matched for delete and update statements. Accurate in this case is the number of rows matched by the dataset's filter.

    @@ -3308,6 +3324,7 @@

    Actions

    requiresSqlStandardDatebooleanfalse

    Whether the dataset requires SQL standard datetimes (false by default, as most allow strings with ISO 8601 format).

    rowCbFunction

    callback to be invoked for each row returned from the database. the return value will be used as the result of query. The rowCb can also return a promise, The resolved value of the promise will be used as result.

    +sourceListpatio.sql.Identifier[][]

    a list of sources for this dataset.

    supportsCtebooleantrue

    Whether the dataset supports common table expressions (the WITH clause).

    supportsDistinctOnbooleanfalse

    Whether the dataset supports the DISTINCT ON clause, false by default.

    supportsIntersectExceptbooleantrue

    Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.

    @@ -4297,9 +4314,9 @@ 

     function (joinType){
    return (joinType || "").replace(/([a-z]+)|([A-Z][a-z]+)/g,
-       function (m) {
-           return m.toUpperCase() + " ";
-       }
+           function (m) {
+               return m.toUpperCase() + " ";
+           }
    ).trimRight() + " JOIN";
            
 }
@@ -4886,10 +4903,10 @@ 
    
    var table = parts[0], column = parts[1], alias = parts[2];
    if (!alias) {
        return column && table ? this._literalExpression(QualifiedIdentifier.fromArgs([table, column])) : "'"
-           + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'"
+               + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'"
    } else {
        return this.literal(new AliasedExpression(column
-           && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias));
+               && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias));
    }
            
 }
@@ -5151,7 +5168,7 @@ 
    
        return new QualifiedIdentifier(table, e);
    } else if (isInstanceOf(e, OrderedExpression)) {
        return new OrderedExpression(this._qualifiedExpression(e.expression, table), e.descending,
-           {nulls:e.nulls});
+               {nulls:e.nulls});
    } else if (isInstanceOf(e, AliasedExpression)) {
        return new AliasedExpression(this._qualifiedExpression(e.expression, table), e.alias);
    } else if (isInstanceOf(e, CaseExpression)) {
@@ -5829,9 +5846,9 @@ 
    
        throw new QueryError("No source specified for the query");
    }
    return " " + source.map(
-       function (s) {
-           return this.__tableRef(s);
-       }, this).join(this._static.COMMA_SEPARATOR);
+           function (s) {
+               return this.__tableRef(s);
+           }, this).join(this._static.COMMA_SEPARATOR);
            
 }
    @@ -7091,8 +7108,8 @@

    return this.complexExpressionSql("EQ", args); } else { return this.complexExpressionSql("OR", - [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0], - null)]); + [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0], + null)]); } } else if (["IN", "NOTIN"].indexOf(op) != -1) { var cols = args[0], vals = args[1], colArray = isArray(cols), valArray = false, emptyValArray = false; @@ -7121,8 +7138,8 @@

    //literal so that if values is an array of two element arrays, it //will be treated as a value list instead of a condition specifier. return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols), - ComplexExpression.IN_OPERATORS[op], - valArray ? this._arraySql(vals) : this.literal(vals)); + ComplexExpression.IN_OPERATORS[op], + valArray ? this._arraySql(vals) : this.literal(vals)); } } else { @@ -7136,13 +7153,13 @@

    } } else { return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols), - ComplexExpression.IN_OPERATORS[op], this.literal(vals)); + ComplexExpression.IN_OPERATORS[op], this.literal(vals)); } } } else if ((newOp = this._static.TWO_ARITY_OPERATORS[op]) != null) { var l = args[0]; return format("(%s %s %s)", isString(l) ? l : this.literal(l), newOp, - this.literal(args[1])); + this.literal(args[1])); } else if ((newOp = this._static.N_ARITY_OPERATORS[op]) != null) { return string.format("(%s)", args.map(this.literal, this).join(" " + newOp + " ")); } else if (op == "NOT") { @@ -9529,12 +9546,12 @@

    var i = this.__identifierInputMethod; v = v.toString(this); return !isUndefinedOrNull(i) ? - isFunction(v[i]) ? - v[i]() : - isFunction(comb[i]) ? - comb[i](v) - : v - : v; + isFunction(v[i]) ? + v[i]() : + isFunction(comb[i]) ? + comb[i](v) + : v + : v; } @@ -10750,7 +10767,7 @@

    } var tref = this.__tableRef(table); return string.format(" %s %s", this._joinTypeSql(jc.joinType), - tableAlias ? this.__asSql(tref, tableAlias) : tref); + tableAlias ? this.__asSql(tref, tableAlias) : tref); } @@ -12767,12 +12784,12 @@

    (v == '' && (v = 'untitled')); var i = this.__identifierOutputMethod; return !isUndefinedOrNull(i) ? - isFunction(v[i]) ? - v[i]() : - isFunction(comb[i]) ? - comb[i](v) - : v - : v; + isFunction(v[i]) ? + v[i]() : + isFunction(comb[i]) ? + comb[i](v) + : v + : v; } @@ -13012,11 +13029,11 @@ 

     function (qcr){
    return [qcr.table, qcr.column].map(
-       function (x) {
-           return [QualifiedIdentifier, Identifier, String].some(function (c) {
-               return x instanceof c
-           }) ? this.literal(x) : this.quoteIdentifier(x)
-       }, this).join('.');
+           function (x) {
+               return [QualifiedIdentifier, Identifier, String].some(function (c) {
+                   return x instanceof c
+               }) ? this.literal(x) : this.quoteIdentifier(x)
+           }, this).join('.');
            
 }
    @@ -14036,6 +14053,75 @@

    + +

    + selectIfNoSource + + + Function + + + + Public + + +

    + +
    +Defined dataset/query.js + +

    Selects the columns if only if there is not already select sources. + +

    +

    + + Example + 
    +var ds = DB.from("items"); //SELECT * FROM items
+
+ds.select("a"); //SELECT a FROM items;
+ds.select("a").selectIfNoSource("a", "b"). //SELECT a FROM items;
+ds.selectIfNoSource("a", "b"). //SELECT a, b FROM items;
+
    + + + Arguments +
      + +
    • cols :

      columns to select if there is not already select sources.

      +
      • + +
    + + + Returns +
      + +
    • patio.Dataset

      a cloned dataset with the appropriate select sources.

      +
      • + +
    + + + + + Source + 
    +function (cols){
+   var ret;
+   if (!this.hasSelectSource) {
+       ret = this.select.apply(this, arguments);
+   } else {
+       ret = this.mergeOptions();
+   }
+   return ret;
+           
+}
+
    + + + +

    selectMap diff --git a/docs/querying.html b/docs/querying.html index 6784893d..5373e59d 100644 --- a/docs/querying.html +++ b/docs/querying.html @@ -557,466 +557,481 @@

    Filtering With Objects

    //SELECT * FROM user WHERE id IN (1, 2, 3) AND name ~ 'Bo$'
- User.filter({id : [1,2,3], name : /Bo$/});
-`` 
+ User.filter({id : [1,2,3], name : /Bo$/});
    +

    This works the same as if you used two separate filter calls: -This works the same as if you used two separate filter calls: -

    // SELECT * FROM user WHERE id IN (1, 2, 3) AND name ~ 'Bo$' - User.filter({id : [1,2,3]}).filter({name : /Bo$/});

    -
    
-If you nest hashes for a top level key then each condition will be applied to the key. This can often be used inplace of a filter block.
    -

    // SELECT * FROM user WHERE ((name ~ 'ob$') AND (name >= 'A') AND (name <= 'Z')) - User.filter({name : {like : /ob$/, between : ["A", "Z"]}}); +

     // SELECT * FROM user WHERE id IN (1, 2, 3) AND name ~ 'Bo$'
+ User.filter({id : [1,2,3]}).filter({name : /Bo$/});
    +

    If you nest hashes for a top level key then each condition will be applied to the key. This can often be used inplace of a filter block.

    -

    // SELECT * FROM user WHERE ((name ~ 'ob$') AND (name >= 'A') AND (name <= 'Z')) +

     // SELECT * FROM user WHERE ((name ~ 'ob$') AND (name >= 'A') AND (name <= 'Z'))
+ User.filter({name : {like : /ob$/, between : ["A", "Z"]}});
+
+  // SELECT * FROM user WHERE ((name ~ 'ob$') AND (name >= 'A') AND (name <= 'Z'))
  User.filter(function(){
     this.name.like(/ob$/).and(this.name.between("A", "Z"));
- });
-
    
-
    
-###Array of Two Element Arrays
+ });
    
+
    Array of Two Element Arrays
    
+
    If you use an array of two element arrays, it is treated as an Object. The only advantage to using an array of two element arrays is that it allows you to use values other than strings for keys, so you can do:
 
-If you use an array of two element arrays, it is treated as an Object. The only advantage to using an array of two element arrays is that it allows you to use values other than strings for keys, so you can do:
    -

    // SELECT * FROM user WHERE name ~ 'oB$' AND name ~ '^Bo' - User.filter([["name", /oB$/], [sql.name, /^Bo/]]);

    -
    
-###Filter Blocks
+
     // SELECT * FROM user WHERE name ~ 'oB$' AND name ~ '^Bo'
+ User.filter([["name", /oB$/], [sql.name, /^Bo/]]);
    
+
    Filter Blocks
    
+
    Functions can also be provided to the filter method. Functions act as a "virtual" filter.   
 
-Functions can also be provided to the filter method. Functions act as a "virtual" filter.
    -

    // SELECT * FROM user WHERE id > 5 +

    +
     // SELECT * FROM user WHERE id > 5
  User.filter(function(){
     return this.id.gt(5)
- });
+ });
    +

    If you provde both regular arguments and a function the results will be ANDed together. +

    -
    
-If you provde both regular arguments and a function the results will be ANDed together.
    -

    // SELECT * FROM user WHERE name >= 'K' AND name <= 'M' AND id > 5
    User.filter({name : {between : ['K', 'M']}}, function(){ +

    // SELECT * FROM user WHERE name >= 'K' AND name <= 'M' AND id > 5                
+User.filter({name : {between : ['K', 'M']}}, function(){
     return this.id.gt(5);
-}); 
+});
    +

    Strings

    +

    If you have a Boolean column in the database you can provide just the column name. +

    -
    
-###Strings
+
     // SELECT * FROM user WHERE is_active
+ User.filter("isActive");
    
+
    Note: if you want the literal representation of string you must use the (literal)[./patio_sql.html#.literal] method.
 
-If you have a Boolean column in the database you can provide just the column name.
    -

    // SELECT * FROM user WHERE is_active - User.filter("isActive");

    -
    
-**Note:** if you want the literal representation of string you must use the (literal)[./patio_sql.html#.literal] method.
    -

    // SELECT * FROM user WHERE name < 'A' - User.filter(sql.literal("name < 'A'")); +

     // SELECT * FROM user WHERE name < 'A'
+ User.filter(sql.literal("name < 'A'"));
    +

    Expressions

    +

    patio SQL expressions are instances of subclasses of [Epression][./patio_sql_Expression.html]. +

    -
    
-###Expressions
+
    //SELECT * FROM user WHERE name LIKE 'B%'
+User.filter(sql.name.like('B%'));
    
+
    In this case patio.sql.StringExpression.like returns a patio.sql.BooleanExpression object, which is used directly in the filter.
 
-patio SQL expressions are instances of subclasses of [Epression][./patio_sql_Expression.html].
    -

    //SELECT * FROM user WHERE name LIKE 'B%' -User.filter(sql.name.like('B%'));

    -
    
-In this case [patio.sql.StringExpression](./patio_sql_StringExpression.html).[like](./patio_sql_StringExpression.html#like) returns a [patio.sql.BooleanExpression](./patio_sql_BooleanExpression.html) object, which is used directly in the filter.
+
    You can use the sql methodMissing feature to create arbitrary complex expression.
 
-You can use the sql methodMissing feature to create arbitrary complex expression.
    -

    // SELECT * FROM user WHERE name LIKE 'B%' AND (b = 1 OR c != 3) -User.filter(sql.name.like('B%').and(sql.b.eq(1).or(sql.c.neq(3))));

    -
    
-You can combine these expression operators with functions:
    -

    // SELECT * FROM user WHERE ((a <= 1) OR NOT b(c) OR NOT d) +

    // SELECT * FROM user WHERE name LIKE 'B%' AND (b = 1 OR c != 3)
+User.filter(sql.name.like('B%').and(sql.b.eq(1).or(sql.c.neq(3))));
    +

    You can combine these expression operators with functions: + +

    +
    // SELECT * FROM user WHERE ((a <= 1) OR NOT b(c) OR NOT d)
 User.filter(function(){
     return this.a.gt(1).and(this.b("c").and(this.d)).not();
 });
 ``
 
-
    
-
    Strings with Placeholders
    
-
    patio also supports place holder strings.
+###Strings with Placeholders
 
-
    
-
    // SELECT * FROM user WHERE name LIKE 'B%'
-User.filter("name LIKE ?", 'B%')
    
-
    This is the most common type of placeholder, where each question mark is substituted with the corresponding argument.
+patio also supports place holder strings.
    +

    // SELECT * FROM user WHERE name LIKE 'B%' +User.filter("name LIKE ?", 'B%')

    -
    // SELECT * FROM user WHERE name LIKE 'B%' AND id = 1
-User.filter("name LIKE ? AND id = ?", 'B%', 1)
    -

    You can also use named placeholders with an object, where the named placeholders use {} that contain the placeholder key name - +

    
+This is the most common type of placeholder, where each question mark is substituted with the corresponding argument.
    +

    // SELECT * FROM user WHERE name LIKE 'B%' AND id = 1 +User.filter("name LIKE ? AND id = ?", 'B%', 1)

    -
    //SELECT * FROM user WHERE name LIKE 'B%' AND id = 1
-User.filter("name LIKE {name} AND id = {id}", {name : 'B%', id : 1});
    -

    Literal Strings

    -

    You can also provide a literal string using the literal - +

    
+You can also use named placeholders with an object, where the named placeholders use `{}` that contain the placeholder key name
    +

    //SELECT * FROM user WHERE name LIKE 'B%' AND id = 1 +User.filter("name LIKE {name} AND id = {id}", {name : 'B%', id : 1});

    -
    // SELECT * FROM user WHERE id = 2
-User.filter(sql.literal("id = 2"))
    -

    However, if you are using any untrusted input, you should use placeholders. In general, unless you are hardcoding values in the strings, you should use placeholders. You should never pass a string that has been built using concatenation becuase it can lead to SQL injection. +

    
+###Literal Strings
 
+You can also provide a literal string using the [literal](./patio_sql.html#.literal)
    +

    // SELECT * FROM user WHERE id = 2 +User.filter(sql.literal("id = 2"))

    -
    //id is some user input
+
    
+However, if you are using any untrusted input, you should use placeholders. In general, unless you are hardcoding values in the strings, you should use placeholders. You should never pass a string that has been built using concatenation becuase it can lead to SQL injection.
    
+
    //id is some user input
 
- User.filter("id = " + id) //id could be anything so dont do it!
+
    
+
     User.filter("id = " + id) //id could be anything so dont do it!
  User.filter("id = ?", id) //Do this as patio will escape it
- User.filter({ id : id}) // Best solution!
    -

    Inverting filters

    -

    You can use the invert method. - + User.filter({ id : id}) // Best solution!

    -
    // SELECT * FROM user WHERE id != 5
-User.filter({id : 5}).invert(); 
+
    
+###Inverting filters               
 
-//OR
+You can use the [invert](.patio_Dataset.html#invert) method.
    
+
    // SELECT * FROM user WHERE id != 5
+User.filter({id : 5}).invert(); 
 
- // SELECT * FROM user WHERE id != 5
-User.filter({id : {neq : 5}});
    -

    NOTE: the invert method inverts the entire filter! +

    +

    //OR

    -
    // SELECT * FROM user WHERE id != 5 OR name <= 'A'
+
     // SELECT * FROM user WHERE id != 5
+User.filter({id : {neq : 5}});
+
    
+
    
+**NOTE:** the [invert](./patio_Dataset.html#invert) method inverts the entire filter!
    
+
    // SELECT * FROM user WHERE id != 5 OR name <= 'A'
  User.filter({id : 5}).filter(function(){ 
     return this.name.gt('A');
-}).invert();
    -

    Excluding filters

    -

    You can use exclude to invert only specific filters: - +}).invert();

    -
    // SELECT * FROM user WHERE id != 5
+
    
+###Excluding filters
+You can use [exclude](./patio_Dataset.html#exclude) to invert only specific filters:
    
+
    // SELECT * FROM user WHERE id != 5
 User.exclude({id : 5});
 
-// SELECT * FROM user WHERE id = 5 OR name <= 'A' 
+
    
+
    // SELECT * FROM user WHERE id = 5 OR name <= 'A' 
 User.filter({id : 5}).exclude(function(){ 
     return this.name.gt('A')
-});
    -

    So to do a NOT IN with an array: - -

    -
    // SELECT * FROM user WHERE id NOT IN (1, 2)
-User.exclude({id : [1, 2]});
    -

    Or to use the NOT LIKE operator: - +});

    -
    // SELECT * FROM user WHERE name NOT LIKE '%o%'
-User.exclude(sql.name.like('%o%'))
    -

    Removing

    -

    To remove all existing filters, use the unfiltered method: - +

    
+So to do a NOT IN with an array:
    +

    // SELECT * FROM user WHERE id NOT IN (1, 2) +User.exclude({id : [1, 2]});

    -
     // SELECT * FROM user
- User.filter({id : 1}).unfiltered();
    -

    Ordering

    -

    To add order to an SQL statement use the order method. - +

    Or to use the NOT LIKE operator:
    +

    // SELECT * FROM user WHERE name NOT LIKE '%o%' +User.exclude(sql.name.like('%o%'))

    -
     // SELECT * FROM user ORDER BY id
- User.order("id");
    -

    You can also provide multiple columns to the order method. +

    
+###Removing
 
+To remove all existing filters, use the [unfiltered](./patio_Dataset.html#unfiltered) method:
    +

    // SELECT * FROM user + User.filter({id : 1}).unfiltered();

    -
     // SELECT * FROM album ORDER BY user_id, id
- User.order("userId", "id");
    -

    Note: order replaces any existing order +

    
+##Ordering
 
+To add order to an SQL statement use the [order](./patio_Dataset.html#order) method.
    +

    // SELECT * FROM user ORDER BY id + User.order("id");

    -
     User.order("id").order("name");
- // SELECT * FROM user ORDER BY name
    -

    If you want to append a column to the existing order use the orderAppend method. - +

    
+You can also provide multiple columns to the order method.
    +

    // SELECT * FROM album ORDER BY user_id, id + User.order("userId", "id");

    -
     // SELECT * FROM user ORDER BY id, name
- User.order("id").orderAppend("name");
    -

    If you want to prepend a column to the existing order use the orderPrepend method. - +

    **Note:** order replaces any existing order
    +

    User.order("id").order("name"); + // SELECT * FROM user ORDER BY name

    -
     User.order("id").orderPrepend("name");
- // SELECT * FROM user ORDER BY name, id
    -

    Reversing

    -

    To reverse the order of a SQL query use the reverse method. - +

    
+If you want to append a column to the existing order use the [orderAppend](./patio_Dataset.html#orderAppend) method.
    +

    // SELECT * FROM user ORDER BY id, name + User.order("id").orderAppend("name");

    -
     // SELECT FROM user ORDER BY id DESC
- User.order("id").reverse();
    -

    You can also use the desc method. - +

    
+If you want to prepend a column to the existing order use the [orderPrepend](./patio_Dataset.html#orderPrepend) method.
    +

    User.order("id").orderPrepend("name"); + // SELECT * FROM user ORDER BY name, id

    -
     // SELECT FROM user ORDER BY id DESC
- User.order(sql.id.desc());
    -

    This allows for finer grained control of the ordering of columns. +

    
+###Reversing                
 
+To reverse the order of a SQL query use the [reverse](./patio_Dataset.html#reverse) method.
    +

    // SELECT FROM user ORDER BY id DESC + User.order("id").reverse();

    -
     // SELECT FROM user ORDER BY name, id DESC
- User.order("name", sql.id.desc());
    -

    Removing

    -

    To remove ordering use the unordered method: - - +

    
+You can also use the [desc](./patio_sql_OrderedMethods.html#desc) method.
    +

    // SELECT FROM user ORDER BY id DESC + User.order(sql.id.desc());

    -
     User.order("name").unordered();
- // SELECT * FROM user
    -

    Selecting columns

    -

    To only return certain columns use the select method. - +

    
+This allows for finer grained control of the ordering of columns.
    +

    // SELECT FROM user ORDER BY name, id DESC + User.order("name", sql.id.desc());

    -
    // SELECT id, name FROM user
-User.select("id", "name");
    -

    NOTE: If you are dealing with Model objects, you'll want to include the primary key if you want to update or remove the object. You'll also want to include any keys (primary or foreign) related to associations you plan to use. +

    
+###Removing
 
+To remove ordering use the [unordered](./patio_Dataset.html#unordered) method:
    +

    User.order("name").unordered(); + // SELECT * FROM user

    -

    NOTE: If a column is not selected, and you attempt to access it, you will get null: +

    
+##Selecting columns
 
+To only return certain columns use the [select](./patio_Dataset.html#select) method.
    +

    // SELECT id, name FROM user +User.select("id", "name");

    -
    // SELECT name FROM user LIMIT 1                    
-User.select("name").first().then(function(user){
-    //user.id === null                    
-});
    -

    select replaces any columns previously selected. +

    
+**NOTE:** If you are dealing with Model objects, you'll want to include the primary key if you want to update or remove the object. You'll also want to include any keys (primary or foreign) related to associations you plan to use.
 
+**NOTE:** If a column is not selected, and you attempt to access it, you will get null:
    +

    // SELECT name FROM user LIMIT 1
    User.select("name").first().then(function(user){ + //user.id === null
    });

    -
     User.select("id").select("name");
- // SELECT name FROM user
    -

    Like order you can use the selectAppend method to append columns to be returned. - +

    
+select replaces any columns previously selected.
    +

    User.select("id").select("name"); + // SELECT name FROM user

    -
    // SELECT id, name FROM user
-User.select("id").selectAppend("name");
    -

    To remove selected columns and revert to SELECT * use the selectAll method. - +

    
+Like order you can use the [selectAppend](./patio_Dataset.html#selectAppend) method to append columns to be returned.
    +

    // SELECT id, name FROM user +User.select("id").selectAppend("name");

    -
     User.select("id").selectAll();
- // SELECT * FROM user
    -

    Distinct

    -

    To add a DISTINCT clause to filter out duplicate rows use the distinct method. - +

    
+To remove selected columns and revert to `SELECT *` use the [selectAll](./patio_Dataset.html#selectAll) method.
    +

    User.select("id").selectAll(); + // SELECT * FROM user

    -

    Note: DISTINCT is separate from the select clause, +

    
+##Distinct
 
-
    
-
    // SELECT DISTINCT name FROM user
-User.distinct().select("name")
    
-
    Limit and Offset
    
-
    To limit the number of rows returned use the limit method.
+To add a `DISTINCT` clause to filter out duplicate rows use the [distinct](./patio_Dataset.html#distinct) method.
 
+**Note:** `DISTINCT` is separate from the select clause,
    +

    // SELECT DISTINCT name FROM user +User.distinct().select("name")

    -
    //SELECT * FROM user LIMIT 5
-User.limit(5);
    -

    To provide an offset you can provide limit with a second argument. +

    
+##Limit and Offset
 
+To limit the number of rows returned use the [limit](./patio_Dataset.html#limit) method.
    +

    //SELECT * FROM user LIMIT 5 +User.limit(5);

    -

    The following would return the 11th through 15th records in the original dataset. +

    
+To provide an offset you can provide limit with a second argument.
 
+The following would return the 11th through 15th records in the original dataset.
    +

    // SELECT * FROM user LIMIT 5 OFFSET 10 + User.limit(5, 10);

    -
    // SELECT * FROM user LIMIT 5 OFFSET 10
- User.limit(5, 10);
    -

    To remove the LIMIT and OFFSET clause use the unlimited method. +

    
+To remove the LIMIT and OFFSET clause use the [unlimited](./patio_Dataset.html#unlimited) method.
    +

    // SELECT * FROM user + User.limit(5, 10).unlimited();

    -
     // SELECT * FROM user
- User.limit(5, 10).unlimited();
    -

    Grouping

    -

    The GROUP clause is used to results based on the values of a given group of columns. To provide grouping use the group method: +

    
 
-
    
-
     // SELECT * FROM user GROUP BY user_id
- User.group("userId");
    
-
    You can remove an existing grouping use the ungrouped method:
+##Grouping
 
+The GROUP clause is used to results based on the values of a given group of columns. To provide grouping use the [group](./patio_Dataset.html#group) method:
    +

    // SELECT * FROM user GROUP BY user_id + User.group("userId");

    -
     User.group("userId").ungrouped();
- // SELECT * FROM user
    -

    A common use of grouping is to count based on the number of grouped rows, so patio provides a groupAndCount method. - +

    
+You can remove an existing grouping use the [ungrouped](./patio_Dataset.html#ungrouped) method:
    +

    User.group("userId").ungrouped(); + // SELECT * FROM user

    -
    // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id
- User.groupAndCount("userId");
    -

    Having

    -

    The HAVING clause filters the results after the grouping has been applied, instead of before. - +

    
+A common use of grouping is to count based on the number of grouped rows, so patio provides a [groupAndCount](./patio_Dataset.html#groupAndCount) method.
    +

    // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id + User.groupAndCount("userId");

    -
     // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id HAVING count >= 10
- User.groupAndCount("dateOfBirth").having({count : {gte : 10}});
    -

    If you have a HAVING clause then filter will apply the filter to the HAVING clause. +

    
+##Having
 
-
    
-
     // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id HAVING count >= 10 AND count < 15
- User.groupAndCount("dateOfBirth").having({count : {gte : 10}}).filter({count : {lt : 15}});
    
-
    Where
    
-
    Unlike filter, the where method will always affect the WHERE clause:
+The HAVING clause filters the results after the grouping has been applied, instead of before.
    +

    // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id HAVING count >= 10 + User.groupAndCount("dateOfBirth").having({count : {gte : 10}});

    -
    // SELECT user_id, COUNT(*) AS count FROM user WHERE name LIKE 'A%' GROUP BY id HAVING count >= 10
- User.groupAndCount("id").having({count : {gte : 10}}).where({name  : {like : 'A%'}});
    -

    Both the WHERE clause and the HAVING clause can be removed by using the unfiltered method: - +

    
+If you have a HAVING clause then filter will apply the filter to the HAVING clause.
    +

    // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id HAVING count >= 10 AND count < 15 + User.groupAndCount("dateOfBirth").having({count : {gte : 10}}).filter({count : {lt : 15}});

    -
    // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id
-User.groupAndCount("id").having({count : {gte : 10}}).where({name  : {like : 'A%'}}).unfiltered();
    -

    Joins

    -

    To join a dataset to another table or dataset. The underlying method used is joinTable: +

    
+##Where                
 
+Unlike filter, the where method will always affect the WHERE clause:
    +

    // SELECT user_id, COUNT(*) AS count FROM user WHERE name LIKE 'A%' GROUP BY id HAVING count >= 10 + User.groupAndCount("id").having({count : {gte : 10}}).where({name : {like : 'A%'}}); +

    +
    
+Both the WHERE clause and the HAVING clause can be removed by using the unfiltered method:
    +

    // SELECT user_id, COUNT(*) AS count FROM user GROUP BY user_id +User.groupAndCount("id").having({count : {gte : 10}}).where({name : {like : 'A%'}}).unfiltered();

    -
    // SELECT * FROM user INNER JOIN user ON blog.user_id = user.id
-User.joinTable("inner", "blog", {userId : sql.id});
    -

    Note: unlike other querying methods when specifying the join condition you must specify the value as a sql.Identifier if it is a column otherwise it will be assumed to be a literal value. +

    
+##Joins
 
+To join a dataset to another table or dataset. The underlying method used is [joinTable](./patio_Dataset.html#joinTable):
    +

    // SELECT * FROM user INNER JOIN user ON blog.user_id = user.id +User.joinTable("inner", "blog", {userId : sql.id});

    -
    // SELECT * FROM user INNER JOIN blog ON blog.user_id = user.id
+
    **Note:** unlike other querying methods when specifying the join condition you must specify the value as a [sql.Identifier](./patio_sql.html#.identifier) if it is a column otherwise it will be assumed to be a literal value.
    
+
    // SELECT * FROM user INNER JOIN blog ON blog.user_id = user.id
 User.joinTable("inner", "blog", {userId : sql.id});
 
-// SELECT * FROM user INNER JOIN blog ON blog.userId = 'id'
-User.joinTable("inner", "blog", {userId : "id"});
    -

    joinTable is not typically used directly, but instead by named join methods: -

    -
    // SELECT * FROM user INNER JOIN blog ON blog.user_id = user.id
+
    // SELECT * FROM user INNER JOIN blog ON blog.userId = 'id'
+User.joinTable("inner", "blog", {userId : "id"});
+
    
+
    
+joinTable is not typically used directly, but instead by named join methods:
    
+
    // SELECT * FROM user INNER JOIN blog ON blog.user_id = user.id
  User.join("blog", {userId : sql.id});
 
- // SELECT * FROM user LEFT JOIN blog ON blog.user_id = user.id
- User.leftJoin("blog", {userId: sql.id});
    -

    Table/Dataset to Join

    -

    For the join methods, the first argument is generally the name of the table to which you are joining. However, you can also provide a -

    -
      -
    • model class:
      • -
    -
     User.join(Blog, {userId : sql.id});
    -
      -
    • dataset, in which case a subselect is used:
      //SELECT * FROM user INNER JOIN (SELECT * FROM blog WHERE (title < 'A')) AS t1 ON (t1.user_id = user.id)
-User.join(Blog.filter({title : {lt : 'A'}}), {userId : sql.id});
      -
      • -
    -

    Join Conditions

    -

    The second argument to the specialized join methods is the conditions to use when joining, which is similar to a filter expression, with a few minor exceptions. +

    // SELECT * FROM user LEFT JOIN blog ON blog.user_id = user.id + User.leftJoin("blog", {userId: sql.id}); +

    +
    
 
+###Table/Dataset to Join
 
-
    
-
    Implicit Qualification
+For the join methods, the first argument is generally the name of the table to which you are joining. However, you can also provide a
 
+* model class:
    +

    User.join(Blog, {userId : sql.id});

    -

    An object used as the join conditions operates similarly to a filter, except that keys are automatically qualified with the table from the first argument, and unqualified values, that are sql.Identifiers, are automatically qualified with the first table or the last table joined. - +

    
+* dataset, in which case a subselect is used:
    +

    //SELECT FROM user INNER JOIN (SELECT FROM blog WHERE (title < 'A')) AS t1 ON (t1.user_id = user.id) + User.join(Blog.filter({title : {lt : 'A'}}), {userId : sql.id});

    -

    Note: both the id key and the userId value are qualified. +

    
+###Join Conditions
 
-
    
-
     //SELECT * FROM user INNER JOIN blog ON (blog.userId = user.id)
- User.join("blog", {userId : sql.id});
    
-
    Because patio uses the last joined table for implicit qualifications of values, you can do things like:
+The second argument to the specialized join methods is the conditions to use when joining, which is similar to a filter expression, with a few minor exceptions.
+
+
+**Implicit Qualification**
+
+An object used as the join conditions operates similarly to a filter, except that keys are automatically qualified with the table from the first argument, and unqualified values, that are sql.Identifiers, are automatically qualified with the first table or the last table joined. 
 
+**Note:** both the id key and the userId value are qualified.
    +

    //SELECT * FROM user INNER JOIN blog ON (blog.userId = user.id) + User.join("blog", {userId : sql.id});

    -
     //SELECT * FROM user
+
    
+
+Because patio uses the last joined table for implicit qualifications of values, you can do things like:
    
+
     //SELECT * FROM user
  //    INNER JOIN blog ON (blog.user_id = user.id)
  //    INNER JOIN posts ON (posts.blog_id = blog.id)
 
 
- User.join("blog", {userId : sql.id}).join("posts", {blogId : sql.id});
    -

    Note blogId is qualified with posts and id is qualified with blog. - -

    -

    Implicit qualification is not always correct: - +

    User.join("blog", {userId : sql.id}).join("posts", {blogId : sql.id});

    -
    // SELECT * FROM user INNER JOIN blog ON (blog.user_id = user.id) INNER JOIN posts ON (posts.user_id = blog.id)
-User.join("blog", {userId : sql.id}).join("posts", {userId : sql.id});
    -

    id is qualified with blog instead of user. This is wrong as the foreign key posts.user_id refers to user.id, not blog.id. To fix this, you need to explicitly qualify when joining: +

    **Note** blogId is qualified with posts and id is qualified with blog.
 
+
+Implicit qualification is not always correct:
    +

    // SELECT * FROM user INNER JOIN blog ON (blog.user_id = user.id) INNER JOIN posts ON (posts.user_id = blog.id) +User.join("blog", {userId : sql.id}).join("posts", {userId : sql.id});

    -
    //SELECT * FROM user
+
    id is qualified with blog instead of user. This is wrong as the foreign key posts.user_id refers to user.id, not blog.id. To fix this, you need to explicitly qualify when joining:
    
+
    //SELECT * FROM user
 //  INNER JOIN blog ON (blog.user_id = user.id)
 //  INNER JOIN posts ON (posts.user_id = user.id)
 
 
-User.join("blog", {userId : sql.id}).join("posts", {userId : sql.id.qualify("user")});
+
    
+
    User.join("blog", {userId : sql.id}).join("posts", {userId : sql.id.qualify("user")});
 
-//OR
+
    
+
    //OR
 
-User.join("blog", {userId : sql.id}).join("posts", {userId : sql.user__id}).sql
    -

    Just like the dataset filter method the join expression can be an array of two element arrays. +

    +

    User.join("blog", {userId : sql.id}).join("posts", {userId : sql.user__id}).sql

    -
    // SELECT * FROM user
+
    
+Just like the dataset filter method the join expression can be an array of two element arrays.
    
+
    // SELECT * FROM user
 //     INNER JOIN blog ON ((blog.user_id = user.id) AND (blog.id >= 1) AND (blog.id <= 5))
 
-User.join("blog", [[sql.userId, sql.id], [sql.id, {between : [1, 5]}]]).sql
    -

    USING Joins

    -

    JOIN ON is the most common type of join condition, however USING is also another valid SQL join expr that patio supports. +

    +

    User.join("blog", [[sql.userId, sql.id], [sql.id, {between : [1, 5]}]]).sql

    -

    JOIN USING is useful when the columns you are using have the same names in both tables. +

    
+###USING Joins
+
+JOIN ON is the most common type of join condition, however USING is also another valid SQL join expr that patio supports.
 
+JOIN USING is useful when the columns you are using have the same names in both tables.
    +

    // SELECT * FROM user INNER JOIN blog USING (user_id) + User.join("blog", [sql.userId])

    -
    // SELECT * FROM user INNER JOIN blog USING (user_id)
- User.join("blog", [sql.userId])
    -

    NATURAL Joins

    -

    NATURAL Joins assume that all columns with the same names used for joining, so you do not need to use a join expression. +

    
+###NATURAL Joins
 
+NATURAL Joins assume that all columns with the same names used for joining, so you do not need to use a join expression.
    +

    // SELECT * FROM user NATURAL JOIN blog + User.naturalJoin("blog");

    -
    // SELECT * FROM user NATURAL JOIN blog
- User.naturalJoin("blog");
    -

    Join Blocks

    -

    The block should accept 3 arguments, the table alias for the table currently being joined, the table alias for the last table joined (or first table), and an array of previous patio.sql.JoinClauses. +

    
+###Join Blocks
 
+The block should accept 3 arguments, the table alias for the table currently being joined, the table alias for the last table joined (or first table), and an array of previous [patio.sql.JoinClause](./patio_sql_JoinClause.html)s.
 
-
    
-
    This allows you to qualify columns similar to how the implicit qualification works, without worrying about the specific aliases being used. For example, if you wanted to join the user and blog tables, but only want user where the user's name comes before the blog's title.
 
-
    
-
     //SELECT * FROM user INNER JOIN blog
+This allows you to qualify columns similar to how the implicit qualification works, without worrying about the specific aliases being used. For example, if you wanted to join the user and blog tables, but only want user where the user's name comes before the blog's title.
    
+
     //SELECT * FROM user INNER JOIN blog
  //     ON ((blog.user_id = user.id) AND (user.name < blog.title))
  User.join("blog", {userId : sql.id}, function(currAlias, lastAlias, previousJoins){
             return sql.name.qualify(lastAlias).lt(sql.title.qualify(currAlias));
-        })
    -

    or you could do this which is the same thing: - + })

    -
     User.join("blog", {userId : sql.id, title : {gt : sql.name.qualify("user")}});
+
    
+or you could do this which is the same thing:
    
+
     User.join("blog", {userId : sql.id, title : {gt : sql.name.qualify("user")}});
 //SELECT * FROM user INNER JOIN blog
-//      ON ((blog.user_id = user.id) AND (blog.title > user.name))
    -

    From

    -

    The FROM table is typically the first clause populated when creating a dataset. For a standard patio.Model, the dataset already has the FROM clause populated, and the most common way to create datasets is with the Database from method. - +// ON ((blog.user_id = user.id) AND (blog.title > user.name))

    -
    DB.from("user");
-// SELECT * FROM user
    -

    However, you can also use the from method on the Dataset. +

    
+##From
 
+The FROM table is typically the first clause populated when creating a dataset. For a standard [patio.Model](./patio_Model.html), the dataset already has the FROM clause populated, and the most common way to create datasets is with the Database from method.
    +

    DB.from("user"); +// SELECT * FROM user

    -
     User.from("user", "oldUser");
+
    
+However, you can also use the from method on the Dataset.
    
+
     User.from("user", "oldUser");
  // SELECT * FROM user, old_user
 
-//Using from again will remove the previous FROM clause.
+
    
+
    //Using from again will remove the previous FROM clause.
 DB.from("user").from("oldUser");
- // SELECT * FROM old_user
    -

    Note: multiple tables in the FROM clause use a cross join by default, so the number of rows will be number of user times the number of old user. + // SELECT * FROM old_user +

    +
    
+**Note:** multiple tables in the FROM clause use a cross join by default, so the number of rows will be number of user times the number of old user.
 
 
-
    
-
    Subselects
    
-
    If you want to perform a subselect you can use the fromSelf method.
+##Subselects
 
+If you want to perform a subselect you can use the [fromSelf](./patio_Dataset.html#fromSelf) method.
    +

    Blog.order("userId").limit(100).fromSelf().group("userId"); + //SELECT FROM (SELECT FROM user ORDER BY user_id LIMIT 100) AS t1 GROUP BY user_id

    -
     Blog.order("userId").limit(100).fromSelf().group("userId");
- //SELECT * FROM (SELECT * FROM user ORDER BY user_id LIMIT 100) AS t1 GROUP BY user_id
    -

    If you did not use the fromSelf method the query would be: - +

    
+If you did not use the `fromSelf` method the query would be:
    +

    // SELECT * FROM user GROUP BY user_id ORDER BY user_id LIMIT 100 + Blog.order("userId").limit(100).group("userId")

    -
     // SELECT * FROM user GROUP BY user_id ORDER BY user_id LIMIT 100
- Blog.order("userId").limit(100).group("userId")
    -

    Without fromSelf, you are doing the grouping, and limiting the number of grouped records returned to 100. So assuming you have blogs written by more than 100 user, you'll end up with 100 results. +

    
+Without fromSelf, you are doing the grouping, and limiting the number of grouped records returned to 100. So assuming you have blogs written by more than 100 user, you'll end up with 100 results.
 
 
-
    
-
    With fromSelf, you are limiting the number of records before grouping. So if the user with the lowest id had 100 blogs, you'd get 1 result, not 100.
+With fromSelf, you are limiting the number of records before grouping. So if the user with the lowest id had 100 blogs, you'd get 1 result, not 100.
 
-
    
-
    Locking for Update
    
-
    patio allows you to easily add a FOR UPDATE clause to your queries so that the records returned can't be modified by another query until the current transaction commits. You just use the forUpdate method:
+##Locking for Update
 
-
    
-
     DB.transaction(function(){
+patio allows you to easily add a FOR UPDATE clause to your queries so that the records returned can't be modified by another query until the current transaction commits. You just use the [forUpdate](./patio_Dataset.html#forUpdate) method:
    
+
     DB.transaction(function(){
     var ret = new comb.Promise();
     User.forUpdate().first({id : 1}).then(function(){
         // SELECT * FROM user WHERE id = 1 FOR UPDATE
@@ -1024,33 +1039,36 @@ 
    Locking for Update
    
         user.save().then(ret);
     }, ret);
     return ret;
- });
    -

    This will ensure that no other connection modifies the row between when you select it and when the transaction ends. - + });

    -

    Custom SQL

    -

    patio makes it easy to use custom SQL by providing the [fetch][./patio_Database.html#fetch] method. +

    
+This will ensure that no other connection modifies the row between when you select it and when the transaction ends.
+
+##Custom SQL
 
+patio makes it easy to use custom SQL by providing the [fetch][./patio_Database.html#fetch] method.
    +

    // SELECT FROM user + DB.fetch("SELECT FROM user")

    -
     // SELECT * FROM user
- DB.fetch("SELECT * FROM user")
    -

    You can also use the withSql dataset method. +

    
+You can also use the withSql dataset method.
    +

    DB.from("user").withSql("SELECT FROM user"); + // SELECT FROM user

    -
     DB.from("user").withSql("SELECT * FROM user");
- // SELECT * FROM user
    -

    You can also use placeholders: +

    
+You can also use placeholders:
    +

    // SELECT FROM user WHERE id = 5 + DB.fetch("SELECT FROM user WHERE id = ?", 5);

    -
     // SELECT * FROM user WHERE id = 5
- DB.fetch("SELECT * FROM user WHERE id = ?", 5);
-
- // SELECT * FROM user WHERE id = 5
- DB.from("user").withSql("SELECT * FROM user WHERE id = {id}", {id : 5});
    -

    Checking for Records

    -

    To test if there are any records in the database use the isEmpty method - +

    // SELECT FROM user WHERE id = 5 + DB.from("user").withSql("SELECT FROM user WHERE id = {id}", {id : 5});

    -
     User.isEmpty().then(function(isEmpty){
+
    
+##Checking for Records
+
+To test if there are any records in the database use the isEmpty method
    
+
     User.isEmpty().then(function(isEmpty){
     // SELECT 1 FROM user LIMIT 1
  }, errorHandler);
  User.filter({id : 0}).isEmpty().then(function(isEmpty){
@@ -1058,41 +1076,43 @@ 
    Checking for Records
    
  },errorHandler);
  User.filter(sql.name.like('B%')).isEmpty().then(function(isEmpty){
     // SELECT 1 FROM user WHERE name LIKE 'B%' LIMIT 1
- },errorHandler);
    -

    Aggregate Calculations

    -

    There are dataset methods for each of the following aggregate calculations: + },errorHandler);

    -
      -
    • count : count just returns the number of records in the dataset.
      • -
    -
     User.count().then(function(count){
+
    ##Aggregate Calculations
+
+There are dataset methods for each of the following aggregate calculations:
+
+* [count](./patio_Dataset.html#count) : count just returns the number of records in the dataset.
    
+
     User.count().then(function(count){
     // SELECT COUNT(*) AS count FROM user LIMIT 1
- });
    -
      -
    • sum : makes a sum aggregate function call for the column.
      • -
    -
     User.sum("id").then(function(){
+ });
+
    
+
    
+* [sum](./patio_Dataset.html#sum) : makes a sum aggregate function call for the column.
    
+
     User.sum("id").then(function(){
     // SELECT sum(id) FROM user LIMIT 1
- });
    -
      -
    • avg: makes a avg aggregate function call for the column.
      • -
    -
     User.avg("id").then(function(){
+ });
+
+
    
+
    
+* [avg](./patio_Dataset.html#avg): makes a avg aggregate function call for the column.
    
+
     User.avg("id").then(function(){
     // SELECT avg(id) FROM user LIMIT 1
- });
    -
      -
    • min : makes a min aggregate function call for the column.
      • -
    -
     User.min("id").then(function(){
+ });
+
    
+
    
+* [min](./patio_Dataset.html#min) : makes a min aggregate function call for the column.
    
+
     User.min("id").then(function(){
     // SELECT sum(id) FROM user LIMIT 1
- });
    -
      -
    • max: makes a max aggregate function call for the column.
      • -
    -
     User.max("id").then(function(){
+ });
+
    
+
    
+* [max](./patio_Dataset.html#max): makes a max aggregate function call for the column.
    
+
     User.max("id").then(function(){
     // SELECT sum(id) FROM user LIMIT 1
- });
    + }); +```

    diff --git a/lib/dataset/index.js b/lib/dataset/index.js index c979f199..27e586e4 100755 --- a/lib/dataset/index.js +++ b/lib/dataset/index.js @@ -234,6 +234,9 @@ define([actions, graph, features, query, sql], { * @property {boolean} [supportsTimestampTimezone=false] Whether the dataset supports timezones in literal timestamps * @property {boolean} [supportsTimestampUsecs=true] Whether the dataset supports fractional seconds in literal timestamps * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions. + * @property {patio.sql.Identifier[]} [sourceList=[]] a list of sources for this dataset. + * @property {patio.sql.Identifier[]} [joinSourceList=[]] a list of join sources + * @property {Boolean} hasSelectSource true if this dataset already has a select sources. */ constructor:function (db, opts) { this._super(arguments); @@ -402,6 +405,21 @@ define([actions, graph, features, query, sql], { } else { return source; } + }, + + sourceList:function () { + return (this.__opts.from || []).map(this.stringToIdentifier, this); + }, + + joinSourceList:function () { + return (this.__opts.join || []).map(function (join) { + return this.stringToIdentifier(join.tableAlias || join.table); + }, this); + }, + + hasSelectSource:function () { + var select = this.__opts.select; + return !(isUndefinedOrNull(select) || select.length === 0); } }, diff --git a/lib/dataset/query.js b/lib/dataset/query.js index 897511e4..e0bc583e 100755 --- a/lib/dataset/query.js +++ b/lib/dataset/query.js @@ -1515,6 +1515,30 @@ define(null, { return this.mergeOptions({select:null}); }, + /** + * Selects the columns if only if there is not already select sources. + * + * @example + * + * var ds = DB.from("items"); //SELECT * FROM items + * + * ds.select("a"); //SELECT a FROM items; + * ds.select("a").selectIfNoSource("a", "b"). //SELECT a FROM items; + * ds.selectIfNoSource("a", "b"). //SELECT a, b FROM items; + * + * @param cols columns to select if there is not already select sources. + * @return {patio.Dataset} a cloned dataset with the appropriate select sources. + */ + selectIfNoSource:function (cols) { + var ret; + if (!this.hasSelectSource) { + ret = this.select.apply(this, arguments); + } else { + ret = this.mergeOptions(); + } + return ret; + }, + /** * Returns a copy of the dataset with the given columns added * to the existing selected columns. If no columns are currently selected, diff --git a/lib/dataset/sql.js b/lib/dataset/sql.js index bb627e9f..6fbcdaf1 100755 --- a/lib/dataset/sql.js +++ b/lib/dataset/sql.js @@ -1,42 +1,43 @@ var comb = require("comb"), - define = comb.define, - array = comb.array, - intersect = array.intersect, - compact = array.compact, - string = comb.string, - format = string.format, - argsToArray = comb.argsToArray, - isInstanceOf = comb.isInstanceOf, - isArray = comb.isArray, - isNumber = comb.isNumber, - isDate = comb.isDate, - isNull = comb.isNull, - isBoolean = comb.isBoolean, - isFunction = comb.isFunction, - isUndefined = comb.isUndefined, - isObject = comb.isObject, - isHash = comb.isHash, - merge = comb.merge, - isUndefinedOrNull = comb.isUndefinedOrNull, - isString = comb.isString, - sql = require("../sql").sql, - Expression = sql.Expression, - ComplexExpression = sql.ComplexExpression, - AliasedExpression = sql.AliasedExpression, - Identifier = sql.Identifier, - QualifiedIdentifier = sql.QualifiedIdentifier, - OrderedExpression = sql.OrderedExpression, - CaseExpression = sql.CaseExpression, - SubScript = sql.SubScript, - NumericExpression = sql.NumericExpression, - ColumnAll = sql.ColumnAll, - Cast = sql.Cast, - StringExpression = sql.StringExpression, - BooleanExpression = sql.BooleanExpression, - SQLFunction = sql.SQLFunction, - LiteralString = sql.LiteralString, - PlaceHolderLiteralString = sql.PlaceHolderLiteralString, - QueryError = require("../errors").QueryError, patio; + define = comb.define, + array = comb.array, + intersect = array.intersect, + compact = array.compact, + string = comb.string, + format = string.format, + argsToArray = comb.argsToArray, + isInstanceOf = comb.isInstanceOf, + isArray = comb.isArray, + isNumber = comb.isNumber, + isDate = comb.isDate, + isNull = comb.isNull, + isBoolean = comb.isBoolean, + isFunction = comb.isFunction, + isUndefined = comb.isUndefined, + isObject = comb.isObject, + isHash = comb.isHash, + isEmpty = comb.isEmpty, + merge = comb.merge, + isUndefinedOrNull = comb.isUndefinedOrNull, + isString = comb.isString, + sql = require("../sql").sql, + Expression = sql.Expression, + ComplexExpression = sql.ComplexExpression, + AliasedExpression = sql.AliasedExpression, + Identifier = sql.Identifier, + QualifiedIdentifier = sql.QualifiedIdentifier, + OrderedExpression = sql.OrderedExpression, + CaseExpression = sql.CaseExpression, + SubScript = sql.SubScript, + NumericExpression = sql.NumericExpression, + ColumnAll = sql.ColumnAll, + Cast = sql.Cast, + StringExpression = sql.StringExpression, + BooleanExpression = sql.BooleanExpression, + SQLFunction = sql.SQLFunction, + LiteralString = sql.LiteralString, + PlaceHolderLiteralString = sql.PlaceHolderLiteralString, + QueryError = require("../errors").QueryError, patio; var Dataset; @@ -447,7 +448,7 @@ define(null, { return new QualifiedIdentifier(table, e); } else if (isInstanceOf(e, OrderedExpression)) { return new OrderedExpression(this._qualifiedExpression(e.expression, table), e.descending, - {nulls:e.nulls}); + {nulls:e.nulls}); } else if (isInstanceOf(e, AliasedExpression)) { return new AliasedExpression(this._qualifiedExpression(e.expression, table), e.alias); } else if (isInstanceOf(e, CaseExpression)) { @@ -615,9 +616,9 @@ define(null, { var columns = this.__opts.columns, ret = ""; if (columns && columns.length) { ret = " (" + columns.map( - function (c) { - return c.toString(this); - }, this).join(this._static.COMMA_SEPARATOR) + ")"; + function (c) { + return c.toString(this); + }, this).join(this._static.COMMA_SEPARATOR) + ")"; } return ret; }, @@ -729,8 +730,8 @@ define(null, { return this.complexExpressionSql("EQ", args); } else { return this.complexExpressionSql("OR", - [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0], - null)]); + [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0], + null)]); } } else if (["IN", "NOTIN"].indexOf(op) != -1) { @@ -761,8 +762,8 @@ define(null, { //literal so that if values is an array of two element arrays, it //will be treated as a value list instead of a condition specifier. return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols), - ComplexExpression.IN_OPERATORS[op], - valArray ? this._arraySql(vals) : this.literal(vals)); + ComplexExpression.IN_OPERATORS[op], + valArray ? this._arraySql(vals) : this.literal(vals)); } } else { @@ -776,13 +777,13 @@ define(null, { } } else { return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols), - ComplexExpression.IN_OPERATORS[op], this.literal(vals)); + ComplexExpression.IN_OPERATORS[op], this.literal(vals)); } } } else if ((newOp = this._static.TWO_ARITY_OPERATORS[op]) != null) { var l = args[0]; return format("(%s %s %s)", isString(l) ? l : this.literal(l), newOp, - this.literal(args[1])); + this.literal(args[1])); } else if ((newOp = this._static.N_ARITY_OPERATORS[op]) != null) { return string.format("(%s)", args.map(this.literal, this).join(" " + newOp + " ")); } else if (op == "NOT") { @@ -825,7 +826,7 @@ define(null, { } var tref = this.__tableRef(table); return string.format(" %s %s", this._joinTypeSql(jc.joinType), - tableAlias ? this.__asSql(tref, tableAlias) : tref); + tableAlias ? this.__asSql(tref, tableAlias) : tref); }, /** @@ -898,11 +899,11 @@ define(null, { */ qualifiedIdentifierSql:function (qcr) { return [qcr.table, qcr.column].map( - function (x) { - return [QualifiedIdentifier, Identifier, String].some(function (c) { - return x instanceof c - }) ? this.literal(x) : this.quoteIdentifier(x) - }, this).join('.'); + function (x) { + return [QualifiedIdentifier, Identifier, String].some(function (c) { + return x instanceof c + }) ? this.literal(x) : this.quoteIdentifier(x) + }, this).join('.'); }, /** @@ -937,12 +938,12 @@ define(null, { var i = this.__identifierInputMethod; v = v.toString(this); return !isUndefinedOrNull(i) ? - isFunction(v[i]) ? - v[i]() : - isFunction(comb[i]) ? - comb[i](v) - : v - : v; + isFunction(v[i]) ? + v[i]() : + isFunction(comb[i]) ? + comb[i](v) + : v + : v; }, /** @@ -955,12 +956,12 @@ define(null, { (v == '' && (v = 'untitled')); var i = this.__identifierOutputMethod; return !isUndefinedOrNull(i) ? - isFunction(v[i]) ? - v[i]() : - isFunction(comb[i]) ? - comb[i](v) - : v - : v; + isFunction(v[i]) ? + v[i]() : + isFunction(comb[i]) ? + comb[i](v) + : v + : v; }, /** @@ -1056,9 +1057,9 @@ define(null, { */ _joinTypeSql:function (joinType) { return (joinType || "").replace(/([a-z]+)|([A-Z][a-z]+)/g, - function (m) { - return m.toUpperCase() + " "; - } + function (m) { + return m.toUpperCase() + " "; + } ).trimRight() + " JOIN"; }, @@ -1184,10 +1185,10 @@ define(null, { var table = parts[0], column = parts[1], alias = parts[2]; if (!alias) { return column && table ? this._literalExpression(QualifiedIdentifier.fromArgs([table, column])) : "'" - + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'" + + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'" } else { return this.literal(new AliasedExpression(column - && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias)); + && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias)); } }, @@ -1480,9 +1481,9 @@ define(null, { throw new QueryError("No source specified for the query"); } return " " + source.map( - function (s) { - return this.__tableRef(s); - }, this).join(this._static.COMMA_SEPARATOR); + function (s) { + return this.__tableRef(s); + }, this).join(this._static.COMMA_SEPARATOR); }, /** diff --git a/lib/model.js b/lib/model.js index 45f6b5fc..b32ceacd 100644 --- a/lib/model.js +++ b/lib/model.js @@ -229,10 +229,15 @@ var Model = define([QueryPlugin, Middleware], { __setFromDb:function (values, ignore) { values = values || {}; this.__ignore = ignore === true; + var schema = this.schema; Object.keys(values).forEach(function (column) { var value = values[column]; // Typecast value retrieved from db - this.__values[column] = this._typeCastValue(column, value, ignore); + if (schema.hasOwnProperty(column)) { + this.__values[column] = this._typeCastValue(column, value, ignore); + } else { + this[column] = value; + } }, this); this.__ignore = false; diff --git a/test/model.test.js b/test/model.test.js index 64f0c149..1cc8166a 100644 --- a/test/model.test.js +++ b/test/model.test.js @@ -10,7 +10,7 @@ var it = require('it'), var gender = ["M", "F"]; -it.describe("A model with properites", function (it) { +it.describe("A model with properites",function (it) { var Employee; it.beforeAll(function () { @@ -194,11 +194,13 @@ it.describe("A model with properites", function (it) { }); it.should("support the filtering of models", function (next) { - var id = sql.identifier("id"), ids = emps.map(function(emp){return emp.id;}); + var id = sql.identifier("id"), ids = emps.map(function (emp) { + return emp.id; + }); comb.executeInOrder(Employee, function (Employee) { var ret = {}; - ret.query1 = Employee.filter({id:ids.slice(0,6)}).all(); + ret.query1 = Employee.filter({id:ids.slice(0, 6)}).all(); ret.query2 = Employee.filter(id.gt(ids[0]), id.lt(ids[5])).order("id").last(); ret.query3 = Employee.filter(function () { return this.firstname.like(/first1[1|2]*$/); @@ -231,7 +233,7 @@ it.describe("A model with properites", function (it) { assert.deepEqual(query4.map(function (e) { assert.instanceOf(e, Employee); return e.id; - }), ids.slice(0,6)); + }), ids.slice(0, 6)); assert.deepEqual(query5.map(function (e) { assert.instanceOf(e, Employee); return e.id; @@ -239,7 +241,7 @@ it.describe("A model with properites", function (it) { next(); }, next); }); - + it.should("support custom query methods", function (next) { Employee.findByGender("F").then(function (emps) { emps.forEach(function (emp) { @@ -272,7 +274,9 @@ it.describe("A model with properites", function (it) { it.should("support map", function (next) { - var ids = emps.map(function(emp){return emp.id;}); + var ids = emps.map(function (emp) { + return emp.id; + }); comb.executeInOrder(Employee, function (Employee) { var ret = {}; @@ -315,7 +319,9 @@ it.describe("A model with properites", function (it) { }); it.should("support first", function (next) { - var id = sql.identifier("id"),ids = emps.map(function(emp){return emp.id;}); + var id = sql.identifier("id"), ids = emps.map(function (emp) { + return emp.id; + }); Employee.first(id.gt(ids[5]), id.lt(ids[11])).then(function (emp) { assert.instanceOf(emp, Employee); assert.equal(emp.id, ids[6]) @@ -401,7 +407,12 @@ it.describe("A model with properites", function (it) { }, next); }); + }); + it.should("allow values when initalizing that are not in the schema", function () { + var m = new Employee({otherVal:"otherVal", firstname:"dougie"}, true); + assert.equal(m.otherVal, "otherVal"); + assert.equal(m.firstname, "dougie"); }); it.afterAll(function () { @@ -409,7 +420,6 @@ it.describe("A model with properites", function (it) { }); - }).as(module); diff --git a/test/plugins/columnMapper.test.js b/test/plugins/columnMapper.test.js index f2abfa14..cb77c587 100644 --- a/test/plugins/columnMapper.test.js +++ b/test/plugins/columnMapper.test.js @@ -10,7 +10,6 @@ var it = require('it'), var gender = ["M", "F"]; - it.describe("patio.plugins.ColumnMapper", function (it) { var Works, Employee; it.beforeAll(function () { From f580dbd2148b86880ab6dc1fd3ee2c1b4bfe01c0 Mon Sep 17 00:00:00 2001 From: Doug Martin Date: Wed, 29 Aug 2012 11:43:25 -0500 Subject: [PATCH 2/3] updated coverage docs --- docs-md/coverage.html | 7535 +++++++++++++++++++++-------------------- docs/coverage.html | 7535 +++++++++++++++++++++-------------------- 2 files changed, 7576 insertions(+), 7494 deletions(-) diff --git a/docs-md/coverage.html b/docs-md/coverage.html index 70d5468b..21fb1ef8 100644 --- a/docs-md/coverage.html +++ b/docs-md/coverage.html @@ -256,10 +256,10 @@
    - Coverage89.21 - SLOC21921 - LOC5357 - Missed578 + Coverage89.04 + SLOC21962 + LOC5365 + Missed588
    @@ -2521,7 +2521,7 @@
  • },
  • _quotedIdentifier:function (c) {
    • -
  • 26239 return format('"%s"', c);
    • +
  • 25927 return format('"%s"', c);
  • },
  • __fullTextStringJoin:function (cols) {
    • @@ -2575,12 +2575,12 @@
  • 3048 var cols = [];
  • 3048 if (rows && rows.length) {
  • 2543 cols = this.__columns = fields && fields.length ? fields.map(function (f) {
    • -
  • 18560 return f.name;
    • +
  • 18922 return f.name;
  • }) : Object.keys(rows[0]);
  • //the pg driver does auto type coercion
  • 2543 cols = cols.map(function (c) {
    • -
  • 18560 return [oi(c), function (o) {
    • -
  • 27740 return o;
    • +
  • 18922 return [oi(c), function (o) {
    • +
  • 28420 return o;
  • }, c];
  • }, this);
  • }
    • @@ -2607,7 +2607,7 @@
  • 3654 var h = {};
  • 3654 var row = rows[index];
  • 3654 cols.forEach(function (col) {
    • -
  • 27740 h[col[0]] = col[1](row[col[2]]);
    • +
  • 28420 h[col[0]] = col[1](row[col[2]]);
  • }, this);
  • 3654 when(cb(h)).then(function (val) {
    • @@ -2659,15 +2659,15 @@
  • },
  • supportsDistinctOn:function () {
    • -
  • 12996 return true;
    • +
  • 12670 return true;
  • },
  • supportsModifyingJoins:function () {
    • -
  • 15440 return true;
    • +
  • 15114 return true;
  • },
  • supportsTimestampTimezones:function () {
    • -
  • 12994 return true;
    • +
  • 12668 return true;
  • }
  • }
    • @@ -5735,3296 +5735,3769 @@
    • -
    +
    -
    associations/_Association.js
    +
    dataset/index.js
    - Coverage87.18 - SLOC515 - LOC156 - Missed20 + Coverage86.11 + SLOC457 + LOC72 + Missed10
    - 
    1. 1var comb = require("comb-proxy"),
      2. 
-
    2.      define = comb.define,
      3. 
+    
      1. 1var comb = require("comb"),
        2. 
+
      2.      hitch = comb.hitch,
        3. 
+
      3.      logging = comb.logging,
        4. 
+
      4.      Logger = logging.Logger,
        5. 
+
      5.      errors = require("../errors"),
        6. 
+
      6.      QueryError = errors.QueryError,
        7. 
+
      7.      DatasetError = errors.DatasetError,
        8. 
+
      8.      Promise = comb.Promise,
        9. 
+
      9.      PromiseList = comb.PromiseList,
        10. 
 
      10.      isUndefined = comb.isUndefined,
        11. 
 
      11.      isUndefinedOrNull = comb.isUndefinedOrNull,
        12. 
-
      12.      isBoolean = comb.isBoolean,
        13. 
 
      13.      isString = comb.isString,
        14. 
-
      14.      isHash = comb.isHash,
        15. 
-
      15.      isFunction = comb.isFunction,
        16. 
 
      16.      isInstanceOf = comb.isInstanceOf,
        17. 
-
      17.      Promise = comb.Promise,
        18. 
-
      18.      PromiseList = comb.PromiseList,
        19. 
-
      19.      hitch = comb.hitch,
        20. 
-
      20.      array = comb.array,
        21. 
-
      21.      isArray = comb.isArray,
        22. 
-
      22.      Middleware = comb.plugins.Middleware,
        23. 
-
      23.      PatioError = require("../errors").PatioError;
        24. 
-
      24.  
        25. 
-
      25. 1var fetch = {
        26. 
-
      26.      LAZY:"lazy",
        27. 
-
      27.      EAGER:"eager"
        28. 
-
      28.  };
        29. 
+
      29.      isString = comb.isString,
        30. 
+
      30.      isFunction = comb.isFunction,
        31. 
+
      31.      isNull = comb.isNull,
        32. 
+
      32.      merge = comb.merge,
        33. 
+
      33.      define = comb.define,
        34. 
+
      34.      graph = require("./graph"),
        35. 
+
      35.      actions = require("./actions"),
        36. 
+
      36.      features = require("./features"),
        37. 
+
      37.      query = require("./query"),
        38. 
+
      38.      sql = require("./sql"),
        39. 
+
      39.      SQL = require("../sql").sql,
        40. 
+
      40.      AliasedExpression = SQL.AliasedExpression,
        41. 
+
      41.      Identifier = SQL.Identifier,
        42. 
+
      42.      QualifiedIdentifier = SQL.QualifiedIdentifier;
        43. 
 
      43.  
        44. 
 
      44.  
        45. 
-
      45.  /**
        46. 
-
      46.   * @class
        47. 
-
      47.   * Base class for all associations.
        48. 
-
      48.   *
        49. 
-
      49.   * </br>
        50. 
-
      50.   * <b>NOT to be instantiated directly</b>
        51. 
-
      51.   * Its just documented for reference.
        52. 
-
      52.   *
        53. 
-
      53.   * @constructs
        54. 
-
      54.   * @param {Object} options
        55. 
-
      55.   * @param {String} options.model a string to look up the model that we are associated with
        56. 
-
      56.   * @param {Function} options.filter  a callback to find association if a filter is defined then
        57. 
-
      57.   *                                    the association is read only
        58. 
-
      58.   * @param {Object} options.key object with left key and right key
        59. 
-
      59.   * @param {String|Object} options.orderBy<String|Object> - how to order our association @see Dataset.order
        60. 
-
      60.   * @param {fetch.EAGER|fetch.LAZY} options.fetchType the fetch type of the model if fetch.Eager is supplied then
        61. 
-
      61.   *                                    the associations are automatically filled, if fetch.Lazy is supplied
        62. 
-
      62.   *                                    then a promise is returned and is called back with the loaded models
        63. 
-
      63.   * @property {Model} model the model associatied with this association.
        64. 
-
      64.   * @name Association
        65. 
-
      65.   * @memberOf patio.associations
        66. 
-
      66.   * */
        67. 
-
      67. 1define(Middleware, {
        68. 
+
      68. 1var LOGGER = comb.logger("patio.Dataset");
        69. 
+
      69. 1define([actions, graph, features, query, sql], {
        70. 
 
      70.      instance:{
        71. 
-
      71.          /**@lends patio.associations.Association.prototype*/
        72. 
-
      72.  
        73. 
-
      73.          type:"",
        74. 
-
      74.  
        75. 
-
      75.          //Our associated model
        76. 
-
      76.          _model:null,
        77. 
-
      77.  
        78. 
-
      78.          /**
        79. 
-
      79.           * Fetch type
        80. 
-
      80.           */
        81. 
-
      81.          fetchType:fetch.LAZY,
        82. 
-
      82.  
        83. 
-
      83.          /**how to order our association*/
        84. 
-
      84.          orderBy:null,
        85. 
-
      85.  
        86. 
-
      86.          /**Our filter method*/
        87. 
-
      87.          filter:null,
        88. 
-
      88.  
        89. 
-
      89.          __hooks:null,
        90. 
-
      90.  
        91. 
-
      91.          isOwner:true,
        92. 
-
      92.  
        93. 
-
      93.          createSetter:true,
        94. 
 
      94.  
        95. 
-
      95.          isCascading:false,
        96. 
-
      96.  
        97. 
-
      97.          supportsStringKey:true,
        98. 
-
      98.  
        99. 
-
      99.          supportsHashKey:true,
        100. 
-
      100.  
        101. 
-
      101.          supportsCompositeKey:true,
        102. 
-
      102.  
        103. 
-
      103.          supportsLeftAndRightKey:true,
        104. 
+
      104.          /**@lends patio.Dataset.prototype*/
        105. 
 
      105.  
        106. 
 
      106.          /**
        107. 
+
      107.           * Class that is used for querying/retirving datasets from a database.
        108. 
 
      108.           *
        109. 
-
      109.           *Method to call to look up association,
        110. 
-
      110.           *called after the model has been filtered
        111. 
-
      111.           **/
        112. 
-
      112.          _fetchMethod:"all",
        113. 
-
      113.  
        114. 
-
      114.  
        115. 
-
      115.          constructor:function (options, patio, filter) {
        116. 
-
      116. 55            options = options || {};
        117. 
-
      117. 55            if (!options.model) {
        118. 
-
      118. 0                throw new Error("Model is required for " + this.type + " association");
        119. 
-
      119.              }
        120. 
-
      120. 55            this._model = options.model;
        121. 
-
      121. 55            this.patio = patio;
        122. 
-
      122. 55            this.__opts = options;
        123. 
-
      123. 55            !isUndefined(options.isCascading) && (this.isCascading = options.isCascading);
        124. 
-
      124. 55            this.filter = filter;
        125. 
-
      125. 55            this.readOnly = isBoolean(options.readOnly) ? options.readOnly : false;
        126. 
-
      126. 55            this.__hooks =
        127. 
-
      127.              {before:{add:null, remove:null, "set":null, load:null}, after:{add:null, remove:null, "set":null, load:null}};
        128. 
-
      128. 55            var hooks = ["Add", "Remove", "Set", "Load"];
        129. 
-
      129. 55            ["before", "after"].forEach(function (h) {
        130. 
-
      130. 110                hooks.forEach(function (a) {
        131. 
-
      131. 440                    var hookName = h + a, hook;
        132. 
-
      132. 440                    if (isFunction((hook = options[hookName]))) {
        133. 
-
      133. 0                        this.__hooks[h][a.toLowerCase()] = hook;
        134. 
-
      134.                      }
        135. 
-
      135.                  }, this);
        136. 
-
      136.              }, this);
        137. 
-
      137. 55            this.fetchType = options.fetchType || fetch.LAZY;
        138. 
-
      138.          },
        139. 
-
      139.  
        140. 
-
      140.          _callHook:function (hook, action, args) {
        141. 
-
      141. 0            var func = this.__hooks[hook][action], ret;
        142. 
-
      142. 0            if (isFunction(func)) {
        143. 
-
      143. 0                ret = func.apply(this, args);
        144. 
-
      144.              }
        145. 
-
      145. 0            return ret;
        146. 
-
      146.          },
        147. 
-
      147.  
        148. 
-
      148.          _clearAssociations:function (model) {
        149. 
-
      149. 125            if (!this.readOnly) {
        150. 
-
      150. 125                delete model.__associations[this.name];
        151. 
-
      151.              }
        152. 
-
      152.          },
        153. 
-
      153.  
        154. 
-
      154.          _forceReloadAssociations:function (model) {
        155. 
-
      155. 243            if (!this.readOnly) {
        156. 
-
      156. 243                delete model.__associations[this.name];
        157. 
-
      157. 243                return model[this.name];
        158. 
-
      158.              }
        159. 
-
      159.          },
        160. 
-
      160.  
        161. 
-
      161.          /**
        162. 
-
      162.           * @return {Boolean} true if the association is eager.
        163. 
-
      163.           */
        164. 
-
      164.          isEager:function () {
        165. 
-
      165. 2114            return this.fetchType == fetch.EAGER;
        166. 
-
      166.          },
        167. 
-
      167.  
        168. 
-
      168.          _checkAssociationKey:function (parent) {
        169. 
-
      169. 785            var q = {};
        170. 
-
      170. 785            this._setAssociationKeys(parent, q);
        171. 
-
      171. 785            return Object.keys(q).every(function (k) {
        172. 
-
      172. 785                return q[k] != null
        173. 
-
      173.              });
        174. 
-
      174.          },
        175. 
-
      175.  
        176. 
-
      176.          _getAssociationKey:function () {
        177. 
-
      177. 5205            var options = this.__opts, key, ret = [], lk, rk;
        178. 
-
      178. 5205            if (!isUndefinedOrNull((key = options.key))) {
        179. 
-
      179. 722                if (this.supportsStringKey && isString(key)) {
        180. 
-
      180.                      //normalize the key first!
        181. 
-
      181. 356                    ret = [
        182. 
-
      182.                          [this.isOwner ? this.defaultLeftKey : key],
        183. 
-
      183.                          [this.isOwner ? key : this.defaultRightKey]
        184. 
-
      184.                      ];
        185. 
-
      185. 366                } else if (this.supportsHashKey && isHash(key)) {
        186. 
-
      186. 366                    var leftKey = Object.keys(key)[0];
        187. 
-
      187. 366                    var rightKey = key[leftKey];
        188. 
-
      188. 366                    ret = [
        189. 
-
      189.                          [leftKey],
        190. 
-
      190.                          [rightKey]
        191. 
-
      191.                      ];
        192. 
-
      192. 0                } else if (this.supportsCompositeKey && isArray(key)) {
        193. 
-
      193. 0                    ret = [
        194. 
-
      194.                          [key],
        195. 
-
      195.                          null
        196. 
-
      196.                      ];
        197. 
-
      197.                  }
        198. 
-
      198. 4483            } else if (this.supportsLeftAndRightKey && (!isUndefinedOrNull((lk = options.leftKey))
        199. 
-
      199.                  && !isUndefinedOrNull((rk = options.rightKey)))) {
        200. 
-
      200. 140                ret = [
        201. 
-
      201.                      array.toArray(lk), array.toArray(rk)
        202. 
-
      202.                  ];
        203. 
-
      203.              } else {
        204. 
-
      204.                  //todo handle composite primary keys
        205. 
-
      205. 4343                ret = [
        206. 
-
      206.                      [this.defaultLeftKey],
        207. 
-
      207.                      [this.defaultRightKey]
        208. 
-
      208.                  ];
        209. 
-
      209.              }
        210. 
-
      210. 5205            return ret;
        211. 
-
      211.          },
        212. 
-
      212.  
        213. 
-
      213.  
        214. 
-
      214.          _setAssociationKeys:function (parent, model, val) {
        215. 
-
      215. 1573            var keys = this._getAssociationKey(parent), leftKey = keys[0], rightKey = keys[1];
        216. 
-
      216. 1573            if (leftKey && rightKey) {
        217. 
-
      217. 1573                for (var i = 0; i < leftKey.length; i++) {
        218. 
-
      218. 1573                    model[rightKey[i]] = !isUndefined(val) ? val : parent[leftKey[i]];
        219. 
-
      219.                  }
        220. 
-
      220.              } else {
        221. 
-
      221. 0                leftKey.forEach(function (k) {
        222. 
-
      222. 0                    model[k] = !isUndefined(val) ? val : parent[k];
        223. 
-
      223.                  });
        224. 
-
      224.              }
        225. 
-
      225.          },
        226. 
-
      226.  
        227. 
-
      227.          _setDatasetOptions:function (ds) {
        228. 
-
      228. 974            var options = this.__opts || {};
        229. 
-
      229. 974            var order, limit, distinct, select, query;
        230. 
-
      230.              //allow for multi key ordering
        231. 
-
      231. 974            if (!isUndefined((select = this.select))) {
        232. 
-
      232. 0                ds = ds.select.apply(ds, array.toArray(select));
        233. 
-
      233.              }
        234. 
-
      234. 974            if (!isUndefined((query = options.query)) || !isUndefined((query = options.conditions))) {
        235. 
-
      235. 0                ds = ds.filter(query);
        236. 
-
      236.              }
        237. 
-
      237. 974            if (isFunction(this.filter)) {
        238. 
-
      238. 334                var ret = this.filter.apply(this, [ds]);
        239. 
-
      239. 334                if (isInstanceOf(ret, ds._static)) {
        240. 
-
      240. 334                    ds = ret;
        241. 
-
      241.                  }
        242. 
-
      242.              }
        243. 
-
      243. 974            if (!isUndefined((distinct = options.distinct))) {
        244. 
-
      244. 0                ds = ds.limit.apply(ds, array.toArray(distinct));
        245. 
-
      245.              }
        246. 
-
      246. 974            if (!isUndefined((order = options.orderBy)) || !isUndefined((order = options.order))) {
        247. 
-
      247. 0                ds = ds.order.apply(ds, array.toArray(order));
        248. 
-
      248.              }
        249. 
-
      249. 974            if (!isUndefined((limit = options.limit))) {
        250. 
-
      250. 0                ds = ds.limit.apply(ds, array.toArray(limit));
        251. 
-
      251.              }
        252. 
-
      252. 974            return ds;
        253. 
-
      253.  
        254. 
-
      254.          },
        255. 
-
      255.  
        256. 
-
      256.          /**
        257. 
-
      257.           *Filters our associated dataset to load our association.
        258. 
+
      258.           * <p> Dynamically genertated methods include
        259. 
+
      259.           * <ul>
        260. 
+
      260.           *     <li>Join methods from {@link patio.Dataset.CONDITIONED_JOIN_TYPES} and
        261. 
+
      261.           *         {@link  patio.Dataset.UNCONDITIONED_JOIN_TYPES}, these methods handle the type call
        262. 
+
      262.           *         to {@link patio.Dataset#joinTable}, so to invoke include all arguments that
        263. 
+
      263.           *         {@link patio.Dataset#joinTable} requires except the type parameter. The default list includes.
        264. 
+
      264.           *         <ul>
        265. 
+
      265.           *             <li>Conditioned join types that accept conditions.
        266. 
+
      266.           *                  <ul>
        267. 
+
      267.           *                      <li>inner - INNER JOIN</li>
        268. 
+
      268.           *                      <li>fullOuter - FULL OUTER</li>
        269. 
+
      269.           *                      <li>rightOuter - RIGHT OUTER JOIN</li>
        270. 
+
      270.           *                      <li>leftOuter - LEFT OUTER JOIN</li>
        271. 
+
      271.           *                      <li>full - FULL JOIN</li>
        272. 
+
      272.           *                      <li>right - RIGHT JOIN</li>
        273. 
+
      273.           *                      <li>left - LEFT JOIN</li>
        274. 
+
      274.           *                  </ul>
        275. 
+
      275.           *             </li>
        276. 
+
      276.           *             <li>Unconditioned join types that do not accept join conditions
        277. 
+
      277.           *                  <ul>
        278. 
+
      278.           *                      <li>natural - NATURAL JOIN</li>
        279. 
+
      279.           *                      <li>naturalLeft - NATURAL LEFT JOIN</li>
        280. 
+
      280.           *                      <li>naturalRight - NATURAL RIGHT JOIN</li>
        281. 
+
      281.           *                      <li>naturalFull - NATURA FULLL JOIN</li>
        282. 
+
      282.           *                      <li>cross - CROSS JOIN</li>
        283. 
+
      283.           *                  </ul>
        284. 
+
      284.           *             </li>
        285. 
+
      285.           *         </ul>
        286. 
+
      286.           *      </li>
        287. 
+
      287.           *  </li>
        288. 
+
      288.           * </ul>
        289. 
 
      289.           *
        290. 
-
      290.           *@return {Dataset} the dataset with all filters applied.
        291. 
-
      291.           **/
        292. 
-
      292.          _filter:function (parent) {
        293. 
-
      293. 648            var options = this.__opts || {};
        294. 
-
      294. 648            var ds;
        295. 
-
      295. 648            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
        296. 
-
      296. 0                ds = ds.apply(parent, [parent]);
        297. 
-
      297.              }
        298. 
-
      298. 648            if (!ds) {
        299. 
-
      299. 648                var q = {};
        300. 
-
      300. 648                this._setAssociationKeys(parent, q);
        301. 
-
      301. 648                ds = this.model.dataset.naked().filter(q);
        302. 
-
      302. 648                var recip = this.model._findAssociation(this);
        303. 
-
      303. 648                recip && (recip = recip[1]);
        304. 
-
      304. 648                ds.rowCb = hitch(this, function (item) {
        305. 
-
      305. 489                    var ret = new Promise();
        306. 
-
      306. 489                    var model = this._toModel(item, true);
        307. 
-
      307. 489                    recip && recip.__setValue(model, parent);
        308. 
-
      308.                      //call hook to finish other model associations
        309. 
-
      309. 489                    model._hook("post", "load").then(hitch(this, function () {
        310. 
-
      310. 489                        ret.callback(model);
        311. 
-
      311.                      }), ret);
        312. 
-
      312. 489                    return ret.promise();
        313. 
-
      313.                  });
        314. 
+
      314.           * <p>
        315. 
+
      315.           *     <h4>Features:</h4>
        316. 
+
      316.           *     <p>
        317. 
+
      317.           *           Features that a particular {@link patio.Dataset} supports are shown in the example below.
        318. 
+
      318.           *           If you wish to implement an adapter please override these values depending on the database that
        319. 
+
      319.           *           you are developing the adapter for.
        320. 
+
      320.           *      </p>
        321. 
+
      321.           *      <pre class="code">
        322. 
+
      322.           *          var ds = DB.from("test");
        323. 
+
      323.           *
        324. 
+
      324.           *          //The default values returned
        325. 
+
      325.           *
        326. 
+
      326.           *          //Whether this dataset quotes identifiers.
        327. 
+
      327.           *          //Whether this dataset quotes identifiers.
        328. 
+
      328.           *          ds.quoteIdentifiers //=>true
        329. 
+
      329.           *
        330. 
+
      330.           *          //Whether this dataset will provide accurate number of rows matched for
        331. 
+
      331.           *          //delete and update statements.  Accurate in this case is the number of
        332. 
+
      332.           *          //rows matched by the dataset's filter.
        333. 
+
      333.           *          ds.providesAccurateRowsMatched; //=>true
        334. 
+
      334.           *
        335. 
+
      335.           *          //Times Whether the dataset requires SQL standard datetimes (false by default,
        336. 
+
      336.           *          // as most allow strings with ISO 8601 format).
        337. 
+
      337.           *          ds.requiresSqlStandardDate; //=>false
        338. 
+
      338.           *
        339. 
+
      339.           *          //Whether the dataset supports common table expressions (the WITH clause).
        340. 
+
      340.           *          ds.supportsCte; //=>true
        341. 
+
      341.           *
        342. 
+
      342.           *          //Whether the dataset supports the DISTINCT ON clause, false by default.
        343. 
+
      343.           *          ds.supportsDistinctOn; //=>false
        344. 
+
      344.           *
        345. 
+
      345.           *          //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
        346. 
+
      346.           *          ds.supportsIntersectExcept; //=>true
        347. 
+
      347.           *
        348. 
+
      348.           *          //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default
        349. 
+
      349.           *          ds.supportsIntersectExceptAll; //=>true
        350. 
+
      350.           *
        351. 
+
      351.           *          //Whether the dataset supports the IS TRUE syntax.
        352. 
+
      352.           *          ds.supportsIsTrue; //=>true
        353. 
+
      353.           *
        354. 
+
      354.           *          //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
        355. 
+
      355.           *          ds.supportsJoinUsing; //=>true
        356. 
+
      356.           *
        357. 
+
      357.           *          //Whether modifying joined datasets is supported.
        358. 
+
      358.           *          ds.supportsModifyingJoin; //=>false
        359. 
+
      359.           *
        360. 
+
      360.           *          //Whether the IN/NOT IN operators support multiple columns when an
        361. 
+
      361.           *          ds.supportsMultipleColumnIn; //=>true
        362. 
+
      362.           *
        363. 
+
      363.           *          //Whether the dataset supports timezones in literal timestamps
        364. 
+
      364.           *          ds.supportsTimestampTimezone; //=>false
        365. 
+
      365.           *
        366. 
+
      366.           *          //Whether the dataset supports fractional seconds in literal timestamps
        367. 
+
      367.           *          ds.supportsTimestampUsecs; //=>true
        368. 
+
      368.           *
        369. 
+
      369.           *          //Whether the dataset supports window functions.
        370. 
+
      370.           *          ds.supportsWindowFunctions; //=>false
        371. 
+
      371.           *       </pre>
        372. 
+
      372.           * <p>
        373. 
+
      373.           * <p>
        374. 
+
      374.           *     <h4>Actions</h4>
        375. 
+
      375.           *     <p>
        376. 
+
      376.           *         Each dataset does not actually send any query to the database until an action method has
        377. 
+
      377.           *         been called upon it(with the exception of {@link patio.Dataset#graph} because columns
        378. 
+
      378.           *         from the other table might need retrived in order to set up the graph). Each action
        379. 
+
      379.           *         returns a <i>comb.Promise</i> that will be resolved with the result or errback, it is important
        380. 
+
      380.           *         that you account for errors otherwise it can be difficult to track down issues.
        381. 
+
      381.           *         The list of action methods is:
        382. 
+
      382.           *         <ul>
        383. 
+
      383.           *             <li>{@link patio.Dataset#all}</li>
        384. 
+
      384.           *             <li>{@link patio.Dataset#one}</li>
        385. 
+
      385.           *             <li>{@link patio.Dataset#avg}</li>
        386. 
+
      386.           *             <li>{@link patio.Dataset#count}</li>
        387. 
+
      387.           *             <li>{@link patio.Dataset#columns}</li>
        388. 
+
      388.           *             <li>{@link patio.Dataset#remove}</li>
        389. 
+
      389.           *             <li>{@link patio.Dataset#forEach}</li>
        390. 
+
      390.           *             <li>{@link patio.Dataset#empty}</li>
        391. 
+
      391.           *             <li>{@link patio.Dataset#first}</li>
        392. 
+
      392.           *             <li>{@link patio.Dataset#get}</li>
        393. 
+
      393.           *             <li>{@link patio.Dataset#import}</li>
        394. 
+
      394.           *             <li>{@link patio.Dataset#insert}</li>
        395. 
+
      395.           *             <li>{@link patio.Dataset#save}</li>
        396. 
+
      396.           *             <li>{@link patio.Dataset#insertMultiple}</li>
        397. 
+
      397.           *             <li>{@link patio.Dataset#saveMultiple}</li>
        398. 
+
      398.           *             <li>{@link patio.Dataset#interval}</li>
        399. 
+
      399.           *             <li>{@link patio.Dataset#last}</li>
        400. 
+
      400.           *             <li>{@link patio.Dataset#map}</li>
        401. 
+
      401.           *             <li>{@link patio.Dataset#max}</li>
        402. 
+
      402.           *             <li>{@link patio.Dataset#min}</li>
        403. 
+
      403.           *             <li>{@link patio.Dataset#multiInsert}</li>
        404. 
+
      404.           *             <li>{@link patio.Dataset#range}</li>
        405. 
+
      405.           *             <li>{@link patio.Dataset#selectHash}</li>
        406. 
+
      406.           *             <li>{@link patio.Dataset#selectMap}</li>
        407. 
+
      407.           *             <li>{@link patio.Dataset#selectOrderMap}</li>
        408. 
+
      408.           *             <li>{@link patio.Dataset#set}</li>
        409. 
+
      409.           *             <li>{@link patio.Dataset#singleRecord}</li>
        410. 
+
      410.           *             <li>{@link patio.Dataset#singleValue}</li>
        411. 
+
      411.           *             <li>{@link patio.Dataset#sum}</li>
        412. 
+
      412.           *             <li>{@link patio.Dataset#toCsv}</li>
        413. 
+
      413.           *             <li>{@link patio.Dataset#toHash}</li>
        414. 
+
      414.           *             <li>{@link patio.Dataset#truncate}</li>
        415. 
+
      415.           *             <li>{@link patio.Dataset#update}</li>
        416. 
+
      416.           *         </ul>
        417. 
+
      417.           *
        418. 
+
      418.           *     </p>
        419. 
+
      419.           * </p>
        420. 
+
      420.           *
        421. 
+
      421.           * @constructs
        422. 
+
      422.           *
        423. 
+
      423.           *
        424. 
+
      424.           * @param {patio.Database} db the database this dataset should use when querying for data.
        425. 
+
      425.           * @param {Object} opts options to set on this dataset instance
        426. 
+
      426.           *
        427. 
+
      427.           * @property {Function} rowCb callback to be invoked for each row returned from the database.
        428. 
+
      428.           *                      the return value will be used as the result of query. The rowCb can also return a promise,
        429. 
+
      429.           *                      The resolved value of the promise will be used as result.
        430. 
+
      430.           *
        431. 
+
      431.           * @property {String} identifierInputMethod this is the method that will be called on each identifier returned from the database.
        432. 
+
      432.           *                                          This value will be defaulted to whatever the identifierInputMethod
        433. 
+
      433.           *                                          is on the database used in initialization.
        434. 
+
      434.           *
        435. 
+
      435.           * @property {String} identifierOutputMethod this is the method that will be called on each identifier sent to the database.
        436. 
+
      436.           *                                          This value will be defaulted to whatever the identifierOutputMethod
        437. 
+
      437.           *                                          is on the database used in initialization.
        438. 
+
      438.           * @property {String} firstSourceAlias The first source (primary table) for this dataset. If the table is aliased, returns the aliased name.
        439. 
+
      439.           *                                     throws a {patio.DatasetError} tf the dataset doesn't have a table.
        440. 
+
      440.           * <pre class="code">
        441. 
+
      441.           *   DB.from("table").firstSourceAlias;
        442. 
+
      442.           *   //=> "table"
        443. 
+
      443.           *
        444. 
+
      444.           *   DB.from("table___t").firstSourceAlias;
        445. 
+
      445.           *   //=> "t"
        446. 
+
      446.           * </pre>
        447. 
+
      447.           *
        448. 
+
      448.           * @property {String} firstSourceTable  The first source (primary table) for this dataset.  If the dataset doesn't
        449. 
+
      449.           *                                      have a table, raises a {@link patio.erros.DatasetError}.
        450. 
+
      450.           *<pre class="code">
        451. 
+
      451.           *
        452. 
+
      452.           *  DB.from("table").firstSourceTable;
        453. 
+
      453.           *         //=> "table"
        454. 
+
      454.           *
        455. 
+
      455.           *  DB.from("table___t").firstSourceTable;
        456. 
+
      456.           *         //=> "t"
        457. 
+
      457.           * </pre>
        458. 
+
      458.           * @property {Boolean} isSimpleSelectAll Returns true if this dataset is a simple SELECT * FROM {table}, otherwise false.
        459. 
+
      459.           * <pre class="code">
        460. 
+
      460.           *     DB.from("items").isSimpleSelectAll; //=> true
        461. 
+
      461.           *     DB.from("items").filter({a : 1}).isSimpleSelectAll; //=> false
        462. 
+
      462.           * </pre>
        463. 
+
      463.           * @property {boolean} [quoteIdentifiers=true]  Whether this dataset quotes identifiers.
        464. 
+
      464.           * @property {boolean} [providesAccurateRowsMatched=true] Whether this dataset will provide accurate number of rows matched for
        465. 
+
      465.           *   delete and update statements.  Accurate in this case is the number of
        466. 
+
      466.           *   rows matched by the dataset's filter.
        467. 
+
      467.           * @property {boolean} [requiresSqlStandardDate=false] Whether the dataset requires SQL standard datetimes (false by default,
        468. 
+
      468.           *                                                     as most allow strings with ISO 8601 format).
        469. 
+
      469.           * @property {boolean} [supportsCte=true] Whether the dataset supports common table expressions (the WITH clause).
        470. 
+
      470.           * @property {boolean} [supportsDistinctOn=false] Whether the dataset supports the DISTINCT ON clause, false by default.
        471. 
+
      471.           * @property {boolean} [supportsIntersectExcept=true] Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
        472. 
+
      472.           * @property {boolean} [supportsIntersectExceptAll=true] Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
        473. 
+
      473.           * @property {boolean} [supportsIsTrue=true] Whether the dataset supports the IS TRUE syntax.
        474. 
+
      474.           * @property {boolean} [supportsJoinUsing=true] Whether the dataset supports the JOIN table USING (column1, ...) syntax.
        475. 
+
      475.           * @property {boolean} [supportsModifyingJoin=false] Whether modifying joined datasets is supported.
        476. 
+
      476.           * @property {boolean} [supportsMultipleColumnIn=true] Whether the IN/NOT IN operators support multiple columns when an
        477. 
+
      477.           * @property {boolean} [supportsTimestampTimezone=false] Whether the dataset supports timezones in literal timestamps
        478. 
+
      478.           * @property {boolean} [supportsTimestampUsecs=true] Whether the dataset supports fractional seconds in literal timestamps
        479. 
+
      479.           * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions.
        480. 
+
      480.           * @property {patio.sql.Identifier[]} [sourceList=[]] a list of sources for this dataset.
        481. 
+
      481.           * @property {patio.sql.Identifier[]} [joinSourceList=[]] a list of join sources
        482. 
+
      482.           * @property {Boolean} hasSelectSource true if this dataset already has a select sources.
        483. 
+
      483.           */
        484. 
+
      484.          constructor:function (db, opts) {
        485. 
+
      485. 29216            this._super(arguments);
        486. 
+
      486. 29216            this.db = db;
        487. 
+
      487. 29216            this.__opts = {};
        488. 
+
      488. 29216            this.__rowCb = null;
        489. 
+
      489. 29216            if (db) {
        490. 
+
      490. 15039                this.__quoteIdentifiers = db.quoteIdentifiers;
        491. 
+
      491. 15039                this.__identifierInputMethod = db.identifierInputMethod;
        492. 
+
      492. 15039                this.__identifierOutputMethod = db.identifierOutputMethod;
        493. 
 
      493.              }
        494. 
-
      494.  
        495. 
-
      495. 648            return this._setDatasetOptions(ds);
        496. 
 
      496.          },
        497. 
 
      497.  
        498. 
-
      498.          __setValue:function (parent, model) {
        499. 
-
      499. 2061            parent.__associations[this.name] = this._fetchMethod
        500. 
-
      500.                  == "all" ? !isArray(model) ? [model] : model : isArray(model) ? model[0] : model;
        501. 
-
      501. 2061            return parent.__associations[this.name];
        502. 
-
      502.          },
        503. 
 
      503.  
        504. 
-
      504.          fetch:function (parent) {
        505. 
-
      505. 785            var ret = new Promise();
        506. 
-
      506. 785            if (this._checkAssociationKey(parent)) {
        507. 
-
      507. 733                this._filter(parent)[this._fetchMethod]().then(hitch(this, function (result) {
        508. 
-
      508. 733                    this.__setValue(parent, result);
        509. 
-
      509. 733                    ret.callback(result);
        510. 
-
      510. 733                    parent = null;
        511. 
-
      511.                  }), ret);
        512. 
-
      512.              } else {
        513. 
-
      513. 52                this.__setValue(parent, null);
        514. 
-
      514. 52                ret.callback(null);
        515. 
+
      515.          /**
        516. 
+
      516.           * Returns a new clone of the dataset with with the given options merged into the current datasets options.
        517. 
+
      517.           * If the options changed include options in {@link patio.dataset.Query#COLUMN_CHANGE_OPTS}, the cached
        518. 
+
      518.           * columns are deleted.  This method should generally not be called
        519. 
+
      519.           * directly by user code.
        520. 
+
      520.           *
        521. 
+
      521.           * @param {Object} opts options to merge into the curred datasets options and applied to the returned dataset.
        522. 
+
      522.           * @return [patio.Dataset] a cloned dataset with the merged options
        523. 
+
      523.           **/
        524. 
+
      524.          mergeOptions:function (opts) {
        525. 
+
      525. 14948            opts = isUndefined(opts) ? {} : opts;
        526. 
+
      526. 14948            var ds = new this._static(this.db, {});
        527. 
+
      527. 14948            ds.rowCb = this.rowCb;
        528. 
+
      528. 14948            this._static.FEATURES.forEach(function (f) {
        529. 
+
      529. 209272                ds[f] = this[f];
        530. 
+
      530.              }, this);
        531. 
+
      531. 14948            ds.__opts = merge({}, this.__opts, opts);
        532. 
+
      532. 14948            ds.identifierInputMethod = this.identifierInputMethod;
        533. 
+
      533. 14948            ds.identifierOutputMethod = this.identifierOutputMethod;
        534. 
+
      534. 14948            var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
        535. 
+
      535. 14948            if (Object.keys(opts).some(function (o) {
        536. 
+
      536. 13536                return columnChangeOpts.indexOf(o) != -1;
        537. 
+
      537.              })) {
        538. 
+
      538. 2456                ds.__opts.columns = null;
        539. 
 
      539.              }
        540. 
-
      540. 785            return ret;
        541. 
+
      541. 14948            return ds;
        542. 
 
      542.          },
        543. 
 
      543.  
        544. 
+
      544.  
        545. 
 
      545.          /**
        546. 
-
      546.           * Middleware called before a model is removed.
        547. 
-
      547.           * </br>
        548. 
-
      548.           * <b> This is called in the scope of the model</b>
        549. 
-
      549.           * @param {Function} next function to pass control up the middleware stack.
        550. 
-
      550.           * @param {_Association} self reference to the Association that is being acted up.
        551. 
+
      551.           * Converts a string to an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
        552. 
+
      552.           * or {@link patio.sql.AliasedExpression}, depending on the format:
        553. 
+
      553.           *
        554. 
+
      554.           * <ul>
        555. 
+
      555.           *      <li>For columns : table__column___alias.</li>
        556. 
+
      556.           *      <li>For tables : schema__table___alias.</li>
        557. 
+
      557.           * </ul>
        558. 
+
      558.           * each portion of the identifier is optional. See example below
        559. 
+
      559.           *
        560. 
+
      560.           * @example
        561. 
+
      561.           *
        562. 
+
      562.           * ds.stringToIdentifier("a") //= > new patio.sql.Identifier("a");
        563. 
+
      563.           * ds.stringToIdentifier("table__column"); //=> new patio.sql.QualifiedIdentifier(table, column);
        564. 
+
      564.           * ds.stringToIdentifier("table__column___alias");
        565. 
+
      565.           *      //=> new patio.sql.AliasedExpression(new patio.sql.QualifiedIdentifier(table, column), alias);
        566. 
+
      566.           *
        567. 
+
      567.           * @param {String} name the name to covert to an an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
        568. 
+
      568.           * or {@link patio.sql.AliasedExpression}.
        569. 
+
      569.           *
        570. 
+
      570.           * @return  {patio.sql.Identifier|patio.sql.QualifiedIdentifier|patio.sql.AliasedExpression} an identifier generated based on the name string.
        571. 
 
      571.           */
        572. 
-
      572.          _preRemove:function (next, model) {
        573. 
-
      573. 223            if (this.isOwner && !this.isCascading) {
        574. 
-
      574. 46                var q = {};
        575. 
-
      575. 46                this._setAssociationKeys(model, q, null);
        576. 
-
      576. 46                model[this.associatedDatasetName].update(q).classic(next);
        577. 
+
      577.          stringToIdentifier:function (name) {
        578. 
+
      578. 15093            if (isString(name)) {
        579. 
+
      579. 10138                var parts = this._splitString(name);
        580. 
+
      580. 10138                var schema = parts[0], table = parts[1], alias = parts[2];
        581. 
+
      581. 10138                return (schema && table && alias
        582. 
+
      582.                      ? new AliasedExpression(new QualifiedIdentifier(schema, table), alias)
        583. 
+
      583.                      : (schema && table
        584. 
+
      584.                      ? new QualifiedIdentifier(schema, table)
        585. 
+
      585.                      : (table && alias
        586. 
+
      586.                      ? new AliasedExpression(new Identifier(table), alias) : new Identifier(table))));
        587. 
 
      587.              } else {
        588. 
-
      588. 177                next();
        589. 
+
      589. 4955                return name;
        590. 
 
      590.              }
        591. 
 
      591.          },
        592. 
 
      592.  
        593. 
 
      593.          /**
        594. 
-
      594.           * Middleware called aft era model is removed.
        595. 
-
      595.           * </br>
        596. 
-
      596.           * <b> This is called in the scope of the model</b>
        597. 
-
      597.           * @param {Function} next function to pass control up the middleware stack.
        598. 
-
      598.           * @param {_Association} self reference to the Association that is being called.
        599. 
+
      599.           * Can either be a string or null.
        600. 
+
      600.           *
        601. 
+
      601.           *
        602. 
+
      602.           * @example
        603. 
+
      603.           * //columns
        604. 
+
      604.           *  table__column___alias //=> table.column as alias
        605. 
+
      605.           *  table__column //=> table.column
        606. 
+
      606.           *  //tables
        607. 
+
      607.           *  schema__table___alias //=> schema.table as alias
        608. 
+
      608.           *  schema__table //=> schema.table
        609. 
+
      609.           *
        610. 
+
      610.           * //name and alias
        611. 
+
      611.           * columnOrTable___alias //=> columnOrTable as alias
        612. 
+
      612.           *
        613. 
+
      613.           *
        614. 
+
      614.           *
        615. 
+
      615.           * @return {String[]} an array with the elements being:
        616. 
+
      616.           * <ul>
        617. 
+
      617.           *      <li>For columns :[table, column, alias].</li>
        618. 
+
      618.           *      <li>For tables : [schema, table, alias].</li>
        619. 
+
      619.           * </ul>
        620. 
 
      620.           */
        621. 
-
      621.          _postRemove:function (next, model) {
        622. 
-
      622. 514            next();
        623. 
+
      623.          _splitString:function (s) {
        624. 
+
      624. 19662            var ret, m;
        625. 
+
      625. 19662            if ((m = s.match(this._static.COLUMN_REF_RE1)) != null) {
        626. 
+
      626. 189                ret = m.slice(1);
        627. 
+
      627.              }
        628. 
+
      628. 19473            else if ((m = s.match(this._static.COLUMN_REF_RE2)) != null) {
        629. 
+
      629. 28                ret = [null, m[1], m[2]];
        630. 
+
      630.              }
        631. 
+
      631. 19445            else if ((m = s.match(this._static.COLUMN_REF_RE3)) != null) {
        632. 
+
      632. 2079                ret = [m[1], m[2], null];
        633. 
+
      633.              }
        634. 
+
      634.              else {
        635. 
+
      635. 17366                ret = [null, s, null];
        636. 
+
      636.              }
        637. 
+
      637. 19662            return ret;
        638. 
 
      638.          },
        639. 
 
      639.  
        640. 
 
      640.          /**
        641. 
-
      641.           * Middleware called before a model is saved.
        642. 
-
      642.           * </br>
        643. 
-
      643.           * <b> This is called in the scope of the model</b>
        644. 
-
      644.           * @param {Function} next function to pass control up the middleware stack.
        645. 
-
      645.           * @param {_Association} self reference to the Association that is being called.
        646. 
-
      646.           */
        647. 
-
      647.          _preSave:function (next, model) {
        648. 
-
      648. 324            next();
        649. 
-
      649.          },
        650. 
+
      650.           * @ignore
        651. 
+
      651.           **/
        652. 
+
      652.          getters:{
        653. 
 
      653.  
        654. 
-
      654.          /**
        655. 
-
      655.           * Middleware called after a model is saved.
        656. 
-
      656.           * </br>
        657. 
-
      657.           * <b> This is called in the scope of the model</b>
        658. 
-
      658.           * @param {Function} next function to pass control up the middleware stack.
        659. 
-
      659.           * @param {_Association} self reference to the Association that is being called.
        660. 
-
      660.           */
        661. 
-
      661.          _postSave:function (next, model) {
        662. 
-
      662. 198            next();
        663. 
-
      663.          },
        664. 
+
      664.              rowCb:function () {
        665. 
+
      665. 23052                return this.__rowCb;
        666. 
+
      666.              },
        667. 
 
      667.  
        668. 
-
      668.          /**
        669. 
-
      669.           * Middleware called before a model is updated.
        670. 
-
      670.           * </br>
        671. 
-
      671.           * <b> This is called in the scope of the model</b>
        672. 
-
      672.           * @param {Function} next function to pass control up the middleware stack.
        673. 
-
      673.           * @param {_Association} self reference to the Association that is being called.
        674. 
-
      674.           */
        675. 
-
      675.          _preUpdate:function (next, model) {
        676. 
-
      676. 2            next();
        677. 
-
      677.          },
        678. 
+
      678.              identifierInputMethod:function () {
        679. 
+
      679. 14948                return this.__identifierInputMethod;
        680. 
+
      680.              },
        681. 
 
      681.  
        682. 
-
      682.          /**
        683. 
-
      683.           * Middleware called before a model is updated.
        684. 
-
      684.           * </br>
        685. 
-
      685.           * <b> This is called in the scope of the model</b>
        686. 
-
      686.           * @param {Function} next function to pass control up the middleware stack.
        687. 
-
      687.           * @param {_Association} self reference to the Association that is being called.
        688. 
-
      688.           */
        689. 
-
      689.          _postUpdate:function (next, model) {
        690. 
-
      690. 127            next();
        691. 
-
      691.          },
        692. 
+
      692.              identifierOutputMethod:function () {
        693. 
+
      693. 14948                return this.__identifierOutputMethod;
        694. 
+
      694.              },
        695. 
 
      695.  
        696. 
-
      696.          /**
        697. 
-
      697.           * Middleware called before a model is loaded.
        698. 
-
      698.           * </br>
        699. 
-
      699.           * <b> This is called in the scope of the model</b>
        700. 
-
      700.           * @param {Function} next function to pass control up the middleware stack.
        701. 
-
      701.           * @param {_Association} self reference to the Association that is being called.
        702. 
-
      702.           */
        703. 
-
      703.          _preLoad:function (next, model) {
        704. 
-
      704. 1570            next();
        705. 
-
      705.          },
        706. 
+
      706.              firstSourceAlias:function () {
        707. 
+
      707. 579                var source = this.__opts.from;
        708. 
+
      708. 579                if (isUndefinedOrNull(source) || !source.length) {
        709. 
+
      709. 2                    throw new DatasetError("No source specified for the query");
        710. 
+
      710.                  }
        711. 
+
      711. 577                source = source[0];
        712. 
+
      712. 577                if (isInstanceOf(source, AliasedExpression)) {
        713. 
+
      713. 20                    return source.alias;
        714. 
+
      714. 557                } else if (isString(source)) {
        715. 
+
      715. 0                    var parts = this._splitString(source);
        716. 
+
      716. 0                    var alias = parts[2];
        717. 
+
      717. 0                    return alias ? alias : source;
        718. 
+
      718.                  } else {
        719. 
+
      719. 557                    return source;
        720. 
+
      720.                  }
        721. 
+
      721.              },
        722. 
 
      722.  
        723. 
-
      723.          /**
        724. 
-
      724.           * Middleware called after a model is loaded.
        725. 
-
      725.           * </br>
        726. 
-
      726.           * <b> This is called in the scope of the model</b>
        727. 
-
      727.           * @param {Function} next function to pass control up the middleware stack.
        728. 
-
      728.           * @param {_Association} self reference to the Association that is being called.
        729. 
-
      729.           */
        730. 
-
      730.          _postLoad:function (next, model) {
        731. 
-
      731. 0            next();
        732. 
-
      732.          },
        733. 
+
      733.              firstSourceTable:function () {
        734. 
+
      734. 15                var source = this.__opts.from;
        735. 
+
      735. 15                if (isUndefinedOrNull(source) || !source.length) {
        736. 
+
      736. 1                    throw new QueryError("No source specified for the query");
        737. 
+
      737.                  }
        738. 
+
      738. 14                var source = source[0];
        739. 
+
      739. 14                if (isInstanceOf(source, AliasedExpression)) {
        740. 
+
      740. 3                    return source.expression;
        741. 
+
      741. 11                } else if (isString(source)) {
        742. 
+
      742. 0                    var parts = this._splitString(source);
        743. 
+
      743. 0                    return source;
        744. 
+
      744.                  } else {
        745. 
+
      745. 11                    return source;
        746. 
+
      746.                  }
        747. 
+
      747.              },
        748. 
 
      748.  
        749. 
-
      749.          /**
        750. 
-
      750.           * Alias used to explicitly set an association on a model.
        751. 
-
      751.           * @param {*} val the value to set the association to
        752. 
-
      752.           * @param {_Association} self reference to the Association that is being called.
        753. 
-
      753.           */
        754. 
-
      754.          _setter:function (val, model) {
        755. 
-
      755. 0            model.__associations[this.name] = val;
        756. 
-
      756.          },
        757. 
+
      757.              sourceList:function () {
        758. 
+
      758. 0                return (this.__opts.from || []).map(this.stringToIdentifier, this);
        759. 
+
      759.              },
        760. 
 
      760.  
        761. 
-
      761.          associationLoaded:function (model) {
        762. 
-
      762. 2707            return model.__associations.hasOwnProperty(this.name);
        763. 
-
      763.          },
        764. 
+
      764.              joinSourceList:function () {
        765. 
+
      765. 0                return (this.__opts.join || []).map(function (join) {
        766. 
+
      766. 0                    return this.stringToIdentifier(join.tableAlias || join.table);
        767. 
+
      767.                  }, this);
        768. 
+
      768.              },
        769. 
 
      769.  
        770. 
-
      770.          getAssociation:function (model) {
        771. 
-
      771. 885            return model.__associations[this.name];
        772. 
+
      772.              hasSelectSource:function () {
        773. 
+
      773. 0                var select = this.__opts.select;
        774. 
+
      774. 0                return !(isUndefinedOrNull(select) || select.length === 0);
        775. 
+
      775.              }
        776. 
 
      776.          },
        777. 
 
      777.  
        778. 
 
      778.          /**
        779. 
-
      779.           * Alias used to explicitly get an association on a model.
        780. 
-
      780.           * @param {_Association} self reference to the Association that is being called.
        781. 
-
      781.           */
        782. 
-
      782.          _getter:function (model) {
        783. 
-
      783.              //if we have them return them;
        784. 
-
      784. 612            if (this.associationLoaded(model)) {
        785. 
-
      785. 220                var assoc = this.getAssociation(model);
        786. 
-
      786. 220                return this.isEager() ? assoc : new Promise().callback(assoc).promise();
        787. 
-
      787. 392            } else if (model.isNew) {
        788. 
-
      788. 0                return null;
        789. 
-
      789.              } else {
        790. 
-
      790. 392                return this.fetch(model);
        791. 
-
      791.              }
        792. 
-
      792.          },
        793. 
+
      793.           * @ignore
        794. 
+
      794.           **/
        795. 
+
      795.          setters:{
        796. 
+
      796.              /**@lends patio.Dataset.prototype*/
        797. 
 
      797.  
        798. 
-
      798.          _toModel:function (val, fromDb) {
        799. 
-
      799. 1412            var Model = this.model;
        800. 
-
      800. 1412            if (!isUndefinedOrNull(Model)) {
        801. 
-
      801. 1412                if (!isInstanceOf(val, Model)) {
        802. 
-
      802. 1167                    val = new this.model(val, fromDb);
        803. 
-
      803.                  }
        804. 
-
      804.              } else {
        805. 
-
      805. 0                throw new PatioError("Invalid model " + this.name);
        806. 
-
      806.              }
        807. 
-
      807. 1412            return val;
        808. 
-
      808.          },
        809. 
+
      809.              identifierInputMethod:function (meth) {
        810. 
+
      810. 15038                this.__identifierInputMethod = meth;
        811. 
+
      811.              },
        812. 
 
      812.  
        813. 
-
      813.          /**
        814. 
-
      814.           * Method to inject functionality into a model. This method alters the model
        815. 
-
      815.           * to prepare it for associations, and initializes all required middleware calls
        816. 
-
      816.           * to fulfill requirements needed to loaded the associations.
        817. 
-
      817.           *
        818. 
-
      818.           * @param {Model} parent the model that is having an associtaion set on it.
        819. 
-
      819.           * @param {String} name the name of the association.
        820. 
-
      820.           */
        821. 
-
      821.          inject:function (parent, name) {
        822. 
-
      822. 55            this.name = name;
        823. 
-
      823. 55            var self = this;
        824. 
-
      824. 55            this.parent = parent;
        825. 
-
      825. 55            parent.prototype.__defineGetter__(name, function () {
        826. 
-
      826. 612                return  self._getter(this);
        827. 
-
      827.              });
        828. 
-
      828. 55            parent.prototype.__defineGetter__(this.associatedDatasetName, function () {
        829. 
-
      829. 146                return  self._filter(this);
        830. 
-
      830.              });
        831. 
+
      831.              identifierOutputMethod:function (meth) {
        832. 
+
      832. 15038                this.__identifierOutputMethod = meth;
        833. 
+
      833.              },
        834. 
 
      834.  
        835. 
-
      835. 55            if (!this.readOnly && this.createSetter) {
        836. 
-
      836.                  //define a setter because we arent read only
        837. 
-
      837. 55                parent.prototype.__defineSetter__(name, function (vals) {
        838. 
-
      838. 139                    self._setter(vals, this);
        839. 
-
      839.                  });
        840. 
+
      840.              rowCb:function (cb) {
        841. 
+
      841. 18564                if (isFunction(cb) || isNull(cb)) {
        842. 
+
      842. 18559                    this.__rowCb = cb;
        843. 
+
      843.                  } else {
        844. 
+
      844. 5                    throw new DatasetError("rowCb mus be a function");
        845. 
+
      845.                  }
        846. 
 
      846.              }
        847. 
-
      847.  
        848. 
-
      848.              //set up all callbacks
        849. 
-
      849. 55            ["pre", "post"].forEach(function (op) {
        850. 
-
      850. 110                ["save", "update", "remove", "load"].forEach(function (type) {
        851. 
-
      851. 440                    parent[op](type, function (next) {
        852. 
-
      852. 5598                        return self["_" + op + type.charAt(0).toUpperCase() + type.slice(1)](next, this);
        853. 
-
      853.                      });
        854. 
-
      854.                  }, this);
        855. 
-
      855.              }, this);
        856. 
-
      856.          },
        857. 
-
      857.  
        858. 
-
      858.          getters:{
        859. 
-
      859.  
        860. 
-
      860.              select:function () {
        861. 
-
      861. 648                return this.__opts.select;
        862. 
-
      862.              },
        863. 
-
      863.  
        864. 
-
      864.              defaultLeftKey:function () {
        865. 
-
      865. 2841                var ret = "";
        866. 
-
      866. 2841                if (this.isOwner) {
        867. 
-
      867. 2095                    ret = this.__opts.primaryKey || this.parent.primaryKey[0]
        868. 
-
      868.                  } else {
        869. 
-
      869. 746                    ret = this.model.tableName + "Id";
        870. 
-
      870.                  }
        871. 
-
      871. 2841                return ret;
        872. 
-
      872.              },
        873. 
-
      873.  
        874. 
-
      874.              defaultRightKey:function () {
        875. 
-
      875. 2721                return this.associatedModelKey;
        876. 
-
      876.              },
        877. 
-
      877.  
        878. 
-
      878.              //Returns our model
        879. 
-
      879.              model:function () {
        880. 
-
      880. 10572                return this.patio.getModel(this._model, this.parent.db);
        881. 
-
      881.              },
        882. 
-
      882.  
        883. 
-
      883.              associatedModelKey:function () {
        884. 
-
      884. 2721                var ret = "";
        885. 
-
      885. 2721                if (this.isOwner) {
        886. 
-
      886. 1857                    ret = this.__opts.primaryKey || this.parent.tableName + "Id";
        887. 
-
      887.                  } else {
        888. 
-
      888. 864                    ret = this.model.primaryKey[0];
        889. 
-
      889.                  }
        890. 
-
      890. 2721                return ret;
        891. 
-
      891.              },
        892. 
-
      892.  
        893. 
-
      893.              associatedDatasetName:function () {
        894. 
-
      894. 201                return this.name + "Dataset"
        895. 
-
      895.              },
        896. 
-
      896.  
        897. 
-
      897.              removeAssociationFlagName:function () {
        898. 
-
      898. 27                return "__remove" + this.name + "association"
        899. 
-
      899.              }
        900. 
-
      900.  
        901. 
-
      901.          }
        902. 
-
      902.      },
        903. 
+
      903.          }
        904. 
+
      904.      },
        905. 
 
      905.  
        906. 
 
      906.      static:{
        907. 
-
      907.          /**@lends patio.associations.Association*/
        908. 
-
      908.  
        909. 
-
      909.          fetch:{
        910. 
-
      910.  
        911. 
-
      911.              LAZY:"lazy",
        912. 
-
      912.  
        913. 
-
      913.              EAGER:"eager"
        914. 
-
      914.          }
        915. 
+
      915.          COLUMN_REF_RE1:/^(\w+)__(\w+)___(\w+)$/,
        916. 
+
      916.          COLUMN_REF_RE2:/^(\w+)___(\w+)$/,
        917. 
+
      917.          COLUMN_REF_RE3:/^(\w+)__(\w+)$/
        918. 
 
      918.      }
        919. 
-
      919.  }).as(module);
      
+
    3.  }).as(module);
      4. 
+
    4.  
      5. 
+
    5.
    -
    +
    -
    model.js
    +
    associations/_Association.js
    - Coverage88.51 - SLOC1067 - LOC322 - Missed37 + Coverage87.18 + SLOC515 + LOC156 + Missed20
    - 
    1. 1var comb = require("comb"),
      2. 
-
    2.      isFunction = comb.isFunction,
      3. 
+    
      1. 1var comb = require("comb-proxy"),
        2. 
+
      2.      define = comb.define,
        3. 
 
      3.      isUndefined = comb.isUndefined,
        4. 
-
      4.      isDefined = comb.isDefined,
        5. 
+
      5.      isUndefinedOrNull = comb.isUndefinedOrNull,
        6. 
 
      6.      isBoolean = comb.isBoolean,
        7. 
 
      7.      isString = comb.isString,
        8. 
-
      8.      argsToArray = comb.argsToArray,
        9. 
-
      9.      isInstanceOf = comb.isInstanceOf,
        10. 
-
      10.      serial = comb.serial,
        11. 
 
      11.      isHash = comb.isHash,
        12. 
-
      12.      when = comb.when,
        13. 
-
      13.      merge = comb.merge,
        14. 
-
      14.      toArray = comb.array.toArray,
        15. 
-
      15.      ModelError = require("./errors").ModelError,
        16. 
-
      16.      plugins = require("./plugins"),
        17. 
-
      17.      isUndefinedOrNull = comb.isUndefinedOrNull,
        18. 
-
      18.      AssociationPlugin = plugins.AssociationPlugin,
        19. 
-
      19.      QueryPlugin = plugins.QueryPlugin,
        20. 
+
      20.      isFunction = comb.isFunction,
        21. 
+
      21.      isInstanceOf = comb.isInstanceOf,
        22. 
 
      22.      Promise = comb.Promise,
        23. 
 
      23.      PromiseList = comb.PromiseList,
        24. 
-
      24.      HashTable = comb.collections.HashTable,
        25. 
 
      25.      hitch = comb.hitch,
        26. 
-
      26.      hitchIgnore = comb.hitchIgnore,
        27. 
+
      27.      array = comb.array,
        28. 
+
      28.      isArray = comb.isArray,
        29. 
 
      29.      Middleware = comb.plugins.Middleware,
        30. 
-
      30.      EventEmitter = require("events").EventEmitter,
        31. 
-
      31.      util = require("util"),
        32. 
-
      32.      define = comb.define,
        33. 
-
      33.      patio;
        34. 
-
      34.  
        35. 
-
      35.  
        36. 
-
      36. 1var MODELS = new HashTable();
        37. 
+
      37.      PatioError = require("../errors").PatioError;
        38. 
 
      38.  
        39. 
-
      39. 1var applyColumnTransformMethod = function (val, meth) {
        40. 
-
      40. 11464    return !isUndefinedOrNull(meth) ? isFunction(val[meth]) ? val[meth] : isFunction(comb[meth]) ? comb[meth](val) : val : val;
        41. 
+
      41. 1var fetch = {
        42. 
+
      42.      LAZY:"lazy",
        43. 
+
      43.      EAGER:"eager"
        44. 
 
      44.  };
        45. 
 
      45.  
        46. 
-
      46. 1var checkAndTransformName = function (name) {
        47. 
-
      47. 10693    return isString(name) ? applyColumnTransformMethod(name, Model.camelize === true ? "camelize" : Model.underscore === true ? "underscore" : null) : name;
        48. 
-
      48.  };
        49. 
 
      49.  
        50. 
-
      50. 1var Model = define([QueryPlugin, Middleware], {
        51. 
+
      51.  /**
        52. 
+
      52.   * @class
        53. 
+
      53.   * Base class for all associations.
        54. 
+
      54.   *
        55. 
+
      55.   * </br>
        56. 
+
      56.   * <b>NOT to be instantiated directly</b>
        57. 
+
      57.   * Its just documented for reference.
        58. 
+
      58.   *
        59. 
+
      59.   * @constructs
        60. 
+
      60.   * @param {Object} options
        61. 
+
      61.   * @param {String} options.model a string to look up the model that we are associated with
        62. 
+
      62.   * @param {Function} options.filter  a callback to find association if a filter is defined then
        63. 
+
      63.   *                                    the association is read only
        64. 
+
      64.   * @param {Object} options.key object with left key and right key
        65. 
+
      65.   * @param {String|Object} options.orderBy<String|Object> - how to order our association @see Dataset.order
        66. 
+
      66.   * @param {fetch.EAGER|fetch.LAZY} options.fetchType the fetch type of the model if fetch.Eager is supplied then
        67. 
+
      67.   *                                    the associations are automatically filled, if fetch.Lazy is supplied
        68. 
+
      68.   *                                    then a promise is returned and is called back with the loaded models
        69. 
+
      69.   * @property {Model} model the model associatied with this association.
        70. 
+
      70.   * @name Association
        71. 
+
      71.   * @memberOf patio.associations
        72. 
+
      72.   * */
        73. 
+
      73. 1define(Middleware, {
        74. 
 
      74.      instance:{
        75. 
+
      75.          /**@lends patio.associations.Association.prototype*/
        76. 
+
      76.  
        77. 
+
      77.          type:"",
        78. 
+
      78.  
        79. 
+
      79.          //Our associated model
        80. 
+
      80.          _model:null,
        81. 
+
      81.  
        82. 
 
      82.          /**
        83. 
-
      83.           * @lends patio.Model.prototype
        84. 
+
      84.           * Fetch type
        85. 
 
      85.           */
        86. 
+
      86.          fetchType:fetch.LAZY,
        87. 
 
      87.  
        88. 
-
      88.          __ignore:false,
        89. 
+
      89.          /**how to order our association*/
        90. 
+
      90.          orderBy:null,
        91. 
 
      91.  
        92. 
-
      92.          __changed:null,
        93. 
+
      93.          /**Our filter method*/
        94. 
+
      94.          filter:null,
        95. 
 
      95.  
        96. 
-
      96.          __values:null,
        97. 
+
      97.          __hooks:null,
        98. 
 
      98.  
        99. 
-
      99.          /**
        100. 
-
      100.           * patio  - read only
        101. 
-
      101.           *
        102. 
-
      102.           * @type patio
        103. 
-
      103.           */
        104. 
-
      104.          patio:null,
        105. 
+
      105.          isOwner:true,
        106. 
+
      106.  
        107. 
+
      107.          createSetter:true,
        108. 
+
      108.  
        109. 
+
      109.          isCascading:false,
        110. 
+
      110.  
        111. 
+
      111.          supportsStringKey:true,
        112. 
+
      112.  
        113. 
+
      113.          supportsHashKey:true,
        114. 
+
      114.  
        115. 
+
      115.          supportsCompositeKey:true,
        116. 
+
      116.  
        117. 
+
      117.          supportsLeftAndRightKey:true,
        118. 
 
      118.  
        119. 
 
      119.          /**
        120. 
-
      120.           * The database type such as mysql
        121. 
-
      121.           *
        122. 
-
      122.           * @type String
        123. 
 
      123.           *
        124. 
-
      124.           * */
        125. 
-
      125.          type:null,
        126. 
+
      126.           *Method to call to look up association,
        127. 
+
      127.           *called after the model has been filtered
        128. 
+
      128.           **/
        129. 
+
      129.          _fetchMethod:"all",
        130. 
 
      130.  
        131. 
-
      131.          /**
        132. 
-
      132.           * Whether or not this model is new
        133. 
-
      133.           * */
        134. 
-
      134.          __isNew:true,
        135. 
 
      135.  
        136. 
-
      136.          /**
        137. 
-
      137.           * Signifies if the model has changed
        138. 
-
      138.           * */
        139. 
-
      139.          __isChanged:false,
        140. 
+
      140.          constructor:function (options, patio, filter) {
        141. 
+
      141. 55            options = options || {};
        142. 
+
      142. 55            if (!options.model) {
        143. 
+
      143. 0                throw new Error("Model is required for " + this.type + " association");
        144. 
+
      144.              }
        145. 
+
      145. 55            this._model = options.model;
        146. 
+
      146. 55            this.patio = patio;
        147. 
+
      147. 55            this.__opts = options;
        148. 
+
      148. 55            !isUndefined(options.isCascading) && (this.isCascading = options.isCascading);
        149. 
+
      149. 55            this.filter = filter;
        150. 
+
      150. 55            this.readOnly = isBoolean(options.readOnly) ? options.readOnly : false;
        151. 
+
      151. 55            this.__hooks =
        152. 
+
      152.              {before:{add:null, remove:null, "set":null, load:null}, after:{add:null, remove:null, "set":null, load:null}};
        153. 
+
      153. 55            var hooks = ["Add", "Remove", "Set", "Load"];
        154. 
+
      154. 55            ["before", "after"].forEach(function (h) {
        155. 
+
      155. 110                hooks.forEach(function (a) {
        156. 
+
      156. 440                    var hookName = h + a, hook;
        157. 
+
      157. 440                    if (isFunction((hook = options[hookName]))) {
        158. 
+
      158. 0                        this.__hooks[h][a.toLowerCase()] = hook;
        159. 
+
      159.                      }
        160. 
+
      160.                  }, this);
        161. 
+
      161.              }, this);
        162. 
+
      162. 55            this.fetchType = options.fetchType || fetch.LAZY;
        163. 
+
      163.          },
        164. 
+
      164.  
        165. 
+
      165.          _callHook:function (hook, action, args) {
        166. 
+
      166. 0            var func = this.__hooks[hook][action], ret;
        167. 
+
      167. 0            if (isFunction(func)) {
        168. 
+
      168. 0                ret = func.apply(this, args);
        169. 
+
      169.              }
        170. 
+
      170. 0            return ret;
        171. 
+
      171.          },
        172. 
+
      172.  
        173. 
+
      173.          _clearAssociations:function (model) {
        174. 
+
      174. 125            if (!this.readOnly) {
        175. 
+
      175. 125                delete model.__associations[this.name];
        176. 
+
      176.              }
        177. 
+
      177.          },
        178. 
+
      178.  
        179. 
+
      179.          _forceReloadAssociations:function (model) {
        180. 
+
      180. 243            if (!this.readOnly) {
        181. 
+
      181. 243                delete model.__associations[this.name];
        182. 
+
      182. 243                return model[this.name];
        183. 
+
      183.              }
        184. 
+
      184.          },
        185. 
 
      185.  
        186. 
 
      186.          /**
        187. 
-
      187.           * Base class for all models.
        188. 
-
      188.           * <p>This is used through {@link patio.addModel}, <b>NOT directly.</b></p>
        189. 
-
      189.           *
        190. 
-
      190.           * @constructs
        191. 
-
      191.           * @augments comb.plugins.Middleware
        192. 
-
      192.           *
        193. 
-
      193.           * @param {Object} columnValues values of each column to be used by this Model.
        194. 
-
      194.           *
        195. 
-
      195.           * @property {patio.Dataset} dataset a dataset to use to retrieve models from the database. The dataset
        196. 
-
      196.           *                          has the {@link patio.Dataset#rowCb} set to create instances of this model.
        197. 
-
      197.           * @property {String[]} columns a list of columns this models table contains.
        198. 
-
      198.           * @property {Object} schema the schema of this models table.
        199. 
-
      199.           * @property {String} tableName the table name of this models table.
        200. 
-
      200.           * @property {*} primaryKeyValue the value of this models primaryKey
        201. 
-
      201.           * @property {Boolean} isNew true if this model is new and does not exist in the database.
        202. 
-
      202.           * @property {Boolean} isChanged true if the model has been changed and not saved.
        203. 
-
      203.           *
        204. 
-
      204.           * @borrows patio.Dataset#all as all
        205. 
-
      205.           * @borrows patio.Dataset#one as one
        206. 
-
      206.           * @borrows patio.Dataset#avg as avg
        207. 
-
      207.           * @borrows patio.Dataset#count as count
        208. 
-
      208.           * @borrows patio.Dataset#columns as columns
        209. 
-
      209.           * @borrows patio.Dataset#forEach as forEach
        210. 
-
      210.           * @borrows patio.Dataset#isEmpty as empty
        211. 
-
      211.           * @borrows patio.Dataset#first as first
        212. 
-
      212.           * @borrows patio.Dataset#get as get
        213. 
-
      213.           * @borrows patio.Dataset#import as import
        214. 
-
      214.           * @borrows patio.Dataset#insert as insert
        215. 
-
      215.           * @borrows patio.Dataset#insertMultiple as insertMultiple
        216. 
-
      216.           * @borrows patio.Dataset#saveMultiple as saveMultiple
        217. 
-
      217.           * @borrows patio.Dataset#interval as interval
        218. 
-
      218.           * @borrows patio.Dataset#last as last
        219. 
-
      219.           * @borrows patio.Dataset#map as map
        220. 
-
      220.           * @borrows patio.Dataset#max as max
        221. 
-
      221.           * @borrows patio.Dataset#min as min
        222. 
-
      222.           * @borrows patio.Dataset#multiInsert as multiInsert
        223. 
-
      223.           * @borrows patio.Dataset#range as range
        224. 
-
      224.           * @borrows patio.Dataset#selectHash as selectHash
        225. 
-
      225.           * @borrows patio.Dataset#selectMap as selectMap
        226. 
-
      226.           * @borrows patio.Dataset#selectOrderMap as selectOrderMap
        227. 
-
      227.           * @borrows patio.Dataset#set as set
        228. 
-
      228.           * @borrows patio.Dataset#singleRecord as singleRecord
        229. 
-
      229.           * @borrows patio.Dataset#singleValue as singleValue
        230. 
-
      230.           * @borrows patio.Dataset#sum as sum
        231. 
-
      231.           * @borrows patio.Dataset#toCsv as toCsv
        232. 
-
      232.           * @borrows patio.Dataset#toHash as toHash
        233. 
-
      233.           * @borrows patio.Dataset#truncate as truncate
        234. 
-
      234.           * @borrows patio.Dataset#addGraphAliases as addGraphAliases
        235. 
-
      235.           * @borrows patio.Dataset#and as and
        236. 
-
      236.           * @borrows patio.Dataset#distinct as distinct
        237. 
-
      237.           * @borrows patio.Dataset#except as except
        238. 
-
      238.           * @borrows patio.Dataset#exclude as exclude
        239. 
-
      239.           * @borrows patio.Dataset#is as is
        240. 
-
      240.           * @borrows patio.Dataset#isNot as isNot
        241. 
-
      241.           * @borrows patio.Dataset#eq as eq
        242. 
-
      242.           * @borrows patio.Dataset#neq as neq
        243. 
-
      243.           * @borrows patio.Dataset#lt as lt
        244. 
-
      244.           * @borrows patio.Dataset#lte as lte
        245. 
-
      245.           * @borrows patio.Dataset#gt as gt
        246. 
-
      246.           * @borrows patio.Dataset#gte as gte
        247. 
-
      247.           * @borrows patio.Dataset#forUpdate as forUpdate
        248. 
-
      248.           * @borrows patio.Dataset#from as from
        249. 
-
      249.           * @borrows patio.Dataset#fromSelf as fromSelf
        250. 
-
      250.           * @borrows patio.Dataset#graph as graph
        251. 
-
      251.           * @borrows patio.Dataset#grep as grep
        252. 
-
      252.           * @borrows patio.Dataset#group as group
        253. 
-
      253.           * @borrows patio.Dataset#groupAndCount as groupAndCount
        254. 
-
      254.           * @borrows patio.Dataset#groupBy as groupBy
        255. 
-
      255.           * @borrows patio.Dataset#having as having
        256. 
-
      256.           * @borrows patio.Dataset#intersect as intersect
        257. 
-
      257.           * @borrows patio.Dataset#invert as invert
        258. 
-
      258.           * @borrows patio.Dataset#limit as limit
        259. 
-
      259.           * @borrows patio.Dataset#lockStyle as lockStyle
        260. 
-
      260.           * @borrows patio.Dataset#naked as naked
        261. 
-
      261.           * @borrows patio.Dataset#or as or
        262. 
-
      262.           * @borrows patio.Dataset#order as order
        263. 
-
      263.           * @borrows patio.Dataset#orderAppend as orderAppend
        264. 
-
      264.           * @borrows patio.Dataset#orderBy as orderBy
        265. 
-
      265.           * @borrows patio.Dataset#orderMore as orderMore
        266. 
-
      266.           * @borrows patio.Dataset#orderPrepend as orderPrepend
        267. 
-
      267.           * @borrows patio.Dataset#qualify as qualify
        268. 
-
      268.           * @borrows patio.Dataset#reverse as reverse
        269. 
-
      269.           * @borrows patio.Dataset#reverseOrder as reverseOrder
        270. 
-
      270.           * @borrows patio.Dataset#select as select
        271. 
-
      271.           * @borrows patio.Dataset#selectAll as selectAll
        272. 
-
      272.           * @borrows patio.Dataset#selectAppend as selectAppend
        273. 
-
      273.           * @borrows patio.Dataset#selectMore as selectMore
        274. 
-
      274.           * @borrows patio.Dataset#setDefaults as setDefaults
        275. 
-
      275.           * @borrows patio.Dataset#setGraphAliases as setGraphAliases
        276. 
-
      276.           * @borrows patio.Dataset#setOverrides as setOverrides
        277. 
-
      277.           * @borrows patio.Dataset#unfiltered as unfiltered
        278. 
-
      278.           * @borrows patio.Dataset#ungraphed as ungraphed
        279. 
-
      279.           * @borrows patio.Dataset#ungrouped as ungrouped
        280. 
-
      280.           * @borrows patio.Dataset#union as union
        281. 
-
      281.           * @borrows patio.Dataset#unlimited as unlimited
        282. 
-
      282.           * @borrows patio.Dataset#unordered as unordered
        283. 
-
      283.           * @borrows patio.Dataset#where as where
        284. 
-
      284.           * @borrows patio.Dataset#with as with
        285. 
-
      285.           * @borrows patio.Dataset#withRecursive as withRecursive
        286. 
-
      286.           * @borrows patio.Dataset#withSql as withSql
        287. 
-
      287.           * @borrows patio.Dataset#naturalJoin as naturalJoin
        288. 
-
      288.           * @borrows patio.Dataset#naturalLeftJoin as naturalLeftJoin
        289. 
-
      289.           * @borrows patio.Dataset#naturalRightJoin as naturalRightJoin
        290. 
-
      290.           * @borrows patio.Dataset#naturalFullJoin as naturalFullJoin
        291. 
-
      291.           * @borrows patio.Dataset#crossJoin as crossJoin
        292. 
-
      292.           * @borrows patio.Dataset#innerJoin as innerJoin
        293. 
-
      293.           * @borrows patio.Dataset#fullOuterJoin as fullOuterJoin
        294. 
-
      294.           * @borrows patio.Dataset#rightOuterJoin as rightOuterJoin
        295. 
-
      295.           * @borrows patio.Dataset#leftOuterJoin as leftOuterJoin
        296. 
-
      296.           * @borrows patio.Dataset#fullJoin as fullJoin
        297. 
-
      297.           * @borrows patio.Dataset#rightJoin as rightJoin
        298. 
-
      298.           * @borrows patio.Dataset#leftJoin as leftJoin
        299. 
-
      299.           * */
        300. 
-
      300.          constructor:function (options, fromDb) {
        301. 
-
      301. 3111            if (this.synced) {
        302. 
-
      302. 3111                this.__emitter = new EventEmitter();
        303. 
-
      303. 3111                this._super(arguments);
        304. 
-
      304. 3111                this.patio = patio || require("./index");
        305. 
-
      305. 3111                fromDb = isBoolean(fromDb) ? fromDb : false;
        306. 
-
      306. 3111                this.__changed = {};
        307. 
-
      307. 3111                this.__values = {};
        308. 
-
      308. 3111                if (fromDb) {
        309. 
-
      309. 1754                    this._hook("pre", "load");
        310. 
-
      310. 1754                    this.__isNew = false;
        311. 
-
      311. 1754                    this.__setFromDb(options, true);
        312. 
-
      312. 1754                    if (this._static.emitOnLoad) {
        313. 
-
      313. 1754                        this.emit("load", this);
        314. 
-
      314. 1754                        this._static.emit("load", this);
        315. 
-
      315.                      }
        316. 
-
      316.                  } else {
        317. 
-
      317. 1357                    this.__isNew = true;
        318. 
-
      318. 1357                    this.__set(options);
        319. 
-
      319.                  }
        320. 
-
      320.              } else {
        321. 
-
      321. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
        322. 
-
      322.              }
        323. 
+
      323.           * @return {Boolean} true if the association is eager.
        324. 
+
      324.           */
        325. 
+
      325.          isEager:function () {
        326. 
+
      326. 2114            return this.fetchType == fetch.EAGER;
        327. 
 
      327.          },
        328. 
 
      328.  
        329. 
-
      329.          __set:function (values, ignore) {
        330. 
-
      330. 1479            values = values || {};
        331. 
-
      331. 1479            this.__ignore = ignore === true;
        332. 
-
      332. 1479            Object.keys(values).forEach(function (attribute) {
        333. 
-
      333. 6632                var value = values[attribute];
        334. 
-
      334.                  //check if the column is a constrained value and is allowed to be set
        335. 
-
      335. 6632                !ignore && this._checkIfColumnIsConstrained(attribute);
        336. 
-
      336. 6632                this[attribute] = value;
        337. 
-
      337.              }, this);
        338. 
-
      338. 1479            this.__ignore = false;
        339. 
+
      339.          _checkAssociationKey:function (parent) {
        340. 
+
      340. 785            var q = {};
        341. 
+
      341. 785            this._setAssociationKeys(parent, q);
        342. 
+
      342. 785            return Object.keys(q).every(function (k) {
        343. 
+
      343. 785                return q[k] != null
        344. 
+
      344.              });
        345. 
 
      345.          },
        346. 
 
      346.  
        347. 
-
      347.          __setFromDb:function (values, ignore) {
        348. 
-
      348. 3057            values = values || {};
        349. 
-
      349. 3057            this.__ignore = ignore === true;
        350. 
-
      350. 3057            var schema = this.schema;
        351. 
-
      351. 3057            Object.keys(values).forEach(function (column) {
        352. 
-
      352. 25150                var value = values[column];
        353. 
-
      353.                  // Typecast value retrieved from db
        354. 
-
      354. 25150                if (schema.hasOwnProperty(column)) {
        355. 
-
      355. 25149                    this.__values[column] = this._typeCastValue(column, value, ignore);
        356. 
-
      356.                  } else {
        357. 
-
      357. 1                    console.log(column);
        358. 
-
      358. 1                    this[column] = value;
        359. 
+
      359.          _getAssociationKey:function () {
        360. 
+
      360. 5205            var options = this.__opts, key, ret = [], lk, rk;
        361. 
+
      361. 5205            if (!isUndefinedOrNull((key = options.key))) {
        362. 
+
      362. 722                if (this.supportsStringKey && isString(key)) {
        363. 
+
      363.                      //normalize the key first!
        364. 
+
      364. 356                    ret = [
        365. 
+
      365.                          [this.isOwner ? this.defaultLeftKey : key],
        366. 
+
      366.                          [this.isOwner ? key : this.defaultRightKey]
        367. 
+
      367.                      ];
        368. 
+
      368. 366                } else if (this.supportsHashKey && isHash(key)) {
        369. 
+
      369. 366                    var leftKey = Object.keys(key)[0];
        370. 
+
      370. 366                    var rightKey = key[leftKey];
        371. 
+
      371. 366                    ret = [
        372. 
+
      372.                          [leftKey],
        373. 
+
      373.                          [rightKey]
        374. 
+
      374.                      ];
        375. 
+
      375. 0                } else if (this.supportsCompositeKey && isArray(key)) {
        376. 
+
      376. 0                    ret = [
        377. 
+
      377.                          [key],
        378. 
+
      378.                          null
        379. 
+
      379.                      ];
        380. 
 
      380.                  }
        381. 
-
      381.              }, this);
        382. 
-
      382. 3057            this.__ignore = false;
        383. 
-
      383.  
        384. 
+
      384. 4483            } else if (this.supportsLeftAndRightKey && (!isUndefinedOrNull((lk = options.leftKey))
        385. 
+
      385.                  && !isUndefinedOrNull((rk = options.rightKey)))) {
        386. 
+
      386. 140                ret = [
        387. 
+
      387.                      array.toArray(lk), array.toArray(rk)
        388. 
+
      388.                  ];
        389. 
+
      389.              } else {
        390. 
+
      390.                  //todo handle composite primary keys
        391. 
+
      391. 4343                ret = [
        392. 
+
      392.                      [this.defaultLeftKey],
        393. 
+
      393.                      [this.defaultRightKey]
        394. 
+
      394.                  ];
        395. 
+
      395.              }
        396. 
+
      396. 5205            return ret;
        397. 
 
      397.          },
        398. 
 
      398.  
        399. 
-
      399.          /**
        400. 
-
      400.           * Set multiple values at once. Useful if you have a hash of properties that you want to set.
        401. 
-
      401.           *
        402. 
-
      402.           * <b>NOTE:</b> This method will use the static restrictedColumns property of the model.
        403. 
-
      403.           *
        404. 
-
      404.           * @example
        405. 
-
      405.           *
        406. 
-
      406.           * myModel.setValues({firstName : "Bob", lastName : "yukon"});
        407. 
-
      407.           *
        408. 
-
      408.           * //this will throw an error by default, assuming id is a pk.
        409. 
-
      409.           * myModel.setValues({id : 1, firstName : "Bob", lastName : "yukon"});
        410. 
-
      410.           *
        411. 
-
      411.           * @param {Object} values value to set on the model.
        412. 
-
      412.           *
        413. 
-
      413.           * @return {patio.Model} return this for chaining.
        414. 
-
      414.           */
        415. 
-
      415.          setValues:function (values) {
        416. 
-
      416. 17            this.__set(values, false);
        417. 
-
      417. 17            return this;
        418. 
-
      418.          },
        419. 
 
      419.  
        420. 
-
      420.          _toObject:function () {
        421. 
-
      421. 1124            if (this.synced) {
        422. 
-
      422. 1124                var columns = this._static.columns, ret = {};
        423. 
-
      423. 1124                for (var i in columns) {
        424. 
-
      424. 10220                    var col = columns[i];
        425. 
-
      425. 10220                    var val = this.__values[col];
        426. 
-
      426. 10220                    if (!isUndefined(val)) {
        427. 
-
      427. 6169                        ret[col] = val;
        428. 
-
      428.                      }
        429. 
+
      429.          _setAssociationKeys:function (parent, model, val) {
        430. 
+
      430. 1573            var keys = this._getAssociationKey(parent), leftKey = keys[0], rightKey = keys[1];
        431. 
+
      431. 1573            if (leftKey && rightKey) {
        432. 
+
      432. 1573                for (var i = 0; i < leftKey.length; i++) {
        433. 
+
      433. 1573                    model[rightKey[i]] = !isUndefined(val) ? val : parent[leftKey[i]];
        434. 
 
      434.                  }
        435. 
-
      435. 1124                return ret;
        436. 
 
      436.              } else {
        437. 
-
      437. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
        438. 
+
      438. 0                leftKey.forEach(function (k) {
        439. 
+
      439. 0                    model[k] = !isUndefined(val) ? val : parent[k];
        440. 
+
      440.                  });
        441. 
 
      441.              }
        442. 
 
      442.          },
        443. 
 
      443.  
        444. 
-
      444.          _addColumnToIsChanged:function (name, val) {
        445. 
-
      445. 7556            if (!this.isNew && !this.__ignore) {
        446. 
-
      446. 165                this.__isChanged = true;
        447. 
-
      447. 165                this.__changed[name] = val;
        448. 
+
      448.          _setDatasetOptions:function (ds) {
        449. 
+
      449. 974            var options = this.__opts || {};
        450. 
+
      450. 974            var order, limit, distinct, select, query;
        451. 
+
      451.              //allow for multi key ordering
        452. 
+
      452. 974            if (!isUndefined((select = this.select))) {
        453. 
+
      453. 0                ds = ds.select.apply(ds, array.toArray(select));
        454. 
 
      454.              }
        455. 
-
      455.          },
        456. 
-
      456.  
        457. 
-
      457.          _checkIfColumnIsConstrained:function (name) {
        458. 
-
      458. 6632            if (this.synced && !this.__ignore) {
        459. 
-
      459. 6632                var col = this.schema[name], restrictedCols = this._static.restrictedColumns || [];
        460. 
-
      460. 6632                if (!isUndefined(col) && (col.primaryKey && this._static.isRestrictedPrimaryKey) || restrictedCols.indexOf(name) != -1) {
        461. 
-
      461. 0                    throw new ModelError("Cannot set primary key of model " + this._static.tableName);
        462. 
+
      462. 974            if (!isUndefined((query = options.query)) || !isUndefined((query = options.conditions))) {
        463. 
+
      463. 0                ds = ds.filter(query);
        464. 
+
      464.              }
        465. 
+
      465. 974            if (isFunction(this.filter)) {
        466. 
+
      466. 334                var ret = this.filter.apply(this, [ds]);
        467. 
+
      467. 334                if (isInstanceOf(ret, ds._static)) {
        468. 
+
      468. 334                    ds = ret;
        469. 
 
      469.                  }
        470. 
 
      470.              }
        471. 
-
      471.          },
        472. 
-
      472.  
        473. 
-
      473.          _getColumnValue:function (name) {
        474. 
-
      474. 5427            var val = this.__values[name];
        475. 
-
      475. 5427            var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
        476. 
-
      476. 5427            var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
        477. 
+
      477. 974            if (!isUndefined((distinct = options.distinct))) {
        478. 
+
      478. 0                ds = ds.limit.apply(ds, array.toArray(distinct));
        479. 
+
      479.              }
        480. 
+
      480. 974            if (!isUndefined((order = options.orderBy)) || !isUndefined((order = options.order))) {
        481. 
+
      481. 0                ds = ds.order.apply(ds, array.toArray(order));
        482. 
+
      482.              }
        483. 
+
      483. 974            if (!isUndefined((limit = options.limit))) {
        484. 
+
      484. 0                ds = ds.limit.apply(ds, array.toArray(limit));
        485. 
+
      485.              }
        486. 
+
      486. 974            return ds;
        487. 
 
      487.  
        488. 
-
      488. 5427            return columnValue;
        489. 
 
      489.          },
        490. 
 
      490.  
        491. 
-
      491.          _setColumnValue:function (name, val) {
        492. 
-
      492. 7556            var ignore = this.__ignore;
        493. 
-
      493. 7556            val = this._typeCastValue(name, val, ignore);
        494. 
-
      494. 7556            this._addColumnToIsChanged(name, val);
        495. 
-
      495. 7556            var setterFunc = this["_set" + name.charAt(0).toUpperCase() + name.substr(1)];
        496. 
-
      496. 7556            var columnValue = isFunction(setterFunc) ? setterFunc.call(this, val, ignore) : val;
        497. 
-
      497. 7556            this.__values[name] = columnValue;
        498. 
-
      498. 7556            if (this._static.emitOnColumnSet) {
        499. 
-
      499. 7556                this.emit("column", name, columnValue, ignore);
        500. 
+
      500.          /**
        501. 
+
      501.           *Filters our associated dataset to load our association.
        502. 
+
      502.           *
        503. 
+
      503.           *@return {Dataset} the dataset with all filters applied.
        504. 
+
      504.           **/
        505. 
+
      505.          _filter:function (parent) {
        506. 
+
      506. 648            var options = this.__opts || {};
        507. 
+
      507. 648            var ds;
        508. 
+
      508. 648            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
        509. 
+
      509. 0                ds = ds.apply(parent, [parent]);
        510. 
+
      510.              }
        511. 
+
      511. 648            if (!ds) {
        512. 
+
      512. 648                var q = {};
        513. 
+
      513. 648                this._setAssociationKeys(parent, q);
        514. 
+
      514. 648                ds = this.model.dataset.naked().filter(q);
        515. 
+
      515. 648                var recip = this.model._findAssociation(this);
        516. 
+
      516. 648                recip && (recip = recip[1]);
        517. 
+
      517. 648                ds.rowCb = hitch(this, function (item) {
        518. 
+
      518. 489                    var ret = new Promise();
        519. 
+
      519. 489                    var model = this._toModel(item, true);
        520. 
+
      520. 489                    recip && recip.__setValue(model, parent);
        521. 
+
      521.                      //call hook to finish other model associations
        522. 
+
      522. 489                    model._hook("post", "load").then(hitch(this, function () {
        523. 
+
      523. 489                        ret.callback(model);
        524. 
+
      524.                      }), ret);
        525. 
+
      525. 489                    return ret.promise();
        526. 
+
      526.                  });
        527. 
 
      527.              }
        528. 
+
      528.  
        529. 
+
      529. 648            return this._setDatasetOptions(ds);
        530. 
 
      530.          },
        531. 
 
      531.  
        532. 
+
      532.          __setValue:function (parent, model) {
        533. 
+
      533. 2061            parent.__associations[this.name] = this._fetchMethod
        534. 
+
      534.                  == "all" ? !isArray(model) ? [model] : model : isArray(model) ? model[0] : model;
        535. 
+
      535. 2061            return parent.__associations[this.name];
        536. 
+
      536.          },
        537. 
 
      537.  
        538. 
-
      538.          //Typecast the value to the column's type if typecasting.  Calls the database's
        539. 
-
      539.          //typecast_value method, so database adapters can override/augment the handling
        540. 
-
      540.          //for database specific column types.
        541. 
-
      541.          _typeCastValue:function (column, value, fromDatabase) {
        542. 
-
      542. 32705            var colSchema, clazz = this._static;
        543. 
-
      543. 32705            if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
        544. 
-
      544. 32705                var type = colSchema.type;
        545. 
-
      545. 32705                if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
        546. 
-
      546. 3                    value = null;
        547. 
-
      547.                  }
        548. 
-
      548. 32705                var raiseOnError = clazz.raiseOnTypecastError;
        549. 
-
      549. 32705                if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
        550. 
-
      550. 0                    throw new ModelError("null is not allowed for the " + column + " column.");
        551. 
-
      551.                  }
        552. 
-
      552. 32705                try {
        553. 
-
      553. 32705                    value = clazz.db.typecastValue(type, value);
        554. 
-
      554.                  } catch (e) {
        555. 
-
      555. 0                    if (raiseOnError === true) {
        556. 
-
      556. 0                        throw e;
        557. 
-
      557.                      }
        558. 
-
      558.                  }
        559. 
+
      559.          fetch:function (parent) {
        560. 
+
      560. 785            var ret = new Promise();
        561. 
+
      561. 785            if (this._checkAssociationKey(parent)) {
        562. 
+
      562. 733                this._filter(parent)[this._fetchMethod]().then(hitch(this, function (result) {
        563. 
+
      563. 733                    this.__setValue(parent, result);
        564. 
+
      564. 733                    ret.callback(result);
        565. 
+
      565. 733                    parent = null;
        566. 
+
      566.                  }), ret);
        567. 
+
      567.              } else {
        568. 
+
      568. 52                this.__setValue(parent, null);
        569. 
+
      569. 52                ret.callback(null);
        570. 
 
      570.              }
        571. 
-
      571. 32705            return value;
        572. 
+
      572. 785            return ret;
        573. 
 
      573.          },
        574. 
 
      574.  
        575. 
 
      575.          /**
        576. 
-
      576.           * Convert this model to an object, containing column, value pairs.
        577. 
-
      577.           *
        578. 
-
      578.           * @return {Object} the object version of this model.
        579. 
-
      579.           **/
        580. 
-
      580.          toObject:function () {
        581. 
-
      581. 0            return this._toObject(false);
        582. 
+
      582.           * Middleware called before a model is removed.
        583. 
+
      583.           * </br>
        584. 
+
      584.           * <b> This is called in the scope of the model</b>
        585. 
+
      585.           * @param {Function} next function to pass control up the middleware stack.
        586. 
+
      586.           * @param {_Association} self reference to the Association that is being acted up.
        587. 
+
      587.           */
        588. 
+
      588.          _preRemove:function (next, model) {
        589. 
+
      589. 223            if (this.isOwner && !this.isCascading) {
        590. 
+
      590. 46                var q = {};
        591. 
+
      591. 46                this._setAssociationKeys(model, q, null);
        592. 
+
      592. 46                model[this.associatedDatasetName].update(q).classic(next);
        593. 
+
      593.              } else {
        594. 
+
      594. 177                next();
        595. 
+
      595.              }
        596. 
 
      596.          },
        597. 
 
      597.  
        598. 
 
      598.          /**
        599. 
-
      599.           * Convert this model to JSON, containing column, value pairs.
        600. 
-
      600.           *
        601. 
-
      601.           * @return {JSON} the JSON version of this model.
        602. 
-
      602.           **/
        603. 
-
      603.          toJSON:function () {
        604. 
-
      604. 0            return this.toObject();
        605. 
+
      605.           * Middleware called aft era model is removed.
        606. 
+
      606.           * </br>
        607. 
+
      607.           * <b> This is called in the scope of the model</b>
        608. 
+
      608.           * @param {Function} next function to pass control up the middleware stack.
        609. 
+
      609.           * @param {_Association} self reference to the Association that is being called.
        610. 
+
      610.           */
        611. 
+
      611.          _postRemove:function (next, model) {
        612. 
+
      612. 514            next();
        613. 
 
      613.          },
        614. 
 
      614.  
        615. 
 
      615.          /**
        616. 
-
      616.           * Convert this model to a string, containing column, value pairs.
        617. 
-
      617.           *
        618. 
-
      618.           * @return {String} the string version of this model.
        619. 
-
      619.           **/
        620. 
-
      620.          toString:function () {
        621. 
-
      621. 0            return JSON.stringify(this.toObject(), null, 4);
        622. 
+
      622.           * Middleware called before a model is saved.
        623. 
+
      623.           * </br>
        624. 
+
      624.           * <b> This is called in the scope of the model</b>
        625. 
+
      625.           * @param {Function} next function to pass control up the middleware stack.
        626. 
+
      626.           * @param {_Association} self reference to the Association that is being called.
        627. 
+
      627.           */
        628. 
+
      628.          _preSave:function (next, model) {
        629. 
+
      629. 324            next();
        630. 
 
      630.          },
        631. 
 
      631.  
        632. 
 
      632.          /**
        633. 
-
      633.           * Convert this model to a string, containing column, value pairs.
        634. 
-
      634.           *
        635. 
-
      635.           * @return {String} the string version of this model.
        636. 
-
      636.           **/
        637. 
-
      637.          valueOf:function () {
        638. 
-
      638. 0            return this.toObject();
        639. 
+
      639.           * Middleware called after a model is saved.
        640. 
+
      640.           * </br>
        641. 
+
      641.           * <b> This is called in the scope of the model</b>
        642. 
+
      642.           * @param {Function} next function to pass control up the middleware stack.
        643. 
+
      643.           * @param {_Association} self reference to the Association that is being called.
        644. 
+
      644.           */
        645. 
+
      645.          _postSave:function (next, model) {
        646. 
+
      646. 198            next();
        647. 
 
      647.          },
        648. 
 
      648.  
        649. 
-
      649.          _checkTransaction:function (options, cb) {
        650. 
-
      650. 2493            return this._static._checkTransaction(options, cb);
        651. 
+
      651.          /**
        652. 
+
      652.           * Middleware called before a model is updated.
        653. 
+
      653.           * </br>
        654. 
+
      654.           * <b> This is called in the scope of the model</b>
        655. 
+
      655.           * @param {Function} next function to pass control up the middleware stack.
        656. 
+
      656.           * @param {_Association} self reference to the Association that is being called.
        657. 
+
      657.           */
        658. 
+
      658.          _preUpdate:function (next, model) {
        659. 
+
      659. 2            next();
        660. 
 
      660.          },
        661. 
 
      661.  
        662. 
-
      662.          addListener:function () {
        663. 
-
      663. 0            var emitter = this.__emitter;
        664. 
-
      664. 0            return emitter.addListener.apply(emitter, arguments);
        665. 
-
      665.          },
        666. 
-
      666.          on:function () {
        667. 
-
      667. 6            var emitter = this.__emitter;
        668. 
-
      668. 6            return emitter.on.apply(emitter, arguments);
        669. 
-
      669.          },
        670. 
-
      670.          once:function () {
        671. 
-
      671. 0            var emitter = this.__emitter;
        672. 
-
      672. 0            return emitter.once.apply(emitter, arguments);
        673. 
-
      673.          },
        674. 
-
      674.          removeListener:function () {
        675. 
-
      675. 6            var emitter = this.__emitter;
        676. 
-
      676. 6            return emitter.removeListener.apply(emitter, arguments);
        677. 
-
      677.          },
        678. 
-
      678.          removeAllListeners:function () {
        679. 
-
      679. 0            var emitter = this.__emitter;
        680. 
-
      680. 0            return emitter.removeAllListeners.apply(emitter, arguments);
        681. 
+
      681.          /**
        682. 
+
      682.           * Middleware called before a model is updated.
        683. 
+
      683.           * </br>
        684. 
+
      684.           * <b> This is called in the scope of the model</b>
        685. 
+
      685.           * @param {Function} next function to pass control up the middleware stack.
        686. 
+
      686.           * @param {_Association} self reference to the Association that is being called.
        687. 
+
      687.           */
        688. 
+
      688.          _postUpdate:function (next, model) {
        689. 
+
      689. 127            next();
        690. 
 
      690.          },
        691. 
-
      691.          setMaxListeners:function () {
        692. 
-
      692. 0            var emitter = this.__emitter;
        693. 
-
      693. 0            return emitter.setMaxListeners.apply(emitter, arguments);
        694. 
+
      694.  
        695. 
+
      695.          /**
        696. 
+
      696.           * Middleware called before a model is loaded.
        697. 
+
      697.           * </br>
        698. 
+
      698.           * <b> This is called in the scope of the model</b>
        699. 
+
      699.           * @param {Function} next function to pass control up the middleware stack.
        700. 
+
      700.           * @param {_Association} self reference to the Association that is being called.
        701. 
+
      701.           */
        702. 
+
      702.          _preLoad:function (next, model) {
        703. 
+
      703. 1570            next();
        704. 
 
      704.          },
        705. 
-
      705.          listeners:function () {
        706. 
-
      706. 0            var emitter = this.__emitter;
        707. 
-
      707. 0            return emitter.listeners.apply(emitter, arguments);
        708. 
+
      708.  
        709. 
+
      709.          /**
        710. 
+
      710.           * Middleware called after a model is loaded.
        711. 
+
      711.           * </br>
        712. 
+
      712.           * <b> This is called in the scope of the model</b>
        713. 
+
      713.           * @param {Function} next function to pass control up the middleware stack.
        714. 
+
      714.           * @param {_Association} self reference to the Association that is being called.
        715. 
+
      715.           */
        716. 
+
      716.          _postLoad:function (next, model) {
        717. 
+
      717. 0            next();
        718. 
 
      718.          },
        719. 
-
      719.          emit:function () {
        720. 
-
      720. 11120            var emitter = this.__emitter;
        721. 
-
      721. 11120            return emitter.emit.apply(emitter, arguments);
        722. 
+
      722.  
        723. 
+
      723.          /**
        724. 
+
      724.           * Alias used to explicitly set an association on a model.
        725. 
+
      725.           * @param {*} val the value to set the association to
        726. 
+
      726.           * @param {_Association} self reference to the Association that is being called.
        727. 
+
      727.           */
        728. 
+
      728.          _setter:function (val, model) {
        729. 
+
      729. 0            model.__associations[this.name] = val;
        730. 
 
      730.          },
        731. 
 
      731.  
        732. 
+
      732.          associationLoaded:function (model) {
        733. 
+
      733. 2707            return model.__associations.hasOwnProperty(this.name);
        734. 
+
      734.          },
        735. 
 
      735.  
        736. 
-
      736.          getters:{
        737. 
-
      737.              /**@lends patio.Model.prototype*/
        738. 
+
      738.          getAssociation:function (model) {
        739. 
+
      739. 885            return model.__associations[this.name];
        740. 
+
      740.          },
        741. 
 
      741.  
        742. 
-
      742.              /*Returns my actual primary key value*/
        743. 
-
      743.              primaryKeyValue:function () {
        744. 
-
      744. 47                return this[this.primaryKey];
        745. 
-
      745.              },
        746. 
+
      746.          /**
        747. 
+
      747.           * Alias used to explicitly get an association on a model.
        748. 
+
      748.           * @param {_Association} self reference to the Association that is being called.
        749. 
+
      749.           */
        750. 
+
      750.          _getter:function (model) {
        751. 
+
      751.              //if we have them return them;
        752. 
+
      752. 612            if (this.associationLoaded(model)) {
        753. 
+
      753. 220                var assoc = this.getAssociation(model);
        754. 
+
      754. 220                return this.isEager() ? assoc : new Promise().callback(assoc).promise();
        755. 
+
      755. 392            } else if (model.isNew) {
        756. 
+
      756. 0                return null;
        757. 
+
      757.              } else {
        758. 
+
      758. 392                return this.fetch(model);
        759. 
+
      759.              }
        760. 
+
      760.          },
        761. 
 
      761.  
        762. 
-
      762.              /*Return if Im a new object*/
        763. 
-
      763.              isNew:function () {
        764. 
-
      764. 9644                return this.__isNew;
        765. 
-
      765.              },
        766. 
+
      766.          _toModel:function (val, fromDb) {
        767. 
+
      767. 1412            var Model = this.model;
        768. 
+
      768. 1412            if (!isUndefinedOrNull(Model)) {
        769. 
+
      769. 1412                if (!isInstanceOf(val, Model)) {
        770. 
+
      770. 1167                    val = new this.model(val, fromDb);
        771. 
+
      771.                  }
        772. 
+
      772.              } else {
        773. 
+
      773. 0                throw new PatioError("Invalid model " + this.name);
        774. 
+
      774.              }
        775. 
+
      775. 1412            return val;
        776. 
+
      776.          },
        777. 
 
      777.  
        778. 
-
      778.              /*Return if Im changed*/
        779. 
-
      779.              isChanged:function () {
        780. 
-
      780. 0                return this.__isChanged;
        781. 
-
      781.              },
        782. 
+
      782.          /**
        783. 
+
      783.           * Method to inject functionality into a model. This method alters the model
        784. 
+
      784.           * to prepare it for associations, and initializes all required middleware calls
        785. 
+
      785.           * to fulfill requirements needed to loaded the associations.
        786. 
+
      786.           *
        787. 
+
      787.           * @param {Model} parent the model that is having an associtaion set on it.
        788. 
+
      788.           * @param {String} name the name of the association.
        789. 
+
      789.           */
        790. 
+
      790.          inject:function (parent, name) {
        791. 
+
      791. 55            this.name = name;
        792. 
+
      792. 55            var self = this;
        793. 
+
      793. 55            this.parent = parent;
        794. 
+
      794. 55            parent.prototype.__defineGetter__(name, function () {
        795. 
+
      795. 612                return  self._getter(this);
        796. 
+
      796.              });
        797. 
+
      797. 55            parent.prototype.__defineGetter__(this.associatedDatasetName, function () {
        798. 
+
      798. 146                return  self._filter(this);
        799. 
+
      799.              });
        800. 
 
      800.  
        801. 
-
      801.              /**@lends patio.Model.prototype*/
        802. 
+
      802. 55            if (!this.readOnly && this.createSetter) {
        803. 
+
      803.                  //define a setter because we arent read only
        804. 
+
      804. 55                parent.prototype.__defineSetter__(name, function (vals) {
        805. 
+
      805. 139                    self._setter(vals, this);
        806. 
+
      806.                  });
        807. 
+
      807.              }
        808. 
 
      808.  
        809. 
-
      809.              primaryKey:function () {
        810. 
-
      810. 2568                return this._static.primaryKey;
        811. 
+
      811.              //set up all callbacks
        812. 
+
      812. 55            ["pre", "post"].forEach(function (op) {
        813. 
+
      813. 110                ["save", "update", "remove", "load"].forEach(function (type) {
        814. 
+
      814. 440                    parent[op](type, function (next) {
        815. 
+
      815. 5598                        return self["_" + op + type.charAt(0).toUpperCase() + type.slice(1)](next, this);
        816. 
+
      816.                      });
        817. 
+
      817.                  }, this);
        818. 
+
      818.              }, this);
        819. 
+
      819.          },
        820. 
+
      820.  
        821. 
+
      821.          getters:{
        822. 
+
      822.  
        823. 
+
      823.              select:function () {
        824. 
+
      824. 648                return this.__opts.select;
        825. 
 
      825.              },
        826. 
 
      826.  
        827. 
-
      827.              tableName:function () {
        828. 
-
      828. 40                return this._static.tableName;
        829. 
+
      829.              defaultLeftKey:function () {
        830. 
+
      830. 2841                var ret = "";
        831. 
+
      831. 2841                if (this.isOwner) {
        832. 
+
      832. 2095                    ret = this.__opts.primaryKey || this.parent.primaryKey[0]
        833. 
+
      833.                  } else {
        834. 
+
      834. 746                    ret = this.model.tableName + "Id";
        835. 
+
      835.                  }
        836. 
+
      836. 2841                return ret;
        837. 
 
      837.              },
        838. 
 
      838.  
        839. 
-
      839.              dataset:function () {
        840. 
-
      840. 3085                return this.__dataset || this._static.dataset;
        841. 
+
      841.              defaultRightKey:function () {
        842. 
+
      842. 2721                return this.associatedModelKey;
        843. 
 
      843.              },
        844. 
 
      844.  
        845. 
-
      845.              db:function () {
        846. 
-
      846. 28                return this._static.db;
        847. 
+
      847.              //Returns our model
        848. 
+
      848.              model:function () {
        849. 
+
      849. 10572                return this.patio.getModel(this._model, this.parent.db);
        850. 
 
      850.              },
        851. 
 
      851.  
        852. 
-
      852.              schema:function () {
        853. 
-
      853. 75099                return this._static.schema;
        854. 
+
      854.              associatedModelKey:function () {
        855. 
+
      855. 2721                var ret = "";
        856. 
+
      856. 2721                if (this.isOwner) {
        857. 
+
      857. 1857                    ret = this.__opts.primaryKey || this.parent.tableName + "Id";
        858. 
+
      858.                  } else {
        859. 
+
      859. 864                    ret = this.model.primaryKey[0];
        860. 
+
      860.                  }
        861. 
+
      861. 2721                return ret;
        862. 
 
      862.              },
        863. 
 
      863.  
        864. 
-
      864.              columns:function () {
        865. 
-
      865. 0                return this._static.columns;
        866. 
+
      866.              associatedDatasetName:function () {
        867. 
+
      867. 201                return this.name + "Dataset"
        868. 
 
      868.              },
        869. 
 
      869.  
        870. 
-
      870.              synced:function () {
        871. 
-
      871. 12784                return this._static.synced;
        872. 
+
      872.              removeAssociationFlagName:function () {
        873. 
+
      873. 27                return "__remove" + this.name + "association"
        874. 
 
      874.              }
        875. 
 
      875.  
        876. 
 
      876.          }
        877. 
 
      877.      },
        878. 
 
      878.  
        879. 
 
      879.      static:{
        880. 
-
      880.          /**
        881. 
-
      881.           * @lends patio.Model
        882. 
-
      882.           */
        883. 
-
      883.  
        884. 
-
      884.          synced:false,
        885. 
+
      885.          /**@lends patio.associations.Association*/
        886. 
 
      886.  
        887. 
-
      887.          /**
        888. 
-
      888.           * Set to false to prevent the emitting of an event on load
        889. 
-
      889.           * @default true
        890. 
-
      890.           */
        891. 
-
      891.          emitOnLoad:true,
        892. 
+
      892.          fetch:{
        893. 
 
      893.  
        894. 
-
      894.          /**
        895. 
-
      895.           * Set to false to prevent the emitting of an event on the setting of a column value
        896. 
-
      896.           * @default true
        897. 
-
      897.           */
        898. 
-
      898.          emitOnColumnSet:true,
        899. 
+
      899.              LAZY:"lazy",
        900. 
 
      900.  
        901. 
+
      901.              EAGER:"eager"
        902. 
+
      902.          }
        903. 
+
      903.      }
        904. 
+
      904.  }).as(module);
      
+
    + +
    + + + + + +
    +
    model.js
    +     		+
    + Coverage88.47 + SLOC1066 + LOC321 + Missed37 +
    +
    + 
    1. 1var comb = require("comb"),
      2. 
+
    2.      isFunction = comb.isFunction,
      3. 
+
    3.      isUndefined = comb.isUndefined,
      4. 
+
    4.      isDefined = comb.isDefined,
      5. 
+
    5.      isBoolean = comb.isBoolean,
      6. 
+
    6.      isString = comb.isString,
      7. 
+
    7.      argsToArray = comb.argsToArray,
      8. 
+
    8.      isInstanceOf = comb.isInstanceOf,
      9. 
+
    9.      serial = comb.serial,
      10. 
+
    10.      isHash = comb.isHash,
      11. 
+
    11.      when = comb.when,
      12. 
+
    12.      merge = comb.merge,
      13. 
+
    13.      toArray = comb.array.toArray,
      14. 
+
    14.      ModelError = require("./errors").ModelError,
      15. 
+
    15.      plugins = require("./plugins"),
      16. 
+
    16.      isUndefinedOrNull = comb.isUndefinedOrNull,
      17. 
+
    17.      AssociationPlugin = plugins.AssociationPlugin,
      18. 
+
    18.      QueryPlugin = plugins.QueryPlugin,
      19. 
+
    19.      Promise = comb.Promise,
      20. 
+
    20.      PromiseList = comb.PromiseList,
      21. 
+
    21.      HashTable = comb.collections.HashTable,
      22. 
+
    22.      hitch = comb.hitch,
      23. 
+
    23.      hitchIgnore = comb.hitchIgnore,
      24. 
+
    24.      Middleware = comb.plugins.Middleware,
      25. 
+
    25.      EventEmitter = require("events").EventEmitter,
      26. 
+
    26.      util = require("util"),
      27. 
+
    27.      define = comb.define,
      28. 
+
    28.      patio;
      29. 
 
    29.  
      30. 
-
    30.          /**
      31. 
-
    31.           * Set to false to prevent empty strings from being type casted to null
      32. 
-
    32.           * @default true
      33. 
-
    33.           */
      34. 
-
    34.          typecastEmptyStringToNull:true,
      35. 
 
    35.  
      36. 
-
    36.          /**
      37. 
-
    37.           * Set to false to prevent properties from being type casted when loaded from the database.
      38. 
-
    38.           * See {@link patio.Database#typecastValue}
      39. 
-
    39.           * @default true
      40. 
-
    40.           */
      41. 
-
    41.          typecastOnLoad:true,
      42. 
+
    42. 1var MODELS = new HashTable();
      43. 
 
    43.  
      44. 
-
    44.          /**
      45. 
-
    45.           * Set to false to prevent properties from being type casted when manually set.
      46. 
-
    46.           * See {@link patio.Database#typecastValue}
      47. 
-
    47.           * @default true
      48. 
-
    48.           */
      49. 
-
    49.          typecastOnAssignment:true,
      50. 
+
    50. 1var applyColumnTransformMethod = function (val, meth) {
      51. 
+
    51. 11464    return !isUndefinedOrNull(meth) ? isFunction(val[meth]) ? val[meth] : isFunction(comb[meth]) ? comb[meth](val) : val : val;
      52. 
+
    52.  };
      53. 
 
    53.  
      54. 
-
    54.          /**
      55. 
-
    55.           * Set to false to prevent errors thrown while type casting a value from being propogated.
      56. 
-
    56.           * @default true
      57. 
-
    57.           */
      58. 
-
    58.          raiseOnTypecastError:true,
      59. 
+
    59. 1var checkAndTransformName = function (name) {
      60. 
+
    60. 10693    return isString(name) ? applyColumnTransformMethod(name, Model.camelize === true ? "camelize" : Model.underscore === true ? "underscore" : null) : name;
      61. 
+
    61.  };
      62. 
 
    62.  
      63. 
+
    63. 1var Model = define([QueryPlugin, Middleware], {
      64. 
+
    64.      instance:{
      65. 
 
    65.          /**
      66. 
-
    66.           * Set to false to allow the setting of primary keys.
      67. 
-
    67.           * @default false
      68. 
+
    68.           * @lends patio.Model.prototype
      69. 
 
    69.           */
      70. 
-
    70.          isRestrictedPrimaryKey:true,
      71. 
 
    71.  
      72. 
-
    72.          /**
      73. 
-
    73.           * Set to false to prevent models from using transactions when saving, deleting, or updating.
      74. 
-
    74.           * This applies to the model associations also.
      75. 
-
    75.           */
      76. 
-
    76.          useTransactions:true,
      77. 
+
    77.          __ignore:false,
      78. 
 
    78.  
      79. 
-
    79.          /**
      80. 
-
    80.           * See {@link patio.Dataset#identifierOutputMethod}
      81. 
-
    81.           * @default null
      82. 
-
    82.           */
      83. 
-
    83.          identifierOutputMethod:null,
      84. 
+
    84.          __changed:null,
      85. 
 
    85.  
      86. 
-
    86.          /**
      87. 
-
    87.           * See {@link patio.Dataset#identifierInputMethod}
      88. 
-
    88.           * @default null
      89. 
-
    89.           */
      90. 
-
    90.          identifierInputMethod:null,
      91. 
+
    91.          __values:null,
      92. 
 
    92.  
      93. 
 
    93.          /**
      94. 
-
    94.           * Set to false to prevent the reload of a model after saving.
      95. 
-
    95.           * @default true
      96. 
+
    96.           * patio  - read only
      97. 
+
    97.           *
      98. 
+
    98.           * @type patio
      99. 
 
    99.           */
      100. 
-
    100.          reloadOnSave:true,
      101. 
+
    101.          patio:null,
      102. 
 
    102.  
      103. 
 
    103.          /**
      104. 
-
    104.           * Columns that should be restriced when setting values through the {@link patio.Model#set} method.
      105. 
+
    105.           * The database type such as mysql
      106. 
 
    106.           *
      107. 
-
    107.           */
      108. 
-
    108.          restrictedColumns:null,
      109. 
+
    109.           * @type String
      110. 
+
    110.           *
      111. 
+
    111.           * */
      112. 
+
    112.          type:null,
      113. 
 
    113.  
      114. 
 
    114.          /**
      115. 
-
    115.           * Set to false to prevent the reload of a model after updating.
      116. 
-
    116.           * @default true
      117. 
-
    117.           */
      118. 
-
    118.          reloadOnUpdate:true,
      119. 
-
    119.  
      120. 
-
    120.  
      121. 
-
    121.          __camelize:false,
      122. 
-
    122.  
      123. 
-
    123.          __underscore:false,
      124. 
-
    124.  
      125. 
-
    125.          __columns:null,
      126. 
-
    126.  
      127. 
-
    127.          __schema:null,
      128. 
-
    128.  
      129. 
-
    129.          __primaryKey:null,
      130. 
-
    130.  
      131. 
-
    131.          __dataset:null,
      132. 
-
    132.  
      133. 
-
    133.          __db:null,
      134. 
-
    134.  
      135. 
-
    135.          __tableName:null,
      136. 
-
    136.  
      137. 
+
    137.           * Whether or not this model is new
      138. 
+
    138.           * */
      139. 
+
    139.          __isNew:true,
      140. 
 
    140.  
      141. 
 
    141.          /**
      142. 
-
    142.           * The table that this Model represents.
      143. 
-
    143.           * <b>READ ONLY</b>
      144. 
-
    144.           */
      145. 
-
    145.          table:null,
      146. 
+
    146.           * Signifies if the model has changed
      147. 
+
    147.           * */
      148. 
+
    148.          __isChanged:false,
      149. 
 
    149.  
      150. 
 
    150.          /**
      151. 
-
    151.           * patio  - read only
      152. 
+
    152.           * Base class for all models.
      153. 
+
    153.           * <p>This is used through {@link patio.addModel}, <b>NOT directly.</b></p>
      154. 
 
    154.           *
      155. 
-
    155.           * @type patio
      156. 
-
    156.           */
      157. 
-
    157.          patio:null,
      158. 
-
    158.  
      159. 
-
    159.          init:function () {
      160. 
-
    160. 92            var emitter = new EventEmitter();
      161. 
-
    161. 92            ["addListener", "on", "once", "removeListener",
      162. 
-
    162.                  "removeAllListeners", "setMaxListeners", "listeners", "emit"].forEach(function (name) {
      163. 
-
    163. 736                    this[name] = emitter[name].bind(emitter);
      164. 
-
    164.                  }, this);
      165. 
-
    165. 92            if (this.__tableName) {
      166. 
-
    166. 91                this._setTableName(this.__tableName);
      167. 
-
    167.              }
      168. 
-
    168. 92            if (this.__db) {
      169. 
-
    169. 7                this._setDb(this.__db);
      170. 
-
    170.              }
      171. 
-
    171.          },
      172. 
-
    172.  
      173. 
-
    173.  
      174. 
-
    174.          sync:function (cb) {
      175. 
-
    175. 3968            var ret = new Promise();
      176. 
-
    176. 3968            if (!this.synced) {
      177. 
-
    177. 93                var db = this.db, tableName = this.tableName, supers = this.__supers;
      178. 
-
    178. 93                db.schema(tableName).then(hitch(this, function (schema) {
      179. 
-
    179. 93                    if (!this.synced && schema) {
      180. 
-
    180. 93                        this._setSchema(schema);
      181. 
-
    181. 93                        if (supers && supers.length) {
      182. 
-
    182. 3                            new PromiseList(supers.map(function (sup) {
      183. 
-
    183. 3                                return sup.sync();
      184. 
-
    184.                              })).then(hitch(this, function () {
      185. 
-
    185. 3                                this.synced = true;
      186. 
-
    186. 3                                supers.forEach(this.inherits, this);
      187. 
-
    187. 3                                ret.callback(this);
      188. 
-
    188.                              }), ret);
      189. 
-
    189.                          } else {
      190. 
-
    190. 90                            this.synced = true;
      191. 
-
    191. 90                            ret.callback(this);
      192. 
-
    192.                          }
      193. 
-
    193. 93                        this.emit("sync", this);
      194. 
-
    194.                      } else {
      195. 
-
    195. 0                        var error = new ModelError("Unable to find schema for " + tableName);
      196. 
-
    196. 0                        this.emit("error", error);
      197. 
-
    197. 0                        ret.errback(error);
      198. 
+
    198.           * @constructs
      199. 
+
    199.           * @augments comb.plugins.Middleware
      200. 
+
    200.           *
      201. 
+
    201.           * @param {Object} columnValues values of each column to be used by this Model.
      202. 
+
    202.           *
      203. 
+
    203.           * @property {patio.Dataset} dataset a dataset to use to retrieve models from the database. The dataset
      204. 
+
    204.           *                          has the {@link patio.Dataset#rowCb} set to create instances of this model.
      205. 
+
    205.           * @property {String[]} columns a list of columns this models table contains.
      206. 
+
    206.           * @property {Object} schema the schema of this models table.
      207. 
+
    207.           * @property {String} tableName the table name of this models table.
      208. 
+
    208.           * @property {*} primaryKeyValue the value of this models primaryKey
      209. 
+
    209.           * @property {Boolean} isNew true if this model is new and does not exist in the database.
      210. 
+
    210.           * @property {Boolean} isChanged true if the model has been changed and not saved.
      211. 
+
    211.           *
      212. 
+
    212.           * @borrows patio.Dataset#all as all
      213. 
+
    213.           * @borrows patio.Dataset#one as one
      214. 
+
    214.           * @borrows patio.Dataset#avg as avg
      215. 
+
    215.           * @borrows patio.Dataset#count as count
      216. 
+
    216.           * @borrows patio.Dataset#columns as columns
      217. 
+
    217.           * @borrows patio.Dataset#forEach as forEach
      218. 
+
    218.           * @borrows patio.Dataset#isEmpty as empty
      219. 
+
    219.           * @borrows patio.Dataset#first as first
      220. 
+
    220.           * @borrows patio.Dataset#get as get
      221. 
+
    221.           * @borrows patio.Dataset#import as import
      222. 
+
    222.           * @borrows patio.Dataset#insert as insert
      223. 
+
    223.           * @borrows patio.Dataset#insertMultiple as insertMultiple
      224. 
+
    224.           * @borrows patio.Dataset#saveMultiple as saveMultiple
      225. 
+
    225.           * @borrows patio.Dataset#interval as interval
      226. 
+
    226.           * @borrows patio.Dataset#last as last
      227. 
+
    227.           * @borrows patio.Dataset#map as map
      228. 
+
    228.           * @borrows patio.Dataset#max as max
      229. 
+
    229.           * @borrows patio.Dataset#min as min
      230. 
+
    230.           * @borrows patio.Dataset#multiInsert as multiInsert
      231. 
+
    231.           * @borrows patio.Dataset#range as range
      232. 
+
    232.           * @borrows patio.Dataset#selectHash as selectHash
      233. 
+
    233.           * @borrows patio.Dataset#selectMap as selectMap
      234. 
+
    234.           * @borrows patio.Dataset#selectOrderMap as selectOrderMap
      235. 
+
    235.           * @borrows patio.Dataset#set as set
      236. 
+
    236.           * @borrows patio.Dataset#singleRecord as singleRecord
      237. 
+
    237.           * @borrows patio.Dataset#singleValue as singleValue
      238. 
+
    238.           * @borrows patio.Dataset#sum as sum
      239. 
+
    239.           * @borrows patio.Dataset#toCsv as toCsv
      240. 
+
    240.           * @borrows patio.Dataset#toHash as toHash
      241. 
+
    241.           * @borrows patio.Dataset#truncate as truncate
      242. 
+
    242.           * @borrows patio.Dataset#addGraphAliases as addGraphAliases
      243. 
+
    243.           * @borrows patio.Dataset#and as and
      244. 
+
    244.           * @borrows patio.Dataset#distinct as distinct
      245. 
+
    245.           * @borrows patio.Dataset#except as except
      246. 
+
    246.           * @borrows patio.Dataset#exclude as exclude
      247. 
+
    247.           * @borrows patio.Dataset#is as is
      248. 
+
    248.           * @borrows patio.Dataset#isNot as isNot
      249. 
+
    249.           * @borrows patio.Dataset#eq as eq
      250. 
+
    250.           * @borrows patio.Dataset#neq as neq
      251. 
+
    251.           * @borrows patio.Dataset#lt as lt
      252. 
+
    252.           * @borrows patio.Dataset#lte as lte
      253. 
+
    253.           * @borrows patio.Dataset#gt as gt
      254. 
+
    254.           * @borrows patio.Dataset#gte as gte
      255. 
+
    255.           * @borrows patio.Dataset#forUpdate as forUpdate
      256. 
+
    256.           * @borrows patio.Dataset#from as from
      257. 
+
    257.           * @borrows patio.Dataset#fromSelf as fromSelf
      258. 
+
    258.           * @borrows patio.Dataset#graph as graph
      259. 
+
    259.           * @borrows patio.Dataset#grep as grep
      260. 
+
    260.           * @borrows patio.Dataset#group as group
      261. 
+
    261.           * @borrows patio.Dataset#groupAndCount as groupAndCount
      262. 
+
    262.           * @borrows patio.Dataset#groupBy as groupBy
      263. 
+
    263.           * @borrows patio.Dataset#having as having
      264. 
+
    264.           * @borrows patio.Dataset#intersect as intersect
      265. 
+
    265.           * @borrows patio.Dataset#invert as invert
      266. 
+
    266.           * @borrows patio.Dataset#limit as limit
      267. 
+
    267.           * @borrows patio.Dataset#lockStyle as lockStyle
      268. 
+
    268.           * @borrows patio.Dataset#naked as naked
      269. 
+
    269.           * @borrows patio.Dataset#or as or
      270. 
+
    270.           * @borrows patio.Dataset#order as order
      271. 
+
    271.           * @borrows patio.Dataset#orderAppend as orderAppend
      272. 
+
    272.           * @borrows patio.Dataset#orderBy as orderBy
      273. 
+
    273.           * @borrows patio.Dataset#orderMore as orderMore
      274. 
+
    274.           * @borrows patio.Dataset#orderPrepend as orderPrepend
      275. 
+
    275.           * @borrows patio.Dataset#qualify as qualify
      276. 
+
    276.           * @borrows patio.Dataset#reverse as reverse
      277. 
+
    277.           * @borrows patio.Dataset#reverseOrder as reverseOrder
      278. 
+
    278.           * @borrows patio.Dataset#select as select
      279. 
+
    279.           * @borrows patio.Dataset#selectAll as selectAll
      280. 
+
    280.           * @borrows patio.Dataset#selectAppend as selectAppend
      281. 
+
    281.           * @borrows patio.Dataset#selectMore as selectMore
      282. 
+
    282.           * @borrows patio.Dataset#setDefaults as setDefaults
      283. 
+
    283.           * @borrows patio.Dataset#setGraphAliases as setGraphAliases
      284. 
+
    284.           * @borrows patio.Dataset#setOverrides as setOverrides
      285. 
+
    285.           * @borrows patio.Dataset#unfiltered as unfiltered
      286. 
+
    286.           * @borrows patio.Dataset#ungraphed as ungraphed
      287. 
+
    287.           * @borrows patio.Dataset#ungrouped as ungrouped
      288. 
+
    288.           * @borrows patio.Dataset#union as union
      289. 
+
    289.           * @borrows patio.Dataset#unlimited as unlimited
      290. 
+
    290.           * @borrows patio.Dataset#unordered as unordered
      291. 
+
    291.           * @borrows patio.Dataset#where as where
      292. 
+
    292.           * @borrows patio.Dataset#with as with
      293. 
+
    293.           * @borrows patio.Dataset#withRecursive as withRecursive
      294. 
+
    294.           * @borrows patio.Dataset#withSql as withSql
      295. 
+
    295.           * @borrows patio.Dataset#naturalJoin as naturalJoin
      296. 
+
    296.           * @borrows patio.Dataset#naturalLeftJoin as naturalLeftJoin
      297. 
+
    297.           * @borrows patio.Dataset#naturalRightJoin as naturalRightJoin
      298. 
+
    298.           * @borrows patio.Dataset#naturalFullJoin as naturalFullJoin
      299. 
+
    299.           * @borrows patio.Dataset#crossJoin as crossJoin
      300. 
+
    300.           * @borrows patio.Dataset#innerJoin as innerJoin
      301. 
+
    301.           * @borrows patio.Dataset#fullOuterJoin as fullOuterJoin
      302. 
+
    302.           * @borrows patio.Dataset#rightOuterJoin as rightOuterJoin
      303. 
+
    303.           * @borrows patio.Dataset#leftOuterJoin as leftOuterJoin
      304. 
+
    304.           * @borrows patio.Dataset#fullJoin as fullJoin
      305. 
+
    305.           * @borrows patio.Dataset#rightJoin as rightJoin
      306. 
+
    306.           * @borrows patio.Dataset#leftJoin as leftJoin
      307. 
+
    307.           * */
      308. 
+
    308.          constructor:function (options, fromDb) {
      309. 
+
    309. 3107            if (this.synced) {
      310. 
+
    310. 3107                this.__emitter = new EventEmitter();
      311. 
+
    311. 3107                this._super(arguments);
      312. 
+
    312. 3107                this.patio = patio || require("./index");
      313. 
+
    313. 3107                fromDb = isBoolean(fromDb) ? fromDb : false;
      314. 
+
    314. 3107                this.__changed = {};
      315. 
+
    315. 3107                this.__values = {};
      316. 
+
    316. 3107                if (fromDb) {
      317. 
+
    317. 1754                    this._hook("pre", "load");
      318. 
+
    318. 1754                    this.__isNew = false;
      319. 
+
    319. 1754                    this.__setFromDb(options, true);
      320. 
+
    320. 1754                    if (this._static.emitOnLoad) {
      321. 
+
    321. 1754                        this.emit("load", this);
      322. 
+
    322. 1754                        this._static.emit("load", this);
      323. 
 
    323.                      }
      324. 
-
    324.                  }), ret);
      325. 
+
    325.                  } else {
      326. 
+
    326. 1353                    this.__isNew = true;
      327. 
+
    327. 1353                    this.__set(options);
      328. 
+
    328.                  }
      329. 
 
    329.              } else {
      330. 
-
    330. 3875                ret.callback(this);
      331. 
-
    331.              }
      332. 
-
    332. 3968            if (isFunction(cb)) {
      333. 
-
    333. 0                ret.classic(cb);
      334. 
+
    334. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
      335. 
 
    335.              }
      336. 
-
    336. 3968            return ret.promise();
      337. 
 
    337.          },
      338. 
 
    338.  
      339. 
-
    339.          /**
      340. 
-
    340.           * Stub for plugins to notified of model inheritance
      341. 
-
    341.           *
      342. 
-
    342.           * @param {patio.Model} model a model class to inherit from
      343. 
-
    343.           */
      344. 
-
    344.          inherits:function (model) {
      345. 
+
    345.          __set:function (values, ignore) {
      346. 
+
    346. 1475            values = values || {};
      347. 
+
    347. 1475            this.__ignore = ignore === true;
      348. 
+
    348. 1475            Object.keys(values).forEach(function (attribute) {
      349. 
+
    349. 6632                var value = values[attribute];
      350. 
+
    350.                  //check if the column is a constrained value and is allowed to be set
      351. 
+
    351. 6632                !ignore && this._checkIfColumnIsConstrained(attribute);
      352. 
+
    352. 6632                this[attribute] = value;
      353. 
+
    353.              }, this);
      354. 
+
    354. 1475            this.__ignore = false;
      355. 
 
    355.          },
      356. 
 
    356.  
      357. 
+
    357.          __setFromDb:function (values, ignore) {
      358. 
+
    358. 3057            values = values || {};
      359. 
+
    359. 3057            this.__ignore = ignore === true;
      360. 
+
    360. 3057            var schema = this.schema;
      361. 
+
    361. 3057            Object.keys(values).forEach(function (column) {
      362. 
+
    362. 25830                var value = values[column];
      363. 
+
    363.                  // Typecast value retrieved from db
      364. 
+
    364. 25830                if (schema.hasOwnProperty(column)) {
      365. 
+
    365. 25149                    this.__values[column] = this._typeCastValue(column, value, ignore);
      366. 
+
    366.                  } else {
      367. 
+
    367. 681                    this[column] = value;
      368. 
+
    368.                  }
      369. 
+
    369.              }, this);
      370. 
+
    370. 3057            this.__ignore = false;
      371. 
+
    371.  
      372. 
+
    372.          },
      373. 
 
    373.  
      374. 
 
    374.          /**
      375. 
-
    375.           * Create a new model initialized with the specified values.
      376. 
+
    376.           * Set multiple values at once. Useful if you have a hash of properties that you want to set.
      377. 
 
    377.           *
      378. 
-
    378.           * @param {Object} values  the values to initialize the model with.
      379. 
+
    379.           * <b>NOTE:</b> This method will use the static restrictedColumns property of the model.
      380. 
 
    380.           *
      381. 
-
    381.           * @returns {Model} instantiated model initialized with the values passed in.
      382. 
+
    382.           * @example
      383. 
+
    383.           *
      384. 
+
    384.           * myModel.setValues({firstName : "Bob", lastName : "yukon"});
      385. 
+
    385.           *
      386. 
+
    386.           * //this will throw an error by default, assuming id is a pk.
      387. 
+
    387.           * myModel.setValues({id : 1, firstName : "Bob", lastName : "yukon"});
      388. 
+
    388.           *
      389. 
+
    389.           * @param {Object} values value to set on the model.
      390. 
+
    390.           *
      391. 
+
    391.           * @return {patio.Model} return this for chaining.
      392. 
 
    392.           */
      393. 
-
    393.          create:function (values) {
      394. 
-
    394.              //load an object from an object
      395. 
-
    395. 0            return new this(values, false);
      396. 
+
    396.          setValues:function (values) {
      397. 
+
    397. 17            this.__set(values, false);
      398. 
+
    398. 17            return this;
      399. 
 
    399.          },
      400. 
 
    400.  
      401. 
-
    401.          load:function (vals) {
      402. 
-
    402. 924            var ret = new Promise();
      403. 
-
    403.              //sync our model
      404. 
-
    404. 924            this.sync().then(hitch(this, function () {
      405. 
-
    405. 924                var m = new this(vals, true);
      406. 
-
    406.                  //call the hooks!
      407. 
-
    407. 924                m._hook("post", "load").then(function () {
      408. 
-
    408. 924                    ret.callback(m);
      409. 
-
    409.                  }, ret);
      410. 
-
    410.              }), ret);
      411. 
-
    411. 924            return ret.promise();
      412. 
+
    412.          _toObject:function () {
      413. 
+
    413. 1124            if (this.synced) {
      414. 
+
    414. 1124                var columns = this._static.columns, ret = {};
      415. 
+
    415. 1124                for (var i in columns) {
      416. 
+
    416. 10220                    var col = columns[i];
      417. 
+
    417. 10220                    var val = this.__values[col];
      418. 
+
    418. 10220                    if (!isUndefined(val)) {
      419. 
+
    419. 6169                        ret[col] = val;
      420. 
+
    420.                      }
      421. 
+
    421.                  }
      422. 
+
    422. 1124                return ret;
      423. 
+
    423.              } else {
      424. 
+
    424. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
      425. 
+
    425.              }
      426. 
 
    426.          },
      427. 
 
    427.  
      428. 
-
    428.          _checkTransaction:function (opts, cb) {
      429. 
-
    429. 2892            if (isFunction(opts)) {
      430. 
-
    430. 639                cb = opts;
      431. 
-
    431. 639                opts = {};
      432. 
-
    432.              } else {
      433. 
-
    433. 2253                opts = opts || {};
      434. 
+
    434.          _addColumnToIsChanged:function (name, val) {
      435. 
+
    435. 7556            if (!this.isNew && !this.__ignore) {
      436. 
+
    436. 165                this.__isChanged = true;
      437. 
+
    437. 165                this.__changed[name] = val;
      438. 
 
    438.              }
      439. 
-
    439. 2892            var ret = new Promise(), retVal = null, errored = false;
      440. 
-
    440. 2892            this.sync().then(hitch(this, function () {
      441. 
-
    441. 2892                if (this.useTransaction(opts)) {
      442. 
-
    442. 2892                    this.db.transaction(opts, hitch(this, function () {
      443. 
-
    443. 2892                        return when(cb()).then(function () {
      444. 
-
    444. 2848                            retVal = argsToArray(arguments);
      445. 
-
    445.                          }, function () {
      446. 
-
    446. 44                            retVal = argsToArray(arguments);
      447. 
-
    447. 44                            errored = true;
      448. 
-
    448.                          });
      449. 
-
    449.                      })).then(hitch(this, function () {
      450. 
-
    450. 2848                        ret[errored ? "errback" : "callback"].apply(ret, retVal);
      451. 
-
    451.                      }), hitch(this, function () {
      452. 
-
    452. 44                        if (errored) {
      453. 
-
    453. 44                            ret.errback.apply(ret, retVal);
      454. 
-
    454.                          } else {
      455. 
-
    455. 0                            ret.errback.apply(ret, arguments);
      456. 
-
    456.                          }
      457. 
-
    457.                      }));
      458. 
-
    458.                  } else {
      459. 
-
    459. 0                    when(cb()).then(ret);
      460. 
+
    460.          },
      461. 
+
    461.  
      462. 
+
    462.          _checkIfColumnIsConstrained:function (name) {
      463. 
+
    463. 6632            if (this.synced && !this.__ignore) {
      464. 
+
    464. 6632                var col = this.schema[name], restrictedCols = this._static.restrictedColumns || [];
      465. 
+
    465. 6632                if (!isUndefined(col) && (col.primaryKey && this._static.isRestrictedPrimaryKey) || restrictedCols.indexOf(name) != -1) {
      466. 
+
    466. 0                    throw new ModelError("Cannot set primary key of model " + this._static.tableName);
      467. 
 
    467.                  }
      468. 
-
    468.              }), ret);
      469. 
-
    469. 2892            return ret.promise();
      470. 
+
    470.              }
      471. 
 
    471.          },
      472. 
 
    472.  
      473. 
-
    473.          /**
      474. 
-
    474.           * @private
      475. 
-
    475.           * Returns a boolean indicating whether or not to use a transaction.
      476. 
-
    476.           * @param {Object} [opts] set a transaction property to override the {@link patio.Model#useTransaction}.
      477. 
-
    477.           */
      478. 
-
    478.          useTransaction:function (opts) {
      479. 
-
    479. 2892            opts = opts || {};
      480. 
-
    480. 2892            return isBoolean(opts.transaction) ? opts.transaction === true : this.useTransactions === true;
      481. 
+
    481.          _getColumnValue:function (name) {
      482. 
+
    482. 5427            var val = this.__values[name];
      483. 
+
    483. 5427            var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
      484. 
+
    484. 5427            var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
      485. 
+
    485.  
      486. 
+
    486. 5427            return columnValue;
      487. 
 
    487.          },
      488. 
 
    488.  
      489. 
-
    489.          _setDataset:function (ds) {
      490. 
-
    490. 3            this.__dataset = ds;
      491. 
-
    491. 3            if (ds.db) {
      492. 
-
    492. 3                this._setDb(ds.db);
      493. 
+
    493.          _setColumnValue:function (name, val) {
      494. 
+
    494. 7556            var ignore = this.__ignore;
      495. 
+
    495. 7556            val = this._typeCastValue(name, val, ignore);
      496. 
+
    496. 7556            this._addColumnToIsChanged(name, val);
      497. 
+
    497. 7556            var setterFunc = this["_set" + name.charAt(0).toUpperCase() + name.substr(1)];
      498. 
+
    498. 7556            var columnValue = isFunction(setterFunc) ? setterFunc.call(this, val, ignore) : val;
      499. 
+
    499. 7556            this.__values[name] = columnValue;
      500. 
+
    500. 7556            if (this._static.emitOnColumnSet) {
      501. 
+
    501. 7556                this.emit("column", name, columnValue, ignore);
      502. 
 
    502.              }
      503. 
 
    503.          },
      504. 
 
    504.  
      505. 
-
    505.          _setDb:function (db) {
      506. 
-
    506. 10            this.__db = db;
      507. 
+
    507.  
      508. 
+
    508.          //Typecast the value to the column's type if typecasting.  Calls the database's
      509. 
+
    509.          //typecast_value method, so database adapters can override/augment the handling
      510. 
+
    510.          //for database specific column types.
      511. 
+
    511.          _typeCastValue:function (column, value, fromDatabase) {
      512. 
+
    512. 32705            var colSchema, clazz = this._static;
      513. 
+
    513. 32705            if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
      514. 
+
    514. 32705                var type = colSchema.type;
      515. 
+
    515. 32705                if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
      516. 
+
    516. 3                    value = null;
      517. 
+
    517.                  }
      518. 
+
    518. 32705                var raiseOnError = clazz.raiseOnTypecastError;
      519. 
+
    519. 32705                if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
      520. 
+
    520. 0                    throw new ModelError("null is not allowed for the " + column + " column.");
      521. 
+
    521.                  }
      522. 
+
    522. 32705                try {
      523. 
+
    523. 32705                    value = clazz.db.typecastValue(type, value);
      524. 
+
    524.                  } catch (e) {
      525. 
+
    525. 0                    if (raiseOnError === true) {
      526. 
+
    526. 0                        throw e;
      527. 
+
    527.                      }
      528. 
+
    528.                  }
      529. 
+
    529.              }
      530. 
+
    530. 32705            return value;
      531. 
 
    531.          },
      532. 
 
    532.  
      533. 
-
    533.          _setTableName:function (name) {
      534. 
-
    534. 91            this.__tableName = name;
      535. 
+
    535.          /**
      536. 
+
    536.           * Convert this model to an object, containing column, value pairs.
      537. 
+
    537.           *
      538. 
+
    538.           * @return {Object} the object version of this model.
      539. 
+
    539.           **/
      540. 
+
    540.          toObject:function () {
      541. 
+
    541. 0            return this._toObject(false);
      542. 
 
    542.          },
      543. 
 
    543.  
      544. 
-
    544.          _setColumns:function (cols) {
      545. 
-
    545. 96            var proto = this.prototype;
      546. 
-
    546. 96            if (this.__columns) {
      547. 
-
    547. 6                this.__columns.forEach(function (name) {
      548. 
-
    548. 16                    delete proto[name];
      549. 
-
    549.                  });
      550. 
-
    550.              }
      551. 
-
    551. 96            this.__columns = cols;
      552. 
-
    552. 96            cols.forEach(function (name) {
      553. 
-
    553. 779                this._defineColumnSetter(name);
      554. 
-
    554. 779                this._defineColumnGetter(name);
      555. 
-
    555.              }, this);
      556. 
+
    556.          /**
      557. 
+
    557.           * Convert this model to JSON, containing column, value pairs.
      558. 
+
    558.           *
      559. 
+
    559.           * @return {JSON} the JSON version of this model.
      560. 
+
    560.           **/
      561. 
+
    561.          toJSON:function () {
      562. 
+
    562. 0            return this.toObject();
      563. 
 
    563.          },
      564. 
 
    564.  
      565. 
-
    565.          _setPrimaryKey:function (pks) {
      566. 
-
    566. 99            this.__primaryKey = pks || [];
      567. 
+
    567.          /**
      568. 
+
    568.           * Convert this model to a string, containing column, value pairs.
      569. 
+
    569.           *
      570. 
+
    570.           * @return {String} the string version of this model.
      571. 
+
    571.           **/
      572. 
+
    572.          toString:function () {
      573. 
+
    573. 0            return JSON.stringify(this.toObject(), null, 4);
      574. 
 
    574.          },
      575. 
 
    575.  
      576. 
-
    576.          _setSchema:function (schema) {
      577. 
-
    577. 96            var columns = [];
      578. 
-
    578. 96            var pks = [];
      579. 
-
    579. 96            for (var i in schema) {
      580. 
-
    580. 779                var col = schema[i];
      581. 
-
    581. 779                var name = applyColumnTransformMethod(i, this.identifierOutputMethod);
      582. 
-
    582. 779                schema[name] = col;
      583. 
-
    583. 779                columns.push(name);
      584. 
-
    584. 779                col.primaryKey && pks.push(name);
      585. 
-
    585.              }
      586. 
-
    586. 96            this.__schema = schema;
      587. 
-
    587. 96            this._setPrimaryKey(pks);
      588. 
-
    588. 96            this._setColumns(columns);
      589. 
+
    589.          /**
      590. 
+
    590.           * Convert this model to a string, containing column, value pairs.
      591. 
+
    591.           *
      592. 
+
    592.           * @return {String} the string version of this model.
      593. 
+
    593.           **/
      594. 
+
    594.          valueOf:function () {
      595. 
+
    595. 0            return this.toObject();
      596. 
 
    596.          },
      597. 
 
    597.  
      598. 
-
    598.          _defineColumnSetter:function (name) {
      599. 
-
    599.              /*Adds a setter to an object*/
      600. 
-
    600. 779            this.prototype.__defineSetter__(name, function (val) {
      601. 
-
    601. 7556                this._setColumnValue(name, val);
      602. 
-
    602.              });
      603. 
+
    603.          _checkTransaction:function (options, cb) {
      604. 
+
    604. 2493            return this._static._checkTransaction(options, cb);
      605. 
 
    605.          },
      606. 
 
    606.  
      607. 
-
    607.          _defineColumnGetter:function (name) {
      608. 
-
    608. 779            this.prototype.__defineGetter__(name, function () {
      609. 
-
    609. 5427                return this._getColumnValue(name);
      610. 
-
    610.              });
      611. 
+
    611.          addListener:function () {
      612. 
+
    612. 0            var emitter = this.__emitter;
      613. 
+
    613. 0            return emitter.addListener.apply(emitter, arguments);
      614. 
+
    614.          },
      615. 
+
    615.          on:function () {
      616. 
+
    616. 6            var emitter = this.__emitter;
      617. 
+
    617. 6            return emitter.on.apply(emitter, arguments);
      618. 
+
    618.          },
      619. 
+
    619.          once:function () {
      620. 
+
    620. 0            var emitter = this.__emitter;
      621. 
+
    621. 0            return emitter.once.apply(emitter, arguments);
      622. 
+
    622.          },
      623. 
+
    623.          removeListener:function () {
      624. 
+
    624. 6            var emitter = this.__emitter;
      625. 
+
    625. 6            return emitter.removeListener.apply(emitter, arguments);
      626. 
+
    626.          },
      627. 
+
    627.          removeAllListeners:function () {
      628. 
+
    628. 0            var emitter = this.__emitter;
      629. 
+
    629. 0            return emitter.removeAllListeners.apply(emitter, arguments);
      630. 
+
    630.          },
      631. 
+
    631.          setMaxListeners:function () {
      632. 
+
    632. 0            var emitter = this.__emitter;
      633. 
+
    633. 0            return emitter.setMaxListeners.apply(emitter, arguments);
      634. 
+
    634.          },
      635. 
+
    635.          listeners:function () {
      636. 
+
    636. 0            var emitter = this.__emitter;
      637. 
+
    637. 0            return emitter.listeners.apply(emitter, arguments);
      638. 
+
    638.          },
      639. 
+
    639.          emit:function () {
      640. 
+
    640. 11120            var emitter = this.__emitter;
      641. 
+
    641. 11120            return emitter.emit.apply(emitter, arguments);
      642. 
 
    642.          },
      643. 
 
    643.  
      644. 
 
    644.  
      645. 
-
    645.          /**
      646. 
-
    646.           * @ignore
      647. 
-
    647.           */
      648. 
 
    648.          getters:{
      649. 
-
    649.              /**@lends patio.Model*/
      650. 
-
    650.  
      651. 
-
    651.              /**
      652. 
-
    652.               * Set to true if this models column names should be use the "underscore" method when sending
      653. 
-
    653.               * keys to the database and to "camelize" method on columns returned from the database. If set to false see
      654. 
-
    654.               * {@link patio.Model#underscore}.
      655. 
-
    655.               * @field
      656. 
-
    656.               * @default false
      657. 
-
    657.               * @type {Boolean}
      658. 
-
    658.               */
      659. 
-
    659.              camelize:function (camelize) {
      660. 
-
    660. 10686                return  this.__camelize;
      661. 
+
    661.              /**@lends patio.Model.prototype*/
      662. 
 
    662.  
      663. 
+
    663.              /*Returns my actual primary key value*/
      664. 
+
    664.              primaryKeyValue:function () {
      665. 
+
    665. 47                return this[this.primaryKey];
      666. 
 
    666.              },
      667. 
 
    667.  
      668. 
-
    668.              /**
      669. 
-
    669.               * Set to true if this models column names should be use the "camelize" method when sending
      670. 
-
    670.               * keys to the database and to "underscore" method on columns returned from the database. If set to false see
      671. 
-
    671.               * {@link patio.Model#underscore}.
      672. 
-
    672.               * @field
      673. 
-
    673.               * @default false
      674. 
-
    674.               * @type {Boolean}
      675. 
-
    675.               */
      676. 
-
    676.              underscore:function (underscore) {
      677. 
-
    677. 36                return this.__underscore;
      678. 
+
    678.              /*Return if Im a new object*/
      679. 
+
    679.              isNew:function () {
      680. 
+
    680. 9644                return this.__isNew;
      681. 
+
    681.              },
      682. 
 
    682.  
      683. 
+
    683.              /*Return if Im changed*/
      684. 
+
    684.              isChanged:function () {
      685. 
+
    685. 0                return this.__isChanged;
      686. 
 
    686.              },
      687. 
 
    687.  
      688. 
-
    688.              /**@lends patio.Model*/
      689. 
+
    689.              /**@lends patio.Model.prototype*/
      690. 
 
    690.  
      691. 
-
    691.              /**
      692. 
-
    692.               * The name of the table all instances of the this {@link patio.Model} use.
      693. 
-
    693.               * @field
      694. 
-
    694.               * @ignoreCode
      695. 
-
    695.               * @type String
      696. 
-
    696.               */
      697. 
-
    697.              tableName:function () {
      698. 
-
    698. 6318                return this.__tableName;
      699. 
+
    699.              primaryKey:function () {
      700. 
+
    700. 2568                return this._static.primaryKey;
      701. 
 
    701.              },
      702. 
 
    702.  
      703. 
-
    703.              /**
      704. 
-
    704.               * The database all instances of this {@link patio.Model} use.
      705. 
-
    705.               * @field
      706. 
-
    706.               *  @ignoreCode
      707. 
-
    707.               * @type patio.Database
      708. 
-
    708.               */
      709. 
-
    709.              db:function () {
      710. 
-
    710. 46374                var db = this.__db;
      711. 
-
    711. 46374                if (!db) {
      712. 
-
    712. 86                    db = this.__db = patio.defaultDatabase;
      713. 
-
    713.                  }
      714. 
-
    714. 46374                if (!db) {
      715. 
-
    715. 0                    throw new ModelError("patio has not been connected to a database");
      716. 
-
    716.                  }
      717. 
-
    717. 46374                return db;
      718. 
+
    718.              tableName:function () {
      719. 
+
    719. 40                return this._static.tableName;
      720. 
 
    720.              },
      721. 
 
    721.  
      722. 
-
    722.              /**
      723. 
-
    723.               * A dataset to use to retrieve instances of this {@link patio.Model{ from the database. The dataset
      724. 
-
    724.               * has the {@link patio.Dataset#rowCb} set to create instances of this model.
      725. 
-
    725.               * @field
      726. 
-
    726.               *  @ignoreCode
      727. 
-
    727.               * @type patio.Dataset
      728. 
-
    728.               */
      729. 
 
    729.              dataset:function () {
      730. 
-
    730. 4836                var ds = this.__dataset;
      731. 
-
    731. 4836                if (!ds) {
      732. 
-
    732. 84                    ds = this.db.from(this.tableName);
      733. 
-
    733. 84                    ds.rowCb = hitch(this, function (vals) {
      734. 
-
    734. 873                        return this.load(vals);
      735. 
-
    735.                      });
      736. 
-
    736. 84                    this.identifierInputMethod && (ds.identifierInputMethod = this.identifierInputMethod);
      737. 
-
    737. 84                    this.identifierOutputMethod && (ds.identifierOutputMethod = this.identifierOutputMethod);
      738. 
-
    738. 84                    this.__dataset = ds;
      739. 
-
    739. 4752                } else if (!ds.rowCb) {
      740. 
-
    740. 6                    ds.rowCb = hitch(this, function rowCb(vals) {
      741. 
-
    741. 25                        return this.load(vals);
      742. 
-
    742.                      });
      743. 
-
    743.                  }
      744. 
-
    744. 4836                return ds;
      745. 
+
    745. 3085                return this.__dataset || this._static.dataset;
      746. 
 
    746.              },
      747. 
 
    747.  
      748. 
-
    748.              /**
      749. 
-
    749.               * A list of columns this models table contains.
      750. 
-
    750.               * @field
      751. 
-
    751.               *  @ignoreCode
      752. 
-
    752.               * @type String[]
      753. 
-
    753.  
      754. 
-
    754.               */
      755. 
-
    755.              columns:function () {
      756. 
-
    756. 1128                return this.__columns;
      757. 
+
    757.              db:function () {
      758. 
+
    758. 28                return this._static.db;
      759. 
 
    759.              },
      760. 
 
    760.  
      761. 
-
    761.              /**
      762. 
-
    762.               * The schema of this {@link patio.Model}'s table. See {@link patio.Database#schema} for details
      763. 
-
    763.               * on the schema object.
      764. 
-
    764.               * @field
      765. 
-
    765.               *  @ignoreCode
      766. 
-
    766.               * @type Object
      767. 
-
    767.               */
      768. 
 
    768.              schema:function () {
      769. 
-
    769. 75103                if (this.synced) {
      770. 
-
    770. 75103                    return this.__schema;
      771. 
-
    771.                  } else {
      772. 
-
    772. 0                    throw new ModelError("Model has not been synced yet");
      773. 
-
    773.                  }
      774. 
+
    774. 75099                return this._static.schema;
      775. 
 
    775.              },
      776. 
 
    776.  
      777. 
-
    777.              /**
      778. 
-
    778.               * The primaryKey column/s of this {@link patio.Model}
      779. 
-
    779.               * @field
      780. 
-
    780.               *  @ignoreCode
      781. 
-
    781.               */
      782. 
-
    782.              primaryKey:function () {
      783. 
-
    783. 8221                if (this.synced) {
      784. 
-
    784. 8221                    return this.__primaryKey.slice(0);
      785. 
-
    785.                  } else {
      786. 
-
    786. 0                    throw new ModelError("Model has not been synced yet");
      787. 
-
    787.                  }
      788. 
+
    788.              columns:function () {
      789. 
+
    789. 0                return this._static.columns;
      790. 
 
    790.              },
      791. 
 
    791.  
      792. 
-
    792.              /**
      793. 
-
    793.               * A reference to the global {@link patio}.
      794. 
-
    794.               * @field
      795. 
-
    795.               *  @ignoreCode
      796. 
-
    796.               */
      797. 
-
    797.              patio:function () {
      798. 
-
    798. 81                return patio || require("./index");
      799. 
+
    799.              synced:function () {
      800. 
+
    800. 12780                return this._static.synced;
      801. 
 
    801.              }
      802. 
-
    802.          },
      803. 
 
    803.  
      804. 
-
    804.          /**@ignore*/
      805. 
-
    805.          setters:{
      806. 
-
    806.              /**@lends patio.Model*/
      807. 
-
    807.              /**@ignore*/
      808. 
-
    808.              camelize:function (camelize) {
      809. 
-
    809. 26                camelize = camelize === true;
      810. 
-
    810. 26                if (camelize) {
      811. 
-
    811. 26                    this.identifierOutputMethod = "camelize";
      812. 
-
    812. 26                    this.identifierInputMethod = "underscore";
      813. 
-
    813.                  }
      814. 
-
    814. 26                this.__camelize = camelize;
      815. 
-
    815. 26                this.__underscore = !camelize;
      816. 
+
    816.          }
      817. 
+
    817.      },
      818. 
 
    818.  
      819. 
-
    819.              },
      820. 
-
    820.              /**@ignore*/
      821. 
-
    821.              underscore:function (underscore) {
      822. 
-
    822. 1                underscore = underscore === true;
      823. 
-
    823. 1                if (underscore) {
      824. 
-
    824. 1                    this.identifierOutputMethod = "underscore";
      825. 
-
    825. 1                    this.identifierInputMethod = "camelize";
      826. 
-
    826.                  }
      827. 
-
    827. 1                this.__underscore = underscore;
      828. 
-
    828. 1                this.__camelize = !underscore;
      829. 
+
    829.      static:{
      830. 
+
    830.          /**
      831. 
+
    831.           * @lends patio.Model
      832. 
+
    832.           */
      833. 
 
    833.  
      834. 
-
    834.              }
      835. 
-
    835.          }
      836. 
-
    836.      }
      837. 
+
    837.          synced:false,
      838. 
 
    838.  
      839. 
-
    839.  }).as(exports, "Model");
      840. 
+
    840.          /**
      841. 
+
    841.           * Set to false to prevent the emitting of an event on load
      842. 
+
    842.           * @default true
      843. 
+
    843.           */
      844. 
+
    844.          emitOnLoad:true,
      845. 
 
    845.  
      846. 
+
    846.          /**
      847. 
+
    847.           * Set to false to prevent the emitting of an event on the setting of a column value
      848. 
+
    848.           * @default true
      849. 
+
    849.           */
      850. 
+
    850.          emitOnColumnSet:true,
      851. 
 
    851.  
      852. 
-
    852. 1function checkAndAddDBToTable(db, table) {
      853. 
-
    853. 93    if (!table.contains(db)) {
      854. 
-
    854. 34        table.set(db, new HashTable());
      855. 
-
    855.      }
      856. 
-
    856.  }
      857. 
 
    857.  
      858. 
-
    858.  /**@ignore*/
      859. 
-
    859. 1exports.create = function (name, supers, modelOptions) {
      860. 
-
    860. 93    if (!patio) {
      861. 
-
    861. 1        (patio = require("./index"));
      862. 
-
    862. 1        patio.on("disconnect", function () {
      863. 
-
    863. 40            MODELS.clear();
      864. 
-
    864.          });
      865. 
-
    865.      }
      866. 
-
    866. 93    var db, ds, tableName;
      867. 
-
    867. 93    var key, modelKey;
      868. 
-
    868. 93    if (isString(name)) {
      869. 
-
    869. 87        tableName = name;
      870. 
-
    870. 87        key = db = patio.defaultDatabase || "default";
      871. 
-
    871. 6    } else if (isInstanceOf(name, patio.Dataset)) {
      872. 
-
    872. 6        ds = name;
      873. 
-
    873. 6        tableName = ds.firstSourceAlias;
      874. 
-
    874. 6        key = db = ds.db;
      875. 
-
    875.      }
      876. 
-
    876. 93    var hasSuper = false;
      877. 
-
    877. 93    if (isHash(supers) || isUndefinedOrNull(supers)) {
      878. 
-
    878. 90        modelOptions = supers;
      879. 
-
    879. 90        supers = [Model];
      880. 
-
    880.      } else {
      881. 
-
    881. 3        supers = toArray(supers);
      882. 
-
    882. 3        supers = supers.map(function (sup) {
      883. 
-
    883. 3            return exports.getModel(sup, db);
      884. 
-
    884.          });
      885. 
-
    885. 3        hasSuper = true;
      886. 
-
    886.      }
      887. 
+
    887.          /**
      888. 
+
    888.           * Set to false to prevent empty strings from being type casted to null
      889. 
+
    889.           * @default true
      890. 
+
    890.           */
      891. 
+
    891.          typecastEmptyStringToNull:true,
      892. 
 
    892.  
      893. 
-
    893. 93    var model;
      894. 
-
    894. 93    checkAndAddDBToTable(key, MODELS);
      895. 
+
    895.          /**
      896. 
+
    896.           * Set to false to prevent properties from being type casted when loaded from the database.
      897. 
+
    897.           * See {@link patio.Database#typecastValue}
      898. 
+
    898.           * @default true
      899. 
+
    899.           */
      900. 
+
    900.          typecastOnLoad:true,
      901. 
 
    901.  
      902. 
-
    902. 93    var DEFAULT_PROTO = {instance:{}, "static":{}};
      903. 
-
    903. 93    modelOptions = merge(DEFAULT_PROTO, modelOptions || {});
      904. 
-
    904. 93    modelOptions.instance._hooks = ["save", "update", "remove", "load"];
      905. 
-
    905. 93    modelOptions.instance.__hooks = {pre:{}, post:{}};
      906. 
-
    906.      //Mixin the column setter/getters
      907. 
-
    907. 93    modelOptions["static"].synced = false;
      908. 
-
    908. 93    modelOptions["static"].__tableName = tableName;
      909. 
-
    909. 93    modelOptions["static"].__db = (db === "default" ? null : db);
      910. 
-
    910. 93    modelOptions["static"].__supers = hasSuper ? supers : [];
      911. 
-
    911. 93    modelOptions["static"].__dataset = ds;
      912. 
-
    912. 93    model = define(supers.concat(modelOptions.plugins || []).concat([AssociationPlugin]), modelOptions);
      913. 
-
    913. 93    ["pre", "post"].forEach(function (op) {
      914. 
-
    914. 186        var optionsOp = modelOptions[op];
      915. 
-
    915. 186        if (optionsOp) {
      916. 
-
    916. 0            for (var i in optionsOp) {
      917. 
-
    917. 0                model[op](i, optionsOp[i]);
      918. 
-
    918.              }
      919. 
-
    919.          }
      920. 
-
    920.      });
      921. 
-
    921. 93    if (!(MODELS.get(key).contains(checkAndTransformName(name)))) {
      922. 
-
    922. 61        MODELS.get(key).set(name, model);
      923. 
-
    923.      }
      924. 
-
    924. 93    return model;
      925. 
-
    925.  };
      926. 
+
    926.          /**
      927. 
+
    927.           * Set to false to prevent properties from being type casted when manually set.
      928. 
+
    928.           * See {@link patio.Database#typecastValue}
      929. 
+
    929.           * @default true
      930. 
+
    930.           */
      931. 
+
    931.          typecastOnAssignment:true,
      932. 
 
    932.  
      933. 
-
    933. 1exports.syncModels = function (cb) {
      934. 
-
    934. 35    var ret = new Promise();
      935. 
-
    935. 35    serial(MODELS.entrySet.map(function (entry) {
      936. 
-
    936. 34        return function () {
      937. 
-
    937. 34            var value = entry.value;
      938. 
-
    938. 34            return serial(value.entrySet.map(function (m) {
      939. 
-
    939. 61                return hitch(m.value, "sync");
      940. 
-
    940.              }));
      941. 
-
    941.          };
      942. 
-
    942.      })).then(hitchIgnore(ret, "callback", true), ret);
      943. 
-
    943. 35    if (isFunction(cb)) {
      944. 
-
    944. 0        ret.classic(cb);
      945. 
-
    945.      }
      946. 
-
    946. 35    return ret.promise();
      947. 
-
    947.  };
      948. 
+
    948.          /**
      949. 
+
    949.           * Set to false to prevent errors thrown while type casting a value from being propogated.
      950. 
+
    950.           * @default true
      951. 
+
    951.           */
      952. 
+
    952.          raiseOnTypecastError:true,
      953. 
 
    953.  
      954. 
-
    954. 1var checkAndGetModel = function (db, name) {
      955. 
-
    955. 21198    var ret;
      956. 
-
    956. 21198    if (MODELS.contains(db)) {
      957. 
-
    957. 10600        ret = MODELS.get(db).get(checkAndTransformName(name));
      958. 
-
    958.      }
      959. 
-
    959. 21198    return ret;
      960. 
-
    960.  };
      961. 
+
    961.          /**
      962. 
+
    962.           * Set to false to allow the setting of primary keys.
      963. 
+
    963.           * @default false
      964. 
+
    964.           */
      965. 
+
    965.          isRestrictedPrimaryKey:true,
      966. 
 
    966.  
      967. 
+
    967.          /**
      968. 
+
    968.           * Set to false to prevent models from using transactions when saving, deleting, or updating.
      969. 
+
    969.           * This applies to the model associations also.
      970. 
+
    970.           */
      971. 
+
    971.          useTransactions:true,
      972. 
 
    972.  
      973. 
-
    973. 1exports.getModel = function (name, db) {
      974. 
-
    974. 10603    var ret = null;
      975. 
-
    975. 10603    if (isDefined(name)) {
      976. 
-
    976. 10603        !patio && (patio = require("./index"));
      977. 
-
    977. 10603        if (isFunction(name)) {
      978. 
-
    978. 3            ret = name;
      979. 
-
    979.          } else {
      980. 
-
    980. 10600            if (!db && isInstanceOf(name, patio.Dataset)) {
      981. 
-
    981. 2                db = name.db;
      982. 
-
    982.              }
      983. 
-
    983. 10600            var defaultDb = patio.defaultDatabase;
      984. 
-
    984. 10600            if (db) {
      985. 
-
    985. 10574                ret = checkAndGetModel(db, name);
      986. 
-
    986. 10574                if (!ret && db === defaultDb) {
      987. 
-
    987. 10572                    ret = checkAndGetModel("default", name);
      988. 
-
    988.                  }
      989. 
-
    989.              } else {
      990. 
-
    990. 26                db = patio.defaultDatabase;
      991. 
-
    991. 26                ret = checkAndGetModel(db, name);
      992. 
-
    992. 26                if (!ret) {
      993. 
-
    993. 26                    ret = checkAndGetModel("default", name);
      994. 
-
    994.                  }
      995. 
-
    995.              }
      996. 
-
    996.          }
      997. 
-
    997.      } else {
      998. 
-
    998. 0        ret = name;
      999. 
-
    999.      }
      1000. 
-
    1000. 10603    if (isUndefinedOrNull(ret)) {
      1001. 
-
    1001. 0        throw new ModelError("Model " + name + " has not been registered with patio");
      1002. 
-
    1002.      }
      1003. 
-
    1003. 10603    return ret;
      1004. 
-
    1004.  };
      1005. 
+
    1005.          /**
      1006. 
+
    1006.           * See {@link patio.Dataset#identifierOutputMethod}
      1007. 
+
    1007.           * @default null
      1008. 
+
    1008.           */
      1009. 
+
    1009.          identifierOutputMethod:null,
      1010. 
 
    1010.  
      1011. 
-
    1011.
    -
    - -
    - - - - - -
    -
    associations/manyToMany.js
    -     		-
    - Coverage89.13 - SLOC309 - LOC138 - Missed15 -
    -
    - 
    1. 1var comb = require("comb-proxy"),
      2. 
-
    2.      define = comb.define,
      3. 
-
    3.      isUndefined = comb.isUndefined,
      4. 
-
    4.      isUndefinedOrNull = comb.isUndefinedOrNull,
      5. 
-
    5.      isFunction = comb.isFunction,
      6. 
-
    6.      isInstanceOf = comb.isInstanceOf,
      7. 
-
    7.      sql = require("../sql").sql,
      8. 
-
    8.      hitch = comb.hitch,
      9. 
-
    9.      array = comb.array,
      10. 
-
    10.      isBoolean = comb.isBoolean,
      11. 
-
    11.      serial = comb.serial,
      12. 
-
    12.      when = comb.when,
      13. 
-
    13.      zip = array.zip,
      14. 
-
    14.      Promise = comb.Promise,
      15. 
-
    15.      PromiseList = comb.PromiseList,
      16. 
-
    16.      hitchIgnore = comb.hitchIgnore,
      17. 
-
    17.      OneToMany = require("./oneToMany"),
      18. 
-
    18.      pluralize = comb.pluralize,
      19. 
-
    19.      AssociationError = require("../errors").AssociationError;
      20. 
+
    20.          /**
      21. 
+
    21.           * See {@link patio.Dataset#identifierInputMethod}
      22. 
+
    22.           * @default null
      23. 
+
    23.           */
      24. 
+
    24.          identifierInputMethod:null,
      25. 
 
    25.  
      26. 
-
    26. 1var LOGGER = comb.logger("comb.associations.ManyToMany");
      27. 
-
    27.  /**
      28. 
-
    28.   * @class Class to define a manyToMany association.
      29. 
-
    29.   *
      30. 
-
    30.   * </br>
      31. 
-
    31.   * <b>NOT to be instantiated directly</b>
      32. 
-
    32.   * Its just documented for reference.
      33. 
-
    33.   *
      34. 
-
    34.   * @name ManyToMany
      35. 
-
    35.   * @augments patio.associations.OneToMany
      36. 
-
    36.   * @memberOf patio.associations
      37. 
-
    37.   *
      38. 
-
    38.   * @param {String} options.joinTable the joinTable of the association.
      39. 
-
    39.   *
      40. 
-
    40.   *
      41. 
-
    41.   * @property {String} joinTable the join table used in the relation.
      42. 
-
    42.   * */
      43. 
-
    43. 1module.exports = define(OneToMany, {
      44. 
-
    44.      instance:{
      45. 
-
    45.          /**@lends patio.associations.ManyToMany.prototype*/
      46. 
-
    46.          type:"manyToMany",
      47. 
+
    47.          /**
      48. 
+
    48.           * Set to false to prevent the reload of a model after saving.
      49. 
+
    49.           * @default true
      50. 
+
    50.           */
      51. 
+
    51.          reloadOnSave:true,
      52. 
 
    52.  
      53. 
-
    53.          _fetchMethod:"all",
      54. 
+
    54.          /**
      55. 
+
    55.           * Columns that should be restriced when setting values through the {@link patio.Model#set} method.
      56. 
+
    56.           *
      57. 
+
    57.           */
      58. 
+
    58.          restrictedColumns:null,
      59. 
 
    59.  
      60. 
-
    60.          supportsStringKey:false,
      61. 
+
    61.          /**
      62. 
+
    62.           * Set to false to prevent the reload of a model after updating.
      63. 
+
    63.           * @default true
      64. 
+
    64.           */
      65. 
+
    65.          reloadOnUpdate:true,
      66. 
 
    66.  
      67. 
-
    67.          supportsCompositeKey:false,
      68. 
 
    68.  
      69. 
+
    69.          __camelize:false,
      70. 
+
    70.  
      71. 
+
    71.          __underscore:false,
      72. 
 
    72.  
      73. 
-
    73.          _filter:function (parent) {
      74. 
-
    74. 326            var keys = this._getAssociationKey(parent);
      75. 
-
    75. 326            var options = this.__opts || {};
      76. 
-
    76. 326            var ds;
      77. 
-
    77. 326            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
      78. 
-
    78. 0                ds = ds.apply(parent, [parent]);
      79. 
-
    79.              }
      80. 
-
    80. 326            if (!ds) {
      81. 
-
    81. 326                ds = this.model.dataset;
      82. 
-
    82. 326                ds = ds.select(ds.firstSourceAlias.all()).naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
      83. 
-
    83. 326                    return sql.stringToIdentifier(k);
      84. 
-
    84.                  })).concat(zip(keys[0], this.parentPrimaryKey.map(function (k) {
      85. 
-
    85. 326                    return parent[k];
      86. 
-
    86.                  }))));
      87. 
-
    87. 326                var recip = this.model._findAssociation(this);
      88. 
-
    88. 326                if (recip) {
      89. 
-
    89. 326                    recip = recip[1];
      90. 
-
    90.                  }
      91. 
-
    91. 326                ds.rowCb = hitch(this, function (item) {
      92. 
-
    92. 340                    var ret = new Promise();
      93. 
-
    93. 340                    var model = this._toModel(item, true);
      94. 
-
    94. 340                    if (recip) {
      95. 
-
    95. 340                        recip.__setValue(model, parent);
      96. 
-
    96.                      }
      97. 
-
    97.                      //call hook to finish other model associations
      98. 
-
    98. 340                    model._hook("post", "load").then(hitch(this, function () {
      99. 
-
    99. 340                        ret.callback(model);
      100. 
-
    100.                      }), ret);
      101. 
-
    101. 340                    return ret.promise();
      102. 
-
    102.                  });
      103. 
+
    103.          __columns:null,
      104. 
 
    104.  
      105. 
-
    105.              }
      106. 
+
    106.          __schema:null,
      107. 
 
    107.  
      108. 
-
    108. 326            return this._setDatasetOptions(ds);
      109. 
-
    109.          },
      110. 
+
    110.          __primaryKey:null,
      111. 
 
    111.  
      112. 
-
    112.          _setAssociationKeys:function (parent, model, val) {
      113. 
-
    113. 534            var keys = this._getAssociationKey(parent),
      114. 
-
    114.                  leftKey = keys[0],
      115. 
-
    115.                  parentPk = this.parentPrimaryKey;
      116. 
-
    116. 534            if (!(leftKey && leftKey.length === parentPk.length)) {
      117. 
-
    117. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
      118. 
+
    118.          __dataset:null,
      119. 
+
    119.  
      120. 
+
    120.          __db:null,
      121. 
+
    121.  
      122. 
+
    122.          __tableName:null,
      123. 
+
    123.  
      124. 
+
    124.  
      125. 
+
    125.          /**
      126. 
+
    126.           * The table that this Model represents.
      127. 
+
    127.           * <b>READ ONLY</b>
      128. 
+
    128.           */
      129. 
+
    129.          table:null,
      130. 
+
    130.  
      131. 
+
    131.          /**
      132. 
+
    132.           * patio  - read only
      133. 
+
    133.           *
      134. 
+
    134.           * @type patio
      135. 
+
    135.           */
      136. 
+
    136.          patio:null,
      137. 
+
    137.  
      138. 
+
    138.          init:function () {
      139. 
+
    139. 92            var emitter = new EventEmitter();
      140. 
+
    140. 92            ["addListener", "on", "once", "removeListener",
      141. 
+
    141.                  "removeAllListeners", "setMaxListeners", "listeners", "emit"].forEach(function (name) {
      142. 
+
    142. 736                    this[name] = emitter[name].bind(emitter);
      143. 
+
    143.                  }, this);
      144. 
+
    144. 92            if (this.__tableName) {
      145. 
+
    145. 91                this._setTableName(this.__tableName);
      146. 
 
    146.              }
      147. 
-
    147. 534            for (var i = 0; i < leftKey.length; i++) {
      148. 
-
    148. 534                model[leftKey[i]] = !isUndefined(val) ? val : parent[parentPk[i]];
      149. 
+
    149. 92            if (this.__db) {
      150. 
+
    150. 7                this._setDb(this.__db);
      151. 
 
    151.              }
      152. 
 
    152.          },
      153. 
 
    153.  
      154. 
 
    154.  
      155. 
-
    155.          __createJoinTableInsertRemoveQuery:function (model, item) {
      156. 
-
    156. 176            var q = {};
      157. 
-
    157. 176            var keys = this._getAssociationKey(model),
      158. 
-
    158.                  leftKey = keys[0],
      159. 
-
    159.                  rightKey = keys[1],
      160. 
-
    160.                  parentPk = this.parentPrimaryKey,
      161. 
-
    161.                  modelPk = this.modelPrimaryKey;
      162. 
-
    162. 176            if (!(leftKey && leftKey.length === parentPk.length)) {
      163. 
-
    163. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
      164. 
-
    164.              }
      165. 
-
    165. 176            if (!(rightKey && rightKey.length === modelPk.length)) {
      166. 
-
    166. 0                throw new AssociationError("Invalid rightKey for " + this.name + " : " + rightKey);
      167. 
-
    167.              }
      168. 
-
    168. 176            for (var i = 0; i < leftKey.length; i++) {
      169. 
-
    169. 176                q[leftKey[i]] = model[parentPk[i]];
      170. 
+
    170.          sync:function (cb) {
      171. 
+
    171. 3968            var ret = new Promise();
      172. 
+
    172. 3968            if (!this.synced) {
      173. 
+
    173. 93                var db = this.db, tableName = this.tableName, supers = this.__supers;
      174. 
+
    174. 93                db.schema(tableName).then(hitch(this, function (schema) {
      175. 
+
    175. 93                    if (!this.synced && schema) {
      176. 
+
    176. 93                        this._setSchema(schema);
      177. 
+
    177. 93                        if (supers && supers.length) {
      178. 
+
    178. 3                            new PromiseList(supers.map(function (sup) {
      179. 
+
    179. 3                                return sup.sync();
      180. 
+
    180.                              })).then(hitch(this, function () {
      181. 
+
    181. 3                                this.synced = true;
      182. 
+
    182. 3                                supers.forEach(this.inherits, this);
      183. 
+
    183. 3                                ret.callback(this);
      184. 
+
    184.                              }), ret);
      185. 
+
    185.                          } else {
      186. 
+
    186. 90                            this.synced = true;
      187. 
+
    187. 90                            ret.callback(this);
      188. 
+
    188.                          }
      189. 
+
    189. 93                        this.emit("sync", this);
      190. 
+
    190.                      } else {
      191. 
+
    191. 0                        var error = new ModelError("Unable to find schema for " + tableName);
      192. 
+
    192. 0                        this.emit("error", error);
      193. 
+
    193. 0                        ret.errback(error);
      194. 
+
    194.                      }
      195. 
+
    195.                  }), ret);
      196. 
+
    196.              } else {
      197. 
+
    197. 3875                ret.callback(this);
      198. 
 
    198.              }
      199. 
-
    199. 176            for (i = 0; i < rightKey.length; i++) {
      200. 
-
    200. 176                q[rightKey[i]] = item[modelPk[i]];
      201. 
+
    201. 3968            if (isFunction(cb)) {
      202. 
+
    202. 0                ret.classic(cb);
      203. 
 
    203.              }
      204. 
-
    204. 176            return q;
      205. 
+
    205. 3968            return ret.promise();
      206. 
 
    206.          },
      207. 
 
    207.  
      208. 
-
    208.          _preRemove:function (next, model) {
      209. 
-
    209. 202            if (this.isOwner && !this.isCascading) {
      210. 
-
    210. 202                var q = {};
      211. 
-
    211. 202                this._setAssociationKeys(model, q);
      212. 
-
    212. 202                this.joinTable.where(q).remove().classic(next);
      213. 
-
    213.              } else {
      214. 
-
    214. 0                next();
      215. 
-
    215.              }
      216. 
+
    216.          /**
      217. 
+
    217.           * Stub for plugins to notified of model inheritance
      218. 
+
    218.           *
      219. 
+
    219.           * @param {patio.Model} model a model class to inherit from
      220. 
+
    220.           */
      221. 
+
    221.          inherits:function (model) {
      222. 
 
    222.          },
      223. 
 
    223.  
      224. 
 
    224.  
      225. 
-
    225.          addAssociation:function (item, model, reload) {
      226. 
-
    226. 260            reload = isBoolean(reload) ? reload : false;
      227. 
-
    227. 260            var ret = new Promise().callback(model);
      228. 
-
    228. 260            if (!isUndefinedOrNull(item)) {
      229. 
-
    229. 260                if (!model.isNew) {
      230. 
-
    230. 148                    item = this._toModel(item);
      231. 
-
    231. 148                    var loaded = this.associationLoaded(model);
      232. 
-
    232. 148                    var recip = this.model._findAssociation(this), save = item.isNew;
      233. 
-
    233. 148                    ret = model._checkTransaction(hitch(this, function () {
      234. 
-
    234. 148                        var joinTable = this.joinTable, ret = new Promise();
      235. 
-
    235. 148                        serial([
      236. 
-
    236.                              function () {
      237. 
-
    237. 148                                return save ? item.save() : null;
      238. 
-
    238.                              },
      239. 
-
    239.                              function () {
      240. 
-
    240. 148                                return joinTable.insert(this.__createJoinTableInsertRemoveQuery(model, item));
      241. 
-
    241.                              }.bind(this),
      242. 
-
    242.                              function () {
      243. 
-
    243. 148                                if (recip) {
      244. 
-
    244. 148                                    recip[1].__setValue(item, [model]);
      245. 
-
    245.                                  }
      246. 
-
    246.                              },
      247. 
-
    247.                              function () {
      248. 
-
    248. 148                                if (loaded && reload) {
      249. 
-
    249. 3                                    return this.parent._reloadAssociationsForType(this.type, this.model, model);
      250. 
-
    250.                                  } else {
      251. 
-
    251. 145                                    return model;
      252. 
-
    252.                                  }
      253. 
-
    253.                              }.bind(this)
      254. 
-
    254.                          ]).then(hitchIgnore(ret, "callback", model), ret);
      255. 
-
    255. 148                        return ret.promise();
      256. 
-
    256.                      }));
      257. 
-
    257.                  } else {
      258. 
-
    258. 112                    item = this._toModel(item);
      259. 
-
    259. 112                    var items = this.getAssociation(model);
      260. 
-
    260. 112                    if (isUndefinedOrNull(items)) {
      261. 
-
    261. 39                        this.__setValue(model, [item]);
      262. 
-
    262.                      } else {
      263. 
-
    263. 73                        items.push(item);
      264. 
-
    264.                      }
      265. 
-
    265.                  }
      266. 
-
    266.              }
      267. 
-
    267. 260            return ret.promise();
      268. 
+
    268.          /**
      269. 
+
    269.           * Create a new model initialized with the specified values.
      270. 
+
    270.           *
      271. 
+
    271.           * @param {Object} values  the values to initialize the model with.
      272. 
+
    272.           *
      273. 
+
    273.           * @returns {Model} instantiated model initialized with the values passed in.
      274. 
+
    274.           */
      275. 
+
    275.          create:function (values) {
      276. 
+
    276.              //load an object from an object
      277. 
+
    277. 0            return new this(values, false);
      278. 
 
    278.          },
      279. 
 
    279.  
      280. 
-
    280.          removeItem:function (item, model, remove, reload) {
      281. 
-
    281. 56            reload = isBoolean(reload) ? reload : false;
      282. 
-
    282. 56            remove = isBoolean(remove) ? remove : false;
      283. 
-
    283. 56            var ret = new Promise().callback(model);
      284. 
-
    284. 56            if (!isUndefinedOrNull(item)) {
      285. 
-
    285. 56                if (!model.isNew) {
      286. 
-
    286. 56                    if (isInstanceOf(item, this.model) && !item.isNew) {
      287. 
-
    287. 56                        var loaded = this.associationLoaded(model);
      288. 
-
    288. 56                        remove = remove && !item.isNew;
      289. 
-
    289. 56                        ret = new Promise();
      290. 
-
    290. 56                        model._checkTransaction(hitch(this, function () {
      291. 
-
    291. 56                            return remove ? item.remove() : this.joinTable.where(this.__createJoinTableInsertRemoveQuery(model, item)).remove();
      292. 
-
    292.                          })).then(hitch(this, function () {
      293. 
-
    293. 56                            if (loaded && reload) {
      294. 
-
    294. 18                                return this.parent._reloadAssociationsForType(this.type, this.model, model).then(ret);
      295. 
-
    295.                              } else {
      296. 
-
    296. 38                                ret.callback(model);
      297. 
-
    297.                              }
      298. 
-
    298.                          }), ret);
      299. 
-
    299. 56                        return ret.promise();
      300. 
-
    300.                      }
      301. 
+
    301.          load:function (vals) {
      302. 
+
    302. 924            var ret = new Promise();
      303. 
+
    303.              //sync our model
      304. 
+
    304. 924            this.sync().then(hitch(this, function () {
      305. 
+
    305. 924                var m = new this(vals, true);
      306. 
+
    306.                  //call the hooks!
      307. 
+
    307. 924                m._hook("post", "load").then(function () {
      308. 
+
    308. 924                    ret.callback(m);
      309. 
+
    309.                  }, ret);
      310. 
+
    310.              }), ret);
      311. 
+
    311. 924            return ret.promise();
      312. 
+
    312.          },
      313. 
+
    313.  
      314. 
+
    314.          _checkTransaction:function (opts, cb) {
      315. 
+
    315. 2892            if (isFunction(opts)) {
      316. 
+
    316. 639                cb = opts;
      317. 
+
    317. 639                opts = {};
      318. 
+
    318.              } else {
      319. 
+
    319. 2253                opts = opts || {};
      320. 
+
    320.              }
      321. 
+
    321. 2892            var ret = new Promise(), retVal = null, errored = false;
      322. 
+
    322. 2892            this.sync().then(hitch(this, function () {
      323. 
+
    323. 2892                if (this.useTransaction(opts)) {
      324. 
+
    324. 2892                    this.db.transaction(opts, hitch(this, function () {
      325. 
+
    325. 2892                        return when(cb()).then(function () {
      326. 
+
    326. 2848                            retVal = argsToArray(arguments);
      327. 
+
    327.                          }, function () {
      328. 
+
    328. 44                            retVal = argsToArray(arguments);
      329. 
+
    329. 44                            errored = true;
      330. 
+
    330.                          });
      331. 
+
    331.                      })).then(hitch(this, function () {
      332. 
+
    332. 2848                        ret[errored ? "errback" : "callback"].apply(ret, retVal);
      333. 
+
    333.                      }), hitch(this, function () {
      334. 
+
    334. 44                        if (errored) {
      335. 
+
    335. 44                            ret.errback.apply(ret, retVal);
      336. 
+
    336.                          } else {
      337. 
+
    337. 0                            ret.errback.apply(ret, arguments);
      338. 
+
    338.                          }
      339. 
+
    339.                      }));
      340. 
 
    340.                  } else {
      341. 
-
    341. 0                    item = this._toModel(item);
      342. 
-
    342. 0                    var items = this.getAssociation(model), index;
      343. 
-
    343. 0                    if (!isUndefinedOrNull(items) && (index = items.indexOf(item)) !== -1) {
      344. 
-
    344. 0                        items.splice(index, 1);
      345. 
-
    345.                      }
      346. 
+
    346. 0                    when(cb()).then(ret);
      347. 
 
    347.                  }
      348. 
+
    348.              }), ret);
      349. 
+
    349. 2892            return ret.promise();
      350. 
+
    350.          },
      351. 
+
    351.  
      352. 
+
    352.          /**
      353. 
+
    353.           * @private
      354. 
+
    354.           * Returns a boolean indicating whether or not to use a transaction.
      355. 
+
    355.           * @param {Object} [opts] set a transaction property to override the {@link patio.Model#useTransaction}.
      356. 
+
    356.           */
      357. 
+
    357.          useTransaction:function (opts) {
      358. 
+
    358. 2892            opts = opts || {};
      359. 
+
    359. 2892            return isBoolean(opts.transaction) ? opts.transaction === true : this.useTransactions === true;
      360. 
+
    360.          },
      361. 
+
    361.  
      362. 
+
    362.          _setDataset:function (ds) {
      363. 
+
    363. 3            this.__dataset = ds;
      364. 
+
    364. 3            if (ds.db) {
      365. 
+
    365. 3                this._setDb(ds.db);
      366. 
 
    366.              }
      367. 
-
    367. 0            return ret.promise();
      368. 
 
    368.          },
      369. 
 
    369.  
      370. 
-
    370.          removeAllItems:function (model, remove) {
      371. 
-
    371. 4            remove = isBoolean(remove) ? remove : false;
      372. 
-
    372. 4            var ret = new Promise();
      373. 
-
    373. 4            if (!model.isNew) {
      374. 
-
    374. 4                var q = {}, removeQ = {};
      375. 
-
    375. 4                this._setAssociationKeys(model, q);
      376. 
-
    376. 4                this._setAssociationKeys(model, removeQ, null);
      377. 
-
    377. 4                var loaded = this.associationLoaded(model);
      378. 
-
    378. 4                return model._checkTransaction(hitch(this, function () {
      379. 
-
    379. 4                    var ds = this.model.dataset, ret = new Promise();
      380. 
-
    380. 4                    when(remove ? this._filter(model).forEach(function (m) {
      381. 
-
    381. 6                        return m.remove();
      382. 
-
    382.                      }) : this.joinTable.filter(q).update(removeQ)).then(function () {
      383. 
-
    383. 4                        if (loaded) {
      384. 
-
    384. 2                            this.parent._reloadAssociationsForType(this.type, this.model, model)
      385. 
-
    385.                                  .then(hitchIgnore(ret, "callback", model), ret);
      386. 
-
    386.                          } else {
      387. 
-
    387. 2                            ret.callback(model);
      388. 
-
    388.                          }
      389. 
-
    389.                      }.bind(this), ret);
      390. 
-
    390. 4                    return ret.promise();
      391. 
-
    391.                  }));
      392. 
-
    392.              } else {
      393. 
-
    393.                  //todo we may want to check if any of the items were previously saved items;
      394. 
-
    394. 0                this._clearAssociations(model);
      395. 
-
    395. 0                ret.callback(model);
      396. 
+
    396.          _setDb:function (db) {
      397. 
+
    397. 10            this.__db = db;
      398. 
+
    398.          },
      399. 
+
    399.  
      400. 
+
    400.          _setTableName:function (name) {
      401. 
+
    401. 91            this.__tableName = name;
      402. 
+
    402.          },
      403. 
+
    403.  
      404. 
+
    404.          _setColumns:function (cols) {
      405. 
+
    405. 96            var proto = this.prototype;
      406. 
+
    406. 96            if (this.__columns) {
      407. 
+
    407. 6                this.__columns.forEach(function (name) {
      408. 
+
    408. 16                    delete proto[name];
      409. 
+
    409.                  });
      410. 
 
    410.              }
      411. 
-
    411. 0            return ret.promise();
      412. 
+
    412. 96            this.__columns = cols;
      413. 
+
    413. 96            cols.forEach(function (name) {
      414. 
+
    414. 779                this._defineColumnSetter(name);
      415. 
+
    415. 779                this._defineColumnGetter(name);
      416. 
+
    416.              }, this);
      417. 
+
    417.          },
      418. 
+
    418.  
      419. 
+
    419.          _setPrimaryKey:function (pks) {
      420. 
+
    420. 99            this.__primaryKey = pks || [];
      421. 
+
    421.          },
      422. 
+
    422.  
      423. 
+
    423.          _setSchema:function (schema) {
      424. 
+
    424. 96            var columns = [];
      425. 
+
    425. 96            var pks = [];
      426. 
+
    426. 96            for (var i in schema) {
      427. 
+
    427. 779                var col = schema[i];
      428. 
+
    428. 779                var name = applyColumnTransformMethod(i, this.identifierOutputMethod);
      429. 
+
    429. 779                schema[name] = col;
      430. 
+
    430. 779                columns.push(name);
      431. 
+
    431. 779                col.primaryKey && pks.push(name);
      432. 
+
    432.              }
      433. 
+
    433. 96            this.__schema = schema;
      434. 
+
    434. 96            this._setPrimaryKey(pks);
      435. 
+
    435. 96            this._setColumns(columns);
      436. 
+
    436.          },
      437. 
+
    437.  
      438. 
+
    438.          _defineColumnSetter:function (name) {
      439. 
+
    439.              /*Adds a setter to an object*/
      440. 
+
    440. 779            this.prototype.__defineSetter__(name, function (val) {
      441. 
+
    441. 7556                this._setColumnValue(name, val);
      442. 
+
    442.              });
      443. 
+
    443.          },
      444. 
+
    444.  
      445. 
+
    445.          _defineColumnGetter:function (name) {
      446. 
+
    446. 779            this.prototype.__defineGetter__(name, function () {
      447. 
+
    447. 5427                return this._getColumnValue(name);
      448. 
+
    448.              });
      449. 
 
    449.          },
      450. 
 
    450.  
      451. 
 
    451.  
      452. 
+
    452.          /**
      453. 
+
    453.           * @ignore
      454. 
+
    454.           */
      455. 
 
    455.          getters:{
      456. 
+
    456.              /**@lends patio.Model*/
      457. 
 
    457.  
      458. 
-
    458.              select:function () {
      459. 
-
    459. 326                return this.__select;
      460. 
-
    460.              },
      461. 
+
    461.              /**
      462. 
+
    462.               * Set to true if this models column names should be use the "underscore" method when sending
      463. 
+
    463.               * keys to the database and to "camelize" method on columns returned from the database. If set to false see
      464. 
+
    464.               * {@link patio.Model#underscore}.
      465. 
+
    465.               * @field
      466. 
+
    466.               * @default false
      467. 
+
    467.               * @type {Boolean}
      468. 
+
    468.               */
      469. 
+
    469.              camelize:function (camelize) {
      470. 
+
    470. 10686                return  this.__camelize;
      471. 
 
    471.  
      472. 
-
    472.              defaultLeftKey:function () {
      473. 
-
    473. 1740                return this.__opts.leftKey || this.parent.tableName + "Id";
      474. 
 
    474.              },
      475. 
 
    475.  
      476. 
-
    476.              defaultRightKey:function () {
      477. 
-
    477. 1740                return this.__opts.rightKey || this.model.tableName + "Id";
      478. 
-
    478.              },
      479. 
+
    479.              /**
      480. 
+
    480.               * Set to true if this models column names should be use the "camelize" method when sending
      481. 
+
    481.               * keys to the database and to "underscore" method on columns returned from the database. If set to false see
      482. 
+
    482.               * {@link patio.Model#underscore}.
      483. 
+
    483.               * @field
      484. 
+
    484.               * @default false
      485. 
+
    485.               * @type {Boolean}
      486. 
+
    486.               */
      487. 
+
    487.              underscore:function (underscore) {
      488. 
+
    488. 36                return this.__underscore;
      489. 
 
    489.  
      490. 
-
    490.              parentPrimaryKey:function () {
      491. 
-
    491. 1036                return this.__opts.leftPrimaryKey || this.parent.primaryKey;
      492. 
 
    492.              },
      493. 
 
    493.  
      494. 
-
    494.              modelPrimaryKey:function () {
      495. 
-
    495. 502                return this.__opts.rightPrimaryKey || this.model.primaryKey;
      496. 
-
    496.              },
      497. 
+
    497.              /**@lends patio.Model*/
      498. 
 
    498.  
      499. 
-
    499.              joinTableName:function () {
      500. 
-
    500. 344                if (!this._joinTable) {
      501. 
-
    501. 18                    var options = this.__opts;
      502. 
-
    502. 18                    var joinTable = options.joinTable;
      503. 
-
    503. 18                    if (isUndefined(joinTable)) {
      504. 
-
    504. 18                        var defaultJoinTable = this.defaultJoinTable;
      505. 
-
    505. 18                        if (isUndefined(defaultJoinTable)) {
      506. 
-
    506. 0                            throw new Error("Unable to determine jointable for " + this.name);
      507. 
-
    507.                          } else {
      508. 
-
    508. 18                            this._joinTable = defaultJoinTable;
      509. 
-
    509.                          }
      510. 
-
    510.                      } else {
      511. 
-
    511. 0                        this._joinTable = joinTable;
      512. 
-
    512.                      }
      513. 
-
    513.                  }
      514. 
-
    514. 344                return this._joinTable;
      515. 
+
    515.              /**
      516. 
+
    516.               * The name of the table all instances of the this {@link patio.Model} use.
      517. 
+
    517.               * @field
      518. 
+
    518.               * @ignoreCode
      519. 
+
    519.               * @type String
      520. 
+
    520.               */
      521. 
+
    521.              tableName:function () {
      522. 
+
    522. 6318                return this.__tableName;
      523. 
 
    523.              },
      524. 
 
    524.  
      525. 
-
    525.              //returns our join table model
      526. 
-
    526.              joinTable:function () {
      527. 
-
    527. 380                if (!this.__joinTableDataset) {
      528. 
-
    528. 18                    var ds = this.__joinTableDataset = this.model.dataset.db.from(this.joinTableName), model = this.model, options = this.__opts;
      529. 
-
    529. 18                    var identifierInputMethod = isUndefined(options.identifierInputMethod) ? model.identifierInputMethod : options.identifierInputMethod,
      530. 
-
    530.                          identifierOutputMethod = isUndefined(options.identifierOutputMethod) ? model.identifierOutputMethod : options.identifierOutputMethod;
      531. 
-
    531. 18                    if (identifierInputMethod) {
      532. 
-
    532. 14                        ds.identifierInputMethod = identifierInputMethod;
      533. 
-
    533.                      }
      534. 
-
    534. 18                    if (identifierOutputMethod) {
      535. 
-
    535. 14                        ds.identifierOutputMethod = identifierOutputMethod;
      536. 
-
    536.                      }
      537. 
+
    537.              /**
      538. 
+
    538.               * The database all instances of this {@link patio.Model} use.
      539. 
+
    539.               * @field
      540. 
+
    540.               *  @ignoreCode
      541. 
+
    541.               * @type patio.Database
      542. 
+
    542.               */
      543. 
+
    543.              db:function () {
      544. 
+
    544. 46374                var db = this.__db;
      545. 
+
    545. 46374                if (!db) {
      546. 
+
    546. 86                    db = this.__db = patio.defaultDatabase;
      547. 
 
    547.                  }
      548. 
-
    548. 380                return this.__joinTableDataset;
      549. 
+
    549. 46374                if (!db) {
      550. 
+
    550. 0                    throw new ModelError("patio has not been connected to a database");
      551. 
+
    551.                  }
      552. 
+
    552. 46374                return db;
      553. 
 
    553.              },
      554. 
 
    554.  
      555. 
-
    555.              defaultJoinTable:function () {
      556. 
-
    556. 18                var ret;
      557. 
-
    557. 18                var recip = this.model._findAssociation(this);
      558. 
-
    558. 18                if (recip && recip.length) {
      559. 
-
    559. 18                    var names = [pluralize(this._model), pluralize(recip[1]._model)].sort();
      560. 
-
    560. 18                    names[1] = names[1].charAt(0).toUpperCase() + names[1].substr(1);
      561. 
-
    561. 18                    ret = names.join("");
      562. 
+
    562.              /**
      563. 
+
    563.               * A dataset to use to retrieve instances of this {@link patio.Model{ from the database. The dataset
      564. 
+
    564.               * has the {@link patio.Dataset#rowCb} set to create instances of this model.
      565. 
+
    565.               * @field
      566. 
+
    566.               *  @ignoreCode
      567. 
+
    567.               * @type patio.Dataset
      568. 
+
    568.               */
      569. 
+
    569.              dataset:function () {
      570. 
+
    570. 4836                var ds = this.__dataset;
      571. 
+
    571. 4836                if (!ds) {
      572. 
+
    572. 84                    ds = this.db.from(this.tableName);
      573. 
+
    573. 84                    ds.rowCb = hitch(this, function (vals) {
      574. 
+
    574. 873                        return this.load(vals);
      575. 
+
    575.                      });
      576. 
+
    576. 84                    this.identifierInputMethod && (ds.identifierInputMethod = this.identifierInputMethod);
      577. 
+
    577. 84                    this.identifierOutputMethod && (ds.identifierOutputMethod = this.identifierOutputMethod);
      578. 
+
    578. 84                    this.__dataset = ds;
      579. 
+
    579. 4752                } else if (!ds.rowCb) {
      580. 
+
    580. 6                    ds.rowCb = hitch(this, function rowCb(vals) {
      581. 
+
    581. 25                        return this.load(vals);
      582. 
+
    582.                      });
      583. 
 
    583.                  }
      584. 
-
    584. 18                return ret;
      585. 
+
    585. 4836                return ds;
      586. 
+
    586.              },
      587. 
+
    587.  
      588. 
+
    588.              /**
      589. 
+
    589.               * A list of columns this models table contains.
      590. 
+
    590.               * @field
      591. 
+
    591.               *  @ignoreCode
      592. 
+
    592.               * @type String[]
      593. 
+
    593.  
      594. 
+
    594.               */
      595. 
+
    595.              columns:function () {
      596. 
+
    596. 1128                return this.__columns;
      597. 
+
    597.              },
      598. 
+
    598.  
      599. 
+
    599.              /**
      600. 
+
    600.               * The schema of this {@link patio.Model}'s table. See {@link patio.Database#schema} for details
      601. 
+
    601.               * on the schema object.
      602. 
+
    602.               * @field
      603. 
+
    603.               *  @ignoreCode
      604. 
+
    604.               * @type Object
      605. 
+
    605.               */
      606. 
+
    606.              schema:function () {
      607. 
+
    607. 75103                if (this.synced) {
      608. 
+
    608. 75103                    return this.__schema;
      609. 
+
    609.                  } else {
      610. 
+
    610. 0                    throw new ModelError("Model has not been synced yet");
      611. 
+
    611.                  }
      612. 
+
    612.              },
      613. 
+
    613.  
      614. 
+
    614.              /**
      615. 
+
    615.               * The primaryKey column/s of this {@link patio.Model}
      616. 
+
    616.               * @field
      617. 
+
    617.               *  @ignoreCode
      618. 
+
    618.               */
      619. 
+
    619.              primaryKey:function () {
      620. 
+
    620. 8221                if (this.synced) {
      621. 
+
    621. 8221                    return this.__primaryKey.slice(0);
      622. 
+
    622.                  } else {
      623. 
+
    623. 0                    throw new ModelError("Model has not been synced yet");
      624. 
+
    624.                  }
      625. 
+
    625.              },
      626. 
+
    626.  
      627. 
+
    627.              /**
      628. 
+
    628.               * A reference to the global {@link patio}.
      629. 
+
    629.               * @field
      630. 
+
    630.               *  @ignoreCode
      631. 
+
    631.               */
      632. 
+
    632.              patio:function () {
      633. 
+
    633. 81                return patio || require("./index");
      634. 
+
    634.              }
      635. 
+
    635.          },
      636. 
+
    636.  
      637. 
+
    637.          /**@ignore*/
      638. 
+
    638.          setters:{
      639. 
+
    639.              /**@lends patio.Model*/
      640. 
+
    640.              /**@ignore*/
      641. 
+
    641.              camelize:function (camelize) {
      642. 
+
    642. 26                camelize = camelize === true;
      643. 
+
    643. 26                if (camelize) {
      644. 
+
    644. 26                    this.identifierOutputMethod = "camelize";
      645. 
+
    645. 26                    this.identifierInputMethod = "underscore";
      646. 
+
    646.                  }
      647. 
+
    647. 26                this.__camelize = camelize;
      648. 
+
    648. 26                this.__underscore = !camelize;
      649. 
+
    649.  
      650. 
+
    650.              },
      651. 
+
    651.              /**@ignore*/
      652. 
+
    652.              underscore:function (underscore) {
      653. 
+
    653. 1                underscore = underscore === true;
      654. 
+
    654. 1                if (underscore) {
      655. 
+
    655. 1                    this.identifierOutputMethod = "underscore";
      656. 
+
    656. 1                    this.identifierInputMethod = "camelize";
      657. 
+
    657.                  }
      658. 
+
    658. 1                this.__underscore = underscore;
      659. 
+
    659. 1                this.__camelize = !underscore;
      660. 
+
    660.  
      661. 
 
    661.              }
      662. 
 
    662.          }
      663. 
 
    663.      }
      664. 
-
    664.  });
      665. 
+
    665.  
      666. 
+
    666.  }).as(exports, "Model");
      667. 
+
    667.  
      668. 
+
    668.  
      669. 
+
    669. 1function checkAndAddDBToTable(db, table) {
      670. 
+
    670. 93    if (!table.contains(db)) {
      671. 
+
    671. 34        table.set(db, new HashTable());
      672. 
+
    672.      }
      673. 
+
    673.  }
      674. 
+
    674.  
      675. 
+
    675.  /**@ignore*/
      676. 
+
    676. 1exports.create = function (name, supers, modelOptions) {
      677. 
+
    677. 93    if (!patio) {
      678. 
+
    678. 1        (patio = require("./index"));
      679. 
+
    679. 1        patio.on("disconnect", function () {
      680. 
+
    680. 40            MODELS.clear();
      681. 
+
    681.          });
      682. 
+
    682.      }
      683. 
+
    683. 93    var db, ds, tableName;
      684. 
+
    684. 93    var key, modelKey;
      685. 
+
    685. 93    if (isString(name)) {
      686. 
+
    686. 87        tableName = name;
      687. 
+
    687. 87        key = db = patio.defaultDatabase || "default";
      688. 
+
    688. 6    } else if (isInstanceOf(name, patio.Dataset)) {
      689. 
+
    689. 6        ds = name;
      690. 
+
    690. 6        tableName = ds.firstSourceAlias;
      691. 
+
    691. 6        key = db = ds.db;
      692. 
+
    692.      }
      693. 
+
    693. 93    var hasSuper = false;
      694. 
+
    694. 93    if (isHash(supers) || isUndefinedOrNull(supers)) {
      695. 
+
    695. 90        modelOptions = supers;
      696. 
+
    696. 90        supers = [Model];
      697. 
+
    697.      } else {
      698. 
+
    698. 3        supers = toArray(supers);
      699. 
+
    699. 3        supers = supers.map(function (sup) {
      700. 
+
    700. 3            return exports.getModel(sup, db);
      701. 
+
    701.          });
      702. 
+
    702. 3        hasSuper = true;
      703. 
+
    703.      }
      704. 
+
    704.  
      705. 
+
    705. 93    var model;
      706. 
+
    706. 93    checkAndAddDBToTable(key, MODELS);
      707. 
+
    707.  
      708. 
+
    708. 93    var DEFAULT_PROTO = {instance:{}, "static":{}};
      709. 
+
    709. 93    modelOptions = merge(DEFAULT_PROTO, modelOptions || {});
      710. 
+
    710. 93    modelOptions.instance._hooks = ["save", "update", "remove", "load"];
      711. 
+
    711. 93    modelOptions.instance.__hooks = {pre:{}, post:{}};
      712. 
+
    712.      //Mixin the column setter/getters
      713. 
+
    713. 93    modelOptions["static"].synced = false;
      714. 
+
    714. 93    modelOptions["static"].__tableName = tableName;
      715. 
+
    715. 93    modelOptions["static"].__db = (db === "default" ? null : db);
      716. 
+
    716. 93    modelOptions["static"].__supers = hasSuper ? supers : [];
      717. 
+
    717. 93    modelOptions["static"].__dataset = ds;
      718. 
+
    718. 93    model = define(supers.concat(modelOptions.plugins || []).concat([AssociationPlugin]), modelOptions);
      719. 
+
    719. 93    ["pre", "post"].forEach(function (op) {
      720. 
+
    720. 186        var optionsOp = modelOptions[op];
      721. 
+
    721. 186        if (optionsOp) {
      722. 
+
    722. 0            for (var i in optionsOp) {
      723. 
+
    723. 0                model[op](i, optionsOp[i]);
      724. 
+
    724.              }
      725. 
+
    725.          }
      726. 
+
    726.      });
      727. 
+
    727. 93    if (!(MODELS.get(key).contains(checkAndTransformName(name)))) {
      728. 
+
    728. 61        MODELS.get(key).set(name, model);
      729. 
+
    729.      }
      730. 
+
    730. 93    return model;
      731. 
+
    731.  };
      732. 
+
    732.  
      733. 
+
    733. 1exports.syncModels = function (cb) {
      734. 
+
    734. 35    var ret = new Promise();
      735. 
+
    735. 35    serial(MODELS.entrySet.map(function (entry) {
      736. 
+
    736. 34        return function () {
      737. 
+
    737. 34            var value = entry.value;
      738. 
+
    738. 34            return serial(value.entrySet.map(function (m) {
      739. 
+
    739. 61                return hitch(m.value, "sync");
      740. 
+
    740.              }));
      741. 
+
    741.          };
      742. 
+
    742.      })).then(hitchIgnore(ret, "callback", true), ret);
      743. 
+
    743. 35    if (isFunction(cb)) {
      744. 
+
    744. 0        ret.classic(cb);
      745. 
+
    745.      }
      746. 
+
    746. 35    return ret.promise();
      747. 
+
    747.  };
      748. 
+
    748.  
      749. 
+
    749. 1var checkAndGetModel = function (db, name) {
      750. 
+
    750. 21198    var ret;
      751. 
+
    751. 21198    if (MODELS.contains(db)) {
      752. 
+
    752. 10600        ret = MODELS.get(db).get(checkAndTransformName(name));
      753. 
+
    753.      }
      754. 
+
    754. 21198    return ret;
      755. 
+
    755.  };
      756. 
+
    756.  
      757. 
+
    757.  
      758. 
+
    758. 1exports.getModel = function (name, db) {
      759. 
+
    759. 10603    var ret = null;
      760. 
+
    760. 10603    if (isDefined(name)) {
      761. 
+
    761. 10603        !patio && (patio = require("./index"));
      762. 
+
    762. 10603        if (isFunction(name)) {
      763. 
+
    763. 3            ret = name;
      764. 
+
    764.          } else {
      765. 
+
    765. 10600            if (!db && isInstanceOf(name, patio.Dataset)) {
      766. 
+
    766. 2                db = name.db;
      767. 
+
    767.              }
      768. 
+
    768. 10600            var defaultDb = patio.defaultDatabase;
      769. 
+
    769. 10600            if (db) {
      770. 
+
    770. 10574                ret = checkAndGetModel(db, name);
      771. 
+
    771. 10574                if (!ret && db === defaultDb) {
      772. 
+
    772. 10572                    ret = checkAndGetModel("default", name);
      773. 
+
    773.                  }
      774. 
+
    774.              } else {
      775. 
+
    775. 26                db = patio.defaultDatabase;
      776. 
+
    776. 26                ret = checkAndGetModel(db, name);
      777. 
+
    777. 26                if (!ret) {
      778. 
+
    778. 26                    ret = checkAndGetModel("default", name);
      779. 
+
    779.                  }
      780. 
+
    780.              }
      781. 
+
    781.          }
      782. 
+
    782.      } else {
      783. 
+
    783. 0        ret = name;
      784. 
+
    784.      }
      785. 
+
    785. 10603    if (isUndefinedOrNull(ret)) {
      786. 
+
    786. 0        throw new ModelError("Model " + name + " has not been registered with patio");
      787. 
+
    787.      }
      788. 
+
    788. 10603    return ret;
      789. 
+
    789.  };
      790. 
+
    790.  
      791. 
 
    791.
    -
    +
    -
    database/schema.js
    +
    associations/manyToMany.js
    - Coverage89.45 - SLOC1230 - LOC275 - Missed29 + Coverage89.05 + SLOC308 + LOC137 + Missed15
    - 
    1. 1"use strict";
      2. 
-
    2. 1var comb = require("comb"),
      3. 
-
    3.      isFunction = comb.isFunction,
      4. 
-
    4.      argsToArray = comb.argsToArray,
      5. 
-
    5.      array = comb.array,
      6. 
-
    6.      isArray = comb.isArray,
      7. 
-
    7.      isString = comb.isString,
      8. 
+    
      1. 1var comb = require("comb-proxy"),
        2. 
+
      2.      define = comb.define,
        3. 
 
      3.      isUndefined = comb.isUndefined,
        4. 
-
      4.      isNumber = comb.isNumber,
        5. 
-
      5.      toArray = comb.array.toArray,
        6. 
+
      6.      isUndefinedOrNull = comb.isUndefinedOrNull,
        7. 
+
      7.      isFunction = comb.isFunction,
        8. 
+
      8.      isInstanceOf = comb.isInstanceOf,
        9. 
+
      9.      sql = require("../sql").sql,
        10. 
 
      10.      hitch = comb.hitch,
        11. 
-
      11.      format = comb.string.format,
        12. 
-
      12.      Dataset = require("../dataset"),
        13. 
-
      13.      Promise = comb.Promise,
        14. 
-
      14.      PromiseList = comb.PromiseList,
        15. 
-
      15.      errors = require("../errors"),
        16. 
-
      16.      DatabaseError = errors.DatabaseError,
        17. 
-
      17.      generators = require("./schemaGenerators"),
        18. 
-
      18.      SchemaGenerator = generators.SchemaGenerator,
        19. 
-
      19.      AlterTableGenerator = generators.AlterTableGenerator,
        20. 
-
      20.      sql = require("../sql").sql,
        21. 
-
      21.      Time = sql.Time,
        22. 
-
      22.      TimeStamp = sql.TimeStamp,
        23. 
-
      23.      DateTime = sql.DateTime,
        24. 
-
      24.      Year = sql.Year,
        25. 
-
      25.      Float = sql.Float,
        26. 
-
      26.      Decimal = sql.Decimal,
        27. 
-
      27.      isInstanceOf = comb.isInstanceOf,
        28. 
-
      28.      Identifier = sql.Identifier,
        29. 
-
      29.      QualifiedIdentifier = sql.QualifiedIdentifier,
        30. 
-
      30.      define = comb.define;
        31. 
-
      31.  
        32. 
+
      32.      array = comb.array,
        33. 
+
      33.      isBoolean = comb.isBoolean,
        34. 
+
      34.      serial = comb.serial,
        35. 
+
      35.      when = comb.when,
        36. 
+
      36.      zip = array.zip,
        37. 
+
      37.      Promise = comb.Promise,
        38. 
+
      38.      PromiseList = comb.PromiseList,
        39. 
+
      39.      hitchIgnore = comb.hitchIgnore,
        40. 
+
      40.      OneToMany = require("./oneToMany"),
        41. 
+
      41.      pluralize = comb.pluralize,
        42. 
+
      42.      AssociationError = require("../errors").AssociationError;
        43. 
 
      43.  
        44. 
-
      44. 1define(null, {
        45. 
+
      45. 1var LOGGER = comb.logger("comb.associations.ManyToMany");
        46. 
+
      46.  /**
        47. 
+
      47.   * @class Class to define a manyToMany association.
        48. 
+
      48.   *
        49. 
+
      49.   * </br>
        50. 
+
      50.   * <b>NOT to be instantiated directly</b>
        51. 
+
      51.   * Its just documented for reference.
        52. 
+
      52.   *
        53. 
+
      53.   * @name ManyToMany
        54. 
+
      54.   * @augments patio.associations.OneToMany
        55. 
+
      55.   * @memberOf patio.associations
        56. 
+
      56.   *
        57. 
+
      57.   * @param {String} options.joinTable the joinTable of the association.
        58. 
+
      58.   *
        59. 
+
      59.   *
        60. 
+
      60.   * @property {String} joinTable the join table used in the relation.
        61. 
+
      61.   * */
        62. 
+
      62. 1module.exports = define(OneToMany, {
        63. 
 
      63.      instance:{
        64. 
-
      64.          /**@lends patio.Database.prototype*/
        65. 
+
      65.          /**@lends patio.associations.ManyToMany.prototype*/
        66. 
+
      66.          type:"manyToMany",
        67. 
 
      67.  
        68. 
-
      68.          /**@ignore*/
        69. 
-
      69.          constructor:function () {
        70. 
-
      70. 123            this._super(arguments);
        71. 
-
      71. 123            this.schemas = {};
        72. 
-
      72.          },
        73. 
+
      73.          _fetchMethod:"all",
        74. 
 
      74.  
        75. 
-
      75.          /**
        76. 
-
      76.           * Adds a column to the specified table. This method expects a column name,
        77. 
-
      77.           * a datatype and optionally a hash with additional constraints and options:
        78. 
-
      78.           *
        79. 
-
      79.           * <p>
        80. 
-
      80.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        81. 
-
      81.           *     addColumn call.
        82. 
-
      82.           * </p>
        83. 
-
      83.           *
        84. 
-
      84.           *
        85. 
-
      85.           * @example
        86. 
-
      86.           * //Outside of a table
        87. 
-
      87.           * //ALTER TABLE test ADD COLUMN name text UNIQUE'
        88. 
-
      88.           * DB.addColumn("test", "name", "text", {unique : true});
        89. 
-
      89.           *
        90. 
-
      90.           * @param {String} table the table to add the column to.
        91. 
-
      91.           * @param {String} column the name of the column to add.
        92. 
-
      92.           * @param type datatype of the column
        93. 
-
      93.           * @param {Object} [opts] additional options that can be used when adding a column.
        94. 
-
      94.           * @param {Boolean} [opts.primaryKey] set to true if this column is a primary key.
        95. 
-
      95.           * @param {Boolean} [opts.allowNull] whether or not this column should allow null.
        96. 
-
      96.           * @param {Boolean} [opts.unique] set to true to add a UNIQUE constraint to a column,
        97. 
-
      97.           *
        98. 
-
      98.           * @return {Promise} a promise that is resolved when the ADD COLUMN action is complete.
        99. 
-
      99.           **/
        100. 
-
      100.          addColumn:function (table, column, type, opts) {
        101. 
-
      101. 9            var args = argsToArray(arguments).slice(1);
        102. 
-
      102. 9            return this.alterTable(table, function () {
        103. 
-
      103. 9                this.addColumn.apply(this, args);
        104. 
-
      104.              });
        105. 
-
      105.          },
        106. 
+
      106.          supportsStringKey:false,
        107. 
 
      107.  
        108. 
-
      108.          /**
        109. 
-
      109.           * Adds an index to a table for the given columns
        110. 
-
      110.           *
        111. 
-
      111.           * <p>
        112. 
-
      112.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        113. 
-
      113.           *     addIndex call.
        114. 
-
      114.           * </p>
        115. 
-
      115.           * @example
        116. 
-
      116.           * DB.addIndex("test", "name", {unique : true});
        117. 
-
      117.           *      //=> 'CREATE UNIQUE INDEX test_name_index ON test (name)'
        118. 
-
      118.           * DB.addIndex("test", ["one", "two"]);
        119. 
-
      119.           *      //=> ''CREATE INDEX test_one_two_index ON test (one, two)''
        120. 
-
      120.           *
        121. 
-
      121.           * @param {String} table the table to add the index to.
        122. 
-
      122.           * @param {String|String[]} columns the name of the column/s to create an index for.
        123. 
-
      123.           * @param {Object} [options] additional options that can be used when adding an index.
        124. 
-
      124.           * @param {Boolean} [options.unique] set to true if this this index should have a UNIQUE constraint.
        125. 
-
      125.           * @param {Boolean} [options.ignoreErrors] set to true to ignore errors.
        126. 
-
      126.           *
        127. 
-
      127.           * @return {Promise} a promise that is resolved when the CREATE INDEX action is complete.
        128. 
-
      128.           * */
        129. 
-
      129.          addIndex:function (table, columns, options) {
        130. 
-
      130. 4            options = options || {};
        131. 
-
      131. 4            var ignoreErrors = options.ignoreErrors === true;
        132. 
-
      132. 4            var ret = new Promise();
        133. 
-
      133. 4            this.alterTable(table,function () {
        134. 
-
      134. 4                this.addIndex(columns, options);
        135. 
-
      135.              }).then(ret, function (err) {
        136. 
-
      136. 0                    if (!ignoreErrors) {
        137. 
-
      137. 0                        ret.errback(err);
        138. 
-
      138.                      } else {
        139. 
-
      139. 0                        ret.callback();
        140. 
+
      140.          supportsCompositeKey:false,
        141. 
+
      141.  
        142. 
+
      142.  
        143. 
+
      143.          _filter:function (parent) {
        144. 
+
      144. 326            var keys = this._getAssociationKey(parent);
        145. 
+
      145. 326            var options = this.__opts || {};
        146. 
+
      146. 326            var ds;
        147. 
+
      147. 326            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
        148. 
+
      148. 0                ds = ds.apply(parent, [parent]);
        149. 
+
      149.              }
        150. 
+
      150. 326            if (!ds) {
        151. 
+
      151. 326                ds = this.model.dataset.naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
        152. 
+
      152. 326                    return sql.stringToIdentifier(k);
        153. 
+
      153.                  })).concat(zip(keys[0], this.parentPrimaryKey.map(function (k) {
        154. 
+
      154. 326                    return parent[k];
        155. 
+
      155.                  }))));
        156. 
+
      156. 326                var recip = this.model._findAssociation(this);
        157. 
+
      157. 326                if (recip) {
        158. 
+
      158. 326                    recip = recip[1];
        159. 
+
      159.                  }
        160. 
+
      160. 326                ds.rowCb = hitch(this, function (item) {
        161. 
+
      161. 340                    var ret = new Promise();
        162. 
+
      162. 340                    var model = this._toModel(item, true);
        163. 
+
      163. 340                    if (recip) {
        164. 
+
      164. 340                        recip.__setValue(model, parent);
        165. 
 
      165.                      }
        166. 
+
      166.                      //call hook to finish other model associations
        167. 
+
      167. 340                    model._hook("post", "load").then(hitch(this, function () {
        168. 
+
      168. 340                        ret.callback(model);
        169. 
+
      169.                      }), ret);
        170. 
+
      170. 340                    return ret.promise();
        171. 
 
      171.                  });
        172. 
-
      172. 4            return ret.promise();
        173. 
-
      173.          },
        174. 
-
      174.  
        175. 
-
      175.          /**
        176. 
-
      176.           *  Removes a column from the specified table.
        177. 
-
      177.           * <p>
        178. 
-
      178.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        179. 
-
      179.           *     dropColumn call.
        180. 
-
      180.           * </p>
        181. 
-
      181.           *
        182. 
-
      182.           * @example
        183. 
-
      183.           *   DB.dropColumn("items", "category");
        184. 
-
      184.           *          //=> 'ALTER TABLE items DROP COLUMN category',
        185. 
-
      185.           *
        186. 
-
      186.           * @param {String|patio.sql.Identifier} table the table to alter.
        187. 
-
      187.           * @param {String|patio.sql.Identifier} column the column to drop.
        188. 
-
      188.           *
        189. 
-
      189.           * @return {Promise} a promise that is resolved once the DROP COLUMN action is complete.
        190. 
-
      190.           * */
        191. 
-
      191.          dropColumn:function (table, column) {
        192. 
-
      192. 3            column = argsToArray(arguments).slice(1);
        193. 
-
      193. 3            return this.alterTable(table, function () {
        194. 
-
      194. 3                this.dropColumn.apply(this, column);
        195. 
-
      195.              });
        196. 
-
      196.          },
        197. 
 
      197.  
        198. 
-
      198.          /**
        199. 
-
      199.           * Removes an index for the given table and column/s.
        200. 
-
      200.           *
        201. 
-
      201.           * <p>
        202. 
-
      202.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        203. 
-
      203.           *     dropIndex call.
        204. 
-
      204.           * </p>
        205. 
-
      205.           *
        206. 
-
      206.           * @example
        207. 
-
      207.           *   DB.dropIndex("posts", "title");
        208. 
-
      208.           *      //=>'DROP INDEX posts_title_index
        209. 
-
      209.           *   DB.dropIndex("posts", ["author", "title"]);
        210. 
-
      210.           *      //'DROP INDEX posts_author_title_index'
        211. 
-
      211.           *
        212. 
-
      212.           * @param {String|patio.sql.Identifier} table the table to alter.
        213. 
-
      213.           * @param {String|patio.sql.Identifier} column the name of the column/s the index was created from.
        214. 
-
      214.           *
        215. 
-
      215.           * @return {Promise} a promise that is resolved once the DROP INDEX action is complete.
        216. 
-
      216.           * */
        217. 
-
      217.          dropIndex:function (table, columns, options) {
        218. 
-
      218. 1            var args = argsToArray(arguments).slice(1);
        219. 
-
      219. 1            return this.alterTable(table, function () {
        220. 
-
      220. 1                this.dropIndex.apply(this, args);
        221. 
-
      221.              });
        222. 
-
      222.          },
        223. 
+
      223.              }
        224. 
 
      224.  
        225. 
-
      225.          /**
        226. 
-
      226.           * Renames a column in the specified table.
        227. 
-
      227.           *
        228. 
-
      228.           * <p>
        229. 
-
      229.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        230. 
-
      230.           *     renameColumn call.
        231. 
-
      231.           * </p>
        232. 
-
      232.           *
        233. 
-
      233.           * @example
        234. 
-
      234.           * DB.renameColumn("items", "cntr", "counter");
        235. 
-
      235.           *      //=> ALTER TABLE items RENAME COLUMN cntr TO counter
        236. 
-
      236.           *
        237. 
-
      237.           * @param {String|patio.sql.Identifier} table the table to alter.
        238. 
-
      238.           * @param {String|patio.sql.Identifier} column the name of the column to rename.
        239. 
-
      239.           * @param {String|patio.sql.Identifier} newColumn the new name of the column.
        240. 
-
      240.           *
        241. 
-
      241.           * @return {Promise} a promise that is resolved once the RENAME COLUMN action is complete.
        242. 
-
      242.           * */
        243. 
-
      243.          renameColumn:function (table, column, newColumn) {
        244. 
-
      244. 4            var args = argsToArray(arguments).slice(1);
        245. 
-
      245. 4            return this.alterTable(table, function () {
        246. 
-
      246. 4                this.renameColumn.apply(this, args);
        247. 
-
      247.              });
        248. 
+
      248. 326            return this._setDatasetOptions(ds);
        249. 
 
      249.          },
        250. 
 
      250.  
        251. 
-
      251.  
        252. 
-
      252.          /**
        253. 
-
      253.           *Sets the default value for the given column in the given table:
        254. 
-
      254.           *
        255. 
-
      255.           * <p>
        256. 
-
      256.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        257. 
-
      257.           *     setColumnDefault call.
        258. 
-
      258.           * </p>
        259. 
-
      259.           *
        260. 
-
      260.           * @example
        261. 
-
      261.           * DB.setColumnDefault("items", "category", "misc");
        262. 
-
      262.           *      //=> ALTER TABLE items ALTER COLUMN category SET DEFAULT 'misc'
        263. 
-
      263.           *
        264. 
-
      264.           * @param {String|patio.sql.Identifier} table the table to alter.
        265. 
-
      265.           * @param {String|patio.sql.Identifier} column the name of the column to set the DEFAULT on.
        266. 
-
      266.           * @param  def the new default value of the column.
        267. 
-
      267.           *
        268. 
-
      268.           * @return {Promise} a promise that is resolved once the SET DEFAULT action is complete.
        269. 
-
      269.           * */
        270. 
-
      270.          setColumnDefault:function (table, column, def) {
        271. 
-
      271. 1            var args = argsToArray(arguments).slice(1);
        272. 
-
      272. 1            return this.alterTable(table, function () {
        273. 
-
      273. 1                this.setColumnDefault.apply(this, args);
        274. 
-
      274.              });
        275. 
+
      275.          _setAssociationKeys:function (parent, model, val) {
        276. 
+
      276. 534            var keys = this._getAssociationKey(parent),
        277. 
+
      277.                  leftKey = keys[0],
        278. 
+
      278.                  parentPk = this.parentPrimaryKey;
        279. 
+
      279. 534            if (!(leftKey && leftKey.length === parentPk.length)) {
        280. 
+
      280. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
        281. 
+
      281.              }
        282. 
+
      282. 534            for (var i = 0; i < leftKey.length; i++) {
        283. 
+
      283. 534                model[leftKey[i]] = !isUndefined(val) ? val : parent[parentPk[i]];
        284. 
+
      284.              }
        285. 
 
      285.          },
        286. 
 
      286.  
        287. 
 
      287.  
        288. 
-
      288.          /**
        289. 
-
      289.           *  Set the data type for the given column in the given table:
        290. 
-
      290.           * <p>
        291. 
-
      291.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        292. 
-
      292.           *     setColumnType call.
        293. 
-
      293.           * </p>
        294. 
-
      294.           *
        295. 
-
      295.           * @example
        296. 
-
      296.           * DB.setColumnType("items", "category", String);
        297. 
-
      297.           *      //=> ALTER TABLE items ALTER COLUMN category TYPE varchar(255)
        298. 
-
      298.           *
        299. 
-
      299.           * @param {String|patio.sql.Identifier} table the table to alter.
        300. 
-
      300.           * @param {String|patio.sql.Identifier} column the name of the column to set the TYPE on.
        301. 
-
      301.           * @param  type the datatype of the column.
        302. 
-
      302.           *
        303. 
-
      303.           * @return {Promise} a promise that is resolved once the SET TYPE action is complete.
        304. 
-
      304.           * */
        305. 
-
      305.          setColumnType:function (table, column, type) {
        306. 
-
      306. 3            var args = argsToArray(arguments).slice(1);
        307. 
-
      307. 3            return this.alterTable(table, function () {
        308. 
-
      308. 3                this.setColumnType.apply(this, args);
        309. 
-
      309.              });
        310. 
-
      310.          },
        311. 
-
      311.  
        312. 
-
      312.  
        313. 
-
      313.          /**
        314. 
-
      314.           *  Alters the given table with the specified block.
        315. 
-
      315.           *  <p>
        316. 
-
      316.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being altered. The block
        317. 
-
      317.           *      is also called with the table as the first argument. Within the block you must use
        318. 
-
      318.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
        319. 
-
      319.           *      that is passed in for all alter table operations. See {@link patio.AlterTableGenerator} for
        320. 
-
      320.           *      avaiable operations.
        321. 
-
      321.           *  </p>
        322. 
-
      322.           *
        323. 
-
      323.           *  <p>
        324. 
-
      324.           *      <b>Note</b> that addColumn accepts all the options available for column
        325. 
-
      325.           *      definitions using createTable, and addIndex accepts all the options
        326. 
-
      326.           *      available for index definition.
        327. 
-
      327.           *  </p>
        328. 
-
      328.           *
        329. 
-
      329.           * @example
        330. 
-
      330.           *   //using the table object
        331. 
-
      331.           *   DB.alterTable("items", function(table){
        332. 
-
      332.           *      //you must use the passed in table object.
        333. 
-
      333.           *     table.addColumn("category", "text", {default : 'javascript'});
        334. 
-
      334.           *     table.dropColumn("category");
        335. 
-
      335.           *     table.renameColumn("cntr", "counter");
        336. 
-
      336.           *     table.setColumnType("value", "float");
        337. 
-
      337.           *     table.setColumnDefault("value", "float");
        338. 
-
      338.           *     table.addIndex(["group", "category"]);
        339. 
-
      339.           *     table.dropIndex [:group, :category]
        340. 
-
      340.           *   });
        341. 
-
      341.           *
        342. 
-
      342.           *   //using this
        343. 
-
      343.           *    DB.alterTable("items", function(){
        344. 
-
      344.           *     this.addColumn("category", "text", {default : 'javascript'});
        345. 
-
      345.           *     this.dropColumn("category");
        346. 
-
      346.           *     this.renameColumn("cntr", "counter");
        347. 
-
      347.           *     this.setColumnType("value", "float");
        348. 
-
      348.           *     this.setColumnDefault("value", "float");
        349. 
-
      349.           *     this.addIndex(["group", "category"]);
        350. 
-
      350.           *     this.dropIndex [:group, :category]
        351. 
-
      351.           *   });
        352. 
-
      352.           *
        353. 
-
      353.           *   //This will not work
        354. 
-
      354.           *   DB.alterTable("items", comb.hitch(someObject, function(){
        355. 
-
      355.           *    //This is called in the scope of someObject so this
        356. 
-
      356.           *    //will not work and will throw an error
        357. 
-
      357.           *     this.addColumn("category", "text", {default : 'javascript'});
        358. 
-
      358.           *   }));
        359. 
-
      359.           *
        360. 
-
      360.           *    //This will work
        361. 
-
      361.           *   DB.alterTable("items", comb.hitch(someObject, function(table){
        362. 
-
      362.           *    //This is called in the scope of someObject so you must
        363. 
-
      363.           *    //use the table argument
        364. 
-
      364.           *     table.category("text", {default : 'javascript'});
        365. 
-
      365.           *   }));
        366. 
-
      366.           *
        367. 
-
      367.           *
        368. 
-
      368.           * @param {String|patio.sql.Identifier} table to the table to perform the ALTER TABLE operations on.
        369. 
-
      369.           * @param {Function} block the block to invoke for the ALTER TABLE operations
        370. 
-
      370.           *
        371. 
-
      371.           * @return {Promise} a promise that is resolved once all ALTER TABLE operations have completed.
        372. 
-
      372.           * */
        373. 
-
      373.          alterTable:function (name, generator, block) {
        374. 
-
      374. 84            if (isFunction(generator)) {
        375. 
-
      375. 84                block = generator;
        376. 
-
      376. 84                generator = new AlterTableGenerator(this, block);
        377. 
+
      377.          __createJoinTableInsertRemoveQuery:function (model, item) {
        378. 
+
      378. 176            var q = {};
        379. 
+
      379. 176            var keys = this._getAssociationKey(model),
        380. 
+
      380.                  leftKey = keys[0],
        381. 
+
      381.                  rightKey = keys[1],
        382. 
+
      382.                  parentPk = this.parentPrimaryKey,
        383. 
+
      383.                  modelPk = this.modelPrimaryKey;
        384. 
+
      384. 176            if (!(leftKey && leftKey.length === parentPk.length)) {
        385. 
+
      385. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
        386. 
 
      386.              }
        387. 
-
      387. 84            var ret = new Promise();
        388. 
-
      388. 84            this.__alterTableSqlList(name, generator.operations).then(hitch(this, function (res) {
        389. 
-
      389. 84                var sqls = array.flatten(res.map(function (r) {
        390. 
-
      390. 93                    return r[1];
        391. 
-
      391.                  }));
        392. 
-
      392. 84                var l = sqls.length;
        393. 
-
      393. 84                var drop = hitch(this, function (i) {
        394. 
-
      394. 179                    if (i < l) {
        395. 
-
      395. 95                        var sql = sqls[i++];
        396. 
-
      396. 95                        this.executeDdl(sql).then(hitch(this, drop, i), ret);
        397. 
-
      397.                      } else {
        398. 
-
      398. 84                        this.removeCachedSchema(name);
        399. 
-
      399. 84                        ret.callback();
        400. 
-
      400.                      }
        401. 
-
      401.                  });
        402. 
-
      402. 84                drop(0);
        403. 
-
      403.              }));
        404. 
-
      404. 84            return ret.promise();
        405. 
-
      405.          },
        406. 
-
      406.  
        407. 
-
      407.          /**
        408. 
-
      408.           * Creates a table with the columns given in the provided block:
        409. 
-
      409.           *
        410. 
-
      410.           * <p>
        411. 
-
      411.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being created. The block
        412. 
-
      412.           *      is also called with the table as the first argument. Within the block you must use
        413. 
-
      413.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
        414. 
-
      414.           *      that is passed in for all create table operations. See {@link patio.SchemaGenerator} for
        415. 
-
      415.           *      available operations.
        416. 
-
      416.           *  </p>
        417. 
-
      417.           *
        418. 
-
      418.           *
        419. 
-
      419.           * @example
        420. 
-
      420.           *
        421. 
-
      421.           *   //using the table to create the table
        422. 
-
      422.           *   DB.createTable("posts", function(table){
        423. 
-
      423.           *     table.primaryKey("id");
        424. 
-
      424.           *     table.column('title", "text");
        425. 
-
      425.           *     //you may also invoke the column name as
        426. 
-
      426.           *     //function on the table
        427. 
-
      427.           *     table.content(String);
        428. 
-
      428.           *     table.index(title);
        429. 
-
      429.           *   });
        430. 
-
      430.           *
        431. 
-
      431.           *   //using this to create the table
        432. 
-
      432.           *   DB.createTable("posts", function(){
        433. 
-
      433.           *     this.primaryKey("id");
        434. 
-
      434.           *     this.column('title", "text");
        435. 
-
      435.           *     //you may also invoke the column name as
        436. 
-
      436.           *     //function on the table
        437. 
-
      437.           *     this.content(String);
        438. 
-
      438.           *     this.index(title);
        439. 
-
      439.           *   });
        440. 
-
      440.           *
        441. 
-
      441.           * @param {String|patio.sql.Identifier} name the name of the table to create.
        442. 
-
      442.           * @param {Object} [options] an optional options object
        443. 
-
      443.           * @param {Boolean} [options.temp] set to true if this table is a TEMPORARY table.
        444. 
-
      444.           * @param {Boolean} [options.ignoreIndexErrors] Ignore any errors when creating indexes.
        445. 
-
      445.           * @param {Function} block the block to invoke when creating the table.
        446. 
-
      446.           *
        447. 
-
      447.           * @return {Promise} a promise that is resolved when the CREATE TABLE action is completed.
        448. 
-
      448.           *
        449. 
-
      449.           */
        450. 
-
      450.          createTable:function (name, options, block) {
        451. 
-
      451. 218            if (isFunction(options)) {
        452. 
-
      452. 208                block = options;
        453. 
-
      453. 208                options = {};
        454. 
+
      454. 176            if (!(rightKey && rightKey.length === modelPk.length)) {
        455. 
+
      455. 0                throw new AssociationError("Invalid rightKey for " + this.name + " : " + rightKey);
        456. 
 
      456.              }
        457. 
-
      457. 218            this.removeCachedSchema(name);
        458. 
-
      458. 218            if (isInstanceOf(options, SchemaGenerator)) {
        459. 
-
      459. 0                options = {generator:options};
        460. 
+
      460. 176            for (var i = 0; i < leftKey.length; i++) {
        461. 
+
      461. 176                q[leftKey[i]] = model[parentPk[i]];
        462. 
 
      462.              }
        463. 
-
      463. 218            var generator = options.generator || new SchemaGenerator(this, block);
        464. 
-
      464. 218            return this.__createTableFromGenerator(name, generator, options)
        465. 
-
      465.                  .chain(hitch(this, "__createTableIndexesFromGenerator", name, generator, options))
        466. 
-
      466.                  .promise();
        467. 
+
      467. 176            for (i = 0; i < rightKey.length; i++) {
        468. 
+
      468. 176                q[rightKey[i]] = item[modelPk[i]];
        469. 
+
      469.              }
        470. 
+
      470. 176            return q;
        471. 
 
      471.          },
        472. 
 
      472.  
        473. 
-
      473.          /**
        474. 
-
      474.           * Forcibly creates a table, attempting to drop it unconditionally (and catching any errors), then creating it.
        475. 
-
      475.           * <p>
        476. 
-
      476.           *      See {@link patio.Database#createTable} for parameter types.
        477. 
-
      477.           * </p>
        478. 
-
      478.           *
        479. 
-
      479.           * @example
        480. 
-
      480.           *  // DROP TABLE a
        481. 
-
      481.           *  // CREATE TABLE a (a integer)
        482. 
-
      482.           *   DB.forceCreateTable("a", function(){
        483. 
-
      483.           *      this.a("integer");
        484. 
-
      484.           *   });
        485. 
-
      485.           *
        486. 
-
      486.           **/
        487. 
-
      487.          forceCreateTable:function (name, options, block) {
        488. 
-
      488. 18            return this.dropTable(name)
        489. 
-
      489.                  .chainBoth(hitch(this, this.createTable, name, options, block))
        490. 
-
      490.                  .promise();
        491. 
+
      491.          _preRemove:function (next, model) {
        492. 
+
      492. 202            if (this.isOwner && !this.isCascading) {
        493. 
+
      493. 202                var q = {};
        494. 
+
      494. 202                this._setAssociationKeys(model, q);
        495. 
+
      495. 202                this.joinTable.where(q).remove().classic(next);
        496. 
+
      496.              } else {
        497. 
+
      497. 0                next();
        498. 
+
      498.              }
        499. 
 
      499.          },
        500. 
 
      500.  
        501. 
 
      501.  
        502. 
-
      502.          /**
        503. 
-
      503.           * Creates the table unless the table already exists.
        504. 
-
      504.           * <p>
        505. 
-
      505.           *      See {@link patio.Database#createTable} for parameter types.
        506. 
-
      506.           * </p>
        507. 
-
      507.           */
        508. 
-
      508.          createTableUnlessExists:function (name, options, block) {
        509. 
-
      509. 0            var ret = new Promise();
        510. 
-
      510. 0            this.tableExists(name).then(hitch(this, function (exists) {
        511. 
-
      511. 0                if (!exists) {
        512. 
-
      512. 0                    this.createTable(name, options, block).then(ret);
        513. 
+
      513.          addAssociation:function (item, model, reload) {
        514. 
+
      514. 260            reload = isBoolean(reload) ? reload : false;
        515. 
+
      515. 260            var ret = new Promise().callback(model);
        516. 
+
      516. 260            if (!isUndefinedOrNull(item)) {
        517. 
+
      517. 260                if (!model.isNew) {
        518. 
+
      518. 148                    item = this._toModel(item);
        519. 
+
      519. 148                    var loaded = this.associationLoaded(model);
        520. 
+
      520. 148                    var recip = this.model._findAssociation(this), save = item.isNew;
        521. 
+
      521. 148                    ret = model._checkTransaction(hitch(this, function () {
        522. 
+
      522. 148                        var joinTable = this.joinTable, ret = new Promise();
        523. 
+
      523. 148                        serial([
        524. 
+
      524.                              function () {
        525. 
+
      525. 148                                return save ? item.save() : null;
        526. 
+
      526.                              },
        527. 
+
      527.                              function () {
        528. 
+
      528. 148                                return joinTable.insert(this.__createJoinTableInsertRemoveQuery(model, item));
        529. 
+
      529.                              }.bind(this),
        530. 
+
      530.                              function () {
        531. 
+
      531. 148                                if (recip) {
        532. 
+
      532. 148                                    recip[1].__setValue(item, [model]);
        533. 
+
      533.                                  }
        534. 
+
      534.                              },
        535. 
+
      535.                              function () {
        536. 
+
      536. 148                                if (loaded && reload) {
        537. 
+
      537. 3                                    return this.parent._reloadAssociationsForType(this.type, this.model, model);
        538. 
+
      538.                                  } else {
        539. 
+
      539. 145                                    return model;
        540. 
+
      540.                                  }
        541. 
+
      541.                              }.bind(this)
        542. 
+
      542.                          ]).then(hitchIgnore(ret, "callback", model), ret);
        543. 
+
      543. 148                        return ret.promise();
        544. 
+
      544.                      }));
        545. 
 
      545.                  } else {
        546. 
-
      546. 0                    ret.callback();
        547. 
-
      547.                  }
        548. 
-
      548.              }), ret);
        549. 
-
      549. 0            return ret.promise();
        550. 
-
      550.          },
        551. 
-
      551.  
        552. 
-
      552.          /**
        553. 
-
      553.           * Creates a view, replacing it if it already exists:
        554. 
-
      554.           * @example
        555. 
-
      555.           *   DB.createOrReplaceView("cheapItems", "SELECT * FROM items WHERE price < 100");
        556. 
-
      556.           *      //=> CREATE OR REPLACE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
        557. 
-
      557.           *   DB.createOrReplaceView("miscItems", DB[:items].filter({category : 'misc'}));
        558. 
-
      558.           *     //=> CREATE OR REPLACE VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
        559. 
-
      559.           *
        560. 
-
      560.           * @param {String|patio.sql.Identifier} name the name of the view to create.
        561. 
-
      561.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
        562. 
-
      562.           * view.
        563. 
-
      563.           *
        564. 
-
      564.           * @return {Promise} a promise that is resolved when the CREATE OR REPLACE VIEW action is complete.
        565. 
-
      565.           **/
        566. 
-
      566.          createOrReplaceView:function (name, source) {
        567. 
-
      567. 4            if (isInstanceOf(source, Dataset)) {
        568. 
-
      568. 2                source = source.sql;
        569. 
-
      569.              }
        570. 
-
      570. 4            var ret = new Promise();
        571. 
-
      571. 4            this.executeDdl(format("CREATE OR REPLACE VIEW %s AS %s", this.__quoteSchemaTable(name), source)).then(hitch(this, function () {
        572. 
-
      572. 4                this.removeCachedSchema(name);
        573. 
-
      573. 4                ret.callback();
        574. 
-
      574.              }), ret);
        575. 
-
      575. 4            return ret.promise();
        576. 
-
      576.          },
        577. 
-
      577.  
        578. 
-
      578.          /**
        579. 
-
      579.           * Creates a view based on a dataset or an SQL string:
        580. 
-
      580.           * @example
        581. 
-
      581.           *   DB.createView("cheapItems", "SELECT * FROM items WHERE price < 100");
        582. 
-
      582.           *      //=> CREATE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
        583. 
-
      583.           *   DB.createView("miscItems", DB[:items].filter({category : 'misc'}));
        584. 
-
      584.           *     //=> CREATE  VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
        585. 
-
      585.           *
        586. 
-
      586.           * @param {String|patio.sql.Identifier} name the name of the view to create.
        587. 
-
      587.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
        588. 
-
      588.           * view.
        589. 
-
      589.           **/
        590. 
-
      590.          createView:function (name, source) {
        591. 
-
      591. 4            if (isInstanceOf(source, Dataset)) {
        592. 
-
      592. 2                source = source.sql;
        593. 
+
      593. 112                    item = this._toModel(item);
        594. 
+
      594. 112                    var items = this.getAssociation(model);
        595. 
+
      595. 112                    if (isUndefinedOrNull(items)) {
        596. 
+
      596. 39                        this.__setValue(model, [item]);
        597. 
+
      597.                      } else {
        598. 
+
      598. 73                        items.push(item);
        599. 
+
      599.                      }
        600. 
+
      600.                  }
        601. 
 
      601.              }
        602. 
-
      602. 4            return this.executeDdl(format("CREATE VIEW %s AS %s", this.__quoteSchemaTable(name), source));
        603. 
+
      603. 260            return ret.promise();
        604. 
 
      604.          },
        605. 
 
      605.  
        606. 
-
      606.          /**
        607. 
-
      607.           *  Drops one or more tables corresponding to the given names.
        608. 
-
      608.           *
        609. 
-
      609.           * @example
        610. 
-
      610.           * DB.dropTable("test");
        611. 
-
      611.           *      //=>'DROP TABLE test'
        612. 
-
      612.           * DB.dropTable("a", "bb", "ccc");
        613. 
-
      613.           *      //=>'DROP TABLE a',
        614. 
-
      614.           *      //=>'DROP TABLE bb',
        615. 
-
      615.           *      //=>'DROP TABLE ccc'
        616. 
-
      616.           *
        617. 
-
      617.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
        618. 
-
      618.           * to drop.
        619. 
-
      619.           *
        620. 
-
      620.           * @return {Promise} a promise that is resolved once all tables have been dropped.
        621. 
-
      621.           **/
        622. 
-
      622.          dropTable:function (names) {
        623. 
-
      623. 81            var ret = new Promise(), l = names.length;
        624. 
-
      624. 81            if (isArray(names)) {
        625. 
-
      625. 48                var drop = hitch(this, function (i) {
        626. 
-
      626. 104                    if (i < l) {
        627. 
-
      627. 65                        var name = names[i++];
        628. 
-
      628. 65                        this.executeDdl(this.__dropTableSql(name)).then(hitch(this, function () {
        629. 
-
      629. 56                            this.removeCachedSchema(name);
        630. 
-
      630. 56                            drop(i);
        631. 
+
      631.          removeItem:function (item, model, remove, reload) {
        632. 
+
      632. 56            reload = isBoolean(reload) ? reload : false;
        633. 
+
      633. 56            remove = isBoolean(remove) ? remove : false;
        634. 
+
      634. 56            var ret = new Promise().callback(model);
        635. 
+
      635. 56            if (!isUndefinedOrNull(item)) {
        636. 
+
      636. 56                if (!model.isNew) {
        637. 
+
      637. 56                    if (isInstanceOf(item, this.model) && !item.isNew) {
        638. 
+
      638. 56                        var loaded = this.associationLoaded(model);
        639. 
+
      639. 56                        remove = remove && !item.isNew;
        640. 
+
      640. 56                        ret = new Promise();
        641. 
+
      641. 56                        model._checkTransaction(hitch(this, function () {
        642. 
+
      642. 56                            return remove ? item.remove() : this.joinTable.where(this.__createJoinTableInsertRemoveQuery(model, item)).remove();
        643. 
+
      643.                          })).then(hitch(this, function () {
        644. 
+
      644. 56                            if (loaded && reload) {
        645. 
+
      645. 18                                return this.parent._reloadAssociationsForType(this.type, this.model, model).then(ret);
        646. 
+
      646.                              } else {
        647. 
+
      647. 38                                ret.callback(model);
        648. 
+
      648.                              }
        649. 
 
      649.                          }), ret);
        650. 
-
      650.                      } else {
        651. 
-
      651. 39                        ret.callback();
        652. 
+
      652. 56                        return ret.promise();
        653. 
 
      653.                      }
        654. 
-
      654.                  });
        655. 
-
      655. 48                drop(0);
        656. 
-
      656. 48                return ret.promise();
        657. 
-
      657.              } else {
        658. 
-
      658. 33                return this.dropTable(argsToArray(arguments).filter(function (t) {
        659. 
-
      659. 38                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
        660. 
-
      660.                  }));
        661. 
-
      661.  
        662. 
+
      662.                  } else {
        663. 
+
      663. 0                    item = this._toModel(item);
        664. 
+
      664. 0                    var items = this.getAssociation(model), index;
        665. 
+
      665. 0                    if (!isUndefinedOrNull(items) && (index = items.indexOf(item)) !== -1) {
        666. 
+
      666. 0                        items.splice(index, 1);
        667. 
+
      667.                      }
        668. 
+
      668.                  }
        669. 
 
      669.              }
        670. 
+
      670. 0            return ret.promise();
        671. 
 
      671.          },
        672. 
 
      672.  
        673. 
-
      673.          /**
        674. 
-
      674.           *  Forcible drops one or more tables corresponding to the given names, ignoring errors.
        675. 
-
      675.           *
        676. 
-
      676.           * @example
        677. 
-
      677.           * DB.dropTable("test");
        678. 
-
      678.           *      //=>'DROP TABLE test'
        679. 
-
      679.           * DB.dropTable("a", "bb", "ccc");
        680. 
-
      680.           *      //=>'DROP TABLE a',
        681. 
-
      681.           *      //=>'DROP TABLE bb',
        682. 
-
      682.           *      //=>'DROP TABLE ccc'
        683. 
-
      683.           *
        684. 
-
      684.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
        685. 
-
      685.           * to drop.
        686. 
-
      686.           *
        687. 
-
      687.           * @return {Promise} a promise that is resolved once all tables have been dropped.
        688. 
-
      688.           **/
        689. 
-
      689.          forceDropTable:function (names) {
        690. 
-
      690. 158            var ret = new Promise(), l = names.length;
        691. 
-
      691. 158            if (isArray(names)) {
        692. 
-
      692. 96                var drop = hitch(this, function (i) {
        693. 
-
      693. 241                    if (i < l) {
        694. 
-
      694. 145                        var name = names[i++];
        695. 
-
      695. 145                        this.executeDdl(this.__dropTableSql(name)).both(hitch(this, function () {
        696. 
-
      696. 145                            this.removeCachedSchema(name);
        697. 
-
      697. 145                            drop(i);
        698. 
-
      698.                          }));
        699. 
-
      699.                      } else {
        700. 
-
      700. 96                        ret.callback();
        701. 
-
      701.                      }
        702. 
-
      702.                  });
        703. 
-
      703. 96                drop(0);
        704. 
+
      704.          removeAllItems:function (model, remove) {
        705. 
+
      705. 4            remove = isBoolean(remove) ? remove : false;
        706. 
+
      706. 4            var ret = new Promise();
        707. 
+
      707. 4            if (!model.isNew) {
        708. 
+
      708. 4                var q = {}, removeQ = {};
        709. 
+
      709. 4                this._setAssociationKeys(model, q);
        710. 
+
      710. 4                this._setAssociationKeys(model, removeQ, null);
        711. 
+
      711. 4                var loaded = this.associationLoaded(model);
        712. 
+
      712. 4                return model._checkTransaction(hitch(this, function () {
        713. 
+
      713. 4                    var ds = this.model.dataset, ret = new Promise();
        714. 
+
      714. 4                    when(remove ? this._filter(model).forEach(function (m) {
        715. 
+
      715. 6                        return m.remove();
        716. 
+
      716.                      }) : this.joinTable.filter(q).update(removeQ)).then(function () {
        717. 
+
      717. 4                        if (loaded) {
        718. 
+
      718. 2                            this.parent._reloadAssociationsForType(this.type, this.model, model)
        719. 
+
      719.                                  .then(hitchIgnore(ret, "callback", model), ret);
        720. 
+
      720.                          } else {
        721. 
+
      721. 2                            ret.callback(model);
        722. 
+
      722.                          }
        723. 
+
      723.                      }.bind(this), ret);
        724. 
+
      724. 4                    return ret.promise();
        725. 
+
      725.                  }));
        726. 
 
      726.              } else {
        727. 
-
      727. 62                this.forceDropTable(argsToArray(arguments).filter(function (t) {
        728. 
-
      728. 62                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
        729. 
-
      729.                  })).both(ret);
        730. 
+
      730.                  //todo we may want to check if any of the items were previously saved items;
        731. 
+
      731. 0                this._clearAssociations(model);
        732. 
+
      732. 0                ret.callback(model);
        733. 
 
      733.              }
        734. 
-
      734. 158            return ret.promise();
        735. 
+
      735. 0            return ret.promise();
        736. 
 
      736.          },
        737. 
 
      737.  
        738. 
-
      738.          /**
        739. 
-
      739.           *  Drops one or more views corresponding to the given names.
        740. 
-
      740.           *
        741. 
-
      741.           * @example
        742. 
-
      742.           * DB.dropView("test_view");
        743. 
-
      743.           *      //=>'DROP VIEW test_view'
        744. 
-
      744.           * DB.dropTable("test_view_1", "test_view_2", "test_view_3");
        745. 
-
      745.           *      //=>'DROP VIEW test_view_1',
        746. 
-
      746.           *      //=>'DROP VIEW test_view_2',
        747. 
-
      747.           *      //=>'DROP VIEW test_view_3'
        748. 
-
      748.           *
        749. 
-
      749.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the views
        750. 
-
      750.           * to drop.
        751. 
-
      751.           *
        752. 
-
      752.           * @return {Promise} a promise that is resolved once the view/s have been dropped.
        753. 
-
      753.           **/
        754. 
-
      754.          dropView:function (names) {
        755. 
-
      755. 8            var ret = new Promise(), l = names.length;
        756. 
-
      756. 8            if (isArray(names)) {
        757. 
-
      757. 4                var drop = hitch(this, function (i) {
        758. 
-
      758. 8                    if (i < l) {
        759. 
-
      759. 4                        var name = names[i++];
        760. 
-
      760. 4                        this.executeDdl(format("DROP VIEW %s", this.__quoteSchemaTable(name))).then(hitch(this, function () {
        761. 
-
      761. 4                            this.removeCachedSchema(name);
        762. 
-
      762. 4                            drop(i);
        763. 
-
      763.                          }), ret);
        764. 
-
      764.                      } else {
        765. 
-
      765. 4                        ret.callback();
        766. 
-
      766.                      }
        767. 
-
      767.                  });
        768. 
-
      768. 4                drop(0);
        769. 
-
      769. 4                return ret.promise();
        770. 
-
      770.              } else {
        771. 
-
      771. 4                return this.dropView(argsToArray(arguments).filter(function (t) {
        772. 
-
      772. 4                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
        773. 
-
      773.                  }));
        774. 
 
      774.  
        775. 
-
      775.              }
        776. 
-
      776.          },
        777. 
+
      777.          getters:{
        778. 
 
      778.  
        779. 
-
      779.          /**
        780. 
-
      780.           * Renames a table.
        781. 
-
      781.           *
        782. 
-
      782.           * @example
        783. 
-
      783.           * comb.executeInOrder(DB, function(DB){
        784. 
-
      784.           *   DB.tables(); //=> ["items"]
        785. 
-
      785.           *   DB.renameTable("items", "old_items");
        786. 
-
      786.           *          //=>'ALTER TABLE items RENAME TO old_items'
        787. 
-
      787.           *   DB.tables; //=> ["old_items"]
        788. 
-
      788.           *});
        789. 
-
      789.           *
        790. 
-
      790.           * @param {String|patio.sql.Identifier} name the name of the table to rename
        791. 
-
      791.           * @param {String|patio.sql.Identifier} newName the new name of the table
        792. 
-
      792.           * @return {Promise} a promise that is resolved once the table is renamed.
        793. 
-
      793.           **/
        794. 
-
      794.          renameTable:function (name, newName) {
        795. 
-
      795. 2            return this.executeDdl(this.__renameTableSql(name, newName)).chain(hitch(this, function () {
        796. 
-
      796. 2                this.removeCachedSchema(name);
        797. 
-
      797.              })).promise();
        798. 
+
      798.              select:function () {
        799. 
+
      799. 326                return this.__select;
        800. 
+
      800.              },
        801. 
 
      801.  
        802. 
-
      802.          },
        803. 
+
      803.              defaultLeftKey:function () {
        804. 
+
      804. 1740                return this.__opts.leftKey || this.parent.tableName + "Id";
        805. 
+
      805.              },
        806. 
 
      806.  
        807. 
-
      807.          /**
        808. 
-
      808.           * @private
        809. 
-
      809.           *  The SQL to execute to modify the DDL for the given table name.  op
        810. 
-
      810.           * should be one of the operations returned by the AlterTableGenerator.
        811. 
-
      811.           * */
        812. 
-
      812.          __alterTableSql:function (table, op) {
        813. 
-
      813. 83            var ret = new Promise();
        814. 
-
      814. 83            var quotedName = op.name ? this.__quoteIdentifier(op.name) : null;
        815. 
-
      815. 83            var alterTableOp = null;
        816. 
-
      816. 83            switch (op.op) {
        817. 
-
      817.                  case "addColumn":
        818. 
-
      818. 13                    alterTableOp = format("ADD COLUMN %s", this.__columnDefinitionSql(op));
        819. 
-
      819. 13                    break;
        820. 
-
      820.                  case "dropColumn":
        821. 
-
      821. 4                    alterTableOp = format("DROP COLUMN %s", quotedName);
        822. 
-
      822. 4                    break;
        823. 
-
      823.                  case "renameColumn":
        824. 
-
      824. 52                    alterTableOp = format("RENAME COLUMN %s TO %s", quotedName, this.__quoteIdentifier(op.newName));
        825. 
-
      825. 52                    break;
        826. 
-
      826.                  case "setColumnType":
        827. 
-
      827. 3                    alterTableOp = format("ALTER COLUMN %s TYPE %s", quotedName, this.typeLiteral(op));
        828. 
-
      828. 3                    break;
        829. 
-
      829.                  case "setColumnDefault":
        830. 
-
      830. 2                    alterTableOp = format("ALTER COLUMN %s SET DEFAULT %s", quotedName, this.literal(op["default"]));
        831. 
-
      831. 2                    break;
        832. 
-
      832.                  case "setColumnNull":
        833. 
-
      833. 0                    alterTableOp = format("ALTER COLUMN %s %s NOT NULL", quotedName, op["null"] ? "DROP" : "SET");
        834. 
-
      834. 0                    break;
        835. 
-
      835.                  case "addIndex":
        836. 
-
      836. 5                    return ret.callback(this.__indexDefinitionSql(table, op)).promise();
        837. 
-
      837.                  case "dropIndex":
        838. 
-
      838. 2                    return ret.callback(this.__dropIndexSql(table, op)).promise();
        839. 
-
      839.                  case "addConstraint":
        840. 
-
      840. 1                    alterTableOp = format("ADD %s", this.__constraintDefinitionSql(op));
        841. 
-
      841. 1                    break;
        842. 
-
      842.                  case "dropConstraint":
        843. 
-
      843. 0                    alterTableOp = format("DROP CONSTRAINT %s", quotedName);
        844. 
-
      844. 0                    break;
        845. 
-
      845.                  default :
        846. 
-
      846. 1                    throw new DatabaseError("Invalid altertable operator");
        847. 
+
      847.              defaultRightKey:function () {
        848. 
+
      848. 1740                return this.__opts.rightKey || this.model.tableName + "Id";
        849. 
+
      849.              },
        850. 
+
      850.  
        851. 
+
      851.              parentPrimaryKey:function () {
        852. 
+
      852. 1036                return this.__opts.leftPrimaryKey || this.parent.primaryKey;
        853. 
+
      853.              },
        854. 
+
      854.  
        855. 
+
      855.              modelPrimaryKey:function () {
        856. 
+
      856. 502                return this.__opts.rightPrimaryKey || this.model.primaryKey;
        857. 
+
      857.              },
        858. 
+
      858.  
        859. 
+
      859.              joinTableName:function () {
        860. 
+
      860. 344                if (!this._joinTable) {
        861. 
+
      861. 18                    var options = this.__opts;
        862. 
+
      862. 18                    var joinTable = options.joinTable;
        863. 
+
      863. 18                    if (isUndefined(joinTable)) {
        864. 
+
      864. 18                        var defaultJoinTable = this.defaultJoinTable;
        865. 
+
      865. 18                        if (isUndefined(defaultJoinTable)) {
        866. 
+
      866. 0                            throw new Error("Unable to determine jointable for " + this.name);
        867. 
+
      867.                          } else {
        868. 
+
      868. 18                            this._joinTable = defaultJoinTable;
        869. 
+
      869.                          }
        870. 
+
      870.                      } else {
        871. 
+
      871. 0                        this._joinTable = joinTable;
        872. 
+
      872.                      }
        873. 
+
      873.                  }
        874. 
+
      874. 344                return this._joinTable;
        875. 
+
      875.              },
        876. 
+
      876.  
        877. 
+
      877.              //returns our join table model
        878. 
+
      878.              joinTable:function () {
        879. 
+
      879. 380                if (!this.__joinTableDataset) {
        880. 
+
      880. 18                    var ds = this.__joinTableDataset = this.model.dataset.db.from(this.joinTableName), model = this.model, options = this.__opts;
        881. 
+
      881. 18                    var identifierInputMethod = isUndefined(options.identifierInputMethod) ? model.identifierInputMethod : options.identifierInputMethod,
        882. 
+
      882.                          identifierOutputMethod = isUndefined(options.identifierOutputMethod) ? model.identifierOutputMethod : options.identifierOutputMethod;
        883. 
+
      883. 18                    if (identifierInputMethod) {
        884. 
+
      884. 14                        ds.identifierInputMethod = identifierInputMethod;
        885. 
+
      885.                      }
        886. 
+
      886. 18                    if (identifierOutputMethod) {
        887. 
+
      887. 14                        ds.identifierOutputMethod = identifierOutputMethod;
        888. 
+
      888.                      }
        889. 
+
      889.                  }
        890. 
+
      890. 380                return this.__joinTableDataset;
        891. 
+
      891.              },
        892. 
+
      892.  
        893. 
+
      893.              defaultJoinTable:function () {
        894. 
+
      894. 18                var ret;
        895. 
+
      895. 18                var recip = this.model._findAssociation(this);
        896. 
+
      896. 18                if (recip && recip.length) {
        897. 
+
      897. 18                    var names = [pluralize(this._model), pluralize(recip[1]._model)].sort();
        898. 
+
      898. 18                    names[1] = names[1].charAt(0).toUpperCase() + names[1].substr(1);
        899. 
+
      899. 18                    ret = names.join("");
        900. 
+
      900.                  }
        901. 
+
      901. 18                return ret;
        902. 
 
      902.              }
        903. 
-
      903. 75            return ret.callback(format("ALTER TABLE %s %s", this.__quoteSchemaTable(table), alterTableOp)).promise();
        904. 
-
      904.          },
        905. 
+
      905.          }
        906. 
+
      906.      }
        907. 
+
      907.  });
        908. 
+
      908.  
      
+
    + +
    + + + + + +
    +
    database/schema.js
    +     		+
    + Coverage89.45 + SLOC1230 + LOC275 + Missed29 +
    +
    + 
    1. 1"use strict";
      2. 
+
    2. 1var comb = require("comb"),
      3. 
+
    3.      isFunction = comb.isFunction,
      4. 
+
    4.      argsToArray = comb.argsToArray,
      5. 
+
    5.      array = comb.array,
      6. 
+
    6.      isArray = comb.isArray,
      7. 
+
    7.      isString = comb.isString,
      8. 
+
    8.      isUndefined = comb.isUndefined,
      9. 
+
    9.      isNumber = comb.isNumber,
      10. 
+
    10.      toArray = comb.array.toArray,
      11. 
+
    11.      hitch = comb.hitch,
      12. 
+
    12.      format = comb.string.format,
      13. 
+
    13.      Dataset = require("../dataset"),
      14. 
+
    14.      Promise = comb.Promise,
      15. 
+
    15.      PromiseList = comb.PromiseList,
      16. 
+
    16.      errors = require("../errors"),
      17. 
+
    17.      DatabaseError = errors.DatabaseError,
      18. 
+
    18.      generators = require("./schemaGenerators"),
      19. 
+
    19.      SchemaGenerator = generators.SchemaGenerator,
      20. 
+
    20.      AlterTableGenerator = generators.AlterTableGenerator,
      21. 
+
    21.      sql = require("../sql").sql,
      22. 
+
    22.      Time = sql.Time,
      23. 
+
    23.      TimeStamp = sql.TimeStamp,
      24. 
+
    24.      DateTime = sql.DateTime,
      25. 
+
    25.      Year = sql.Year,
      26. 
+
    26.      Float = sql.Float,
      27. 
+
    27.      Decimal = sql.Decimal,
      28. 
+
    28.      isInstanceOf = comb.isInstanceOf,
      29. 
+
    29.      Identifier = sql.Identifier,
      30. 
+
    30.      QualifiedIdentifier = sql.QualifiedIdentifier,
      31. 
+
    31.      define = comb.define;
      32. 
 
    32.  
      33. 
-
    33.          /**
      34. 
-
    34.           * @private
      35. 
-
    35.           * Array of SQL DDL modification statements for the given table,
      36. 
-
    36.           * corresponding to the DDL changes specified by the operations.
      37. 
-
    37.           * */
      38. 
-
    38.          __alterTableSqlList:function (table, operations) {
      39. 
-
    39. 84            return new PromiseList(operations.map(hitch(this, "__alterTableSql", table)));
      40. 
+
    40.  
      41. 
+
    41. 1define(null, {
      42. 
+
    42.      instance:{
      43. 
+
    43.          /**@lends patio.Database.prototype*/
      44. 
+
    44.  
      45. 
+
    45.          /**@ignore*/
      46. 
+
    46.          constructor:function () {
      47. 
+
    47. 123            this._super(arguments);
      48. 
+
    48. 123            this.schemas = {};
      49. 
 
    49.          },
      50. 
 
    50.  
      51. 
 
    51.          /**
      52. 
-
    52.           * @private
      53. 
-
    53.           * SQL DDL fragment containing the column creation SQL for the given column.
      54. 
+
    54.           * Adds a column to the specified table. This method expects a column name,
      55. 
+
    55.           * a datatype and optionally a hash with additional constraints and options:
      56. 
 
    56.           *
      57. 
-
    57.           * @param column
      58. 
-
    58.           */
      59. 
-
    59.          __columnDefinitionSql:function (column) {
      60. 
-
    60. 644            var sql = [format("%s %s", this.__quoteIdentifier(column.name), this.typeLiteral(column))];
      61. 
-
    61. 644            column.unique && sql.push(this._static.UNIQUE);
      62. 
-
    62. 644            (column.allowNull === false || column["null"] === false) && sql.push(this._static.NOT_NULL);
      63. 
-
    63. 644            (column.allowNull === true || column["null"] === true) && sql.push(this._static.NULL);
      64. 
-
    64. 644            !isUndefined(column["default"]) && sql.push(format(" DEFAULT %s", this.literal(column["default"])));
      65. 
-
    65. 644            column.primaryKey && sql.push(this._static.PRIMARY_KEY);
      66. 
-
    66. 644            column.autoIncrement && sql.push(" " + this.autoIncrementSql);
      67. 
-
    67. 644            column.table && sql.push(this.__columnReferencesColumnConstraintSql(column));
      68. 
-
    68. 644            return sql.join("");
      69. 
+
    69.           * <p>
      70. 
+
    70.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      71. 
+
    71.           *     addColumn call.
      72. 
+
    72.           * </p>
      73. 
+
    73.           *
      74. 
+
    74.           *
      75. 
+
    75.           * @example
      76. 
+
    76.           * //Outside of a table
      77. 
+
    77.           * //ALTER TABLE test ADD COLUMN name text UNIQUE'
      78. 
+
    78.           * DB.addColumn("test", "name", "text", {unique : true});
      79. 
+
    79.           *
      80. 
+
    80.           * @param {String} table the table to add the column to.
      81. 
+
    81.           * @param {String} column the name of the column to add.
      82. 
+
    82.           * @param type datatype of the column
      83. 
+
    83.           * @param {Object} [opts] additional options that can be used when adding a column.
      84. 
+
    84.           * @param {Boolean} [opts.primaryKey] set to true if this column is a primary key.
      85. 
+
    85.           * @param {Boolean} [opts.allowNull] whether or not this column should allow null.
      86. 
+
    86.           * @param {Boolean} [opts.unique] set to true to add a UNIQUE constraint to a column,
      87. 
+
    87.           *
      88. 
+
    88.           * @return {Promise} a promise that is resolved when the ADD COLUMN action is complete.
      89. 
+
    89.           **/
      90. 
+
    90.          addColumn:function (table, column, type, opts) {
      91. 
+
    91. 9            var args = argsToArray(arguments).slice(1);
      92. 
+
    92. 9            return this.alterTable(table, function () {
      93. 
+
    93. 9                this.addColumn.apply(this, args);
      94. 
+
    94.              });
      95. 
 
    95.          },
      96. 
 
    96.  
      97. 
 
    97.          /**
      98. 
-
    98.           * @private
      99. 
-
    99.           * SQL DDL fragment containing the column creation
      100. 
-
    100.           * SQL for all given columns, used inside a CREATE TABLE block.
      101. 
-
    101.           */
      102. 
-
    102.          __columnListSql:function (generator) {
      103. 
-
    103. 218            return generator.columns.map(hitch(this, "__columnDefinitionSql")).concat(generator.constraints.map(hitch(this, "__constraintDefinitionSql"))).join(this._static.COMMA_SEPARATOR);
      104. 
+
    104.           * Adds an index to a table for the given columns
      105. 
+
    105.           *
      106. 
+
    106.           * <p>
      107. 
+
    107.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      108. 
+
    108.           *     addIndex call.
      109. 
+
    109.           * </p>
      110. 
+
    110.           * @example
      111. 
+
    111.           * DB.addIndex("test", "name", {unique : true});
      112. 
+
    112.           *      //=> 'CREATE UNIQUE INDEX test_name_index ON test (name)'
      113. 
+
    113.           * DB.addIndex("test", ["one", "two"]);
      114. 
+
    114.           *      //=> ''CREATE INDEX test_one_two_index ON test (one, two)''
      115. 
+
    115.           *
      116. 
+
    116.           * @param {String} table the table to add the index to.
      117. 
+
    117.           * @param {String|String[]} columns the name of the column/s to create an index for.
      118. 
+
    118.           * @param {Object} [options] additional options that can be used when adding an index.
      119. 
+
    119.           * @param {Boolean} [options.unique] set to true if this this index should have a UNIQUE constraint.
      120. 
+
    120.           * @param {Boolean} [options.ignoreErrors] set to true to ignore errors.
      121. 
+
    121.           *
      122. 
+
    122.           * @return {Promise} a promise that is resolved when the CREATE INDEX action is complete.
      123. 
+
    123.           * */
      124. 
+
    124.          addIndex:function (table, columns, options) {
      125. 
+
    125. 4            options = options || {};
      126. 
+
    126. 4            var ignoreErrors = options.ignoreErrors === true;
      127. 
+
    127. 4            var ret = new Promise();
      128. 
+
    128. 4            this.alterTable(table,function () {
      129. 
+
    129. 4                this.addIndex(columns, options);
      130. 
+
    130.              }).then(ret, function (err) {
      131. 
+
    131. 0                    if (!ignoreErrors) {
      132. 
+
    132. 0                        ret.errback(err);
      133. 
+
    133.                      } else {
      134. 
+
    134. 0                        ret.callback();
      135. 
+
    135.                      }
      136. 
+
    136.                  });
      137. 
+
    137. 4            return ret.promise();
      138. 
 
    138.          },
      139. 
 
    139.  
      140. 
 
    140.          /**
      141. 
-
    141.           * @private
      142. 
-
    142.           *SQL DDL fragment for column foreign key references (column constraints)
      143. 
-
    143.           */
      144. 
-
    144.          __columnReferencesColumnConstraintSql:function (column) {
      145. 
-
    145. 30            return this.__columnReferencesSql(column);
      146. 
+
    146.           *  Removes a column from the specified table.
      147. 
+
    147.           * <p>
      148. 
+
    148.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      149. 
+
    149.           *     dropColumn call.
      150. 
+
    150.           * </p>
      151. 
+
    151.           *
      152. 
+
    152.           * @example
      153. 
+
    153.           *   DB.dropColumn("items", "category");
      154. 
+
    154.           *          //=> 'ALTER TABLE items DROP COLUMN category',
      155. 
+
    155.           *
      156. 
+
    156.           * @param {String|patio.sql.Identifier} table the table to alter.
      157. 
+
    157.           * @param {String|patio.sql.Identifier} column the column to drop.
      158. 
+
    158.           *
      159. 
+
    159.           * @return {Promise} a promise that is resolved once the DROP COLUMN action is complete.
      160. 
+
    160.           * */
      161. 
+
    161.          dropColumn:function (table, column) {
      162. 
+
    162. 3            column = argsToArray(arguments).slice(1);
      163. 
+
    163. 3            return this.alterTable(table, function () {
      164. 
+
    164. 3                this.dropColumn.apply(this, column);
      165. 
+
    165.              });
      166. 
 
    166.          },
      167. 
 
    167.  
      168. 
 
    168.          /**
      169. 
-
    169.           * @private
      170. 
-
    170.           * SQL DDL fragment for column foreign key references
      171. 
-
    171.           */
      172. 
-
    172.          __columnReferencesSql:function (column) {
      173. 
-
    173. 38            var sql = format(" REFERENCES %s", this.__quoteSchemaTable(column.table));
      174. 
-
    174. 38            column.key && (sql += format("(%s)", array.toArray(column.key).map(this.__quoteIdentifier, this).join(this._static.COMMA_SEPARATOR)));
      175. 
-
    175. 38            column.onDelete && (sql += format(" ON DELETE %s", this.__onDeleteClause(column.onDelete)));
      176. 
-
    176. 38            column.onUpdate && (sql += format(" ON UPDATE %s", this.__onUpdateClause(column.onUpdate)));
      177. 
-
    177. 38            column.deferrable && (sql += " DEFERRABLE INITIALLY DEFERRED");
      178. 
-
    178. 38            return sql;
      179. 
+
    179.           * Removes an index for the given table and column/s.
      180. 
+
    180.           *
      181. 
+
    181.           * <p>
      182. 
+
    182.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      183. 
+
    183.           *     dropIndex call.
      184. 
+
    184.           * </p>
      185. 
+
    185.           *
      186. 
+
    186.           * @example
      187. 
+
    187.           *   DB.dropIndex("posts", "title");
      188. 
+
    188.           *      //=>'DROP INDEX posts_title_index
      189. 
+
    189.           *   DB.dropIndex("posts", ["author", "title"]);
      190. 
+
    190.           *      //'DROP INDEX posts_author_title_index'
      191. 
+
    191.           *
      192. 
+
    192.           * @param {String|patio.sql.Identifier} table the table to alter.
      193. 
+
    193.           * @param {String|patio.sql.Identifier} column the name of the column/s the index was created from.
      194. 
+
    194.           *
      195. 
+
    195.           * @return {Promise} a promise that is resolved once the DROP INDEX action is complete.
      196. 
+
    196.           * */
      197. 
+
    197.          dropIndex:function (table, columns, options) {
      198. 
+
    198. 1            var args = argsToArray(arguments).slice(1);
      199. 
+
    199. 1            return this.alterTable(table, function () {
      200. 
+
    200. 1                this.dropIndex.apply(this, args);
      201. 
+
    201.              });
      202. 
 
    202.          },
      203. 
 
    203.  
      204. 
 
    204.          /**
      205. 
-
    205.           * @private
      206. 
-
    206.           * SQL DDL fragment for table foreign key references (table constraints)
      207. 
+
    207.           * Renames a column in the specified table.
      208. 
+
    208.           *
      209. 
+
    209.           * <p>
      210. 
+
    210.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      211. 
+
    211.           *     renameColumn call.
      212. 
+
    212.           * </p>
      213. 
+
    213.           *
      214. 
+
    214.           * @example
      215. 
+
    215.           * DB.renameColumn("items", "cntr", "counter");
      216. 
+
    216.           *      //=> ALTER TABLE items RENAME COLUMN cntr TO counter
      217. 
+
    217.           *
      218. 
+
    218.           * @param {String|patio.sql.Identifier} table the table to alter.
      219. 
+
    219.           * @param {String|patio.sql.Identifier} column the name of the column to rename.
      220. 
+
    220.           * @param {String|patio.sql.Identifier} newColumn the new name of the column.
      221. 
+
    221.           *
      222. 
+
    222.           * @return {Promise} a promise that is resolved once the RENAME COLUMN action is complete.
      223. 
 
    223.           * */
      224. 
-
    224.          __columnReferencesTableConstraintSql:function (constraint) {
      225. 
-
    225. 6            return format("FOREIGN KEY %s%s", this.literal(constraint.columns.map(function (c) {
      226. 
-
    226. 6                return isString(c) ? sql.stringToIdentifier(c) : c;
      227. 
-
    227.              })), this.__columnReferencesSql(constraint));
      228. 
+
    228.          renameColumn:function (table, column, newColumn) {
      229. 
+
    229. 4            var args = argsToArray(arguments).slice(1);
      230. 
+
    230. 4            return this.alterTable(table, function () {
      231. 
+
    231. 4                this.renameColumn.apply(this, args);
      232. 
+
    232.              });
      233. 
 
    233.          },
      234. 
 
    234.  
      235. 
-
    235.          /**
      236. 
-
    236.           * @private
      237. 
-
    237.           * SQL DDL fragment specifying a constraint on a table.
      238. 
-
    238.           */
      239. 
-
    239.          __constraintDefinitionSql:function (constraint) {
      240. 
-
    240. 6            var ret = [constraint.name ? format("CONSTRAINT %s ", this.__quoteIdentifier(constraint.name)) : ""];
      241. 
-
    241. 6            switch (constraint.type) {
      242. 
-
    242.                  case "check":
      243. 
-
    243. 0                    var check = constraint.check;
      244. 
-
    244. 0                    ret.push(format("CHECK %s", this.__filterExpr(isArray(check) && check.length === 1 ? check[0] : check)));
      245. 
-
    245. 0                    break;
      246. 
-
    246.                  case "primaryKey":
      247. 
-
    247. 0                    ret.push(format("PRIMARY KEY %s", this.literal(constraint.columns.map(function (c) {
      248. 
-
    248. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      249. 
-
    249.                      }))));
      250. 
-
    250. 0                    break;
      251. 
-
    251.                  case "foreignKey":
      252. 
-
    252. 6                    ret.push(this.__columnReferencesTableConstraintSql(constraint));
      253. 
-
    253. 6                    break;
      254. 
-
    254.                  case "unique":
      255. 
-
    255. 0                    ret.push(format("UNIQUE %s", this.literal(constraint.columns.map(function (c) {
      256. 
-
    256. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      257. 
-
    257.                      }))));
      258. 
-
    258. 0                    break;
      259. 
-
    259.                  default:
      260. 
-
    260. 0                    throw new DatabaseError(format("Invalid constriant type %s, should be 'check', 'primaryKey', foreignKey', or 'unique'", constraint.type));
      261. 
-
    261.              }
      262. 
-
    262. 6            return ret.join("");
      263. 
-
    263.          },
      264. 
 
    264.  
      265. 
 
    265.          /**
      266. 
-
    266.           * @private
      267. 
-
    267.           * Execute the create table statements using the generator.
      268. 
+
    268.           *Sets the default value for the given column in the given table:
      269. 
+
    269.           *
      270. 
+
    270.           * <p>
      271. 
+
    271.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      272. 
+
    272.           *     setColumnDefault call.
      273. 
+
    273.           * </p>
      274. 
+
    274.           *
      275. 
+
    275.           * @example
      276. 
+
    276.           * DB.setColumnDefault("items", "category", "misc");
      277. 
+
    277.           *      //=> ALTER TABLE items ALTER COLUMN category SET DEFAULT 'misc'
      278. 
+
    278.           *
      279. 
+
    279.           * @param {String|patio.sql.Identifier} table the table to alter.
      280. 
+
    280.           * @param {String|patio.sql.Identifier} column the name of the column to set the DEFAULT on.
      281. 
+
    281.           * @param  def the new default value of the column.
      282. 
+
    282.           *
      283. 
+
    283.           * @return {Promise} a promise that is resolved once the SET DEFAULT action is complete.
      284. 
 
    284.           * */
      285. 
-
    285.          __createTableFromGenerator:function (name, generator, options) {
      286. 
-
    286. 218            return this.executeDdl(this.__createTableSql(name, generator, options));
      287. 
+
    287.          setColumnDefault:function (table, column, def) {
      288. 
+
    288. 1            var args = argsToArray(arguments).slice(1);
      289. 
+
    289. 1            return this.alterTable(table, function () {
      290. 
+
    290. 1                this.setColumnDefault.apply(this, args);
      291. 
+
    291.              });
      292. 
 
    292.          },
      293. 
 
    293.  
      294. 
-
    294.          /**
      295. 
-
    295.           * @private
      296. 
-
    296.           * Execute the create index statements using the generator.
      297. 
-
    297.           * */
      298. 
-
    298.          __createTableIndexesFromGenerator:function (name, generator, options) {
      299. 
-
    299. 218            var e = options.ignoreIndexErrors;
      300. 
-
    300. 218            var ret = new Promise();
      301. 
-
    301. 218            var promises = generator.indexes.map(function (index) {
      302. 
-
    302. 18                var ps = this.__indexSqlList(name, [index]).map(this.executeDdl, this);
      303. 
-
    303. 18                return new PromiseList(ps);
      304. 
-
    304.              }, this);
      305. 
-
    305. 218            if (promises.length) {
      306. 
-
    306. 16                new PromiseList(promises).then(ret, hitch(ret, e ? "callback" : "errback"));
      307. 
-
    307.              } else {
      308. 
-
    308. 202                ret.callback();
      309. 
-
    309.              }
      310. 
-
    310. 218            return ret.promise();
      311. 
-
    311.          },
      312. 
 
    312.  
      313. 
 
    313.          /**
      314. 
-
    314.           * @private
      315. 
-
    315.           * DDL statement for creating a table with the given name, columns, and options
      316. 
+
    316.           *  Set the data type for the given column in the given table:
      317. 
+
    317.           * <p>
      318. 
+
    318.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      319. 
+
    319.           *     setColumnType call.
      320. 
+
    320.           * </p>
      321. 
+
    321.           *
      322. 
+
    322.           * @example
      323. 
+
    323.           * DB.setColumnType("items", "category", String);
      324. 
+
    324.           *      //=> ALTER TABLE items ALTER COLUMN category TYPE varchar(255)
      325. 
+
    325.           *
      326. 
+
    326.           * @param {String|patio.sql.Identifier} table the table to alter.
      327. 
+
    327.           * @param {String|patio.sql.Identifier} column the name of the column to set the TYPE on.
      328. 
+
    328.           * @param  type the datatype of the column.
      329. 
+
    329.           *
      330. 
+
    330.           * @return {Promise} a promise that is resolved once the SET TYPE action is complete.
      331. 
 
    331.           * */
      332. 
-
    332.          __createTableSql:function (name, generator, options) {
      333. 
-
    333. 218            return format("CREATE %sTABLE %s (%s)", options.temp ? this.temporaryTableSql : "", this.__quoteSchemaTable(name), this.__columnListSql(generator));
      334. 
+
    334.          setColumnType:function (table, column, type) {
      335. 
+
    335. 3            var args = argsToArray(arguments).slice(1);
      336. 
+
    336. 3            return this.alterTable(table, function () {
      337. 
+
    337. 3                this.setColumnType.apply(this, args);
      338. 
+
    338.              });
      339. 
 
    339.          },
      340. 
 
    340.  
      341. 
+
    341.  
      342. 
 
    342.          /**
      343. 
-
    343.           * @private
      344. 
-
    344.           * Default index name for the table and columns, may be too long
      345. 
-
    345.           * for certain databases.
      346. 
-
    346.           */
      347. 
-
    347.          __defaultIndexName:function (tableName, columns) {
      348. 
-
    348. 25            var parts = this.__schemaAndTable(tableName);
      349. 
-
    349. 25            var schema = parts[0], table = parts[1];
      350. 
-
    350. 25            var index = [];
      351. 
-
    351. 25            if (schema && schema !== this.defaultSchema) {
      352. 
-
    352. 0                index.push(schema);
      353. 
+
    353.           *  Alters the given table with the specified block.
      354. 
+
    354.           *  <p>
      355. 
+
    355.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being altered. The block
      356. 
+
    356.           *      is also called with the table as the first argument. Within the block you must use
      357. 
+
    357.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
      358. 
+
    358.           *      that is passed in for all alter table operations. See {@link patio.AlterTableGenerator} for
      359. 
+
    359.           *      avaiable operations.
      360. 
+
    360.           *  </p>
      361. 
+
    361.           *
      362. 
+
    362.           *  <p>
      363. 
+
    363.           *      <b>Note</b> that addColumn accepts all the options available for column
      364. 
+
    364.           *      definitions using createTable, and addIndex accepts all the options
      365. 
+
    365.           *      available for index definition.
      366. 
+
    366.           *  </p>
      367. 
+
    367.           *
      368. 
+
    368.           * @example
      369. 
+
    369.           *   //using the table object
      370. 
+
    370.           *   DB.alterTable("items", function(table){
      371. 
+
    371.           *      //you must use the passed in table object.
      372. 
+
    372.           *     table.addColumn("category", "text", {default : 'javascript'});
      373. 
+
    373.           *     table.dropColumn("category");
      374. 
+
    374.           *     table.renameColumn("cntr", "counter");
      375. 
+
    375.           *     table.setColumnType("value", "float");
      376. 
+
    376.           *     table.setColumnDefault("value", "float");
      377. 
+
    377.           *     table.addIndex(["group", "category"]);
      378. 
+
    378.           *     table.dropIndex [:group, :category]
      379. 
+
    379.           *   });
      380. 
+
    380.           *
      381. 
+
    381.           *   //using this
      382. 
+
    382.           *    DB.alterTable("items", function(){
      383. 
+
    383.           *     this.addColumn("category", "text", {default : 'javascript'});
      384. 
+
    384.           *     this.dropColumn("category");
      385. 
+
    385.           *     this.renameColumn("cntr", "counter");
      386. 
+
    386.           *     this.setColumnType("value", "float");
      387. 
+
    387.           *     this.setColumnDefault("value", "float");
      388. 
+
    388.           *     this.addIndex(["group", "category"]);
      389. 
+
    389.           *     this.dropIndex [:group, :category]
      390. 
+
    390.           *   });
      391. 
+
    391.           *
      392. 
+
    392.           *   //This will not work
      393. 
+
    393.           *   DB.alterTable("items", comb.hitch(someObject, function(){
      394. 
+
    394.           *    //This is called in the scope of someObject so this
      395. 
+
    395.           *    //will not work and will throw an error
      396. 
+
    396.           *     this.addColumn("category", "text", {default : 'javascript'});
      397. 
+
    397.           *   }));
      398. 
+
    398.           *
      399. 
+
    399.           *    //This will work
      400. 
+
    400.           *   DB.alterTable("items", comb.hitch(someObject, function(table){
      401. 
+
    401.           *    //This is called in the scope of someObject so you must
      402. 
+
    402.           *    //use the table argument
      403. 
+
    403.           *     table.category("text", {default : 'javascript'});
      404. 
+
    404.           *   }));
      405. 
+
    405.           *
      406. 
+
    406.           *
      407. 
+
    407.           * @param {String|patio.sql.Identifier} table to the table to perform the ALTER TABLE operations on.
      408. 
+
    408.           * @param {Function} block the block to invoke for the ALTER TABLE operations
      409. 
+
    409.           *
      410. 
+
    410.           * @return {Promise} a promise that is resolved once all ALTER TABLE operations have completed.
      411. 
+
    411.           * */
      412. 
+
    412.          alterTable:function (name, generator, block) {
      413. 
+
    413. 84            if (isFunction(generator)) {
      414. 
+
    414. 84                block = generator;
      415. 
+
    415. 84                generator = new AlterTableGenerator(this, block);
      416. 
 
    416.              }
      417. 
-
    417. 25            index.push(table);
      418. 
-
    418. 25            index = index.concat(columns.map(function (c) {
      419. 
-
    419. 28                return isString(c) ? c : this.literal(c).replace(/\W/g, "");
      420. 
-
    420.              }, this));
      421. 
-
    421. 25            index.push("index");
      422. 
-
    422. 25            return index.join(this._static.UNDERSCORE);
      423. 
-
    423.  
      424. 
+
    424. 84            var ret = new Promise();
      425. 
+
    425. 84            this.__alterTableSqlList(name, generator.operations).then(hitch(this, function (res) {
      426. 
+
    426. 84                var sqls = array.flatten(res.map(function (r) {
      427. 
+
    427. 93                    return r[1];
      428. 
+
    428.                  }));
      429. 
+
    429. 84                var l = sqls.length;
      430. 
+
    430. 84                var drop = hitch(this, function (i) {
      431. 
+
    431. 179                    if (i < l) {
      432. 
+
    432. 95                        var sql = sqls[i++];
      433. 
+
    433. 95                        this.executeDdl(sql).then(hitch(this, drop, i), ret);
      434. 
+
    434.                      } else {
      435. 
+
    435. 84                        this.removeCachedSchema(name);
      436. 
+
    436. 84                        ret.callback();
      437. 
+
    437.                      }
      438. 
+
    438.                  });
      439. 
+
    439. 84                drop(0);
      440. 
+
    440.              }));
      441. 
+
    441. 84            return ret.promise();
      442. 
 
    442.          },
      443. 
 
    443.  
      444. 
 
    444.          /**
      445. 
-
    445.           * @private
      446. 
-
    446.           * The SQL to drop an index for the table.
      447. 
-
    447.           * */
      448. 
-
    448.          __dropIndexSql:function (table, op) {
      449. 
-
    449. 2            return format("DROP INDEX %s", this.__quoteIdentifier(op.name || this.__defaultIndexName(table, op.columns)));
      450. 
-
    450.          },
      451. 
-
    451.  
      452. 
-
    452.          /**
      453. 
-
    453.           * @private
      454. 
+
    454.           * Creates a table with the columns given in the provided block:
      455. 
+
    455.           *
      456. 
+
    456.           * <p>
      457. 
+
    457.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being created. The block
      458. 
+
    458.           *      is also called with the table as the first argument. Within the block you must use
      459. 
+
    459.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
      460. 
+
    460.           *      that is passed in for all create table operations. See {@link patio.SchemaGenerator} for
      461. 
+
    461.           *      available operations.
      462. 
+
    462.           *  </p>
      463. 
+
    463.           *
      464. 
+
    464.           *
      465. 
+
    465.           * @example
      466. 
+
    466.           *
      467. 
+
    467.           *   //using the table to create the table
      468. 
+
    468.           *   DB.createTable("posts", function(table){
      469. 
+
    469.           *     table.primaryKey("id");
      470. 
+
    470.           *     table.column('title", "text");
      471. 
+
    471.           *     //you may also invoke the column name as
      472. 
+
    472.           *     //function on the table
      473. 
+
    473.           *     table.content(String);
      474. 
+
    474.           *     table.index(title);
      475. 
+
    475.           *   });
      476. 
+
    476.           *
      477. 
+
    477.           *   //using this to create the table
      478. 
+
    478.           *   DB.createTable("posts", function(){
      479. 
+
    479.           *     this.primaryKey("id");
      480. 
+
    480.           *     this.column('title", "text");
      481. 
+
    481.           *     //you may also invoke the column name as
      482. 
+
    482.           *     //function on the table
      483. 
+
    483.           *     this.content(String);
      484. 
+
    484.           *     this.index(title);
      485. 
+
    485.           *   });
      486. 
+
    486.           *
      487. 
+
    487.           * @param {String|patio.sql.Identifier} name the name of the table to create.
      488. 
+
    488.           * @param {Object} [options] an optional options object
      489. 
+
    489.           * @param {Boolean} [options.temp] set to true if this table is a TEMPORARY table.
      490. 
+
    490.           * @param {Boolean} [options.ignoreIndexErrors] Ignore any errors when creating indexes.
      491. 
+
    491.           * @param {Function} block the block to invoke when creating the table.
      492. 
+
    492.           *
      493. 
+
    493.           * @return {Promise} a promise that is resolved when the CREATE TABLE action is completed.
      494. 
 
    494.           *
      495. 
-
    495.           *  SQL DDL statement to drop the table with the given name.
      496. 
-
    496.           **/
      497. 
-
    497.          __dropTableSql:function (name) {
      498. 
-
    498. 210            return format("DROP TABLE %s", this.__quoteSchemaTable(name));
      499. 
-
    499.          },
      500. 
-
    500.  
      501. 
-
    501.          /**
      502. 
-
    502.           * @private
      503. 
-
    503.           * Proxy the filterExpr call to the dataset, used for creating constraints.
      504. 
-
    504.           * */
      505. 
-
    505.          __filterExpr:function (args, block) {
      506. 
-
    506. 2            var ds = this.__schemaUtiltyDataset;
      507. 
-
    507. 2            return ds.literal(ds._filterExpr.apply(ds, arguments));
      508. 
-
    508.          },
      509. 
-
    509.  
      510. 
-
    510.  
      511. 
-
    511.          /**
      512. 
-
    512.           * @private
      513. 
-
    513.           * SQL DDL statement for creating an index for the table with the given name
      514. 
-
    514.           * and index specifications.
      515. 
 
    515.           */
      516. 
-
    516.          __indexDefinitionSql:function (tableName, index) {
      517. 
-
    517. 7            var indexName = index.name || this.__defaultIndexName(tableName, index.columns);
      518. 
-
    518. 7            if (index.type) {
      519. 
-
    519. 0                throw new DatabaseError("Index types are not supported for this database");
      520. 
-
    520. 7            } else if (index.where) {
      521. 
-
    521. 0                throw new DatabaseError("Partial indexes are not supported for this database");
      522. 
-
    522.              } else {
      523. 
-
    523. 7                return format("CREATE %sINDEX %s ON %s %s", index.unique ? "UNIQUE " : "", this.__quoteIdentifier(indexName), this.__quoteSchemaTable(tableName), this.literal(index.columns.map(function (c) {
      524. 
-
    524. 8                    return isString(c) ? new Identifier(c) : c;
      525. 
-
    525.                  })));
      526. 
+
    526.          createTable:function (name, options, block) {
      527. 
+
    527. 218            if (isFunction(options)) {
      528. 
+
    528. 208                block = options;
      529. 
+
    529. 208                options = {};
      530. 
+
    530.              }
      531. 
+
    531. 218            this.removeCachedSchema(name);
      532. 
+
    532. 218            if (isInstanceOf(options, SchemaGenerator)) {
      533. 
+
    533. 0                options = {generator:options};
      534. 
 
    534.              }
      535. 
+
    535. 218            var generator = options.generator || new SchemaGenerator(this, block);
      536. 
+
    536. 218            return this.__createTableFromGenerator(name, generator, options)
      537. 
+
    537.                  .chain(hitch(this, "__createTableIndexesFromGenerator", name, generator, options))
      538. 
+
    538.                  .promise();
      539. 
 
    539.          },
      540. 
 
    540.  
      541. 
 
    541.          /**
      542. 
-
    542.           * Array of SQL DDL statements, one for each index specification,
      543. 
-
    543.           * for the given table.
      544. 
-
    544.           */
      545. 
-
    545.          __indexSqlList:function (tableName, indexes) {
      546. 
-
    546. 18            return indexes.map(hitch(this, this.__indexDefinitionSql, tableName));
      547. 
+
    547.           * Forcibly creates a table, attempting to drop it unconditionally (and catching any errors), then creating it.
      548. 
+
    548.           * <p>
      549. 
+
    549.           *      See {@link patio.Database#createTable} for parameter types.
      550. 
+
    550.           * </p>
      551. 
+
    551.           *
      552. 
+
    552.           * @example
      553. 
+
    553.           *  // DROP TABLE a
      554. 
+
    554.           *  // CREATE TABLE a (a integer)
      555. 
+
    555.           *   DB.forceCreateTable("a", function(){
      556. 
+
    556.           *      this.a("integer");
      557. 
+
    557.           *   });
      558. 
+
    558.           *
      559. 
+
    559.           **/
      560. 
+
    560.          forceCreateTable:function (name, options, block) {
      561. 
+
    561. 18            return this.dropTable(name)
      562. 
+
    562.                  .chainBoth(hitch(this, this.createTable, name, options, block))
      563. 
+
    563.                  .promise();
      564. 
 
    564.          },
      565. 
 
    565.  
      566. 
-
    566.          /**
      567. 
-
    567.           * @private
      568. 
-
    568.           * SQL DDL ON DELETE fragment to use, based on the given action.
      569. 
-
    569.           *The following actions are recognized:
      570. 
-
    570.           * <ul>
      571. 
-
    571.           *  <li>cascade - Delete rows referencing this row.</li>
      572. 
-
    572.           *  <li>noAction (default) - Raise an error if other rows reference this
      573. 
-
    573.           *   row, allow deferring of the integrity check.
      574. 
-
    574.           *  </li>
      575. 
-
    575.           *  <li>restrict - Raise an error if other rows reference this row,
      576. 
-
    576.           *   but do not allow deferring the integrity check.</li>
      577. 
-
    577.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      578. 
-
    578.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      579. 
-
    579.           * </ul>
      580. 
-
    580.           */
      581. 
-
    581.          __onDeleteClause:function (action) {
      582. 
-
    582. 23            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      583. 
-
    583.          },
      584. 
 
    584.  
      585. 
 
    585.          /**
      586. 
-
    586.           * @private
      587. 
-
    587.           * SQL DDL ON UPDATE fragment to use, based on the given action.
      588. 
-
    588.           *The following actions are recognized:
      589. 
-
    589.           * <ul>
      590. 
-
    590.           *  <li>cascade - Delete rows referencing this row.</li>
      591. 
-
    591.           *  <li>noAction (default) - Raise an error if other rows reference this
      592. 
-
    592.           *   row, allow deferring of the integrity check.
      593. 
-
    593.           *  </li>
      594. 
-
    594.           *  <li>restrict - Raise an error if other rows reference this row,
      595. 
-
    595.           *   but do not allow deferring the integrity check.</li>
      596. 
-
    596.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      597. 
-
    597.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      598. 
-
    598.           * </ul>
      599. 
+
    599.           * Creates the table unless the table already exists.
      600. 
+
    600.           * <p>
      601. 
+
    601.           *      See {@link patio.Database#createTable} for parameter types.
      602. 
+
    602.           * </p>
      603. 
 
    603.           */
      604. 
-
    604.          __onUpdateClause:function (action) {
      605. 
-
    605. 1            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      606. 
+
    606.          createTableUnlessExists:function (name, options, block) {
      607. 
+
    607. 0            var ret = new Promise();
      608. 
+
    608. 0            this.tableExists(name).then(hitch(this, function (exists) {
      609. 
+
    609. 0                if (!exists) {
      610. 
+
    610. 0                    this.createTable(name, options, block).then(ret);
      611. 
+
    611.                  } else {
      612. 
+
    612. 0                    ret.callback();
      613. 
+
    613.                  }
      614. 
+
    614.              }), ret);
      615. 
+
    615. 0            return ret.promise();
      616. 
 
    616.          },
      617. 
 
    617.  
      618. 
 
    618.          /**
      619. 
-
    619.           * @private
      620. 
-
    620.           * Proxy the quoteSchemaTable method to the dataset
      621. 
-
    621.           * */
      622. 
-
    622.          __quoteSchemaTable:function (table) {
      623. 
-
    623. 2212            return this.__schemaUtiltyDataset.quoteSchemaTable(table);
      624. 
+
    624.           * Creates a view, replacing it if it already exists:
      625. 
+
    625.           * @example
      626. 
+
    626.           *   DB.createOrReplaceView("cheapItems", "SELECT * FROM items WHERE price < 100");
      627. 
+
    627.           *      //=> CREATE OR REPLACE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
      628. 
+
    628.           *   DB.createOrReplaceView("miscItems", DB[:items].filter({category : 'misc'}));
      629. 
+
    629.           *     //=> CREATE OR REPLACE VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
      630. 
+
    630.           *
      631. 
+
    631.           * @param {String|patio.sql.Identifier} name the name of the view to create.
      632. 
+
    632.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
      633. 
+
    633.           * view.
      634. 
+
    634.           *
      635. 
+
    635.           * @return {Promise} a promise that is resolved when the CREATE OR REPLACE VIEW action is complete.
      636. 
+
    636.           **/
      637. 
+
    637.          createOrReplaceView:function (name, source) {
      638. 
+
    638. 4            if (isInstanceOf(source, Dataset)) {
      639. 
+
    639. 2                source = source.sql;
      640. 
+
    640.              }
      641. 
+
    641. 4            var ret = new Promise();
      642. 
+
    642. 4            this.executeDdl(format("CREATE OR REPLACE VIEW %s AS %s", this.__quoteSchemaTable(name), source)).then(hitch(this, function () {
      643. 
+
    643. 4                this.removeCachedSchema(name);
      644. 
+
    644. 4                ret.callback();
      645. 
+
    645.              }), ret);
      646. 
+
    646. 4            return ret.promise();
      647. 
 
    647.          },
      648. 
 
    648.  
      649. 
 
    649.          /**
      650. 
-
    650.           * @private
      651. 
-
    651.           * Proxy the quoteIdentifier method to the dataset, used for quoting tables and columns.
      652. 
-
    652.           * */
      653. 
-
    653.          __quoteIdentifier:function (v) {
      654. 
-
    654. 846            return this.__schemaUtiltyDataset.quoteIdentifier(v);
      655. 
+
    655.           * Creates a view based on a dataset or an SQL string:
      656. 
+
    656.           * @example
      657. 
+
    657.           *   DB.createView("cheapItems", "SELECT * FROM items WHERE price < 100");
      658. 
+
    658.           *      //=> CREATE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
      659. 
+
    659.           *   DB.createView("miscItems", DB[:items].filter({category : 'misc'}));
      660. 
+
    660.           *     //=> CREATE  VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
      661. 
+
    661.           *
      662. 
+
    662.           * @param {String|patio.sql.Identifier} name the name of the view to create.
      663. 
+
    663.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
      664. 
+
    664.           * view.
      665. 
+
    665.           **/
      666. 
+
    666.          createView:function (name, source) {
      667. 
+
    667. 4            if (isInstanceOf(source, Dataset)) {
      668. 
+
    668. 2                source = source.sql;
      669. 
+
    669.              }
      670. 
+
    670. 4            return this.executeDdl(format("CREATE VIEW %s AS %s", this.__quoteSchemaTable(name), source));
      671. 
 
    671.          },
      672. 
 
    672.  
      673. 
 
    673.          /**
      674. 
-
    674.           * @private
      675. 
-
    675.           * SQL DDL statement for renaming a table.
      676. 
-
    676.           * */
      677. 
-
    677.          __renameTableSql:function (name, newName) {
      678. 
-
    678. 1            return format("ALTER TABLE %s RENAME TO %s", this.__quoteSchemaTable(name), this.__quoteSchemaTable(newName));
      679. 
-
    679.          },
      680. 
+
    680.           *  Drops one or more tables corresponding to the given names.
      681. 
+
    681.           *
      682. 
+
    682.           * @example
      683. 
+
    683.           * DB.dropTable("test");
      684. 
+
    684.           *      //=>'DROP TABLE test'
      685. 
+
    685.           * DB.dropTable("a", "bb", "ccc");
      686. 
+
    686.           *      //=>'DROP TABLE a',
      687. 
+
    687.           *      //=>'DROP TABLE bb',
      688. 
+
    688.           *      //=>'DROP TABLE ccc'
      689. 
+
    689.           *
      690. 
+
    690.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
      691. 
+
    691.           * to drop.
      692. 
+
    692.           *
      693. 
+
    693.           * @return {Promise} a promise that is resolved once all tables have been dropped.
      694. 
+
    694.           **/
      695. 
+
    695.          dropTable:function (names) {
      696. 
+
    696. 81            var ret = new Promise(), l = names.length;
      697. 
+
    697. 81            if (isArray(names)) {
      698. 
+
    698. 48                var drop = hitch(this, function (i) {
      699. 
+
    699. 104                    if (i < l) {
      700. 
+
    700. 65                        var name = names[i++];
      701. 
+
    701. 65                        this.executeDdl(this.__dropTableSql(name)).then(hitch(this, function () {
      702. 
+
    702. 56                            this.removeCachedSchema(name);
      703. 
+
    703. 56                            drop(i);
      704. 
+
    704.                          }), ret);
      705. 
+
    705.                      } else {
      706. 
+
    706. 39                        ret.callback();
      707. 
+
    707.                      }
      708. 
+
    708.                  });
      709. 
+
    709. 48                drop(0);
      710. 
+
    710. 48                return ret.promise();
      711. 
+
    711.              } else {
      712. 
+
    712. 33                return this.dropTable(argsToArray(arguments).filter(function (t) {
      713. 
+
    713. 38                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
      714. 
+
    714.                  }));
      715. 
 
    715.  
      716. 
-
    716.          /**
      717. 
-
    717.           * @private
      718. 
-
    718.           * Remove the cached schemaUtilityDataset, because the identifier
      719. 
-
    719.           * quoting has changed.
      720. 
-
    720.           */
      721. 
-
    721.          __resetSchemaUtilityDataset:function () {
      722. 
-
    722. 0            this.__schemaUtiltyDs = null;
      723. 
+
    723.              }
      724. 
 
    724.          },
      725. 
 
    725.  
      726. 
 
    726.          /**
      727. 
-
    727.           * @private
      728. 
-
    728.           * Split the schema information from the table
      729. 
-
    729.           * */
      730. 
-
    730.          __schemaAndTable:function (tableName) {
      731. 
-
    731. 244            return  this.__schemaUtiltyDataset.schemaAndTable(tableName);
      732. 
+
    732.           *  Forcible drops one or more tables corresponding to the given names, ignoring errors.
      733. 
+
    733.           *
      734. 
+
    734.           * @example
      735. 
+
    735.           * DB.dropTable("test");
      736. 
+
    736.           *      //=>'DROP TABLE test'
      737. 
+
    737.           * DB.dropTable("a", "bb", "ccc");
      738. 
+
    738.           *      //=>'DROP TABLE a',
      739. 
+
    739.           *      //=>'DROP TABLE bb',
      740. 
+
    740.           *      //=>'DROP TABLE ccc'
      741. 
+
    741.           *
      742. 
+
    742.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
      743. 
+
    743.           * to drop.
      744. 
+
    744.           *
      745. 
+
    745.           * @return {Promise} a promise that is resolved once all tables have been dropped.
      746. 
+
    746.           **/
      747. 
+
    747.          forceDropTable:function (names) {
      748. 
+
    748. 158            var ret = new Promise(), l = names.length;
      749. 
+
    749. 158            if (isArray(names)) {
      750. 
+
    750. 96                var drop = hitch(this, function (i) {
      751. 
+
    751. 241                    if (i < l) {
      752. 
+
    752. 145                        var name = names[i++];
      753. 
+
    753. 145                        this.executeDdl(this.__dropTableSql(name)).both(hitch(this, function () {
      754. 
+
    754. 145                            this.removeCachedSchema(name);
      755. 
+
    755. 145                            drop(i);
      756. 
+
    756.                          }));
      757. 
+
    757.                      } else {
      758. 
+
    758. 96                        ret.callback();
      759. 
+
    759.                      }
      760. 
+
    760.                  });
      761. 
+
    761. 96                drop(0);
      762. 
+
    762.              } else {
      763. 
+
    763. 62                this.forceDropTable(argsToArray(arguments).filter(function (t) {
      764. 
+
    764. 62                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
      765. 
+
    765.                  })).both(ret);
      766. 
+
    766.              }
      767. 
+
    767. 158            return ret.promise();
      768. 
 
    768.          },
      769. 
 
    769.  
      770. 
 
    770.          /**
      771. 
-
    771.           * @private
      772. 
-
    772.           * Return true if the given column schema represents an autoincrementing primary key.
      773. 
+
    773.           *  Drops one or more views corresponding to the given names.
      774. 
 
    774.           *
      775. 
-
    775.           */
      776. 
-
    776.          _schemaAutoincrementingPrimaryKey:function (schema) {
      777. 
-
    777. 0            return !!schema.primaryKey;
      778. 
+
    778.           * @example
      779. 
+
    779.           * DB.dropView("test_view");
      780. 
+
    780.           *      //=>'DROP VIEW test_view'
      781. 
+
    781.           * DB.dropTable("test_view_1", "test_view_2", "test_view_3");
      782. 
+
    782.           *      //=>'DROP VIEW test_view_1',
      783. 
+
    783.           *      //=>'DROP VIEW test_view_2',
      784. 
+
    784.           *      //=>'DROP VIEW test_view_3'
      785. 
+
    785.           *
      786. 
+
    786.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the views
      787. 
+
    787.           * to drop.
      788. 
+
    788.           *
      789. 
+
    789.           * @return {Promise} a promise that is resolved once the view/s have been dropped.
      790. 
+
    790.           **/
      791. 
+
    791.          dropView:function (names) {
      792. 
+
    792. 8            var ret = new Promise(), l = names.length;
      793. 
+
    793. 8            if (isArray(names)) {
      794. 
+
    794. 4                var drop = hitch(this, function (i) {
      795. 
+
    795. 8                    if (i < l) {
      796. 
+
    796. 4                        var name = names[i++];
      797. 
+
    797. 4                        this.executeDdl(format("DROP VIEW %s", this.__quoteSchemaTable(name))).then(hitch(this, function () {
      798. 
+
    798. 4                            this.removeCachedSchema(name);
      799. 
+
    799. 4                            drop(i);
      800. 
+
    800.                          }), ret);
      801. 
+
    801.                      } else {
      802. 
+
    802. 4                        ret.callback();
      803. 
+
    803.                      }
      804. 
+
    804.                  });
      805. 
+
    805. 4                drop(0);
      806. 
+
    806. 4                return ret.promise();
      807. 
+
    807.              } else {
      808. 
+
    808. 4                return this.dropView(argsToArray(arguments).filter(function (t) {
      809. 
+
    809. 4                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
      810. 
+
    810.                  }));
      811. 
+
    811.  
      812. 
+
    812.              }
      813. 
 
    813.          },
      814. 
 
    814.  
      815. 
 
    815.          /**
      816. 
-
    816.           * @private
      817. 
-
    817.           * SQL fragment specifying the type of a given column.
      818. 
-
    818.           * */
      819. 
-
    819.          typeLiteral:function (column) {
      820. 
-
    820. 690            return this.__typeLiteralGeneric(column);
      821. 
+
    821.           * Renames a table.
      822. 
+
    822.           *
      823. 
+
    823.           * @example
      824. 
+
    824.           * comb.executeInOrder(DB, function(DB){
      825. 
+
    825.           *   DB.tables(); //=> ["items"]
      826. 
+
    826.           *   DB.renameTable("items", "old_items");
      827. 
+
    827.           *          //=>'ALTER TABLE items RENAME TO old_items'
      828. 
+
    828.           *   DB.tables; //=> ["old_items"]
      829. 
+
    829.           *});
      830. 
+
    830.           *
      831. 
+
    831.           * @param {String|patio.sql.Identifier} name the name of the table to rename
      832. 
+
    832.           * @param {String|patio.sql.Identifier} newName the new name of the table
      833. 
+
    833.           * @return {Promise} a promise that is resolved once the table is renamed.
      834. 
+
    834.           **/
      835. 
+
    835.          renameTable:function (name, newName) {
      836. 
+
    836. 2            return this.executeDdl(this.__renameTableSql(name, newName)).chain(hitch(this, function () {
      837. 
+
    837. 2                this.removeCachedSchema(name);
      838. 
+
    838.              })).promise();
      839. 
+
    839.  
      840. 
 
    840.          },
      841. 
 
    841.  
      842. 
 
    842.          /**
      843. 
 
    843.           * @private
      844. 
-
    844.           * SQL fragment specifying the full type of a column,
      845. 
-
    845.           * consider the type with possible modifiers.
      846. 
-
    846.           */
      847. 
-
    847.          __typeLiteralGeneric:function (column) {
      848. 
-
    848. 690            var type = column.type;
      849. 
-
    849. 690            var meth = "__typeLiteralGeneric";
      850. 
-
    850. 690            var isStr = isString(type);
      851. 
-
    851. 690            var proper = isStr ? type.charAt(0).toUpperCase() + type.substr(1) : null;
      852. 
-
    852. 690            if (type === String || (isStr && type.match(/string/i))) {
      853. 
-
    853. 198                meth += "String";
      854. 
-
    854. 492            } else if ((isStr && type.match(/number/i)) || type === Number) {
      855. 
-
    855. 12                meth += "Numeric";
      856. 
-
    856. 480            } else if ((isStr && type.match(/datetime/i)) || type === DateTime) {
      857. 
-
    857. 8                meth += "DateTime";
      858. 
-
    858. 472            } else if ((isStr && type.match(/date/i)) || type === Date) {
      859. 
-
    859. 11                meth += "Date";
      860. 
-
    860. 461            } else if ((isStr && type.match(/year/i)) || type === Year) {
      861. 
-
    861. 2                meth += "Year";
      862. 
-
    862. 459            } else if ((isStr && type.match(/timestamp/i))|| type === TimeStamp) {
      863. 
-
    863. 4                meth += "Timestamp";
      864. 
-
    864. 455            } else if ((isStr && type.match(/time/i)) || type === Time) {
      865. 
-
    865. 2                meth += "Time";
      866. 
-
    866. 453            } else if ((isStr && type.match(/decimal/i)) || type === Decimal) {
      867. 
-
    867. 2                meth += "Decimal";
      868. 
-
    868. 451            } else if ((isStr && type.match(/float/i)) || type === Float) {
      869. 
-
    869. 15                meth += "Float";
      870. 
-
    870. 436            } else if ((isStr && type.match(/boolean/i)) || type === Boolean) {
      871. 
-
    871. 5                meth += "Boolean";
      872. 
-
    872. 431            } else if ((isStr && type.match(/buffer/i)) || type === Buffer) {
      873. 
-
    873. 29                meth += "Blob";
      874. 
-
    874. 402            } else if (isStr && isFunction(this[meth + proper])) {
      875. 
-
    875. 138                meth += proper;
      876. 
-
    876.              } else {
      877. 
-
    877. 264                return this.__typeLiteralSpecific(column);
      878. 
+
    878.           *  The SQL to execute to modify the DDL for the given table name.  op
      879. 
+
    879.           * should be one of the operations returned by the AlterTableGenerator.
      880. 
+
    880.           * */
      881. 
+
    881.          __alterTableSql:function (table, op) {
      882. 
+
    882. 83            var ret = new Promise();
      883. 
+
    883. 83            var quotedName = op.name ? this.__quoteIdentifier(op.name) : null;
      884. 
+
    884. 83            var alterTableOp = null;
      885. 
+
    885. 83            switch (op.op) {
      886. 
+
    886.                  case "addColumn":
      887. 
+
    887. 13                    alterTableOp = format("ADD COLUMN %s", this.__columnDefinitionSql(op));
      888. 
+
    888. 13                    break;
      889. 
+
    889.                  case "dropColumn":
      890. 
+
    890. 4                    alterTableOp = format("DROP COLUMN %s", quotedName);
      891. 
+
    891. 4                    break;
      892. 
+
    892.                  case "renameColumn":
      893. 
+
    893. 52                    alterTableOp = format("RENAME COLUMN %s TO %s", quotedName, this.__quoteIdentifier(op.newName));
      894. 
+
    894. 52                    break;
      895. 
+
    895.                  case "setColumnType":
      896. 
+
    896. 3                    alterTableOp = format("ALTER COLUMN %s TYPE %s", quotedName, this.typeLiteral(op));
      897. 
+
    897. 3                    break;
      898. 
+
    898.                  case "setColumnDefault":
      899. 
+
    899. 2                    alterTableOp = format("ALTER COLUMN %s SET DEFAULT %s", quotedName, this.literal(op["default"]));
      900. 
+
    900. 2                    break;
      901. 
+
    901.                  case "setColumnNull":
      902. 
+
    902. 0                    alterTableOp = format("ALTER COLUMN %s %s NOT NULL", quotedName, op["null"] ? "DROP" : "SET");
      903. 
+
    903. 0                    break;
      904. 
+
    904.                  case "addIndex":
      905. 
+
    905. 5                    return ret.callback(this.__indexDefinitionSql(table, op)).promise();
      906. 
+
    906.                  case "dropIndex":
      907. 
+
    907. 2                    return ret.callback(this.__dropIndexSql(table, op)).promise();
      908. 
+
    908.                  case "addConstraint":
      909. 
+
    909. 1                    alterTableOp = format("ADD %s", this.__constraintDefinitionSql(op));
      910. 
+
    910. 1                    break;
      911. 
+
    911.                  case "dropConstraint":
      912. 
+
    912. 0                    alterTableOp = format("DROP CONSTRAINT %s", quotedName);
      913. 
+
    913. 0                    break;
      914. 
+
    914.                  default :
      915. 
+
    915. 1                    throw new DatabaseError("Invalid altertable operator");
      916. 
 
    916.              }
      917. 
-
    917. 426            return this[meth](column);
      918. 
+
    918. 75            return ret.callback(format("ALTER TABLE %s %s", this.__quoteSchemaTable(table), alterTableOp)).promise();
      919. 
 
    919.          },
      920. 
 
    920.  
      921. 
 
    921.          /**
      922. 
 
    922.           * @private
      923. 
-
    923.           * patio uses the date type by default for Dates.
      924. 
-
    924.           * <ul>
      925. 
-
    925.           *      <li>if onlyTime is present then time is used</li>
      926. 
-
    926.           *      <li>if timeStamp is present then timestamp is used,</li>
      927. 
-
    927.           *      <li>if dateTime is present then datetime is used</li>
      928. 
-
    928.           *      <li>if yearOnly is present then year is used</li>
      929. 
-
    929.           *       <li>else date is used</li>
      930. 
-
    930.           * </ul>
      931. 
-
    931.           */
      932. 
-
    932.          __typeLiteralGenericDate:function (column) {
      933. 
-
    933. 11            var type = column.type, ret = "date";
      934. 
-
    934. 11            if (column.onlyTime) {
      935. 
-
    935. 2                ret = "time";
      936. 
-
    936. 9            } else if (column.timeStamp) {
      937. 
-
    937. 2                ret = "timestamp";
      938. 
-
    938. 7            } else if (column.dateTime) {
      939. 
-
    939. 2                ret = "datetime";
      940. 
-
    940. 5            } else if (column.yearOnly) {
      941. 
-
    941. 2                ret = "year";
      942. 
-
    942.              }
      943. 
-
    943. 11            return ret;
      944. 
+
    944.           * Array of SQL DDL modification statements for the given table,
      945. 
+
    945.           * corresponding to the DDL changes specified by the operations.
      946. 
+
    946.           * */
      947. 
+
    947.          __alterTableSqlList:function (table, operations) {
      948. 
+
    948. 84            return new PromiseList(operations.map(hitch(this, "__alterTableSql", table)));
      949. 
 
    949.          },
      950. 
 
    950.  
      951. 
 
    951.          /**
      952. 
 
    952.           * @private
      953. 
-
    953.           * * patio uses the blob type by default for Buffers.
      954. 
+
    954.           * SQL DDL fragment containing the column creation SQL for the given column.
      955. 
+
    955.           *
      956. 
+
    956.           * @param column
      957. 
 
    957.           */
      958. 
-
    958.          __typeLiteralGenericBlob:function (column) {
      959. 
-
    959. 25            return "blob";
      960. 
+
    960.          __columnDefinitionSql:function (column) {
      961. 
+
    961. 644            var sql = [format("%s %s", this.__quoteIdentifier(column.name), this.typeLiteral(column))];
      962. 
+
    962. 644            column.unique && sql.push(this._static.UNIQUE);
      963. 
+
    963. 644            (column.allowNull === false || column["null"] === false) && sql.push(this._static.NOT_NULL);
      964. 
+
    964. 644            (column.allowNull === true || column["null"] === true) && sql.push(this._static.NULL);
      965. 
+
    965. 644            !isUndefined(column["default"]) && sql.push(format(" DEFAULT %s", this.literal(column["default"])));
      966. 
+
    966. 644            column.primaryKey && sql.push(this._static.PRIMARY_KEY);
      967. 
+
    967. 644            column.autoIncrement && sql.push(" " + this.autoIncrementSql);
      968. 
+
    968. 644            column.table && sql.push(this.__columnReferencesColumnConstraintSql(column));
      969. 
+
    969. 644            return sql.join("");
      970. 
 
    970.          },
      971. 
 
    971.  
      972. 
 
    972.          /**
      973. 
 
    973.           * @private
      974. 
-
    974.           * * patio uses the year type by default for {@link patio.sql.DateTime}.
      975. 
+
    975.           * SQL DDL fragment containing the column creation
      976. 
+
    976.           * SQL for all given columns, used inside a CREATE TABLE block.
      977. 
 
    977.           */
      978. 
-
    978.          __typeLiteralGenericDateTime:function (column) {
      979. 
-
    979. 2            return "datetime";
      980. 
+
    980.          __columnListSql:function (generator) {
      981. 
+
    981. 218            return generator.columns.map(hitch(this, "__columnDefinitionSql")).concat(generator.constraints.map(hitch(this, "__constraintDefinitionSql"))).join(this._static.COMMA_SEPARATOR);
      982. 
 
    982.          },
      983. 
 
    983.  
      984. 
 
    984.          /**
      985. 
 
    985.           * @private
      986. 
-
    986.           * patio uses the timestamp type by default for {@link patio.sql.TimeStamp}.
      987. 
+
    987.           *SQL DDL fragment for column foreign key references (column constraints)
      988. 
 
    988.           */
      989. 
-
    989.          __typeLiteralGenericTimestamp:function (column) {
      990. 
-
    990. 4            return "timestamp";
      991. 
+
    991.          __columnReferencesColumnConstraintSql:function (column) {
      992. 
+
    992. 30            return this.__columnReferencesSql(column);
      993. 
 
    993.          },
      994. 
 
    994.  
      995. 
 
    995.          /**
      996. 
 
    996.           * @private
      997. 
-
    997.           * patio uses the time type by default for {@link patio.sql.Time}.
      998. 
+
    998.           * SQL DDL fragment for column foreign key references
      999. 
 
    999.           */
      1000. 
-
    1000.          __typeLiteralGenericTime:function (column) {
      1001. 
-
    1001. 2            return "time";
      1002. 
+
    1002.          __columnReferencesSql:function (column) {
      1003. 
+
    1003. 38            var sql = format(" REFERENCES %s", this.__quoteSchemaTable(column.table));
      1004. 
+
    1004. 38            column.key && (sql += format("(%s)", array.toArray(column.key).map(this.__quoteIdentifier, this).join(this._static.COMMA_SEPARATOR)));
      1005. 
+
    1005. 38            column.onDelete && (sql += format(" ON DELETE %s", this.__onDeleteClause(column.onDelete)));
      1006. 
+
    1006. 38            column.onUpdate && (sql += format(" ON UPDATE %s", this.__onUpdateClause(column.onUpdate)));
      1007. 
+
    1007. 38            column.deferrable && (sql += " DEFERRABLE INITIALLY DEFERRED");
      1008. 
+
    1008. 38            return sql;
      1009. 
 
    1009.          },
      1010. 
 
    1010.  
      1011. 
 
    1011.          /**
      1012. 
 
    1012.           * @private
      1013. 
-
    1013.           * patio uses the year type by default for {@link patio.sql.Year}.
      1014. 
-
    1014.           */
      1015. 
-
    1015.          __typeLiteralGenericYear:function (column) {
      1016. 
-
    1016. 2            return "year";
      1017. 
+
    1017.           * SQL DDL fragment for table foreign key references (table constraints)
      1018. 
+
    1018.           * */
      1019. 
+
    1019.          __columnReferencesTableConstraintSql:function (constraint) {
      1020. 
+
    1020. 6            return format("FOREIGN KEY %s%s", this.literal(constraint.columns.map(function (c) {
      1021. 
+
    1021. 6                return isString(c) ? sql.stringToIdentifier(c) : c;
      1022. 
+
    1022.              })), this.__columnReferencesSql(constraint));
      1023. 
 
    1023.          },
      1024. 
 
    1024.  
      1025. 
 
    1025.          /**
      1026. 
 
    1026.           * @private
      1027. 
-
    1027.           * patio uses the boolean type by default for Boolean class
      1028. 
-
    1028.           * */
      1029. 
-
    1029.          __typeLiteralGenericBoolean:function (column) {
      1030. 
-
    1030. 3            return "boolean";
      1031. 
+
    1031.           * SQL DDL fragment specifying a constraint on a table.
      1032. 
+
    1032.           */
      1033. 
+
    1033.          __constraintDefinitionSql:function (constraint) {
      1034. 
+
    1034. 6            var ret = [constraint.name ? format("CONSTRAINT %s ", this.__quoteIdentifier(constraint.name)) : ""];
      1035. 
+
    1035. 6            switch (constraint.type) {
      1036. 
+
    1036.                  case "check":
      1037. 
+
    1037. 0                    var check = constraint.check;
      1038. 
+
    1038. 0                    ret.push(format("CHECK %s", this.__filterExpr(isArray(check) && check.length === 1 ? check[0] : check)));
      1039. 
+
    1039. 0                    break;
      1040. 
+
    1040.                  case "primaryKey":
      1041. 
+
    1041. 0                    ret.push(format("PRIMARY KEY %s", this.literal(constraint.columns.map(function (c) {
      1042. 
+
    1042. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      1043. 
+
    1043.                      }))));
      1044. 
+
    1044. 0                    break;
      1045. 
+
    1045.                  case "foreignKey":
      1046. 
+
    1046. 6                    ret.push(this.__columnReferencesTableConstraintSql(constraint));
      1047. 
+
    1047. 6                    break;
      1048. 
+
    1048.                  case "unique":
      1049. 
+
    1049. 0                    ret.push(format("UNIQUE %s", this.literal(constraint.columns.map(function (c) {
      1050. 
+
    1050. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      1051. 
+
    1051.                      }))));
      1052. 
+
    1052. 0                    break;
      1053. 
+
    1053.                  default:
      1054. 
+
    1054. 0                    throw new DatabaseError(format("Invalid constriant type %s, should be 'check', 'primaryKey', foreignKey', or 'unique'", constraint.type));
      1055. 
+
    1055.              }
      1056. 
+
    1056. 6            return ret.join("");
      1057. 
 
    1057.          },
      1058. 
 
    1058.  
      1059. 
 
    1059.          /**
      1060. 
 
    1060.           * @private
      1061. 
-
    1061.           * patio uses the numeric type by default for NumericTypes
      1062. 
-
    1062.           * If a size is given, it is used, otherwise, it will default to whatever
      1063. 
-
    1063.           * the database default is for an unsized value.
      1064. 
-
    1064.           * <ul>
      1065. 
-
    1065.           * <li> if isInt is present the int is used</li>
      1066. 
-
    1066.           * <li> if isDouble is present then double precision is used</li>
      1067. 
-
    1067.           * </ul>
      1068. 
-
    1068.           */
      1069. 
-
    1069.          __typeLiteralGenericNumeric:function (column) {
      1070. 
-
    1070. 10            return column.size ? format("numeric(%s)", array.toArray(column.size).join(', ')) : column.isInt ? "integer" : column.isDouble ? "double precision" : "numeric";
      1071. 
+
    1071.           * Execute the create table statements using the generator.
      1072. 
+
    1072.           * */
      1073. 
+
    1073.          __createTableFromGenerator:function (name, generator, options) {
      1074. 
+
    1074. 218            return this.executeDdl(this.__createTableSql(name, generator, options));
      1075. 
 
    1075.          },
      1076. 
 
    1076.  
      1077. 
-
    1077.  
      1078. 
 
    1078.          /**
      1079. 
 
    1079.           * @private
      1080. 
-
    1080.           */
      1081. 
-
    1081.          __typeLiteralGenericFloat:function (column) {
      1082. 
-
    1082. 15            return "double precision";
      1083. 
+
    1083.           * Execute the create index statements using the generator.
      1084. 
+
    1084.           * */
      1085. 
+
    1085.          __createTableIndexesFromGenerator:function (name, generator, options) {
      1086. 
+
    1086. 218            var e = options.ignoreIndexErrors;
      1087. 
+
    1087. 218            var ret = new Promise();
      1088. 
+
    1088. 218            var promises = generator.indexes.map(function (index) {
      1089. 
+
    1089. 18                var ps = this.__indexSqlList(name, [index]).map(this.executeDdl, this);
      1090. 
+
    1090. 18                return new PromiseList(ps);
      1091. 
+
    1091.              }, this);
      1092. 
+
    1092. 218            if (promises.length) {
      1093. 
+
    1093. 16                new PromiseList(promises).then(ret, hitch(ret, e ? "callback" : "errback"));
      1094. 
+
    1094.              } else {
      1095. 
+
    1095. 202                ret.callback();
      1096. 
+
    1096.              }
      1097. 
+
    1097. 218            return ret.promise();
      1098. 
 
    1098.          },
      1099. 
 
    1099.  
      1100. 
 
    1100.          /**
      1101. 
 
    1101.           * @private
      1102. 
-
    1102.           */
      1103. 
-
    1103.          __typeLiteralGenericDecimal:function (column) {
      1104. 
-
    1104. 2            return "double precision";
      1105. 
+
    1105.           * DDL statement for creating a table with the given name, columns, and options
      1106. 
+
    1106.           * */
      1107. 
+
    1107.          __createTableSql:function (name, generator, options) {
      1108. 
+
    1108. 218            return format("CREATE %sTABLE %s (%s)", options.temp ? this.temporaryTableSql : "", this.__quoteSchemaTable(name), this.__columnListSql(generator));
      1109. 
 
    1109.          },
      1110. 
 
    1110.  
      1111. 
 
    1111.          /**
      1112. 
 
    1112.           * @private
      1113. 
-
    1113.           * patio uses the varchar type by default for Strings.  If a
      1114. 
-
    1114.           * size isn't present, patio assumes a size of 255.  If the
      1115. 
-
    1115.           * fixed option is used, patio uses the char type.  If the
      1116. 
-
    1116.           * text option is used, patio uses the :text type.
      1117. 
+
    1117.           * Default index name for the table and columns, may be too long
      1118. 
+
    1118.           * for certain databases.
      1119. 
 
    1119.           */
      1120. 
-
    1120.          __typeLiteralGenericString:function (column) {
      1121. 
-
    1121. 41            return column.text ? "text" : format("%s(%s)", column.fixed ? "char" : "varchar", column.size || 255);
      1122. 
+
    1122.          __defaultIndexName:function (tableName, columns) {
      1123. 
+
    1123. 25            var parts = this.__schemaAndTable(tableName);
      1124. 
+
    1124. 25            var schema = parts[0], table = parts[1];
      1125. 
+
    1125. 25            var index = [];
      1126. 
+
    1126. 25            if (schema && schema !== this.defaultSchema) {
      1127. 
+
    1127. 0                index.push(schema);
      1128. 
+
    1128.              }
      1129. 
+
    1129. 25            index.push(table);
      1130. 
+
    1130. 25            index = index.concat(columns.map(function (c) {
      1131. 
+
    1131. 28                return isString(c) ? c : this.literal(c).replace(/\W/g, "");
      1132. 
+
    1132.              }, this));
      1133. 
+
    1133. 25            index.push("index");
      1134. 
+
    1134. 25            return index.join(this._static.UNDERSCORE);
      1135. 
+
    1135.  
      1136. 
 
    1136.          },
      1137. 
 
    1137.  
      1138. 
 
    1138.          /**
      1139. 
 
    1139.           * @private
      1140. 
-
    1140.           * SQL fragment for the given type of a column if the column is not one of the
      1141. 
-
    1141.           * generic types specified with a native javascript type class.
      1142. 
-
    1142.           */
      1143. 
-
    1143.          __typeLiteralSpecific:function (column) {
      1144. 
-
    1144. 336            var type = column.type;
      1145. 
-
    1145. 336            type = type === "double" ? "double precision" : type;
      1146. 
-
    1146. 336            if (type === "varchar") {
      1147. 
-
    1147. 7                column.size = isNumber(column.size) ? column.size : 255;
      1148. 
-
    1148.              }
      1149. 
-
    1149. 336            var elements = column.size || column.elements;
      1150. 
-
    1150. 336            return format("%s%s%s", type, elements ? this.literal(toArray(elements)) : "", column.unsigned ? " UNSIGNED" : "");
      1151. 
+
    1151.           * The SQL to drop an index for the table.
      1152. 
+
    1152.           * */
      1153. 
+
    1153.          __dropIndexSql:function (table, op) {
      1154. 
+
    1154. 2            return format("DROP INDEX %s", this.__quoteIdentifier(op.name || this.__defaultIndexName(table, op.columns)));
      1155. 
 
    1155.          },
      1156. 
 
    1156.  
      1157. 
-
    1157.          /**@ignore*/
      1158. 
-
    1158.          getters:{
      1159. 
-
    1159.              /**@lends patio.Database.prototype*/
      1160. 
-
    1160.              /**
      1161. 
-
    1161.               * @private
      1162. 
-
    1162.               *  The SQL string specify the autoincrement property, generally used by
      1163. 
-
    1163.               * primary keys.
      1164. 
-
    1164.               *
      1165. 
-
    1165.               * @field
      1166. 
-
    1166.               * */
      1167. 
-
    1167.              autoIncrementSql:function () {
      1168. 
-
    1168. 10                return this._static.AUTOINCREMENT;
      1169. 
-
    1169.              },
      1170. 
-
    1170.  
      1171. 
-
    1171.              /**
      1172. 
-
    1172.               * @private
      1173. 
-
    1173.               * @field
      1174. 
-
    1174.               * */
      1175. 
-
    1175.              temporaryTableSql:function () {
      1176. 
-
    1176. 3                return this._static.TEMPORARY;
      1177. 
-
    1177.              },
      1178. 
-
    1178.  
      1179. 
-
    1179.              /**
      1180. 
-
    1180.               * @private
      1181. 
-
    1181.               * @field
      1182. 
-
    1182.               * */
      1183. 
-
    1183.              __schemaUtiltyDataset:function () {
      1184. 
-
    1184. 3304                this.__schemaUtiltyDs = this.__schemaUtiltyDs || this.dataset;
      1185. 
-
    1185. 3304                return this.__schemaUtiltyDs;
      1186. 
-
    1186.              }
      1187. 
-
    1187.          }
      1188. 
+
    1188.          /**
      1189. 
+
    1189.           * @private
      1190. 
+
    1190.           *
      1191. 
+
    1191.           *  SQL DDL statement to drop the table with the given name.
      1192. 
+
    1192.           **/
      1193. 
+
    1193.          __dropTableSql:function (name) {
      1194. 
+
    1194. 210            return format("DROP TABLE %s", this.__quoteSchemaTable(name));
      1195. 
+
    1195.          },
      1196. 
 
    1196.  
      1197. 
-
    1197.      },
      1198. 
+
    1198.          /**
      1199. 
+
    1199.           * @private
      1200. 
+
    1200.           * Proxy the filterExpr call to the dataset, used for creating constraints.
      1201. 
+
    1201.           * */
      1202. 
+
    1202.          __filterExpr:function (args, block) {
      1203. 
+
    1203. 2            var ds = this.__schemaUtiltyDataset;
      1204. 
+
    1204. 2            return ds.literal(ds._filterExpr.apply(ds, arguments));
      1205. 
+
    1205.          },
      1206. 
 
    1206.  
      1207. 
-
    1207.      "static":{
      1208. 
-
    1208.          /**@lends patio.Database*/
      1209. 
 
    1209.  
      1210. 
 
    1210.          /**
      1211. 
-
    1211.           *Default  AUTO INCREMENT SQL
      1212. 
+
    1212.           * @private
      1213. 
+
    1213.           * SQL DDL statement for creating an index for the table with the given name
      1214. 
+
    1214.           * and index specifications.
      1215. 
 
    1215.           */
      1216. 
-
    1216.          AUTOINCREMENT:'AUTOINCREMENT',
      1217. 
+
    1217.          __indexDefinitionSql:function (tableName, index) {
      1218. 
+
    1218. 7            var indexName = index.name || this.__defaultIndexName(tableName, index.columns);
      1219. 
+
    1219. 7            if (index.type) {
      1220. 
+
    1220. 0                throw new DatabaseError("Index types are not supported for this database");
      1221. 
+
    1221. 7            } else if (index.where) {
      1222. 
+
    1222. 0                throw new DatabaseError("Partial indexes are not supported for this database");
      1223. 
+
    1223.              } else {
      1224. 
+
    1224. 7                return format("CREATE %sINDEX %s ON %s %s", index.unique ? "UNIQUE " : "", this.__quoteIdentifier(indexName), this.__quoteSchemaTable(tableName), this.literal(index.columns.map(function (c) {
      1225. 
+
    1225. 8                    return isString(c) ? new Identifier(c) : c;
      1226. 
+
    1226.                  })));
      1227. 
+
    1227.              }
      1228. 
+
    1228.          },
      1229. 
 
    1229.  
      1230. 
 
    1230.          /**
      1231. 
-
    1231.           *Default  CASCACDE SQL
      1232. 
+
    1232.           * Array of SQL DDL statements, one for each index specification,
      1233. 
+
    1233.           * for the given table.
      1234. 
 
    1234.           */
      1235. 
-
    1235.          CASCADE:'CASCADE',
      1236. 
+
    1236.          __indexSqlList:function (tableName, indexes) {
      1237. 
+
    1237. 18            return indexes.map(hitch(this, this.__indexDefinitionSql, tableName));
      1238. 
+
    1238.          },
      1239. 
 
    1239.  
      1240. 
 
    1240.          /**
      1241. 
-
    1241.           *Default comma
      1242. 
+
    1242.           * @private
      1243. 
+
    1243.           * SQL DDL ON DELETE fragment to use, based on the given action.
      1244. 
+
    1244.           *The following actions are recognized:
      1245. 
+
    1245.           * <ul>
      1246. 
+
    1246.           *  <li>cascade - Delete rows referencing this row.</li>
      1247. 
+
    1247.           *  <li>noAction (default) - Raise an error if other rows reference this
      1248. 
+
    1248.           *   row, allow deferring of the integrity check.
      1249. 
+
    1249.           *  </li>
      1250. 
+
    1250.           *  <li>restrict - Raise an error if other rows reference this row,
      1251. 
+
    1251.           *   but do not allow deferring the integrity check.</li>
      1252. 
+
    1252.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      1253. 
+
    1253.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      1254. 
+
    1254.           * </ul>
      1255. 
 
    1255.           */
      1256. 
-
    1256.          COMMA_SEPARATOR:', ',
      1257. 
+
    1257.          __onDeleteClause:function (action) {
      1258. 
+
    1258. 23            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      1259. 
+
    1259.          },
      1260. 
 
    1260.  
      1261. 
 
    1261.          /**
      1262. 
-
    1262.           *Default  NO ACTION SQL
      1263. 
+
    1263.           * @private
      1264. 
+
    1264.           * SQL DDL ON UPDATE fragment to use, based on the given action.
      1265. 
+
    1265.           *The following actions are recognized:
      1266. 
+
    1266.           * <ul>
      1267. 
+
    1267.           *  <li>cascade - Delete rows referencing this row.</li>
      1268. 
+
    1268.           *  <li>noAction (default) - Raise an error if other rows reference this
      1269. 
+
    1269.           *   row, allow deferring of the integrity check.
      1270. 
+
    1270.           *  </li>
      1271. 
+
    1271.           *  <li>restrict - Raise an error if other rows reference this row,
      1272. 
+
    1272.           *   but do not allow deferring the integrity check.</li>
      1273. 
+
    1273.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      1274. 
+
    1274.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      1275. 
+
    1275.           * </ul>
      1276. 
 
    1276.           */
      1277. 
-
    1277.          NO_ACTION:'NO ACTION',
      1278. 
+
    1278.          __onUpdateClause:function (action) {
      1279. 
+
    1279. 1            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      1280. 
+
    1280.          },
      1281. 
 
    1281.  
      1282. 
 
    1282.          /**
      1283. 
-
    1283.           *Default  NOT NULL SQL
      1284. 
-
    1284.           */
      1285. 
-
    1285.          NOT_NULL:' NOT NULL',
      1286. 
+
    1286.           * @private
      1287. 
+
    1287.           * Proxy the quoteSchemaTable method to the dataset
      1288. 
+
    1288.           * */
      1289. 
+
    1289.          __quoteSchemaTable:function (table) {
      1290. 
+
    1290. 2212            return this.__schemaUtiltyDataset.quoteSchemaTable(table);
      1291. 
+
    1291.          },
      1292. 
 
    1292.  
      1293. 
 
    1293.          /**
      1294. 
-
    1294.           * Default NULL SQL
      1295. 
-
    1295.           */
      1296. 
-
    1296.          NULL:' NULL',
      1297. 
+
    1297.           * @private
      1298. 
+
    1298.           * Proxy the quoteIdentifier method to the dataset, used for quoting tables and columns.
      1299. 
+
    1299.           * */
      1300. 
+
    1300.          __quoteIdentifier:function (v) {
      1301. 
+
    1301. 846            return this.__schemaUtiltyDataset.quoteIdentifier(v);
      1302. 
+
    1302.          },
      1303. 
 
    1303.  
      1304. 
 
    1304.          /**
      1305. 
-
    1305.           *Default  PRIMARY KEY SQL
      1306. 
-
    1306.           */
      1307. 
-
    1307.          PRIMARY_KEY:' PRIMARY KEY',
      1308. 
+
    1308.           * @private
      1309. 
+
    1309.           * SQL DDL statement for renaming a table.
      1310. 
+
    1310.           * */
      1311. 
+
    1311.          __renameTableSql:function (name, newName) {
      1312. 
+
    1312. 1            return format("ALTER TABLE %s RENAME TO %s", this.__quoteSchemaTable(name), this.__quoteSchemaTable(newName));
      1313. 
+
    1313.          },
      1314. 
 
    1314.  
      1315. 
 
    1315.          /**
      1316. 
-
    1316.           *Default  RESTRICT SQL
      1317. 
+
    1317.           * @private
      1318. 
+
    1318.           * Remove the cached schemaUtilityDataset, because the identifier
      1319. 
+
    1319.           * quoting has changed.
      1320. 
 
    1320.           */
      1321. 
-
    1321.          RESTRICT:'RESTRICT',
      1322. 
+
    1322.          __resetSchemaUtilityDataset:function () {
      1323. 
+
    1323. 0            this.__schemaUtiltyDs = null;
      1324. 
+
    1324.          },
      1325. 
 
    1325.  
      1326. 
 
    1326.          /**
      1327. 
-
    1327.           *Default  SET DEFAULT SQL
      1328. 
-
    1328.           */
      1329. 
-
    1329.          SET_DEFAULT:'SET DEFAULT',
      1330. 
-
    1330.  
      1331. 
+
    1331.           * @private
      1332. 
+
    1332.           * Split the schema information from the table
      1333. 
+
    1333.           * */
      1334. 
+
    1334.          __schemaAndTable:function (tableName) {
      1335. 
+
    1335. 244            return  this.__schemaUtiltyDataset.schemaAndTable(tableName);
      1336. 
+
    1336.          },
      1337. 
+
    1337.  
      1338. 
 
    1338.          /**
      1339. 
-
    1339.           *Default  SET NULL SQL
      1340. 
+
    1340.           * @private
      1341. 
+
    1341.           * Return true if the given column schema represents an autoincrementing primary key.
      1342. 
+
    1342.           *
      1343. 
 
    1343.           */
      1344. 
-
    1344.          SET_NULL:'SET NULL',
      1345. 
+
    1345.          _schemaAutoincrementingPrimaryKey:function (schema) {
      1346. 
+
    1346. 0            return !!schema.primaryKey;
      1347. 
+
    1347.          },
      1348. 
 
    1348.  
      1349. 
 
    1349.          /**
      1350. 
-
    1350.           *Default  TEMPORARY SQL
      1351. 
-
    1351.           */
      1352. 
-
    1352.          TEMPORARY:'TEMPORARY ',
      1353. 
+
    1353.           * @private
      1354. 
+
    1354.           * SQL fragment specifying the type of a given column.
      1355. 
+
    1355.           * */
      1356. 
+
    1356.          typeLiteral:function (column) {
      1357. 
+
    1357. 690            return this.__typeLiteralGeneric(column);
      1358. 
+
    1358.          },
      1359. 
 
    1359.  
      1360. 
 
    1360.          /**
      1361. 
-
    1361.           *Default  UNDERSCORE SQL, used in index creation.
      1362. 
+
    1362.           * @private
      1363. 
+
    1363.           * SQL fragment specifying the full type of a column,
      1364. 
+
    1364.           * consider the type with possible modifiers.
      1365. 
 
    1365.           */
      1366. 
-
    1366.          UNDERSCORE:'_',
      1367. 
+
    1367.          __typeLiteralGeneric:function (column) {
      1368. 
+
    1368. 690            var type = column.type;
      1369. 
+
    1369. 690            var meth = "__typeLiteralGeneric";
      1370. 
+
    1370. 690            var isStr = isString(type);
      1371. 
+
    1371. 690            var proper = isStr ? type.charAt(0).toUpperCase() + type.substr(1) : null;
      1372. 
+
    1372. 690            if (type === String || (isStr && type.match(/string/i))) {
      1373. 
+
    1373. 198                meth += "String";
      1374. 
+
    1374. 492            } else if ((isStr && type.match(/number/i)) || type === Number) {
      1375. 
+
    1375. 12                meth += "Numeric";
      1376. 
+
    1376. 480            } else if ((isStr && type.match(/datetime/i)) || type === DateTime) {
      1377. 
+
    1377. 8                meth += "DateTime";
      1378. 
+
    1378. 472            } else if ((isStr && type.match(/date/i)) || type === Date) {
      1379. 
+
    1379. 11                meth += "Date";
      1380. 
+
    1380. 461            } else if ((isStr && type.match(/year/i)) || type === Year) {
      1381. 
+
    1381. 2                meth += "Year";
      1382. 
+
    1382. 459            } else if ((isStr && type.match(/timestamp/i))|| type === TimeStamp) {
      1383. 
+
    1383. 4                meth += "Timestamp";
      1384. 
+
    1384. 455            } else if ((isStr && type.match(/time/i)) || type === Time) {
      1385. 
+
    1385. 2                meth += "Time";
      1386. 
+
    1386. 453            } else if ((isStr && type.match(/decimal/i)) || type === Decimal) {
      1387. 
+
    1387. 2                meth += "Decimal";
      1388. 
+
    1388. 451            } else if ((isStr && type.match(/float/i)) || type === Float) {
      1389. 
+
    1389. 15                meth += "Float";
      1390. 
+
    1390. 436            } else if ((isStr && type.match(/boolean/i)) || type === Boolean) {
      1391. 
+
    1391. 5                meth += "Boolean";
      1392. 
+
    1392. 431            } else if ((isStr && type.match(/buffer/i)) || type === Buffer) {
      1393. 
+
    1393. 29                meth += "Blob";
      1394. 
+
    1394. 402            } else if (isStr && isFunction(this[meth + proper])) {
      1395. 
+
    1395. 138                meth += proper;
      1396. 
+
    1396.              } else {
      1397. 
+
    1397. 264                return this.__typeLiteralSpecific(column);
      1398. 
+
    1398.              }
      1399. 
+
    1399. 426            return this[meth](column);
      1400. 
+
    1400.          },
      1401. 
 
    1401.  
      1402. 
 
    1402.          /**
      1403. 
-
    1403.           *Default  UNIQUE SQL
      1404. 
+
    1404.           * @private
      1405. 
+
    1405.           * patio uses the date type by default for Dates.
      1406. 
+
    1406.           * <ul>
      1407. 
+
    1407.           *      <li>if onlyTime is present then time is used</li>
      1408. 
+
    1408.           *      <li>if timeStamp is present then timestamp is used,</li>
      1409. 
+
    1409.           *      <li>if dateTime is present then datetime is used</li>
      1410. 
+
    1410.           *      <li>if yearOnly is present then year is used</li>
      1411. 
+
    1411.           *       <li>else date is used</li>
      1412. 
+
    1412.           * </ul>
      1413. 
 
    1413.           */
      1414. 
-
    1414.          UNIQUE:' UNIQUE',
      1415. 
+
    1415.          __typeLiteralGenericDate:function (column) {
      1416. 
+
    1416. 11            var type = column.type, ret = "date";
      1417. 
+
    1417. 11            if (column.onlyTime) {
      1418. 
+
    1418. 2                ret = "time";
      1419. 
+
    1419. 9            } else if (column.timeStamp) {
      1420. 
+
    1420. 2                ret = "timestamp";
      1421. 
+
    1421. 7            } else if (column.dateTime) {
      1422. 
+
    1422. 2                ret = "datetime";
      1423. 
+
    1423. 5            } else if (column.yearOnly) {
      1424. 
+
    1424. 2                ret = "year";
      1425. 
+
    1425.              }
      1426. 
+
    1426. 11            return ret;
      1427. 
+
    1427.          },
      1428. 
 
    1428.  
      1429. 
 
    1429.          /**
      1430. 
-
    1430.           * Default  UNSIGNED SQL
      1431. 
+
    1431.           * @private
      1432. 
+
    1432.           * * patio uses the blob type by default for Buffers.
      1433. 
 
    1433.           */
      1434. 
-
    1434.          UNSIGNED:' UNSIGNED'
      1435. 
-
    1435.  
      1436. 
-
    1436.      }
      1437. 
-
    1437.  }).as(module);
      1438. 
-
    1438.
    -
    - -
    - - - - - -
    -
    errors.js
    -     		-
    - Coverage89.47 - SLOC81 - LOC19 - Missed2 -
    -
    - 
    1. 1var patio = exports;
      2. 
+
    2.          __typeLiteralGenericBlob:function (column) {
      3. 
+
    3. 25            return "blob";
      4. 
+
    4.          },
      5. 
 
    5.  
      6. 
+
    6.          /**
      7. 
+
    7.           * @private
      8. 
+
    8.           * * patio uses the year type by default for {@link patio.sql.DateTime}.
      9. 
+
    9.           */
      10. 
+
    10.          __typeLiteralGenericDateTime:function (column) {
      11. 
+
    11. 2            return "datetime";
      12. 
+
    12.          },
      13. 
 
    13.  
      14. 
-
    14.  /**
      15. 
-
    15.   * @class Thrown if a function is not impltemened
      16. 
-
    16.   *
      17. 
-
    17.   * @param {String} message the message to show.
      18. 
-
    18.   */
      19. 
-
    19. 1patio.NotImplemented = function(message) {
      20. 
-
    20. 4  return new Error("Not Implemented :  " + message);
      21. 
-
    21.  };
      22. 
+
    22.          /**
      23. 
+
    23.           * @private
      24. 
+
    24.           * patio uses the timestamp type by default for {@link patio.sql.TimeStamp}.
      25. 
+
    25.           */
      26. 
+
    26.          __typeLiteralGenericTimestamp:function (column) {
      27. 
+
    27. 4            return "timestamp";
      28. 
+
    28.          },
      29. 
 
    29.  
      30. 
-
    30.  /**
      31. 
-
    31.   * @class Thrown if there is an Expression Error.
      32. 
-
    32.   *
      33. 
-
    33.   * @param {String} message the message to show.
      34. 
-
    34.   */
      35. 
-
    35. 1patio.ExpressionError = function(message) {
      36. 
-
    36. 0  return new Error("Expression Error :" + message);
      37. 
-
    37.  };
      38. 
+
    38.          /**
      39. 
+
    39.           * @private
      40. 
+
    40.           * patio uses the time type by default for {@link patio.sql.Time}.
      41. 
+
    41.           */
      42. 
+
    42.          __typeLiteralGenericTime:function (column) {
      43. 
+
    43. 2            return "time";
      44. 
+
    44.          },
      45. 
 
    45.  
      46. 
-
    46.  /**
      47. 
-
    47.   * @class Thrown if there is a Query Error.
      48. 
-
    48.   *
      49. 
-
    49.   * @param {String} message the message to show.
      50. 
-
    50.   */
      51. 
-
    51. 1patio.QueryError = function(message) {
      52. 
-
    52. 121  return new Error("QueryError : " + message);
      53. 
-
    53.  };
      54. 
+
    54.          /**
      55. 
+
    55.           * @private
      56. 
+
    56.           * patio uses the year type by default for {@link patio.sql.Year}.
      57. 
+
    57.           */
      58. 
+
    58.          __typeLiteralGenericYear:function (column) {
      59. 
+
    59. 2            return "year";
      60. 
+
    60.          },
      61. 
 
    61.  
      62. 
-
    62.  /**
      63. 
-
    63.   * @class Thrown if there is a Dataset Error.
      64. 
-
    64.   *
      65. 
-
    65.   * @param {String} message the message to show.
      66. 
-
    66.   */
      67. 
-
    67. 1patio.DatasetError = function(message) {
      68. 
-
    68. 7  return new Error("DatasetError : " + message);
      69. 
-
    69.  };
      70. 
+
    70.          /**
      71. 
+
    71.           * @private
      72. 
+
    72.           * patio uses the boolean type by default for Boolean class
      73. 
+
    73.           * */
      74. 
+
    74.          __typeLiteralGenericBoolean:function (column) {
      75. 
+
    75. 3            return "boolean";
      76. 
+
    76.          },
      77. 
 
    77.  
      78. 
-
    78.  /**
      79. 
-
    79.   * @class Thrown if there is a Database Error.
      80. 
-
    80.   *
      81. 
-
    81.   * @param {String} message the message to show.
      82. 
-
    82.   */
      83. 
-
    83. 1patio.DatabaseError = function(message) {
      84. 
-
    84. 5  return new Error("Database error : " + message);
      85. 
-
    85.  };
      86. 
+
    86.          /**
      87. 
+
    87.           * @private
      88. 
+
    88.           * patio uses the numeric type by default for NumericTypes
      89. 
+
    89.           * If a size is given, it is used, otherwise, it will default to whatever
      90. 
+
    90.           * the database default is for an unsized value.
      91. 
+
    91.           * <ul>
      92. 
+
    92.           * <li> if isInt is present the int is used</li>
      93. 
+
    93.           * <li> if isDouble is present then double precision is used</li>
      94. 
+
    94.           * </ul>
      95. 
+
    95.           */
      96. 
+
    96.          __typeLiteralGenericNumeric:function (column) {
      97. 
+
    97. 10            return column.size ? format("numeric(%s)", array.toArray(column.size).join(', ')) : column.isInt ? "integer" : column.isDouble ? "double precision" : "numeric";
      98. 
+
    98.          },
      99. 
 
    99.  
      100. 
-
    100.  /**
      101. 
-
    101.   * @class Thrown if there is a unexpected Error.
      102. 
-
    102.   *
      103. 
-
    103.   * @param {String} message the message to show.
      104. 
-
    104.   */
      105. 
-
    105. 1patio.PatioError = function(message) {
      106. 
-
    106. 31  return new Error("Patio error : " + message);
      107. 
-
    107.  };
      108. 
 
    108.  
      109. 
-
    109.  /**
      110. 
-
    110.   * @class Thrown if there is a error thrown within a model.
      111. 
-
    111.   * @param {String} message the message to show.
      112. 
-
    112.   */
      113. 
-
    113. 1patio.ModelError = function(message) {
      114. 
-
    114. 2  return new Error("Model error : " + message);
      115. 
-
    115.  };
      116. 
+
    116.          /**
      117. 
+
    117.           * @private
      118. 
+
    118.           */
      119. 
+
    119.          __typeLiteralGenericFloat:function (column) {
      120. 
+
    120. 15            return "double precision";
      121. 
+
    121.          },
      122. 
 
    122.  
      123. 
-
    123.  /**
      124. 
-
    124.   * @class Thrown if there is an error when loading/creating/deleteing an association.
      125. 
-
    125.   * @param {String} message the message to show.
      126. 
-
    126.   */
      127. 
-
    127. 1patio.AssociationError = function(message) {
      128. 
-
    128. 0  return new Error("Association error : " + message);
      129. 
-
    129.  };
      130. 
+
    130.          /**
      131. 
+
    131.           * @private
      132. 
+
    132.           */
      133. 
+
    133.          __typeLiteralGenericDecimal:function (column) {
      134. 
+
    134. 2            return "double precision";
      135. 
+
    135.          },
      136. 
 
    136.  
      137. 
+
    137.          /**
      138. 
+
    138.           * @private
      139. 
+
    139.           * patio uses the varchar type by default for Strings.  If a
      140. 
+
    140.           * size isn't present, patio assumes a size of 255.  If the
      141. 
+
    141.           * fixed option is used, patio uses the char type.  If the
      142. 
+
    142.           * text option is used, patio uses the :text type.
      143. 
+
    143.           */
      144. 
+
    144.          __typeLiteralGenericString:function (column) {
      145. 
+
    145. 41            return column.text ? "text" : format("%s(%s)", column.fixed ? "char" : "varchar", column.size || 255);
      146. 
+
    146.          },
      147. 
 
    147.  
      148. 
-
    148.  /**
      149. 
-
    149.   * Thrown if there is an error when performing a migration.
      150. 
-
    150.   * @param {String} message the message to show.
      151. 
-
    151.   */
      152. 
-
    152. 1patio.MigrationError = function(message) {
      153. 
-
    153. 2    return new Error("Migration error : " + message);
      154. 
-
    154.  };
    +
  • /**
    • +
  • * @private
    • +
  • * SQL fragment for the given type of a column if the column is not one of the
    • +
  • * generic types specified with a native javascript type class.
    • +
  • */
    • +
  • __typeLiteralSpecific:function (column) {
    • +
  • 336 var type = column.type;
    • +
  • 336 type = type === "double" ? "double precision" : type;
    • +
  • 336 if (type === "varchar") {
    • +
  • 7 column.size = isNumber(column.size) ? column.size : 255;
    • +
  • }
    • +
  • 336 var elements = column.size || column.elements;
    • +
  • 336 return format("%s%s%s", type, elements ? this.literal(toArray(elements)) : "", column.unsigned ? " UNSIGNED" : "");
    • +
  • },
    • +
    • +
  • /**@ignore*/
    • +
  • getters:{
    • +
  • /**@lends patio.Database.prototype*/
    • +
  • /**
    • +
  • * @private
    • +
  • * The SQL string specify the autoincrement property, generally used by
    • +
  • * primary keys.
    • +
  • *
    • +
  • * @field
    • +
  • * */
    • +
  • autoIncrementSql:function () {
    • +
  • 10 return this._static.AUTOINCREMENT;
    • +
  • },
    • +
    • +
  • /**
    • +
  • * @private
    • +
  • * @field
    • +
  • * */
    • +
  • temporaryTableSql:function () {
    • +
  • 3 return this._static.TEMPORARY;
    • +
  • },
    • +
    • +
  • /**
    • +
  • * @private
    • +
  • * @field
    • +
  • * */
    • +
  • __schemaUtiltyDataset:function () {
    • +
  • 3304 this.__schemaUtiltyDs = this.__schemaUtiltyDs || this.dataset;
    • +
  • 3304 return this.__schemaUtiltyDs;
    • +
  • }
    • +
  • }
    • +
    • +
  • },
    • +
    • +
  • "static":{
    • +
  • /**@lends patio.Database*/
    • +
    • +
  • /**
    • +
  • *Default AUTO INCREMENT SQL
    • +
  • */
    • +
  • AUTOINCREMENT:'AUTOINCREMENT',
    • +
    • +
  • /**
    • +
  • *Default CASCACDE SQL
    • +
  • */
    • +
  • CASCADE:'CASCADE',
    • +
    • +
  • /**
    • +
  • *Default comma
    • +
  • */
    • +
  • COMMA_SEPARATOR:', ',
    • +
    • +
  • /**
    • +
  • *Default NO ACTION SQL
    • +
  • */
    • +
  • NO_ACTION:'NO ACTION',
    • +
    • +
  • /**
    • +
  • *Default NOT NULL SQL
    • +
  • */
    • +
  • NOT_NULL:' NOT NULL',
    • +
    • +
  • /**
    • +
  • * Default NULL SQL
    • +
  • */
    • +
  • NULL:' NULL',
    • +
    • +
  • /**
    • +
  • *Default PRIMARY KEY SQL
    • +
  • */
    • +
  • PRIMARY_KEY:' PRIMARY KEY',
    • +
    • +
  • /**
    • +
  • *Default RESTRICT SQL
    • +
  • */
    • +
  • RESTRICT:'RESTRICT',
    • +
    • +
  • /**
    • +
  • *Default SET DEFAULT SQL
    • +
  • */
    • +
  • SET_DEFAULT:'SET DEFAULT',
    • +
    • +
  • /**
    • +
  • *Default SET NULL SQL
    • +
  • */
    • +
  • SET_NULL:'SET NULL',
    • +
    • +
  • /**
    • +
  • *Default TEMPORARY SQL
    • +
  • */
    • +
  • TEMPORARY:'TEMPORARY ',
    • +
    • +
  • /**
    • +
  • *Default UNDERSCORE SQL, used in index creation.
    • +
  • */
    • +
  • UNDERSCORE:'_',
    • +
    • +
  • /**
    • +
  • *Default UNIQUE SQL
    • +
  • */
    • +
  • UNIQUE:' UNIQUE',
    • +
    • +
  • /**
    • +
  • * Default UNSIGNED SQL
    • +
  • */
    • +
  • UNSIGNED:' UNSIGNED'
    • +
    • +
  • }
    • +
  • }).as(module);
    • +
    • +
    + +
    + + + + + +
    +
    errors.js
    +     		+
    + Coverage89.47 + SLOC81 + LOC19 + Missed2 +
    +
    + 
    1. 1var patio = exports;
      2. 
+
    2.  
      3. 
+
    3.  
      4. 
+
    4.  /**
      5. 
+
    5.   * @class Thrown if a function is not impltemened
      6. 
+
    6.   *
      7. 
+
    7.   * @param {String} message the message to show.
      8. 
+
    8.   */
      9. 
+
    9. 1patio.NotImplemented = function(message) {
      10. 
+
    10. 4  return new Error("Not Implemented :  " + message);
      11. 
+
    11.  };
      12. 
+
    12.  
      13. 
+
    13.  /**
      14. 
+
    14.   * @class Thrown if there is an Expression Error.
      15. 
+
    15.   *
      16. 
+
    16.   * @param {String} message the message to show.
      17. 
+
    17.   */
      18. 
+
    18. 1patio.ExpressionError = function(message) {
      19. 
+
    19. 0  return new Error("Expression Error :" + message);
      20. 
+
    20.  };
      21. 
+
    21.  
      22. 
+
    22.  /**
      23. 
+
    23.   * @class Thrown if there is a Query Error.
      24. 
+
    24.   *
      25. 
+
    25.   * @param {String} message the message to show.
      26. 
+
    26.   */
      27. 
+
    27. 1patio.QueryError = function(message) {
      28. 
+
    28. 121  return new Error("QueryError : " + message);
      29. 
+
    29.  };
      30. 
+
    30.  
      31. 
+
    31.  /**
      32. 
+
    32.   * @class Thrown if there is a Dataset Error.
      33. 
+
    33.   *
      34. 
+
    34.   * @param {String} message the message to show.
      35. 
+
    35.   */
      36. 
+
    36. 1patio.DatasetError = function(message) {
      37. 
+
    37. 7  return new Error("DatasetError : " + message);
      38. 
+
    38.  };
      39. 
+
    39.  
      40. 
+
    40.  /**
      41. 
+
    41.   * @class Thrown if there is a Database Error.
      42. 
+
    42.   *
      43. 
+
    43.   * @param {String} message the message to show.
      44. 
+
    44.   */
      45. 
+
    45. 1patio.DatabaseError = function(message) {
      46. 
+
    46. 5  return new Error("Database error : " + message);
      47. 
+
    47.  };
      48. 
+
    48.  
      49. 
+
    49.  /**
      50. 
+
    50.   * @class Thrown if there is a unexpected Error.
      51. 
+
    51.   *
      52. 
+
    52.   * @param {String} message the message to show.
      53. 
+
    53.   */
      54. 
+
    54. 1patio.PatioError = function(message) {
      55. 
+
    55. 31  return new Error("Patio error : " + message);
      56. 
+
    56.  };
      57. 
+
    57.  
      58. 
+
    58.  /**
      59. 
+
    59.   * @class Thrown if there is a error thrown within a model.
      60. 
+
    60.   * @param {String} message the message to show.
      61. 
+
    61.   */
      62. 
+
    62. 1patio.ModelError = function(message) {
      63. 
+
    63. 2  return new Error("Model error : " + message);
      64. 
+
    64.  };
      65. 
+
    65.  
      66. 
+
    66.  /**
      67. 
+
    67.   * @class Thrown if there is an error when loading/creating/deleteing an association.
      68. 
+
    68.   * @param {String} message the message to show.
      69. 
+
    69.   */
      70. 
+
    70. 1patio.AssociationError = function(message) {
      71. 
+
    71. 0  return new Error("Association error : " + message);
      72. 
+
    72.  };
      73. 
+
    73.  
      74. 
+
    74.  
      75. 
+
    75.  /**
      76. 
+
    76.   * Thrown if there is an error when performing a migration.
      77. 
+
    77.   * @param {String} message the message to show.
      78. 
+
    78.   */
      79. 
+
    79. 1patio.MigrationError = function(message) {
      80. 
+
    80. 2    return new Error("Migration error : " + message);
      81. 
+
    81.  };
    @@ -9069,21 +9542,21 @@
  • 1var virtualRow = function (name) {
    • -
  • 874 var WILDCARD = new LiteralString('*');
    • -
  • 874 var QUESTION_MARK = new LiteralString('?');
    • -
  • 874 var COMMA_SEPARATOR = new LiteralString(', ');
    • -
  • 874 var DOUBLE_UNDERSCORE = '__';
    • -
    • -
  • 874 var parts = name.split(DOUBLE_UNDERSCORE);
    • -
  • 874 var table = parts[0], column = parts[1];
    • -
  • 874 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • -
  • 874 var prox = methodMissing(ident, function (m) {
    • +
  • 875 var WILDCARD = new LiteralString('*');
    • +
  • 875 var QUESTION_MARK = new LiteralString('?');
    • +
  • 875 var COMMA_SEPARATOR = new LiteralString(', ');
    • +
  • 875 var DOUBLE_UNDERSCORE = '__';
    • +
    • +
  • 875 var parts = name.split(DOUBLE_UNDERSCORE);
    • +
  • 875 var table = parts[0], column = parts[1];
    • +
  • 875 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • +
  • 875 var prox = methodMissing(ident, function (m) {
  • 4 return function () {
  • 3 var args = argsToArray(arguments);
  • 3 return SQLFunction.fromArgs([m, name].concat(args));
  • }
  • }, column ? QualifiedIdentifier : Identifier);
    • -
  • 874 var ret = createFunctionWrapper(prox, function (m) {
    • +
  • 875 var ret = createFunctionWrapper(prox, function (m) {
  • 548 var args = argsToArray(arguments);
  • 548 if (args.length) {
  • 542 return SQLFunction.fromArgs([name].concat(args));
    • @@ -9093,8 +9566,8 @@
  • }, function () {
  • 0 return SQLFunction.fromArgs(arguments);
  • });
    • -
  • 874 ret.__proto__ = ident;
    • -
  • 874 return ret;
    • +
  • 875 ret.__proto__ = ident;
    • +
  • 875 return ret;
  • };
  • 1var DATE_METHODS = ["getDate", "getDay", "getFullYear", "getHours", "getMilliseconds", "getMinutes", "getMonth", "getSeconds",
    • @@ -9546,7 +10019,7 @@
  • });
  • 1exports.sql = methodMissing(sql, function (name) {
    • -
  • 874 return virtualRow(name);
    • +
  • 875 return virtualRow(name);
  • });
  • 1var OPERTATOR_INVERSIONS = {
    • @@ -10198,7 +10671,7 @@
  • * @return {patio.sql.ColumnAll}
  • */
  • all:function () {
    • -
  • 329 return new ColumnAll(this);
    • +
  • 3 return new ColumnAll(this);
  • }
    • @@ -10356,13 +10829,13 @@
  • * @return {patio.sql.Expression} an expression.
  • */
  • fromArgs:function (args) {
    • -
  • 2215 var ret;
    • -
  • 2215 try {
    • -
  • 2215 ret = new this();
    • +
  • 2216 var ret;
    • +
  • 2216 try {
    • +
  • 2216 ret = new this();
  • } catch (ignore) {
  • }
    • -
  • 2215 this.apply(ret, args);
    • -
  • 2215 return ret;
    • +
  • 2216 this.apply(ret, args);
    • +
  • 2216 return ret;
  • },
  • /**
    • @@ -10554,7 +11027,7 @@
  • * @property table the table this all column expression represents.
  • */
  • constructor:function (table) {
    • -
  • 346 this.table = table;
    • +
  • 20 this.table = table;
  • },
  • /**
    • @@ -10566,9 +11039,9 @@
  • * @return String the SQL columnAll expression fragment.
  • */
  • toString:function (ds) {
    • -
  • 345 !Dataset && (Dataset = require("./dataset"));
    • -
  • 345 ds = ds || new Dataset();
    • -
  • 345 return ds.columnAllSql(this);
    • +
  • 19 !Dataset && (Dataset = require("./dataset"));
    • +
  • 19 ds = ds || new Dataset();
    • +
  • 19 return ds.columnAllSql(this);
  • }
  • }
  • }).as(sql, "ColumnAll");
    • @@ -11165,7 +11638,7 @@
  • * @property {String} value <b>READ ONLY</b> the column or table this identifier represents.
  • */
  • constructor:function (value) {
    • -
  • 16412 this.__value = value;
    • +
  • 16414 this.__value = value;
  • },
  • /**
    • @@ -11185,7 +11658,7 @@
  • /**@ignore*/
  • getters:{
  • value:function () {
    • -
  • 25480 return this.__value;
    • +
  • 25154 return this.__value;
  • }
  • }
  • }
    • @@ -11742,7 +12215,7 @@
  • 1var addStringMethod = function (op) {
  • 24 return function () {
    • -
  • 3968 return this.__str[op].apply(this.__str, arguments);
    • +
  • 4294 return this.__str[op].apply(this.__str, arguments);
  • }
  • };
    • @@ -11765,7 +12238,7 @@
  • * @param {String} str the literal string.
  • */
  • constructor:function (str) {
    • -
  • 3092 this.__str = str;
    • +
  • 3095 this.__str = str;
  • }
  • }
  • }).as(sql, "LiteralString");
    • @@ -12275,601 +12748,144 @@
  • } else {
  • 0 ret.callback(this.__appliedMigrations);
  • }
    • -
  • 18 return ret.promise();
    • -
  • },
    • -
    • -
  • __getMirationFiles:function () {
    • -
  • 18 var ret = new Promise();
    • -
  • 18 var upMigrations = [], downMigrations = [], target = this.target;
    • -
  • 18 if (!this.__migrationFiles) {
    • -
  • 18 when(
    • -
  • this.getFileNames(),
    • -
  • this.__getAppliedMigrations()
    • -
  • ).then(hitch(this, function (res) {
    • -
  • 18 var files = res[0], appliedMigrations = res[1];
    • -
  • 18 var l = files.length, inserts = [];
    • -
  • 18 if (l > 0) {
    • -
  • 18 try {
    • -
  • 18 for (var i = 0; i < l; i++) {
    • -
  • 92 var file = files[i], f = path.basename(file), fLowerCase = f.toLowerCase();
    • -
  • 92 if (!isUndefined(target)) {
    • -
  • 48 var version = this.getMigrationVersionFromFile(f);
    • -
  • 48 if (version > target || (version === 0 && target === version)) {
    • -
  • 35 if (appliedMigrations.indexOf(fLowerCase) != -1) {
    • -
  • 26 downMigrations.push([f, require(file), "down"]);
    • -
  • }
    • -
  • 13 } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
    • -
  • 9 upMigrations.push([f, require(file), "up"]);
    • -
  • }
    • -
  • 44 } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
    • -
  • 35 upMigrations.push([f, require(file), "up"]);
    • -
  • }
    • -
  • }
    • -
  • } catch (e) {
    • -
  • 0 return ret.errback(e)
    • -
  • }
    • -
  • 18 this.__migrationFiles = upMigrations.concat(downMigrations.reverse())
    • -
  • 18 ret.callback(this.__migrationFiles);
    • -
  • } else {
    • -
  • 0 return ret.callback();
    • -
  • }
    • -
  • }), ret);
    • -
  • } else {
    • -
  • 0 ret.callback(this.__migrationFiles);
    • -
  • }
    • -
  • 18 return ret.promise();
    • -
  • },
    • -
    • -
    • -
  • // Returns the dataset for the schema_migrations table. If no such table
    • -
  • // exists, it is automatically created.
    • -
  • _getSchemaDataset:function () {
    • -
  • 36 var ret = new Promise();
    • -
  • 36 if (!this.__schemaDataset) {
    • -
  • 18 var ds = this.db.from(this.table);
    • -
  • 18 this.__createTable().then(hitch(this, function () {
    • -
  • 18 this.__schemaDataset = ds;
    • -
  • 18 ret.callback(ds);
    • -
  • }), ret);
    • -
  • } else {
    • -
  • 18 ret.callback(this.__schemaDataset);
    • -
  • }
    • -
  • 36 return ret.promise();
    • -
  • },
    • -
    • -
  • __convertSchemaInfo:function () {
    • -
  • 1 var ret = new Promise(), c = this.column;
    • -
  • 1 var ds = this.db.from(this.table);
    • -
  • 1 this.db.from(IntegerMigrator.DEFAULT_SCHEMA_TABLE).get(IntegerMigrator.DEFAULT_SCHEMA_COLUMN).then(hitch(this, function (version) {
    • -
  • 1 this.getFileNames().then(hitch(this, function (files) {
    • -
  • 1 var l = files.length, inserts = [];
    • -
  • 1 if (l > 0) {
    • -
  • 1 for (var i = 0; i < l; i++) {
    • -
  • 7 var f = path.basename(files[i]);
    • -
  • 7 if (this.getMigrationVersionFromFile(f) <= version) {
    • -
  • 5 var insert = {};
    • -
  • 5 insert[c] = f;
    • -
  • 5 inserts.push(ds.insert(insert));
    • -
  • }
    • -
  • }
    • -
  • }
    • -
  • 1 if (inserts.length) {
    • -
  • 1 when.apply(comb, inserts).then(ret);
    • -
  • } else {
    • -
  • 0 ret.callback();
    • -
  • }
    • -
  • }), ret);
    • -
  • }), ret);
    • -
  • 1 return ret.promise();
    • -
    • -
  • },
    • -
    • -
  • __createTable:function () {
    • -
  • 18 var c = this.column, table = this.table, db = this.db, intMigrationTable = IntegerMigrator.DEFAULT_SCHEMA_TABLE;
    • -
  • 18 var ds = this.db.from(table);
    • -
  • 18 var ret = new Promise();
    • -
  • 18 when(
    • -
  • db.tableExists(table),
    • -
  • db.tableExists(intMigrationTable)
    • -
  • ).then(hitch(this, function (res) {
    • -
  • 18 var exists = res[0], intMigratorExists = res[1];
    • -
  • 18 if (!exists) {
    • -
  • 10 db.createTable(table,
    • -
  • function () {
    • -
  • 10 this.column(c, String, {primaryKey:true});
    • -
  • }).addErrback(ret);
    • -
  • 10 if (intMigratorExists) {
    • -
  • 1 db.from(intMigrationTable).all().then(hitch(this, function (versions) {
    • -
  • 1 var version;
    • -
  • 1 if (versions.length === 1 && (version = versions[0]) && isNumber(version[Object.keys(version)[0]])) {
    • -
  • 1 this.__convertSchemaInfo().then(ret);
    • -
  • } else {
    • -
  • 0 ret.callback();
    • -
  • }
    • -
  • }));
    • -
  • } else {
    • -
  • 9 ret.callback();
    • -
  • }
    • -
  • } else {
    • -
  • 8 ds.columns.then(hitch(this, function (columns) {
    • -
  • 8 if (columns.indexOf(c) === -1) {
    • -
  • 0 ret.errback(new MigrationError(format("Migration table %s does not contain column %s", table, c)));
    • -
  • } else {
    • -
  • 8 ret.callback();
    • -
  • }
    • -
  • }), ret);
    • -
  • }
    • -
  • }), ret);
    • -
  • 18 return ret.promise();
    • -
  • }
    • -
  • },
    • -
    • -
  • static:{
    • -
  • DEFAULT_SCHEMA_COLUMN:"filename",
    • -
  • DEFAULT_SCHEMA_TABLE:"schema_migrations"
    • -
  • }
    • -
  • }).as(exports, "TimestampMigrator");
    • -
    • -
  • 1exports.run = function () {
    • -
  • 31 return Migrator.run.apply(Migrator, arguments);
    • -
  • };
    • -
    - -
    - - - - - -
    -
    dataset/index.js
    -     		-
    - Coverage92.54 - SLOC439 - LOC67 - Missed5 -
    -
    - 
    1. 1var comb = require("comb"),
      2. 
-
    2.      hitch = comb.hitch,
      3. 
-
    3.      logging = comb.logging,
      4. 
-
    4.      Logger = logging.Logger,
      5. 
-
    5.      errors = require("../errors"),
      6. 
-
    6.      QueryError = errors.QueryError,
      7. 
-
    7.      DatasetError = errors.DatasetError,
      8. 
-
    8.      Promise = comb.Promise,
      9. 
-
    9.      PromiseList = comb.PromiseList,
      10. 
-
    10.      isUndefined = comb.isUndefined,
      11. 
-
    11.      isUndefinedOrNull = comb.isUndefinedOrNull,
      12. 
-
    12.      isString = comb.isString,
      13. 
-
    13.      isInstanceOf = comb.isInstanceOf,
      14. 
-
    14.      isString = comb.isString,
      15. 
-
    15.      isFunction = comb.isFunction,
      16. 
-
    16.      isNull = comb.isNull,
      17. 
-
    17.      merge = comb.merge,
      18. 
-
    18.      define = comb.define,
      19. 
-
    19.      graph = require("./graph"),
      20. 
-
    20.      actions = require("./actions"),
      21. 
-
    21.      features = require("./features"),
      22. 
-
    22.      query = require("./query"),
      23. 
-
    23.      sql = require("./sql"),
      24. 
-
    24.      SQL = require("../sql").sql,
      25. 
-
    25.      AliasedExpression = SQL.AliasedExpression,
      26. 
-
    26.      Identifier = SQL.Identifier,
      27. 
-
    27.      QualifiedIdentifier = SQL.QualifiedIdentifier;
      28. 
-
    28.  
      29. 
-
    29.  
      30. 
-
    30. 1var LOGGER = comb.logger("patio.Dataset");
      31. 
-
    31. 1define([actions, graph, features, query, sql], {
      32. 
-
    32.      instance:{
      33. 
-
    33.  
      34. 
-
    34.          /**@lends patio.Dataset.prototype*/
      35. 
-
    35.  
      36. 
-
    36.          /**
      37. 
-
    37.           * Class that is used for querying/retirving datasets from a database.
      38. 
-
    38.           *
      39. 
-
    39.           * <p> Dynamically genertated methods include
      40. 
-
    40.           * <ul>
      41. 
-
    41.           *     <li>Join methods from {@link patio.Dataset.CONDITIONED_JOIN_TYPES} and
      42. 
-
    42.           *         {@link  patio.Dataset.UNCONDITIONED_JOIN_TYPES}, these methods handle the type call
      43. 
-
    43.           *         to {@link patio.Dataset#joinTable}, so to invoke include all arguments that
      44. 
-
    44.           *         {@link patio.Dataset#joinTable} requires except the type parameter. The default list includes.
      45. 
-
    45.           *         <ul>
      46. 
-
    46.           *             <li>Conditioned join types that accept conditions.
      47. 
-
    47.           *                  <ul>
      48. 
-
    48.           *                      <li>inner - INNER JOIN</li>
      49. 
-
    49.           *                      <li>fullOuter - FULL OUTER</li>
      50. 
-
    50.           *                      <li>rightOuter - RIGHT OUTER JOIN</li>
      51. 
-
    51.           *                      <li>leftOuter - LEFT OUTER JOIN</li>
      52. 
-
    52.           *                      <li>full - FULL JOIN</li>
      53. 
-
    53.           *                      <li>right - RIGHT JOIN</li>
      54. 
-
    54.           *                      <li>left - LEFT JOIN</li>
      55. 
-
    55.           *                  </ul>
      56. 
-
    56.           *             </li>
      57. 
-
    57.           *             <li>Unconditioned join types that do not accept join conditions
      58. 
-
    58.           *                  <ul>
      59. 
-
    59.           *                      <li>natural - NATURAL JOIN</li>
      60. 
-
    60.           *                      <li>naturalLeft - NATURAL LEFT JOIN</li>
      61. 
-
    61.           *                      <li>naturalRight - NATURAL RIGHT JOIN</li>
      62. 
-
    62.           *                      <li>naturalFull - NATURA FULLL JOIN</li>
      63. 
-
    63.           *                      <li>cross - CROSS JOIN</li>
      64. 
-
    64.           *                  </ul>
      65. 
-
    65.           *             </li>
      66. 
-
    66.           *         </ul>
      67. 
-
    67.           *      </li>
      68. 
-
    68.           *  </li>
      69. 
-
    69.           * </ul>
      70. 
-
    70.           *
      71. 
-
    71.           * <p>
      72. 
-
    72.           *     <h4>Features:</h4>
      73. 
-
    73.           *     <p>
      74. 
-
    74.           *           Features that a particular {@link patio.Dataset} supports are shown in the example below.
      75. 
-
    75.           *           If you wish to implement an adapter please override these values depending on the database that
      76. 
-
    76.           *           you are developing the adapter for.
      77. 
-
    77.           *      </p>
      78. 
-
    78.           *      <pre class="code">
      79. 
-
    79.           *          var ds = DB.from("test");
      80. 
-
    80.           *
      81. 
-
    81.           *          //The default values returned
      82. 
-
    82.           *
      83. 
-
    83.           *          //Whether this dataset quotes identifiers.
      84. 
-
    84.           *          //Whether this dataset quotes identifiers.
      85. 
-
    85.           *          ds.quoteIdentifiers //=>true
      86. 
-
    86.           *
      87. 
-
    87.           *          //Whether this dataset will provide accurate number of rows matched for
      88. 
-
    88.           *          //delete and update statements.  Accurate in this case is the number of
      89. 
-
    89.           *          //rows matched by the dataset's filter.
      90. 
-
    90.           *          ds.providesAccurateRowsMatched; //=>true
      91. 
-
    91.           *
      92. 
-
    92.           *          //Times Whether the dataset requires SQL standard datetimes (false by default,
      93. 
-
    93.           *          // as most allow strings with ISO 8601 format).
      94. 
-
    94.           *          ds.requiresSqlStandardDate; //=>false
      95. 
-
    95.           *
      96. 
-
    96.           *          //Whether the dataset supports common table expressions (the WITH clause).
      97. 
-
    97.           *          ds.supportsCte; //=>true
      98. 
-
    98.           *
      99. 
-
    99.           *          //Whether the dataset supports the DISTINCT ON clause, false by default.
      100. 
-
    100.           *          ds.supportsDistinctOn; //=>false
      101. 
-
    101.           *
      102. 
-
    102.           *          //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
      103. 
-
    103.           *          ds.supportsIntersectExcept; //=>true
      104. 
-
    104.           *
      105. 
-
    105.           *          //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default
      106. 
-
    106.           *          ds.supportsIntersectExceptAll; //=>true
      107. 
-
    107.           *
      108. 
-
    108.           *          //Whether the dataset supports the IS TRUE syntax.
      109. 
-
    109.           *          ds.supportsIsTrue; //=>true
      110. 
-
    110.           *
      111. 
-
    111.           *          //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
      112. 
-
    112.           *          ds.supportsJoinUsing; //=>true
      113. 
-
    113.           *
      114. 
-
    114.           *          //Whether modifying joined datasets is supported.
      115. 
-
    115.           *          ds.supportsModifyingJoin; //=>false
      116. 
-
    116.           *
      117. 
-
    117.           *          //Whether the IN/NOT IN operators support multiple columns when an
      118. 
-
    118.           *          ds.supportsMultipleColumnIn; //=>true
      119. 
-
    119.           *
      120. 
-
    120.           *          //Whether the dataset supports timezones in literal timestamps
      121. 
-
    121.           *          ds.supportsTimestampTimezone; //=>false
      122. 
-
    122.           *
      123. 
-
    123.           *          //Whether the dataset supports fractional seconds in literal timestamps
      124. 
-
    124.           *          ds.supportsTimestampUsecs; //=>true
      125. 
-
    125.           *
      126. 
-
    126.           *          //Whether the dataset supports window functions.
      127. 
-
    127.           *          ds.supportsWindowFunctions; //=>false
      128. 
-
    128.           *       </pre>
      129. 
-
    129.           * <p>
      130. 
-
    130.           * <p>
      131. 
-
    131.           *     <h4>Actions</h4>
      132. 
-
    132.           *     <p>
      133. 
-
    133.           *         Each dataset does not actually send any query to the database until an action method has
      134. 
-
    134.           *         been called upon it(with the exception of {@link patio.Dataset#graph} because columns
      135. 
-
    135.           *         from the other table might need retrived in order to set up the graph). Each action
      136. 
-
    136.           *         returns a <i>comb.Promise</i> that will be resolved with the result or errback, it is important
      137. 
-
    137.           *         that you account for errors otherwise it can be difficult to track down issues.
      138. 
-
    138.           *         The list of action methods is:
      139. 
-
    139.           *         <ul>
      140. 
-
    140.           *             <li>{@link patio.Dataset#all}</li>
      141. 
-
    141.           *             <li>{@link patio.Dataset#one}</li>
      142. 
-
    142.           *             <li>{@link patio.Dataset#avg}</li>
      143. 
-
    143.           *             <li>{@link patio.Dataset#count}</li>
      144. 
-
    144.           *             <li>{@link patio.Dataset#columns}</li>
      145. 
-
    145.           *             <li>{@link patio.Dataset#remove}</li>
      146. 
-
    146.           *             <li>{@link patio.Dataset#forEach}</li>
      147. 
-
    147.           *             <li>{@link patio.Dataset#empty}</li>
      148. 
-
    148.           *             <li>{@link patio.Dataset#first}</li>
      149. 
-
    149.           *             <li>{@link patio.Dataset#get}</li>
      150. 
-
    150.           *             <li>{@link patio.Dataset#import}</li>
      151. 
-
    151.           *             <li>{@link patio.Dataset#insert}</li>
      152. 
-
    152.           *             <li>{@link patio.Dataset#save}</li>
      153. 
-
    153.           *             <li>{@link patio.Dataset#insertMultiple}</li>
      154. 
-
    154.           *             <li>{@link patio.Dataset#saveMultiple}</li>
      155. 
-
    155.           *             <li>{@link patio.Dataset#interval}</li>
      156. 
-
    156.           *             <li>{@link patio.Dataset#last}</li>
      157. 
-
    157.           *             <li>{@link patio.Dataset#map}</li>
      158. 
-
    158.           *             <li>{@link patio.Dataset#max}</li>
      159. 
-
    159.           *             <li>{@link patio.Dataset#min}</li>
      160. 
-
    160.           *             <li>{@link patio.Dataset#multiInsert}</li>
      161. 
-
    161.           *             <li>{@link patio.Dataset#range}</li>
      162. 
-
    162.           *             <li>{@link patio.Dataset#selectHash}</li>
      163. 
-
    163.           *             <li>{@link patio.Dataset#selectMap}</li>
      164. 
-
    164.           *             <li>{@link patio.Dataset#selectOrderMap}</li>
      165. 
-
    165.           *             <li>{@link patio.Dataset#set}</li>
      166. 
-
    166.           *             <li>{@link patio.Dataset#singleRecord}</li>
      167. 
-
    167.           *             <li>{@link patio.Dataset#singleValue}</li>
      168. 
-
    168.           *             <li>{@link patio.Dataset#sum}</li>
      169. 
-
    169.           *             <li>{@link patio.Dataset#toCsv}</li>
      170. 
-
    170.           *             <li>{@link patio.Dataset#toHash}</li>
      171. 
-
    171.           *             <li>{@link patio.Dataset#truncate}</li>
      172. 
-
    172.           *             <li>{@link patio.Dataset#update}</li>
      173. 
-
    173.           *         </ul>
      174. 
-
    174.           *
      175. 
-
    175.           *     </p>
      176. 
-
    176.           * </p>
      177. 
-
    177.           *
      178. 
-
    178.           * @constructs
      179. 
-
    179.           *
      180. 
-
    180.           *
      181. 
-
    181.           * @param {patio.Database} db the database this dataset should use when querying for data.
      182. 
-
    182.           * @param {Object} opts options to set on this dataset instance
      183. 
-
    183.           *
      184. 
-
    184.           * @property {Function} rowCb callback to be invoked for each row returned from the database.
      185. 
-
    185.           *                      the return value will be used as the result of query. The rowCb can also return a promise,
      186. 
-
    186.           *                      The resolved value of the promise will be used as result.
      187. 
-
    187.           *
      188. 
-
    188.           * @property {String} identifierInputMethod this is the method that will be called on each identifier returned from the database.
      189. 
-
    189.           *                                          This value will be defaulted to whatever the identifierInputMethod
      190. 
-
    190.           *                                          is on the database used in initialization.
      191. 
-
    191.           *
      192. 
-
    192.           * @property {String} identifierOutputMethod this is the method that will be called on each identifier sent to the database.
      193. 
-
    193.           *                                          This value will be defaulted to whatever the identifierOutputMethod
      194. 
-
    194.           *                                          is on the database used in initialization.
      195. 
-
    195.           * @property {String} firstSourceAlias The first source (primary table) for this dataset. If the table is aliased, returns the aliased name.
      196. 
-
    196.           *                                     throws a {patio.DatasetError} tf the dataset doesn't have a table.
      197. 
-
    197.           * <pre class="code">
      198. 
-
    198.           *   DB.from("table").firstSourceAlias;
      199. 
-
    199.           *   //=> "table"
      200. 
-
    200.           *
      201. 
-
    201.           *   DB.from("table___t").firstSourceAlias;
      202. 
-
    202.           *   //=> "t"
      203. 
-
    203.           * </pre>
      204. 
-
    204.           *
      205. 
-
    205.           * @property {String} firstSourceTable  The first source (primary table) for this dataset.  If the dataset doesn't
      206. 
-
    206.           *                                      have a table, raises a {@link patio.erros.DatasetError}.
      207. 
-
    207.           *<pre class="code">
      208. 
-
    208.           *
      209. 
-
    209.           *  DB.from("table").firstSourceTable;
      210. 
-
    210.           *         //=> "table"
      211. 
-
    211.           *
      212. 
-
    212.           *  DB.from("table___t").firstSourceTable;
      213. 
-
    213.           *         //=> "t"
      214. 
-
    214.           * </pre>
      215. 
-
    215.           * @property {Boolean} isSimpleSelectAll Returns true if this dataset is a simple SELECT * FROM {table}, otherwise false.
      216. 
-
    216.           * <pre class="code">
      217. 
-
    217.           *     DB.from("items").isSimpleSelectAll; //=> true
      218. 
-
    218.           *     DB.from("items").filter({a : 1}).isSimpleSelectAll; //=> false
      219. 
-
    219.           * </pre>
      220. 
-
    220.           * @property {boolean} [quoteIdentifiers=true]  Whether this dataset quotes identifiers.
      221. 
-
    221.           * @property {boolean} [providesAccurateRowsMatched=true] Whether this dataset will provide accurate number of rows matched for
      222. 
-
    222.           *   delete and update statements.  Accurate in this case is the number of
      223. 
-
    223.           *   rows matched by the dataset's filter.
      224. 
-
    224.           * @property {boolean} [requiresSqlStandardDate=false] Whether the dataset requires SQL standard datetimes (false by default,
      225. 
-
    225.           *                                                     as most allow strings with ISO 8601 format).
      226. 
-
    226.           * @property {boolean} [supportsCte=true] Whether the dataset supports common table expressions (the WITH clause).
      227. 
-
    227.           * @property {boolean} [supportsDistinctOn=false] Whether the dataset supports the DISTINCT ON clause, false by default.
      228. 
-
    228.           * @property {boolean} [supportsIntersectExcept=true] Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
      229. 
-
    229.           * @property {boolean} [supportsIntersectExceptAll=true] Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
      230. 
-
    230.           * @property {boolean} [supportsIsTrue=true] Whether the dataset supports the IS TRUE syntax.
      231. 
-
    231.           * @property {boolean} [supportsJoinUsing=true] Whether the dataset supports the JOIN table USING (column1, ...) syntax.
      232. 
-
    232.           * @property {boolean} [supportsModifyingJoin=false] Whether modifying joined datasets is supported.
      233. 
-
    233.           * @property {boolean} [supportsMultipleColumnIn=true] Whether the IN/NOT IN operators support multiple columns when an
      234. 
-
    234.           * @property {boolean} [supportsTimestampTimezone=false] Whether the dataset supports timezones in literal timestamps
      235. 
-
    235.           * @property {boolean} [supportsTimestampUsecs=true] Whether the dataset supports fractional seconds in literal timestamps
      236. 
-
    236.           * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions.
      237. 
-
    237.           */
      238. 
-
    238.          constructor:function (db, opts) {
      239. 
-
    239. 29542            this._super(arguments);
      240. 
-
    240. 29542            this.db = db;
      241. 
-
    241. 29542            this.__opts = {};
      242. 
-
    242. 29542            this.__rowCb = null;
      243. 
-
    243. 29542            if (db) {
      244. 
-
    244. 15365                this.__quoteIdentifiers = db.quoteIdentifiers;
      245. 
-
    245. 15365                this.__identifierInputMethod = db.identifierInputMethod;
      246. 
-
    246. 15365                this.__identifierOutputMethod = db.identifierOutputMethod;
      247. 
-
    247.              }
      248. 
+
    248. 18            return ret.promise();
      249. 
 
    249.          },
      250. 
 
    250.  
      251. 
-
    251.  
      252. 
-
    252.          /**
      253. 
-
    253.           * Returns a new clone of the dataset with with the given options merged into the current datasets options.
      254. 
-
    254.           * If the options changed include options in {@link patio.dataset.Query#COLUMN_CHANGE_OPTS}, the cached
      255. 
-
    255.           * columns are deleted.  This method should generally not be called
      256. 
-
    256.           * directly by user code.
      257. 
-
    257.           *
      258. 
-
    258.           * @param {Object} opts options to merge into the curred datasets options and applied to the returned dataset.
      259. 
-
    259.           * @return [patio.Dataset] a cloned dataset with the merged options
      260. 
-
    260.           **/
      261. 
-
    261.          mergeOptions:function (opts) {
      262. 
-
    262. 15274            opts = isUndefined(opts) ? {} : opts;
      263. 
-
    263. 15274            var ds = new this._static(this.db, {});
      264. 
-
    264. 15274            ds.rowCb = this.rowCb;
      265. 
-
    265. 15274            this._static.FEATURES.forEach(function (f) {
      266. 
-
    266. 213836                ds[f] = this[f];
      267. 
-
    267.              }, this);
      268. 
-
    268. 15274            ds.__opts = merge({}, this.__opts, opts);
      269. 
-
    269. 15274            ds.identifierInputMethod = this.identifierInputMethod;
      270. 
-
    270. 15274            ds.identifierOutputMethod = this.identifierOutputMethod;
      271. 
-
    271. 15274            var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
      272. 
-
    272. 15274            if (Object.keys(opts).some(function (o) {
      273. 
-
    273. 13862                return columnChangeOpts.indexOf(o) != -1;
      274. 
-
    274.              })) {
      275. 
-
    275. 2782                ds.__opts.columns = null;
      276. 
+
    276.          __getMirationFiles:function () {
      277. 
+
    277. 18            var ret = new Promise();
      278. 
+
    278. 18            var upMigrations = [], downMigrations = [], target = this.target;
      279. 
+
    279. 18            if (!this.__migrationFiles) {
      280. 
+
    280. 18                when(
      281. 
+
    281.                      this.getFileNames(),
      282. 
+
    282.                      this.__getAppliedMigrations()
      283. 
+
    283.                  ).then(hitch(this, function (res) {
      284. 
+
    284. 18                    var files = res[0], appliedMigrations = res[1];
      285. 
+
    285. 18                    var l = files.length, inserts = [];
      286. 
+
    286. 18                    if (l > 0) {
      287. 
+
    287. 18                        try {
      288. 
+
    288. 18                            for (var i = 0; i < l; i++) {
      289. 
+
    289. 92                                var file = files[i], f = path.basename(file), fLowerCase = f.toLowerCase();
      290. 
+
    290. 92                                if (!isUndefined(target)) {
      291. 
+
    291. 48                                    var version = this.getMigrationVersionFromFile(f);
      292. 
+
    292. 48                                    if (version > target || (version === 0 && target === version)) {
      293. 
+
    293. 35                                        if (appliedMigrations.indexOf(fLowerCase) != -1) {
      294. 
+
    294. 26                                            downMigrations.push([f, require(file), "down"]);
      295. 
+
    295.                                          }
      296. 
+
    296. 13                                    } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
      297. 
+
    297. 9                                        upMigrations.push([f, require(file), "up"]);
      298. 
+
    298.                                      }
      299. 
+
    299. 44                                } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
      300. 
+
    300. 35                                    upMigrations.push([f, require(file), "up"]);
      301. 
+
    301.                                  }
      302. 
+
    302.                              }
      303. 
+
    303.                          } catch (e) {
      304. 
+
    304. 0                            return ret.errback(e)
      305. 
+
    305.                          }
      306. 
+
    306. 18                        this.__migrationFiles = upMigrations.concat(downMigrations.reverse())
      307. 
+
    307. 18                        ret.callback(this.__migrationFiles);
      308. 
+
    308.                      } else {
      309. 
+
    309. 0                        return ret.callback();
      310. 
+
    310.                      }
      311. 
+
    311.                  }), ret);
      312. 
+
    312.              } else {
      313. 
+
    313. 0                ret.callback(this.__migrationFiles);
      314. 
 
    314.              }
      315. 
-
    315. 15274            return ds;
      316. 
+
    316. 18            return ret.promise();
      317. 
 
    317.          },
      318. 
 
    318.  
      319. 
 
    319.  
      320. 
-
    320.          /**
      321. 
-
    321.           * Converts a string to an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
      322. 
-
    322.           * or {@link patio.sql.AliasedExpression}, depending on the format:
      323. 
-
    323.           *
      324. 
-
    324.           * <ul>
      325. 
-
    325.           *      <li>For columns : table__column___alias.</li>
      326. 
-
    326.           *      <li>For tables : schema__table___alias.</li>
      327. 
-
    327.           * </ul>
      328. 
-
    328.           * each portion of the identifier is optional. See example below
      329. 
-
    329.           *
      330. 
-
    330.           * @example
      331. 
-
    331.           *
      332. 
-
    332.           * ds.stringToIdentifier("a") //= > new patio.sql.Identifier("a");
      333. 
-
    333.           * ds.stringToIdentifier("table__column"); //=> new patio.sql.QualifiedIdentifier(table, column);
      334. 
-
    334.           * ds.stringToIdentifier("table__column___alias");
      335. 
-
    335.           *      //=> new patio.sql.AliasedExpression(new patio.sql.QualifiedIdentifier(table, column), alias);
      336. 
-
    336.           *
      337. 
-
    337.           * @param {String} name the name to covert to an an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
      338. 
-
    338.           * or {@link patio.sql.AliasedExpression}.
      339. 
-
    339.           *
      340. 
-
    340.           * @return  {patio.sql.Identifier|patio.sql.QualifiedIdentifier|patio.sql.AliasedExpression} an identifier generated based on the name string.
      341. 
-
    341.           */
      342. 
-
    342.          stringToIdentifier:function (name) {
      343. 
-
    343. 15093            if (isString(name)) {
      344. 
-
    344. 10138                var parts = this._splitString(name);
      345. 
-
    345. 10138                var schema = parts[0], table = parts[1], alias = parts[2];
      346. 
-
    346. 10138                return (schema && table && alias
      347. 
-
    347.                      ? new AliasedExpression(new QualifiedIdentifier(schema, table), alias)
      348. 
-
    348.                      : (schema && table
      349. 
-
    349.                      ? new QualifiedIdentifier(schema, table)
      350. 
-
    350.                      : (table && alias
      351. 
-
    351.                      ? new AliasedExpression(new Identifier(table), alias) : new Identifier(table))));
      352. 
+
    352.          // Returns the dataset for the schema_migrations table. If no such table
      353. 
+
    353.          // exists, it is automatically created.
      354. 
+
    354.          _getSchemaDataset:function () {
      355. 
+
    355. 36            var ret = new Promise();
      356. 
+
    356. 36            if (!this.__schemaDataset) {
      357. 
+
    357. 18                var ds = this.db.from(this.table);
      358. 
+
    358. 18                this.__createTable().then(hitch(this, function () {
      359. 
+
    359. 18                    this.__schemaDataset = ds;
      360. 
+
    360. 18                    ret.callback(ds);
      361. 
+
    361.                  }), ret);
      362. 
 
    362.              } else {
      363. 
-
    363. 4955                return name;
      364. 
-
    364.              }
      365. 
-
    365.          },
      366. 
-
    366.  
      367. 
-
    367.          /**
      368. 
-
    368.           * Can either be a string or null.
      369. 
-
    369.           *
      370. 
-
    370.           *
      371. 
-
    371.           * @example
      372. 
-
    372.           * //columns
      373. 
-
    373.           *  table__column___alias //=> table.column as alias
      374. 
-
    374.           *  table__column //=> table.column
      375. 
-
    375.           *  //tables
      376. 
-
    376.           *  schema__table___alias //=> schema.table as alias
      377. 
-
    377.           *  schema__table //=> schema.table
      378. 
-
    378.           *
      379. 
-
    379.           * //name and alias
      380. 
-
    380.           * columnOrTable___alias //=> columnOrTable as alias
      381. 
-
    381.           *
      382. 
-
    382.           *
      383. 
-
    383.           *
      384. 
-
    384.           * @return {String[]} an array with the elements being:
      385. 
-
    385.           * <ul>
      386. 
-
    386.           *      <li>For columns :[table, column, alias].</li>
      387. 
-
    387.           *      <li>For tables : [schema, table, alias].</li>
      388. 
-
    388.           * </ul>
      389. 
-
    389.           */
      390. 
-
    390.          _splitString:function (s) {
      391. 
-
    391. 19662            var ret, m;
      392. 
-
    392. 19662            if ((m = s.match(this._static.COLUMN_REF_RE1)) != null) {
      393. 
-
    393. 189                ret = m.slice(1);
      394. 
-
    394.              }
      395. 
-
    395. 19473            else if ((m = s.match(this._static.COLUMN_REF_RE2)) != null) {
      396. 
-
    396. 28                ret = [null, m[1], m[2]];
      397. 
-
    397.              }
      398. 
-
    398. 19445            else if ((m = s.match(this._static.COLUMN_REF_RE3)) != null) {
      399. 
-
    399. 2079                ret = [m[1], m[2], null];
      400. 
-
    400.              }
      401. 
-
    401.              else {
      402. 
-
    402. 17366                ret = [null, s, null];
      403. 
+
    403. 18                ret.callback(this.__schemaDataset);
      404. 
 
    404.              }
      405. 
-
    405. 19662            return ret;
      406. 
+
    406. 36            return ret.promise();
      407. 
 
    407.          },
      408. 
 
    408.  
      409. 
-
    409.          /**
      410. 
-
    410.           * @ignore
      411. 
-
    411.           **/
      412. 
-
    412.          getters:{
      413. 
-
    413.  
      414. 
-
    414.              rowCb:function () {
      415. 
-
    415. 23378                return this.__rowCb;
      416. 
-
    416.              },
      417. 
-
    417.  
      418. 
-
    418.              identifierInputMethod:function () {
      419. 
-
    419. 15274                return this.__identifierInputMethod;
      420. 
-
    420.              },
      421. 
-
    421.  
      422. 
-
    422.              identifierOutputMethod:function () {
      423. 
-
    423. 15274                return this.__identifierOutputMethod;
      424. 
-
    424.              },
      425. 
-
    425.  
      426. 
-
    426.              firstSourceAlias:function () {
      427. 
-
    427. 905                var source = this.__opts.from;
      428. 
-
    428. 905                if (isUndefinedOrNull(source) || !source.length) {
      429. 
-
    429. 2                    throw new DatasetError("No source specified for the query");
      430. 
-
    430.                  }
      431. 
-
    431. 903                source = source[0];
      432. 
-
    432. 903                if (isInstanceOf(source, AliasedExpression)) {
      433. 
-
    433. 20                    return source.alias;
      434. 
-
    434. 883                } else if (isString(source)) {
      435. 
-
    435. 0                    var parts = this._splitString(source);
      436. 
-
    436. 0                    var alias = parts[2];
      437. 
-
    437. 0                    return alias ? alias : source;
      438. 
-
    438.                  } else {
      439. 
-
    439. 883                    return source;
      440. 
-
    440.                  }
      441. 
-
    441.              },
      442. 
+
    442.          __convertSchemaInfo:function () {
      443. 
+
    443. 1            var ret = new Promise(), c = this.column;
      444. 
+
    444. 1            var ds = this.db.from(this.table);
      445. 
+
    445. 1            this.db.from(IntegerMigrator.DEFAULT_SCHEMA_TABLE).get(IntegerMigrator.DEFAULT_SCHEMA_COLUMN).then(hitch(this, function (version) {
      446. 
+
    446. 1                this.getFileNames().then(hitch(this, function (files) {
      447. 
+
    447. 1                    var l = files.length, inserts = [];
      448. 
+
    448. 1                    if (l > 0) {
      449. 
+
    449. 1                        for (var i = 0; i < l; i++) {
      450. 
+
    450. 7                            var f = path.basename(files[i]);
      451. 
+
    451. 7                            if (this.getMigrationVersionFromFile(f) <= version) {
      452. 
+
    452. 5                                var insert = {};
      453. 
+
    453. 5                                insert[c] = f;
      454. 
+
    454. 5                                inserts.push(ds.insert(insert));
      455. 
+
    455.                              }
      456. 
+
    456.                          }
      457. 
+
    457.                      }
      458. 
+
    458. 1                    if (inserts.length) {
      459. 
+
    459. 1                        when.apply(comb, inserts).then(ret);
      460. 
+
    460.                      } else {
      461. 
+
    461. 0                        ret.callback();
      462. 
+
    462.                      }
      463. 
+
    463.                  }), ret);
      464. 
+
    464.              }), ret);
      465. 
+
    465. 1            return ret.promise();
      466. 
 
    466.  
      467. 
-
    467.              firstSourceTable:function () {
      468. 
-
    468. 15                var source = this.__opts.from;
      469. 
-
    469. 15                if (isUndefinedOrNull(source) || !source.length) {
      470. 
-
    470. 1                    throw new QueryError("No source specified for the query");
      471. 
-
    471.                  }
      472. 
-
    472. 14                var source = source[0];
      473. 
-
    473. 14                if (isInstanceOf(source, AliasedExpression)) {
      474. 
-
    474. 3                    return source.expression;
      475. 
-
    475. 11                } else if (isString(source)) {
      476. 
-
    476. 0                    var parts = this._splitString(source);
      477. 
-
    477. 0                    return source;
      478. 
-
    478.                  } else {
      479. 
-
    479. 11                    return source;
      480. 
-
    480.                  }
      481. 
-
    481.              }
      482. 
 
    482.          },
      483. 
 
    483.  
      484. 
-
    484.          /**
      485. 
-
    485.           * @ignore
      486. 
-
    486.           **/
      487. 
-
    487.          setters:{
      488. 
-
    488.              /**@lends patio.Dataset.prototype*/
      489. 
-
    489.  
      490. 
-
    490.              identifierInputMethod:function (meth) {
      491. 
-
    491. 15364                this.__identifierInputMethod = meth;
      492. 
-
    492.              },
      493. 
-
    493.  
      494. 
-
    494.              identifierOutputMethod:function (meth) {
      495. 
-
    495. 15364                this.__identifierOutputMethod = meth;
      496. 
-
    496.              },
      497. 
-
    497.  
      498. 
-
    498.              rowCb:function (cb) {
      499. 
-
    499. 18890                if (isFunction(cb) || isNull(cb)) {
      500. 
-
    500. 18885                    this.__rowCb = cb;
      501. 
+
    501.          __createTable:function () {
      502. 
+
    502. 18            var c = this.column, table = this.table, db = this.db, intMigrationTable = IntegerMigrator.DEFAULT_SCHEMA_TABLE;
      503. 
+
    503. 18            var ds = this.db.from(table);
      504. 
+
    504. 18            var ret = new Promise();
      505. 
+
    505. 18            when(
      506. 
+
    506.                  db.tableExists(table),
      507. 
+
    507.                  db.tableExists(intMigrationTable)
      508. 
+
    508.              ).then(hitch(this, function (res) {
      509. 
+
    509. 18                var exists = res[0], intMigratorExists = res[1];
      510. 
+
    510. 18                if (!exists) {
      511. 
+
    511. 10                    db.createTable(table,
      512. 
+
    512.                          function () {
      513. 
+
    513. 10                            this.column(c, String, {primaryKey:true});
      514. 
+
    514.                          }).addErrback(ret);
      515. 
+
    515. 10                    if (intMigratorExists) {
      516. 
+
    516. 1                        db.from(intMigrationTable).all().then(hitch(this, function (versions) {
      517. 
+
    517. 1                            var version;
      518. 
+
    518. 1                            if (versions.length === 1 && (version = versions[0]) && isNumber(version[Object.keys(version)[0]])) {
      519. 
+
    519. 1                                this.__convertSchemaInfo().then(ret);
      520. 
+
    520.                              } else {
      521. 
+
    521. 0                                ret.callback();
      522. 
+
    522.                              }
      523. 
+
    523.                          }));
      524. 
+
    524.                      } else {
      525. 
+
    525. 9                        ret.callback();
      526. 
+
    526.                      }
      527. 
 
    527.                  } else {
      528. 
-
    528. 5                    throw new DatasetError("rowCb mus be a function");
      529. 
+
    529. 8                    ds.columns.then(hitch(this, function (columns) {
      530. 
+
    530. 8                        if (columns.indexOf(c) === -1) {
      531. 
+
    531. 0                            ret.errback(new MigrationError(format("Migration table %s does not contain column %s", table, c)));
      532. 
+
    532.                          } else {
      533. 
+
    533. 8                            ret.callback();
      534. 
+
    534.                          }
      535. 
+
    535.                      }), ret);
      536. 
 
    536.                  }
      537. 
-
    537.              }
      538. 
+
    538.              }), ret);
      539. 
+
    539. 18            return ret.promise();
      540. 
 
    540.          }
      541. 
 
    541.      },
      542. 
 
    542.  
      543. 
 
    543.      static:{
      544. 
-
    544.          COLUMN_REF_RE1:/^(\w+)__(\w+)___(\w+)$/,
      545. 
-
    545.          COLUMN_REF_RE2:/^(\w+)___(\w+)$/,
      546. 
-
    546.          COLUMN_REF_RE3:/^(\w+)__(\w+)$/
      547. 
+
    547.          DEFAULT_SCHEMA_COLUMN:"filename",
      548. 
+
    548.          DEFAULT_SCHEMA_TABLE:"schema_migrations"
      549. 
 
    549.      }
      550. 
-
    550.  }).as(module);
      551. 
+
    551.  }).as(exports, "TimestampMigrator");
      552. 
 
    552.  
      553. 
-
    553.
    +
  • 1exports.run = function () {
    • +
  • 31 return Migrator.run.apply(Migrator, arguments);
    • +
  • };
    • @@ -13876,7 +13892,7 @@
    Coverage92.86 - SLOC1683 + SLOC1684 LOC504 Missed36
    @@ -13884,44 +13900,45 @@ 
    1. 1var comb = require("comb"),
      2. 
-
    2.      define = comb.define,
      3. 
-
    3.      array = comb.array,
      4. 
-
    4.      intersect = array.intersect,
      5. 
-
    5.      compact = array.compact,
      6. 
-
    6.      string = comb.string,
      7. 
-
    7.      format = string.format,
      8. 
-
    8.      argsToArray = comb.argsToArray,
      9. 
-
    9.      isInstanceOf = comb.isInstanceOf,
      10. 
-
    10.      isArray = comb.isArray,
      11. 
-
    11.      isNumber = comb.isNumber,
      12. 
-
    12.      isDate = comb.isDate,
      13. 
-
    13.      isNull = comb.isNull,
      14. 
-
    14.      isBoolean = comb.isBoolean,
      15. 
-
    15.      isFunction = comb.isFunction,
      16. 
-
    16.      isUndefined = comb.isUndefined,
      17. 
-
    17.      isObject = comb.isObject,
      18. 
-
    18.      isHash = comb.isHash,
      19. 
-
    19.      merge = comb.merge,
      20. 
-
    20.      isUndefinedOrNull = comb.isUndefinedOrNull,
      21. 
-
    21.      isString = comb.isString,
      22. 
-
    22.      sql = require("../sql").sql,
      23. 
-
    23.      Expression = sql.Expression,
      24. 
-
    24.      ComplexExpression = sql.ComplexExpression,
      25. 
-
    25.      AliasedExpression = sql.AliasedExpression,
      26. 
-
    26.      Identifier = sql.Identifier,
      27. 
-
    27.      QualifiedIdentifier = sql.QualifiedIdentifier,
      28. 
-
    28.      OrderedExpression = sql.OrderedExpression,
      29. 
-
    29.      CaseExpression = sql.CaseExpression,
      30. 
-
    30.      SubScript = sql.SubScript,
      31. 
-
    31.      NumericExpression = sql.NumericExpression,
      32. 
-
    32.      ColumnAll = sql.ColumnAll,
      33. 
-
    33.      Cast = sql.Cast,
      34. 
-
    34.      StringExpression = sql.StringExpression,
      35. 
-
    35.      BooleanExpression = sql.BooleanExpression,
      36. 
-
    36.      SQLFunction = sql.SQLFunction,
      37. 
-
    37.      LiteralString = sql.LiteralString,
      38. 
-
    38.      PlaceHolderLiteralString = sql.PlaceHolderLiteralString,
      39. 
-
    39.      QueryError = require("../errors").QueryError, patio;
      40. 
+
    40.          define = comb.define,
      41. 
+
    41.          array = comb.array,
      42. 
+
    42.          intersect = array.intersect,
      43. 
+
    43.          compact = array.compact,
      44. 
+
    44.          string = comb.string,
      45. 
+
    45.          format = string.format,
      46. 
+
    46.          argsToArray = comb.argsToArray,
      47. 
+
    47.          isInstanceOf = comb.isInstanceOf,
      48. 
+
    48.          isArray = comb.isArray,
      49. 
+
    49.          isNumber = comb.isNumber,
      50. 
+
    50.          isDate = comb.isDate,
      51. 
+
    51.          isNull = comb.isNull,
      52. 
+
    52.          isBoolean = comb.isBoolean,
      53. 
+
    53.          isFunction = comb.isFunction,
      54. 
+
    54.          isUndefined = comb.isUndefined,
      55. 
+
    55.          isObject = comb.isObject,
      56. 
+
    56.          isHash = comb.isHash,
      57. 
+
    57.          isEmpty = comb.isEmpty,
      58. 
+
    58.          merge = comb.merge,
      59. 
+
    59.          isUndefinedOrNull = comb.isUndefinedOrNull,
      60. 
+
    60.          isString = comb.isString,
      61. 
+
    61.          sql = require("../sql").sql,
      62. 
+
    62.          Expression = sql.Expression,
      63. 
+
    63.          ComplexExpression = sql.ComplexExpression,
      64. 
+
    64.          AliasedExpression = sql.AliasedExpression,
      65. 
+
    65.          Identifier = sql.Identifier,
      66. 
+
    66.          QualifiedIdentifier = sql.QualifiedIdentifier,
      67. 
+
    67.          OrderedExpression = sql.OrderedExpression,
      68. 
+
    68.          CaseExpression = sql.CaseExpression,
      69. 
+
    69.          SubScript = sql.SubScript,
      70. 
+
    70.          NumericExpression = sql.NumericExpression,
      71. 
+
    71.          ColumnAll = sql.ColumnAll,
      72. 
+
    72.          Cast = sql.Cast,
      73. 
+
    73.          StringExpression = sql.StringExpression,
      74. 
+
    74.          BooleanExpression = sql.BooleanExpression,
      75. 
+
    75.          SQLFunction = sql.SQLFunction,
      76. 
+
    76.          LiteralString = sql.LiteralString,
      77. 
+
    77.          PlaceHolderLiteralString = sql.PlaceHolderLiteralString,
      78. 
+
    78.          QueryError = require("../errors").QueryError, patio;
      79. 
 
    79.  
      80. 
 
    80. 1var Dataset;
      81. 
 
    81.  
      82. 
@@ -13985,9 +14002,9 @@
 
    82.          constructor:function () {
      83. 
 
    83.              //We initialize these here because otherwise
      84. 
 
    84.              //the will be blank because of recursive dependencies.
      85. 
-
    85. 29542            !patio && (patio = require("../index"));
      86. 
-
    86. 29542            !Dataset && (Dataset = patio.Dataset);
      87. 
-
    87. 29542            this._super(arguments);
      88. 
+
    88. 29216            !patio && (patio = require("../index"));
      89. 
+
    89. 29216            !Dataset && (Dataset = patio.Dataset);
      90. 
+
    90. 29216            this._super(arguments);
      91. 
 
    91.          },
      92. 
 
    92.  
      93. 
 
    93.          /**
      94. 
@@ -14272,15 +14289,15 @@
 
    94.           * @return {String} a literal representation of the value.
      95. 
 
    95.           */
      96. 
 
    96.          literal:function (v) {
      97. 
-
    97. 44748            if (isInstanceOf(v, LiteralString)) {
      98. 
+
    98. 44422            if (isInstanceOf(v, LiteralString)) {
      99. 
 
    99. 204                return "" + v;
      100. 
-
    100. 44544            } else if (isString(v)) {
      101. 
+
    101. 44218            } else if (isString(v)) {
      102. 
 
    102. 6110                return this._literalString(v);
      103. 
-
    103. 38434            } else if (isNumber(v)) {
      104. 
+
    104. 38108            } else if (isNumber(v)) {
      105. 
 
    105. 6997                return this._literalNumber(v);
      106. 
 
    106.              }
      107. 
-
    107. 31437            else if (isInstanceOf(v, Expression)) {
      108. 
-
    108. 28903                return this._literalExpression(v);
      109. 
+
    109. 31111            else if (isInstanceOf(v, Expression)) {
      110. 
+
    110. 28577                return this._literalExpression(v);
      111. 
 
    111.              }
      112. 
 
    112. 2534            else if (isInstanceOf(v, Dataset)) {
      113. 
 
    113. 104                return this._literalDataset(v);
      114. 
@@ -14332,7 +14349,7 @@
 
    114. 59                return new QualifiedIdentifier(table, e);
      115. 
 
    115. 217            } else if (isInstanceOf(e, OrderedExpression)) {
      116. 
 
    116. 2                return new OrderedExpression(this._qualifiedExpression(e.expression, table), e.descending,
      117. 
-
    117.                      {nulls:e.nulls});
      118. 
+
    118.                          {nulls:e.nulls});
      119. 
 
    119. 215            } else if (isInstanceOf(e, AliasedExpression)) {
      120. 
 
    120. 72                return new AliasedExpression(this._qualifiedExpression(e.expression, table), e.alias);
      121. 
 
    121. 143            } else if (isInstanceOf(e, CaseExpression)) {
      122. 
@@ -14500,9 +14517,9 @@
 
    122. 1440            var columns = this.__opts.columns, ret = "";
      123. 
 
    123. 1440            if (columns && columns.length) {
      124. 
 
    124. 1387                ret = " (" + columns.map(
      125. 
-
    125.                      function (c) {
      126. 
-
    126. 6691                        return c.toString(this);
      127. 
-
    127.                      }, this).join(this._static.COMMA_SEPARATOR) + ")";
      128. 
+
    128.                          function (c) {
      129. 
+
    129. 6691                            return c.toString(this);
      130. 
+
    130.                          }, this).join(this._static.COMMA_SEPARATOR) + ")";
      131. 
 
    131.              }
      132. 
 
    132. 1440            return ret;
      133. 
 
    133.          },
      134. 
@@ -14592,7 +14609,7 @@
 
    134.           * SQL fragment for specifying all columns in a given table
      135. 
 
    135.           **/
      136. 
 
    136.          columnAllSql:function (ca) {
      137. 
-
    137. 345            return  string.format("%s.*", this.quoteSchemaTable(ca.table));
      138. 
+
    138. 19            return  string.format("%s.*", this.quoteSchemaTable(ca.table));
      139. 
 
    139.          },
      140. 
 
    140.  
      141. 
 
    141.          /**
      142. 
@@ -14614,8 +14631,8 @@
 
    142. 0                    return this.complexExpressionSql("EQ", args);
      143. 
 
    143.                  } else {
      144. 
 
    144. 0                    return this.complexExpressionSql("OR",
      145. 
-
    145.                          [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0],
      146. 
-
    146.                              null)]);
      147. 
+
    147.                              [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0],
      148. 
+
    148.                                      null)]);
      149. 
 
    149.                  }
      150. 
 
    150.  
      151. 
 
    151. 6454            } else if (["IN", "NOTIN"].indexOf(op) != -1) {
      152. 
@@ -14646,8 +14663,8 @@
 
    152.                          //literal so that if values is an array of two element arrays, it
      153. 
 
    153.                          //will be treated as a value list instead of a condition specifier.
      154. 
 
    154. 4                        return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols),
      155. 
-
    155.                              ComplexExpression.IN_OPERATORS[op],
      156. 
-
    156.                              valArray ? this._arraySql(vals) : this.literal(vals));
      157. 
+
    157.                                  ComplexExpression.IN_OPERATORS[op],
      158. 
+
    158.                                  valArray ? this._arraySql(vals) : this.literal(vals));
      159. 
 
    159.                      }
      160. 
 
    160.                  }
      161. 
 
    161.                  else {
      162. 
@@ -14661,13 +14678,13 @@
 
    162.                          }
      163. 
 
    163.                      } else {
      164. 
 
    164. 10                        return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols),
      165. 
-
    165.                              ComplexExpression.IN_OPERATORS[op], this.literal(vals));
      166. 
+
    166.                                  ComplexExpression.IN_OPERATORS[op], this.literal(vals));
      167. 
 
    167.                      }
      168. 
 
    168.                  }
      169. 
 
    169. 6437            } else if ((newOp = this._static.TWO_ARITY_OPERATORS[op]) != null) {
      170. 
 
    170. 5427                var l = args[0];
      171. 
 
    171. 5427                return format("(%s %s %s)", isString(l) ? l : this.literal(l), newOp,
      172. 
-
    172.                      this.literal(args[1]));
      173. 
+
    173.                          this.literal(args[1]));
      174. 
 
    174. 1010            } else if ((newOp = this._static.N_ARITY_OPERATORS[op]) != null) {
      175. 
 
    175. 976                return string.format("(%s)", args.map(this.literal, this).join(" " + newOp + " "));
      176. 
 
    176. 34            } else if (op == "NOT") {
      177. 
@@ -14710,7 +14727,7 @@
 
    177.              }
      178. 
 
    178. 925            var tref = this.__tableRef(table);
      179. 
 
    179. 925            return string.format(" %s %s", this._joinTypeSql(jc.joinType),
      180. 
-
    180.                  tableAlias ? this.__asSql(tref, tableAlias) : tref);
      181. 
+
    181.                      tableAlias ? this.__asSql(tref, tableAlias) : tref);
      182. 
 
    182.          },
      183. 
 
    183.  
      184. 
 
    184.          /**
      185. 
@@ -14783,11 +14800,11 @@
 
    185.           */
      186. 
 
    186.          qualifiedIdentifierSql:function (qcr) {
      187. 
 
    187. 4532            return [qcr.table, qcr.column].map(
      188. 
-
    188.                  function (x) {
      189. 
-
    189. 9064                    return [QualifiedIdentifier, Identifier, String].some(function (c) {
      190. 
-
    190. 25671                        return x instanceof c
      191. 
-
    191.                      }) ? this.literal(x) : this.quoteIdentifier(x)
      192. 
-
    192.                  }, this).join('.');
      193. 
+
    193.                      function (x) {
      194. 
+
    194. 9064                        return [QualifiedIdentifier, Identifier, String].some(function (c) {
      195. 
+
    195. 25671                            return x instanceof c
      196. 
+
    196.                          }) ? this.literal(x) : this.quoteIdentifier(x)
      197. 
+
    197.                      }, this).join('.');
      198. 
 
    198.          },
      199. 
 
    199.  
      200. 
 
    200.          /**
      201. 
@@ -14798,18 +14815,18 @@
 
    201.           * quote the name with {@link patio.dataset._Sql#_quotedIdentifier}.
      202. 
 
    202.           */
      203. 
 
    203.          quoteIdentifier:function (name) {
      204. 
-
    204. 34093            if (isInstanceOf(name, LiteralString)) {
      205. 
+
    205. 33767            if (isInstanceOf(name, LiteralString)) {
      206. 
 
    206. 260                return name;
      207. 
 
    207.              } else {
      208. 
-
    208. 33833                if (isInstanceOf(name, Identifier)) {
      209. 
+
    209. 33507                if (isInstanceOf(name, Identifier)) {
      210. 
 
    210. 22237                    name = name.value;
      211. 
 
    211.                  }
      212. 
-
    212. 33833                name = this.inputIdentifier(name);
      213. 
-
    213. 33833                if (this.quoteIdentifiers) {
      214. 
-
    214. 26623                    name = this._quotedIdentifier(name)
      215. 
+
    215. 33507                name = this.inputIdentifier(name);
      216. 
+
    216. 33507                if (this.quoteIdentifiers) {
      217. 
+
    217. 26311                    name = this._quotedIdentifier(name)
      218. 
 
    218.                  }
      219. 
 
    219.              }
      220. 
-
    220. 33833            return name;
      221. 
+
    221. 33507            return name;
      222. 
 
    222.          },
      223. 
 
    223.  
      224. 
 
    224.          /**
      225. 
@@ -14819,15 +14836,15 @@
 
    225.           * identifierOutputMethod.
      226. 
 
    226.           */
      227. 
 
    227.          inputIdentifier:function (v) {
      228. 
-
    228. 34019            var i = this.__identifierInputMethod;
      229. 
-
    229. 34019            v = v.toString(this);
      230. 
-
    230. 34019            return !isUndefinedOrNull(i) ?
      231. 
-
    231.                  isFunction(v[i]) ?
      232. 
-
    232.                      v[i]() :
      233. 
-
    233.                      isFunction(comb[i]) ?
      234. 
-
    234.                          comb[i](v)
      235. 
-
    235.                          : v
      236. 
-
    236.                  : v;
      237. 
+
    237. 33693            var i = this.__identifierInputMethod;
      238. 
+
    238. 33693            v = v.toString(this);
      239. 
+
    239. 33693            return !isUndefinedOrNull(i) ?
      240. 
+
    240.                      isFunction(v[i]) ?
      241. 
+
    241.                              v[i]() :
      242. 
+
    242.                              isFunction(comb[i]) ?
      243. 
+
    243.                                      comb[i](v)
      244. 
+
    244.                                      : v
      245. 
+
    245.                      : v;
      246. 
 
    246.          },
      247. 
 
    247.  
      248. 
 
    248.          /**
      249. 
@@ -14837,15 +14854,15 @@
 
    249.           * identifierOutputMethod.
      250. 
 
    250.           */
      251. 
 
    251.          outputIdentifier:function (v) {
      252. 
-
    252. 19523            (v == '' && (v = 'untitled'));
      253. 
-
    253. 19523            var i = this.__identifierOutputMethod;
      254. 
-
    254. 19523            return !isUndefinedOrNull(i) ?
      255. 
-
    255.                  isFunction(v[i]) ?
      256. 
-
    256.                      v[i]() :
      257. 
-
    257.                      isFunction(comb[i]) ?
      258. 
-
    258.                          comb[i](v)
      259. 
-
    259.                          : v
      260. 
-
    260.                  : v;
      261. 
+
    261. 19885            (v == '' && (v = 'untitled'));
      262. 
+
    262. 19885            var i = this.__identifierOutputMethod;
      263. 
+
    263. 19885            return !isUndefinedOrNull(i) ?
      264. 
+
    264.                      isFunction(v[i]) ?
      265. 
+
    265.                              v[i]() :
      266. 
+
    266.                              isFunction(comb[i]) ?
      267. 
+
    267.                                      comb[i](v)
      268. 
+
    268.                                      : v
      269. 
+
    269.                      : v;
      270. 
 
    270.          },
      271. 
 
    271.  
      272. 
 
    272.          /**
      273. 
@@ -14855,10 +14872,10 @@
 
    273.           * quoted (if quoting identifiers)
      274. 
 
    274.           */
      275. 
 
    275.          quoteSchemaTable:function (table) {
      276. 
-
    276. 2557            var parts = this.schemaAndTable(table);
      277. 
-
    277. 2557            var schema = parts[0];
      278. 
-
    278. 2557            table = parts[1];
      279. 
-
    279. 2557            return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
      280. 
+
    280. 2231            var parts = this.schemaAndTable(table);
      281. 
+
    281. 2231            var schema = parts[0];
      282. 
+
    282. 2231            table = parts[1];
      283. 
+
    283. 2231            return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
      284. 
 
    284.          },
      285. 
 
    285.  
      286. 
 
    286.  
      287. 
@@ -14867,15 +14884,15 @@
 
    287.           * Split the schema information from the table
      288. 
 
    288.           */
      289. 
 
    289.          schemaAndTable:function (tableName) {
      290. 
-
    290. 2801            var sch = this.db ? this.db.defaultSchema || null : null;
      291. 
-
    291. 2801            if (isString(tableName)) {
      292. 
+
    292. 2475            var sch = this.db ? this.db.defaultSchema || null : null;
      293. 
+
    293. 2475            if (isString(tableName)) {
      294. 
 
    294. 1008                var parts = this._splitString(tableName);
      295. 
 
    295. 1008                var s = parts[0], table = parts[1];
      296. 
 
    296. 1008                return [s || sch, table];
      297. 
-
    297. 1793            } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
      298. 
+
    298. 1467            } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
      299. 
 
    299. 3                return [tableName.table, tableName.column]
      300. 
-
    300. 1790            } else if (isInstanceOf(tableName, Identifier)) {
      301. 
-
    301. 1790                return [null, tableName.value];
      302. 
+
    302. 1464            } else if (isInstanceOf(tableName, Identifier)) {
      303. 
+
    303. 1464                return [null, tableName.value];
      304. 
 
    304.              } else {
      305. 
 
    305. 0                throw new QueryError("table should be a QualifiedIdentifier, Identifier, or String");
      306. 
 
    306.              }
      307. 
@@ -14924,7 +14941,7 @@
 
    307.           * expressions.
      308. 
 
    308.           */
      309. 
 
    309.          __expressionList:function (columns) {
      310. 
-
    310. 4610            return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
      311. 
+
    311. 4284            return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
      312. 
 
    312.          },
      313. 
 
    313.  
      314. 
 
    314.          //Format the timestamp based on the default_timestamp_format, with a couple
      315. 
@@ -14941,9 +14958,9 @@
 
    315.           */
      316. 
 
    316.          _joinTypeSql:function (joinType) {
      317. 
 
    317. 922            return (joinType || "").replace(/([a-z]+)|([A-Z][a-z]+)/g,
      318. 
-
    318.                  function (m) {
      319. 
-
    319. 1127                    return m.toUpperCase() + " ";
      320. 
-
    320.                  }
      321. 
+
    321.                      function (m) {
      322. 
+
    322. 1127                        return m.toUpperCase() + " ";
      323. 
+
    323.                      }
      324. 
 
    324.              ).trimRight() + " JOIN";
      325. 
 
    325.          },
      326. 
 
    326.  
      327. 
@@ -15046,7 +15063,7 @@
 
    327.           * @return SQL fragment for SQL::Expression, result depends on the specific type of expression.
      328. 
 
    328.           * */
      329. 
 
    329.          _literalExpression:function (v) {
      330. 
-
    330. 28913            return v.toString(this);
      331. 
+
    331. 28587            return v.toString(this);
      332. 
 
    332.          },
      333. 
 
    333.  
      334. 
 
    334.          /**
      335. 
@@ -15069,10 +15086,10 @@
 
    335. 6059            var table = parts[0], column = parts[1], alias = parts[2];
      336. 
 
    336. 6059            if (!alias) {
      337. 
 
    337. 6059                return column && table ? this._literalExpression(QualifiedIdentifier.fromArgs([table, column])) : "'"
      338. 
-
    338.                      + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'"
      339. 
+
    339.                          + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'"
      340. 
 
    340.              } else {
      341. 
 
    341. 0                return this.literal(new AliasedExpression(column
      342. 
-
    342.                      && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias));
      343. 
+
    343.                          && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias));
      344. 
 
    344.              }
      345. 
 
    345.          },
      346. 
 
    346.  
      347. 
@@ -15365,9 +15382,9 @@
 
    347. 0                throw new QueryError("No source specified for the query");
      348. 
 
    348.              }
      349. 
 
    349. 6657            return " " + source.map(
      350. 
-
    350.                  function (s) {
      351. 
-
    351. 6971                    return this.__tableRef(s);
      352. 
-
    352.                  }, this).join(this._static.COMMA_SEPARATOR);
      353. 
+
    353.                      function (s) {
      354. 
+
    354. 6971                        return this.__tableRef(s);
      355. 
+
    355.                      }, this).join(this._static.COMMA_SEPARATOR);
      356. 
 
    356.          },
      357. 
 
    357.  
      358. 
 
    358.          /**
      359. 
@@ -15712,7 +15729,7 @@
 
    359.               * @type String
      360. 
 
    360.               */
      361. 
 
    361.              identifierInputMethod:function () {
      362. 
-
    362. 15364                return this.__identifierInputMethod;
      363. 
+
    363. 15038                return this.__identifierInputMethod;
      364. 
 
    364.              },
      365. 
 
    365.  
      366. 
 
    366.              /**
      367. 
@@ -15724,7 +15741,7 @@
 
    367.               * @type String
      368. 
 
    368.               */
      369. 
 
    369.              identifierOutputMethod:function () {
      370. 
-
    370. 15364                return this.__identifierOutputMethod;
      371. 
+
    371. 15038                return this.__identifierOutputMethod;
      372. 
 
    372.              },
      373. 
 
    373.  
      374. 
 
    374.              /**
      375. 
@@ -15737,7 +15754,7 @@
 
    375.               * @default true
      376. 
 
    376.               */
      377. 
 
    377.              quoteIdentifiers:function () {
      378. 
-
    378. 15330                return this.__quoteIdentifiers;
      379. 
+
    379. 15004                return this.__quoteIdentifiers;
      380. 
 
    380.              }
      381. 
 
    381.          },
      382. 
 
    382.  
      383. 
@@ -15880,10 +15897,10 @@
 
    383.  
      384. 
 
    384.          /**@ignore*/
      385. 
 
    385.          constructor:function () {
      386. 
-
    386. 29542            if (!Dataset) {
      387. 
+
    387. 29216            if (!Dataset) {
      388. 
 
    388. 1                Dataset = require("../index").Dataset;
      389. 
 
    389.              }
      390. 
-
    390. 29542            this._super(arguments);
      391. 
+
    391. 29216            this._super(arguments);
      392. 
 
    392.          },
      393. 
 
    393.  
      394. 
 
    394.  
      395. 
@@ -15913,7 +15930,7 @@
 
    395. 2734            var a = [];
      396. 
 
    396. 2734            var ret = new Promise().classic(cb);
      397. 
 
    397. 2734            this.forEach(hitch(this, function (r) {
      398. 
-
    398. 2934                a.push(r);
      399. 
+
    399. 2947                a.push(r);
      400. 
 
    400.              })).then(hitch(this, function () {
      401. 
 
    401. 2731                this.postLoad(a);
      402. 
 
    402. 2731                if (block) {
      403. 
@@ -17159,10 +17176,10 @@
 
    403.           *
      404. 
 
    404.           */
      405. 
 
    405.          constructor:function () {
      406. 
-
    406. 3111            if (comb.isUndefinedOrNull(this.__associations)) {
      407. 
-
    407. 3002                this.__associations = {};
      408. 
+
    408. 3107            if (comb.isUndefinedOrNull(this.__associations)) {
      409. 
+
    409. 3000                this.__associations = {};
      410. 
 
    410.              }
      411. 
-
    411. 3111            this._super(arguments);
      412. 
+
    412. 3107            this._super(arguments);
      413. 
 
    413.          },
      414. 
 
    414.  
      415. 
 
    415.          reload:function () {
      416. 
@@ -18089,240 +18106,29 @@
 
    416.           * });
      417. 
 
    417.           * }
      418. 
 
    418.           *
      419. 
-
    419.           *
      420. 
-
    420.           * @param {String|Function} name the name of the column, or a callback that accepts a function to create validators.
      421. 
-
    421.           *
      422. 
-
    422.           * @throws {patio.ModelError} if name is not a function or string.
      423. 
-
    423.           * @return {patio.Model|Validator} returns a validator if name is a string, other wise returns this for chaining.
      424. 
-
    424.           */
      425. 
-
    425.          validate:function (name) {
      426. 
-
    426. 41            this.__initValidation();
      427. 
-
    427. 41            var ret;
      428. 
-
    428. 41            if (isFunction(name)) {
      429. 
-
    429. 1                name.apply(this, [this.__getValidator.bind(this)]);
      430. 
-
    430. 1                ret = this;
      431. 
-
    431. 40            } else if (isString(name)) {
      432. 
-
    432. 40                ret = this.__getValidator(name);
      433. 
-
    433.              } else {
      434. 
-
    434. 0                throw new ModelError("name is must be a string or function when validating");
      435. 
-
    435.              }
      436. 
-
    436. 41            return ret;
      437. 
-
    437.          }
      438. 
-
    438.      }
      439. 
-
    439.  
      440. 
-
    440.  }).as(module);
      441. 
-
    441.
    -
    - -
    - - - - - -
    -
    database/logging.js
    -     		-
    - Coverage97.96 - SLOC193 - LOC49 - Missed1 -
    -
    - 
    1. 1var comb = require("comb"),
      2. 
-
    2.      define = comb.define,
      3. 
-
    3.      Promise = comb.Promise,
      4. 
-
    4.      isFunction = comb.isFunction,
      5. 
-
    5.      logging = comb.logging,
      6. 
-
    6.      Logger = logging.Logger,
      7. 
-
    7.      hitch = comb.hitch,
      8. 
-
    8.      format = comb.string.format,
      9. 
-
    9.      QueryError = require("../errors").QueryError;
      10. 
-
    10.  
      11. 
-
    11.  
      12. 
-
    12. 1var LOGGER = Logger.getLogger("patio.Database");
      13. 
-
    13.  
      14. 
-
    14. 1define(null, {
      15. 
-
    15.      instance:{
      16. 
-
    16.          /**@lends patio.Database.prototype*/
      17. 
-
    17.  
      18. 
-
    18.          /**
      19. 
-
    19.           * Logs an INFO level message to the "patio.Database" logger.
      20. 
-
    20.           */
      21. 
-
    21.          logInfo:function () {
      22. 
-
    22. 8337            if (LOGGER.isInfo) {
      23. 
-
    23. 8337                LOGGER.info.apply(LOGGER, arguments);
      24. 
-
    24.              }
      25. 
-
    25.          },
      26. 
-
    26.  
      27. 
-
    27.          /**
      28. 
-
    28.           * Logs a DEBUG level message to the "patio.Database" logger.
      29. 
-
    29.           */
      30. 
-
    30.          logDebug:function () {
      31. 
-
    31. 8027            if (LOGGER.isDebug) {
      32. 
-
    32. 8027                LOGGER.debug.apply(LOGGER, arguments);
      33. 
-
    33.              }
      34. 
-
    34.          },
      35. 
-
    35.  
      36. 
-
    36.          /**
      37. 
-
    37.           * Logs an ERROR level message to the "patio.Database" logger.
      38. 
-
    38.           */
      39. 
-
    39.          logError:function (error) {
      40. 
-
    40. 75            if (LOGGER.isError) {
      41. 
-
    41. 75                LOGGER.error.apply(LOGGER, arguments);
      42. 
-
    42.              }
      43. 
-
    43.          },
      44. 
-
    44.  
      45. 
-
    45.          /**
      46. 
-
    46.           * Logs a WARN level message to the "patio.Database" logger.
      47. 
-
    47.           */
      48. 
-
    48.          logWarn:function () {
      49. 
-
    49. 1            if (LOGGER.isWarn) {
      50. 
-
    50. 1                LOGGER.warn.apply(LOGGER, arguments);
      51. 
-
    51.              }
      52. 
-
    52.          },
      53. 
-
    53.  
      54. 
-
    54.          /**
      55. 
-
    55.           * Logs a TRACE level message to the "patio.Database" logger.
      56. 
-
    56.           */
      57. 
-
    57.          logTrace:function () {
      58. 
-
    58. 1            if (LOGGER.isTrace) {
      59. 
-
    59. 1                LOGGER.trace.apply(LOGGER, arguments);
      60. 
-
    60.              }
      61. 
-
    61.          },
      62. 
-
    62.  
      63. 
-
    63.          /**
      64. 
-
    64.           * Logs a FATAL level message to the "patio.Database" logger.
      65. 
-
    65.           */
      66. 
-
    66.          logFatal:function () {
      67. 
-
    67. 1            if (LOGGER.isFatal) {
      68. 
-
    68. 1                LOGGER.fatal.apply(LOGGER, arguments);
      69. 
-
    69.              }
      70. 
-
    70.          },
      71. 
-
    71.  
      72. 
-
    72.          /* Yield to the block, logging any errors at error level to all loggers,
      73. 
-
    73.           * and all other queries with the duration at warn or info level.
      74. 
-
    74.           * */
      75. 
-
    75.          __logAndExecute:function (sql, args, cb) {
      76. 
-
    76. 8101            if (isFunction(args)) {
      77. 
-
    77. 8100                cb = args;
      78. 
-
    78. 8100                args = null;
      79. 
-
    79.              }
      80. 
-
    80.  
      81. 
-
    81. 8101            if (args) {
      82. 
-
    82. 0                sql = format("%s; %j", sql, args);
      83. 
-
    83.              }
      84. 
-
    84. 8101            sql = sql.trim();
      85. 
-
    85. 8101            var start = new Date();
      86. 
-
    86. 8101            var ret = new Promise();
      87. 
-
    87. 8101            if (isFunction(cb)) {
      88. 
-
    88. 8100                this.logInfo("Executing; %s", sql);
      89. 
-
    89. 8100                cb().then(hitch(this, function () {
      90. 
-
    90. 8026                    this.logDebug("Duration: % 6dms; %s", new Date() - start, sql);
      91. 
-
    91. 8026                    ret.callback.apply(ret, arguments);
      92. 
-
    92.                  }), hitch(this, function (err) {
      93. 
-
    93. 74                    err = new QueryError(format("%s: %s", err.message, sql));
      94. 
-
    94. 74                    this.logError(err);
      95. 
-
    95. 74                    ret.errback.apply(ret, [err]);
      96. 
-
    96.                  }));
      97. 
-
    97.              } else {
      98. 
-
    98. 1                throw new QueryError("CB is required");
      99. 
-
    99.              }
      100. 
-
    100. 8100            return ret.promise();
      101. 
-
    101.          },
      102. 
-
    102.  
      103. 
-
    103.          /*Log the given SQL and then execute it on the connection, used by
      104. 
-
    104.           *the transaction code.
      105. 
-
    105.           * */
      106. 
-
    106.          __logConnectionExecute:function (conn, sql) {
      107. 
-
    107. 2079            return this.__logAndExecute(sql, hitch(this, function () {
      108. 
-
    108. 2079                return conn[this.connectionExecuteMethod](sql);
      109. 
-
    109.              }));
      110. 
-
    110.          },
      111. 
-
    111.  
      112. 
-
    112.  
      113. 
-
    113.          getters:{
      114. 
-
    114.              /**@lends patio.Database.prototype*/
      115. 
-
    115.              /**
      116. 
-
    116.               * The "patio.Database" logger.
      117. 
-
    117.               * @field
      118. 
-
    118.               */
      119. 
-
    119.              logger:function () {
      120. 
-
    120. 2                return LOGGER;
      121. 
-
    121.              }
      122. 
-
    122.          }
      123. 
-
    123.      },
      124. 
-
    124.  
      125. 
-
    125.      "static":{
      126. 
-
    126.          /**@lends patio.Database*/
      127. 
-
    127.          /**
      128. 
-
    128.           * Logs an INFO level message to the "patio.Database" logger.
      129. 
-
    129.           */
      130. 
-
    130.          logInfo:function () {
      131. 
-
    131. 1            if (LOGGER.isInfo) {
      132. 
-
    132. 1                LOGGER.info.apply(LOGGER, arguments);
      133. 
-
    133.              }
      134. 
-
    134.          },
      135. 
-
    135.  
      136. 
-
    136.          /**
      137. 
-
    137.           * Logs a DEBUG level message to the "patio.Database" logger.
      138. 
-
    138.           */
      139. 
-
    139.          logDebug:function () {
      140. 
-
    140. 1            if (LOGGER.isDebug) {
      141. 
-
    141. 1                LOGGER.debug.apply(LOGGER, arguments);
      142. 
-
    142.              }
      143. 
-
    143.          },
      144. 
-
    144.  
      145. 
-
    145.          /**
      146. 
-
    146.           * Logs a ERROR level message to the "patio.Database" logger.
      147. 
-
    147.           */
      148. 
-
    148.          logError:function () {
      149. 
-
    149. 1            if (LOGGER.isError) {
      150. 
-
    150. 1                LOGGER.error.apply(LOGGER, arguments);
      151. 
-
    151.              }
      152. 
-
    152.          },
      153. 
-
    153.  
      154. 
-
    154.          /**
      155. 
-
    155.           * Logs a WARN level message to the "patio.Database" logger.
      156. 
-
    156.           */
      157. 
-
    157.          logWarn:function () {
      158. 
-
    158. 1            if (LOGGER.isWarn) {
      159. 
-
    159. 1                LOGGER.warn.apply(LOGGER, arguments);
      160. 
-
    160.              }
      161. 
-
    161.          },
      162. 
-
    162.  
      163. 
-
    163.          /**
      164. 
-
    164.           * Logs a TRACE level message to the "patio.Database" logger.
      165. 
-
    165.           */
      166. 
-
    166.          logTrace:function () {
      167. 
-
    167. 1            if (LOGGER.isTrace) {
      168. 
-
    168. 1                LOGGER.trace.apply(LOGGER, arguments);
      169. 
-
    169.              }
      170. 
-
    170.          },
      171. 
-
    171.  
      172. 
-
    172.          /**
      173. 
-
    173.           * Logs a FATAL level message to the "patio.Database" logger.
      174. 
+
    174.           *
      175. 
+
    175.           * @param {String|Function} name the name of the column, or a callback that accepts a function to create validators.
      176. 
+
    176.           *
      177. 
+
    177.           * @throws {patio.ModelError} if name is not a function or string.
      178. 
+
    178.           * @return {patio.Model|Validator} returns a validator if name is a string, other wise returns this for chaining.
      179. 
 
    179.           */
      180. 
-
    180.          logFatal:function () {
      181. 
-
    181. 1            if (LOGGER.isFatal) {
      182. 
-
    182. 1                LOGGER.fatal.apply(LOGGER, arguments);
      183. 
-
    183.              }
      184. 
-
    184.          },
      185. 
-
    185.  
      186. 
-
    186.          getters:{
      187. 
-
    187.              /**@lends patio.Database*/
      188. 
-
    188.              /**
      189. 
-
    189.               * The "patio.Database" logger.
      190. 
-
    190.               * @field
      191. 
-
    191.               */
      192. 
-
    192.              logger:function () {
      193. 
-
    193. 1                return LOGGER;
      194. 
+
    194.          validate:function (name) {
      195. 
+
    195. 41            this.__initValidation();
      196. 
+
    196. 41            var ret;
      197. 
+
    197. 41            if (isFunction(name)) {
      198. 
+
    198. 1                name.apply(this, [this.__getValidator.bind(this)]);
      199. 
+
    199. 1                ret = this;
      200. 
+
    200. 40            } else if (isString(name)) {
      201. 
+
    201. 40                ret = this.__getValidator(name);
      202. 
+
    202.              } else {
      203. 
+
    203. 0                throw new ModelError("name is must be a string or function when validating");
      204. 
 
    204.              }
      205. 
+
    205. 41            return ret;
      206. 
 
    206.          }
      207. 
 
    207.      }
      208. 
 
    208.  
      209. 
-
    209.  }).as(module);
    +
  • }).as(module);
    • +
    • @@ -18333,10 +18139,10 @@
    - Coverage98.84 - SLOC2136 - LOC431 - Missed5 + Coverage97.71 + SLOC2160 + LOC436 + Missed10
    @@ -18401,17 +18207,17 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29542 this._super(arguments);
    • -
  • 29542 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 206794 if (!this[type + "Join"]) {
    • -
  • 206794 this[type + "Join"] = conditionedJoin.bind(this, type);
    • +
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29216 this._super(arguments);
    • +
  • 29216 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 204512 if (!this[type + "Join"]) {
    • +
  • 204512 this[type + "Join"] = conditionedJoin.bind(this, type);
  • }
  • }, this);
    • -
  • 29542 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 147710 if (!this[type + "Join"]) {
    • -
  • 147710 this[type + "Join"] = unConditionJoin.bind(this, type);
    • +
  • 29216 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 146080 if (!this[type + "Join"]) {
    • +
  • 146080 this[type + "Join"] = unConditionJoin.bind(this, type);
  • }
  • }, this);
    • @@ -19823,29 +19629,29 @@
  • * @return {patio.Dataset} a cloned dataset with the columns selected changed.
  • */
  • select:function (args) {
    • -
  • 861 args = flatten(argsToArray(arguments));
    • -
  • 861 var columns = [];
    • -
  • 861 args.forEach(function (c) {
    • -
  • 1281 if (isFunction(c)) {
    • +
  • 535 args = flatten(argsToArray(arguments));
    • +
  • 535 var columns = [];
    • +
  • 535 args.forEach(function (c) {
    • +
  • 955 if (isFunction(c)) {
  • 23 var res = c.apply(sql, [sql]);
  • 23 columns = columns.concat(isArray(res) ? res : [res]);
  • } else {
    • -
  • 1258 columns.push(c);
    • +
  • 932 columns.push(c);
  • }
  • });
    • -
  • 861 var select = [];
    • -
  • 861 columns.forEach(function (c) {
    • -
  • 1284 if (isHash(c)) {
    • +
  • 535 var select = [];
    • +
  • 535 columns.forEach(function (c) {
    • +
  • 958 if (isHash(c)) {
  • 3 for (var i in c) {
  • 4 select.push(new AliasedExpression(new Identifier(i), c[i]));
  • }
    • -
  • 1281 } else if (isString(c)) {
    • +
  • 955 } else if (isString(c)) {
  • 406 select.push(this.stringToIdentifier(c));
  • } else {
    • -
  • 875 select.push(c);
    • +
  • 549 select.push(c);
  • }
  • }, this);
    • -
  • 861 return this.mergeOptions({select:select});
    • +
  • 535 return this.mergeOptions({select:select});
  • },
    • @@ -19859,6 +19665,30 @@
  • },
  • /**
    • +
  • * Selects the columns if only if there is not already select sources.
    • +
  • *
    • +
  • * @example
    • +
  • *
    • +
  • * var ds = DB.from("items"); //SELECT * FROM items
    • +
  • *
    • +
  • * ds.select("a"); //SELECT a FROM items;
    • +
  • * ds.select("a").selectIfNoSource("a", "b"). //SELECT a FROM items;
    • +
  • * ds.selectIfNoSource("a", "b"). //SELECT a, b FROM items;
    • +
  • *
    • +
  • * @param cols columns to select if there is not already select sources.
    • +
  • * @return {patio.Dataset} a cloned dataset with the appropriate select sources.
    • +
  • */
    • +
  • selectIfNoSource:function (cols) {
    • +
  • 0 var ret;
    • +
  • 0 if (!this.hasSelectSource) {
    • +
  • 0 ret = this.select.apply(this, arguments);
    • +
  • } else {
    • +
  • 0 ret = this.mergeOptions();
    • +
  • }
    • +
  • 0 return ret;
    • +
  • },
    • +
    • +
  • /**
  • * Returns a copy of the dataset with the given columns added
  • * to the existing selected columns. If no columns are currently selected,
  • * it will select the columns given in addition to *.
    • @@ -20479,6 +20309,217 @@
  • as(module);
    • +
    + + + + + +
    +
    database/logging.js
    +     		+
    + Coverage97.96 + SLOC193 + LOC49 + Missed1 +
    +
    + 
    1. 1var comb = require("comb"),
      2. 
+
    2.      define = comb.define,
      3. 
+
    3.      Promise = comb.Promise,
      4. 
+
    4.      isFunction = comb.isFunction,
      5. 
+
    5.      logging = comb.logging,
      6. 
+
    6.      Logger = logging.Logger,
      7. 
+
    7.      hitch = comb.hitch,
      8. 
+
    8.      format = comb.string.format,
      9. 
+
    9.      QueryError = require("../errors").QueryError;
      10. 
+
    10.  
      11. 
+
    11.  
      12. 
+
    12. 1var LOGGER = Logger.getLogger("patio.Database");
      13. 
+
    13.  
      14. 
+
    14. 1define(null, {
      15. 
+
    15.      instance:{
      16. 
+
    16.          /**@lends patio.Database.prototype*/
      17. 
+
    17.  
      18. 
+
    18.          /**
      19. 
+
    19.           * Logs an INFO level message to the "patio.Database" logger.
      20. 
+
    20.           */
      21. 
+
    21.          logInfo:function () {
      22. 
+
    22. 8337            if (LOGGER.isInfo) {
      23. 
+
    23. 8337                LOGGER.info.apply(LOGGER, arguments);
      24. 
+
    24.              }
      25. 
+
    25.          },
      26. 
+
    26.  
      27. 
+
    27.          /**
      28. 
+
    28.           * Logs a DEBUG level message to the "patio.Database" logger.
      29. 
+
    29.           */
      30. 
+
    30.          logDebug:function () {
      31. 
+
    31. 8027            if (LOGGER.isDebug) {
      32. 
+
    32. 8027                LOGGER.debug.apply(LOGGER, arguments);
      33. 
+
    33.              }
      34. 
+
    34.          },
      35. 
+
    35.  
      36. 
+
    36.          /**
      37. 
+
    37.           * Logs an ERROR level message to the "patio.Database" logger.
      38. 
+
    38.           */
      39. 
+
    39.          logError:function (error) {
      40. 
+
    40. 75            if (LOGGER.isError) {
      41. 
+
    41. 75                LOGGER.error.apply(LOGGER, arguments);
      42. 
+
    42.              }
      43. 
+
    43.          },
      44. 
+
    44.  
      45. 
+
    45.          /**
      46. 
+
    46.           * Logs a WARN level message to the "patio.Database" logger.
      47. 
+
    47.           */
      48. 
+
    48.          logWarn:function () {
      49. 
+
    49. 1            if (LOGGER.isWarn) {
      50. 
+
    50. 1                LOGGER.warn.apply(LOGGER, arguments);
      51. 
+
    51.              }
      52. 
+
    52.          },
      53. 
+
    53.  
      54. 
+
    54.          /**
      55. 
+
    55.           * Logs a TRACE level message to the "patio.Database" logger.
      56. 
+
    56.           */
      57. 
+
    57.          logTrace:function () {
      58. 
+
    58. 1            if (LOGGER.isTrace) {
      59. 
+
    59. 1                LOGGER.trace.apply(LOGGER, arguments);
      60. 
+
    60.              }
      61. 
+
    61.          },
      62. 
+
    62.  
      63. 
+
    63.          /**
      64. 
+
    64.           * Logs a FATAL level message to the "patio.Database" logger.
      65. 
+
    65.           */
      66. 
+
    66.          logFatal:function () {
      67. 
+
    67. 1            if (LOGGER.isFatal) {
      68. 
+
    68. 1                LOGGER.fatal.apply(LOGGER, arguments);
      69. 
+
    69.              }
      70. 
+
    70.          },
      71. 
+
    71.  
      72. 
+
    72.          /* Yield to the block, logging any errors at error level to all loggers,
      73. 
+
    73.           * and all other queries with the duration at warn or info level.
      74. 
+
    74.           * */
      75. 
+
    75.          __logAndExecute:function (sql, args, cb) {
      76. 
+
    76. 8101            if (isFunction(args)) {
      77. 
+
    77. 8100                cb = args;
      78. 
+
    78. 8100                args = null;
      79. 
+
    79.              }
      80. 
+
    80.  
      81. 
+
    81. 8101            if (args) {
      82. 
+
    82. 0                sql = format("%s; %j", sql, args);
      83. 
+
    83.              }
      84. 
+
    84. 8101            sql = sql.trim();
      85. 
+
    85. 8101            var start = new Date();
      86. 
+
    86. 8101            var ret = new Promise();
      87. 
+
    87. 8101            if (isFunction(cb)) {
      88. 
+
    88. 8100                this.logInfo("Executing; %s", sql);
      89. 
+
    89. 8100                cb().then(hitch(this, function () {
      90. 
+
    90. 8026                    this.logDebug("Duration: % 6dms; %s", new Date() - start, sql);
      91. 
+
    91. 8026                    ret.callback.apply(ret, arguments);
      92. 
+
    92.                  }), hitch(this, function (err) {
      93. 
+
    93. 74                    err = new QueryError(format("%s: %s", err.message, sql));
      94. 
+
    94. 74                    this.logError(err);
      95. 
+
    95. 74                    ret.errback.apply(ret, [err]);
      96. 
+
    96.                  }));
      97. 
+
    97.              } else {
      98. 
+
    98. 1                throw new QueryError("CB is required");
      99. 
+
    99.              }
      100. 
+
    100. 8100            return ret.promise();
      101. 
+
    101.          },
      102. 
+
    102.  
      103. 
+
    103.          /*Log the given SQL and then execute it on the connection, used by
      104. 
+
    104.           *the transaction code.
      105. 
+
    105.           * */
      106. 
+
    106.          __logConnectionExecute:function (conn, sql) {
      107. 
+
    107. 2079            return this.__logAndExecute(sql, hitch(this, function () {
      108. 
+
    108. 2079                return conn[this.connectionExecuteMethod](sql);
      109. 
+
    109.              }));
      110. 
+
    110.          },
      111. 
+
    111.  
      112. 
+
    112.  
      113. 
+
    113.          getters:{
      114. 
+
    114.              /**@lends patio.Database.prototype*/
      115. 
+
    115.              /**
      116. 
+
    116.               * The "patio.Database" logger.
      117. 
+
    117.               * @field
      118. 
+
    118.               */
      119. 
+
    119.              logger:function () {
      120. 
+
    120. 2                return LOGGER;
      121. 
+
    121.              }
      122. 
+
    122.          }
      123. 
+
    123.      },
      124. 
+
    124.  
      125. 
+
    125.      "static":{
      126. 
+
    126.          /**@lends patio.Database*/
      127. 
+
    127.          /**
      128. 
+
    128.           * Logs an INFO level message to the "patio.Database" logger.
      129. 
+
    129.           */
      130. 
+
    130.          logInfo:function () {
      131. 
+
    131. 1            if (LOGGER.isInfo) {
      132. 
+
    132. 1                LOGGER.info.apply(LOGGER, arguments);
      133. 
+
    133.              }
      134. 
+
    134.          },
      135. 
+
    135.  
      136. 
+
    136.          /**
      137. 
+
    137.           * Logs a DEBUG level message to the "patio.Database" logger.
      138. 
+
    138.           */
      139. 
+
    139.          logDebug:function () {
      140. 
+
    140. 1            if (LOGGER.isDebug) {
      141. 
+
    141. 1                LOGGER.debug.apply(LOGGER, arguments);
      142. 
+
    142.              }
      143. 
+
    143.          },
      144. 
+
    144.  
      145. 
+
    145.          /**
      146. 
+
    146.           * Logs a ERROR level message to the "patio.Database" logger.
      147. 
+
    147.           */
      148. 
+
    148.          logError:function () {
      149. 
+
    149. 1            if (LOGGER.isError) {
      150. 
+
    150. 1                LOGGER.error.apply(LOGGER, arguments);
      151. 
+
    151.              }
      152. 
+
    152.          },
      153. 
+
    153.  
      154. 
+
    154.          /**
      155. 
+
    155.           * Logs a WARN level message to the "patio.Database" logger.
      156. 
+
    156.           */
      157. 
+
    157.          logWarn:function () {
      158. 
+
    158. 1            if (LOGGER.isWarn) {
      159. 
+
    159. 1                LOGGER.warn.apply(LOGGER, arguments);
      160. 
+
    160.              }
      161. 
+
    161.          },
      162. 
+
    162.  
      163. 
+
    163.          /**
      164. 
+
    164.           * Logs a TRACE level message to the "patio.Database" logger.
      165. 
+
    165.           */
      166. 
+
    166.          logTrace:function () {
      167. 
+
    167. 1            if (LOGGER.isTrace) {
      168. 
+
    168. 1                LOGGER.trace.apply(LOGGER, arguments);
      169. 
+
    169.              }
      170. 
+
    170.          },
      171. 
+
    171.  
      172. 
+
    172.          /**
      173. 
+
    173.           * Logs a FATAL level message to the "patio.Database" logger.
      174. 
+
    174.           */
      175. 
+
    175.          logFatal:function () {
      176. 
+
    176. 1            if (LOGGER.isFatal) {
      177. 
+
    177. 1                LOGGER.fatal.apply(LOGGER, arguments);
      178. 
+
    178.              }
      179. 
+
    179.          },
      180. 
+
    180.  
      181. 
+
    181.          getters:{
      182. 
+
    182.              /**@lends patio.Database*/
      183. 
+
    183.              /**
      184. 
+
    184.               * The "patio.Database" logger.
      185. 
+
    185.               * @field
      186. 
+
    186.               */
      187. 
+
    187.              logger:function () {
      188. 
+
    188. 1                return LOGGER;
      189. 
+
    189.              }
      190. 
+
    190.          }
      191. 
+
    191.      }
      192. 
+
    192.  
      193. 
+
    193.  }).as(module);
    +
    +
    @@ -21126,7 +21167,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(){
    • -
  • 49107 return this.__quoteIdentifiers;
    • +
  • 48455 return this.__quoteIdentifiers;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21134,20 +21175,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(){
    • -
  • 15274 return this.__providesAccurateRowsMatched;
    • +
  • 14948 return this.__providesAccurateRowsMatched;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(){
    • -
  • 15281 return this.__requiresSqlStandardDateTimes;
    • +
  • 14955 return this.__requiresSqlStandardDateTimes;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(){
    • -
  • 15287 return this.__supportsCte;
    • +
  • 14961 return this.__supportsCte;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21159,25 +21200,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(){
    • -
  • 15310 return this.__supportsIntersectExcept;
    • +
  • 14984 return this.__supportsIntersectExcept;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(){
    • -
  • 15286 return this.__supportsIntersectExceptAll;
    • +
  • 14960 return this.__supportsIntersectExceptAll;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(){
    • -
  • 15543 return this.__supportsIsTrue;
    • +
  • 15217 return this.__supportsIsTrue;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(){
    • -
  • 15285 return this.__supportsJoinUsing;
    • +
  • 14959 return this.__supportsJoinUsing;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21189,7 +21230,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(){
    • -
  • 15278 return this.__supportsMultipleColumnIn;
    • +
  • 14952 return this.__supportsMultipleColumnIn;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21201,13 +21242,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(){
    • -
  • 15274 return this.__supportsTimestampUsecs;
    • +
  • 14948 return this.__supportsTimestampUsecs;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(){
    • -
  • 15274 return this.__supportsWindowFunctions;
    • +
  • 14948 return this.__supportsWindowFunctions;
  • }
  • },
    • @@ -21218,7 +21259,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(val){
    • -
  • 15286 this.__quoteIdentifiers = val;
    • +
  • 14960 this.__quoteIdentifiers = val;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21226,20 +21267,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(val){
    • -
  • 15274 this.__providesAccurateRowsMatched = val;
    • +
  • 14948 this.__providesAccurateRowsMatched = val;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(val){
    • -
  • 15274 this.__requiresSqlStandardDateTimes = val;
    • +
  • 14948 this.__requiresSqlStandardDateTimes = val;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(val){
    • -
  • 15275 this.__supportsCte = val;
    • +
  • 14949 this.__supportsCte = val;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21251,25 +21292,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(val){
    • -
  • 15276 this.__supportsIntersectExcept = val;
    • +
  • 14950 this.__supportsIntersectExcept = val;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(val){
    • -
  • 15276 this.__supportsIntersectExceptAll = val;
    • +
  • 14950 this.__supportsIntersectExceptAll = val;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(val){
    • -
  • 15274 this.__supportsIsTrue = val;
    • +
  • 14948 this.__supportsIsTrue = val;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(val){
    • -
  • 15276 this.__supportsJoinUsing = val;
    • +
  • 14950 this.__supportsJoinUsing = val;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21281,7 +21322,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(val){
    • -
  • 15274 this.__supportsMultipleColumnIn = val;
    • +
  • 14948 this.__supportsMultipleColumnIn = val;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21293,13 +21334,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(val){
    • -
  • 15274 this.__supportsTimestampUsecs = val;
    • +
  • 14948 this.__supportsTimestampUsecs = val;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(val){
    • -
  • 15274 this.__supportsWindowFunctions = val;
    • +
  • 14948 this.__supportsWindowFunctions = val;
  • }
  • }
    • @@ -21393,8 +21434,8 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29542 this._super(arguments);
    • +
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29216 this._super(arguments);
  • },
  • /**
    • diff --git a/docs/coverage.html b/docs/coverage.html index 70d5468b..21fb1ef8 100644 --- a/docs/coverage.html +++ b/docs/coverage.html @@ -256,10 +256,10 @@ @@ -2521,7 +2521,7 @@
  • },
  • _quotedIdentifier:function (c) {
    • -
  • 26239 return format('"%s"', c);
    • +
  • 25927 return format('"%s"', c);
  • },
  • __fullTextStringJoin:function (cols) {
    • @@ -2575,12 +2575,12 @@
  • 3048 var cols = [];
  • 3048 if (rows && rows.length) {
  • 2543 cols = this.__columns = fields && fields.length ? fields.map(function (f) {
    • -
  • 18560 return f.name;
    • +
  • 18922 return f.name;
  • }) : Object.keys(rows[0]);
  • //the pg driver does auto type coercion
  • 2543 cols = cols.map(function (c) {
    • -
  • 18560 return [oi(c), function (o) {
    • -
  • 27740 return o;
    • +
  • 18922 return [oi(c), function (o) {
    • +
  • 28420 return o;
  • }, c];
  • }, this);
  • }
    • @@ -2607,7 +2607,7 @@
  • 3654 var h = {};
  • 3654 var row = rows[index];
  • 3654 cols.forEach(function (col) {
    • -
  • 27740 h[col[0]] = col[1](row[col[2]]);
    • +
  • 28420 h[col[0]] = col[1](row[col[2]]);
  • }, this);
  • 3654 when(cb(h)).then(function (val) {
    • @@ -2659,15 +2659,15 @@
  • },
  • supportsDistinctOn:function () {
    • -
  • 12996 return true;
    • +
  • 12670 return true;
  • },
  • supportsModifyingJoins:function () {
    • -
  • 15440 return true;
    • +
  • 15114 return true;
  • },
  • supportsTimestampTimezones:function () {
    • -
  • 12994 return true;
    • +
  • 12668 return true;
  • }
  • }
    • @@ -5735,3296 +5735,3769 @@
    • -
    +
    - Coverage89.21 - SLOC21921 - LOC5357 - Missed578 + Coverage89.04 + SLOC21962 + LOC5365 + Missed588
    -
    associations/_Association.js
    +
    dataset/index.js
    - Coverage87.18 - SLOC515 - LOC156 - Missed20 + Coverage86.11 + SLOC457 + LOC72 + Missed10
    - 
    1. 1var comb = require("comb-proxy"),
      2. 
-
    2.      define = comb.define,
      3. 
+    
      1. 1var comb = require("comb"),
        2. 
+
      2.      hitch = comb.hitch,
        3. 
+
      3.      logging = comb.logging,
        4. 
+
      4.      Logger = logging.Logger,
        5. 
+
      5.      errors = require("../errors"),
        6. 
+
      6.      QueryError = errors.QueryError,
        7. 
+
      7.      DatasetError = errors.DatasetError,
        8. 
+
      8.      Promise = comb.Promise,
        9. 
+
      9.      PromiseList = comb.PromiseList,
        10. 
 
      10.      isUndefined = comb.isUndefined,
        11. 
 
      11.      isUndefinedOrNull = comb.isUndefinedOrNull,
        12. 
-
      12.      isBoolean = comb.isBoolean,
        13. 
 
      13.      isString = comb.isString,
        14. 
-
      14.      isHash = comb.isHash,
        15. 
-
      15.      isFunction = comb.isFunction,
        16. 
 
      16.      isInstanceOf = comb.isInstanceOf,
        17. 
-
      17.      Promise = comb.Promise,
        18. 
-
      18.      PromiseList = comb.PromiseList,
        19. 
-
      19.      hitch = comb.hitch,
        20. 
-
      20.      array = comb.array,
        21. 
-
      21.      isArray = comb.isArray,
        22. 
-
      22.      Middleware = comb.plugins.Middleware,
        23. 
-
      23.      PatioError = require("../errors").PatioError;
        24. 
-
      24.  
        25. 
-
      25. 1var fetch = {
        26. 
-
      26.      LAZY:"lazy",
        27. 
-
      27.      EAGER:"eager"
        28. 
-
      28.  };
        29. 
+
      29.      isString = comb.isString,
        30. 
+
      30.      isFunction = comb.isFunction,
        31. 
+
      31.      isNull = comb.isNull,
        32. 
+
      32.      merge = comb.merge,
        33. 
+
      33.      define = comb.define,
        34. 
+
      34.      graph = require("./graph"),
        35. 
+
      35.      actions = require("./actions"),
        36. 
+
      36.      features = require("./features"),
        37. 
+
      37.      query = require("./query"),
        38. 
+
      38.      sql = require("./sql"),
        39. 
+
      39.      SQL = require("../sql").sql,
        40. 
+
      40.      AliasedExpression = SQL.AliasedExpression,
        41. 
+
      41.      Identifier = SQL.Identifier,
        42. 
+
      42.      QualifiedIdentifier = SQL.QualifiedIdentifier;
        43. 
 
      43.  
        44. 
 
      44.  
        45. 
-
      45.  /**
        46. 
-
      46.   * @class
        47. 
-
      47.   * Base class for all associations.
        48. 
-
      48.   *
        49. 
-
      49.   * </br>
        50. 
-
      50.   * <b>NOT to be instantiated directly</b>
        51. 
-
      51.   * Its just documented for reference.
        52. 
-
      52.   *
        53. 
-
      53.   * @constructs
        54. 
-
      54.   * @param {Object} options
        55. 
-
      55.   * @param {String} options.model a string to look up the model that we are associated with
        56. 
-
      56.   * @param {Function} options.filter  a callback to find association if a filter is defined then
        57. 
-
      57.   *                                    the association is read only
        58. 
-
      58.   * @param {Object} options.key object with left key and right key
        59. 
-
      59.   * @param {String|Object} options.orderBy<String|Object> - how to order our association @see Dataset.order
        60. 
-
      60.   * @param {fetch.EAGER|fetch.LAZY} options.fetchType the fetch type of the model if fetch.Eager is supplied then
        61. 
-
      61.   *                                    the associations are automatically filled, if fetch.Lazy is supplied
        62. 
-
      62.   *                                    then a promise is returned and is called back with the loaded models
        63. 
-
      63.   * @property {Model} model the model associatied with this association.
        64. 
-
      64.   * @name Association
        65. 
-
      65.   * @memberOf patio.associations
        66. 
-
      66.   * */
        67. 
-
      67. 1define(Middleware, {
        68. 
+
      68. 1var LOGGER = comb.logger("patio.Dataset");
        69. 
+
      69. 1define([actions, graph, features, query, sql], {
        70. 
 
      70.      instance:{
        71. 
-
      71.          /**@lends patio.associations.Association.prototype*/
        72. 
-
      72.  
        73. 
-
      73.          type:"",
        74. 
-
      74.  
        75. 
-
      75.          //Our associated model
        76. 
-
      76.          _model:null,
        77. 
-
      77.  
        78. 
-
      78.          /**
        79. 
-
      79.           * Fetch type
        80. 
-
      80.           */
        81. 
-
      81.          fetchType:fetch.LAZY,
        82. 
-
      82.  
        83. 
-
      83.          /**how to order our association*/
        84. 
-
      84.          orderBy:null,
        85. 
-
      85.  
        86. 
-
      86.          /**Our filter method*/
        87. 
-
      87.          filter:null,
        88. 
-
      88.  
        89. 
-
      89.          __hooks:null,
        90. 
-
      90.  
        91. 
-
      91.          isOwner:true,
        92. 
-
      92.  
        93. 
-
      93.          createSetter:true,
        94. 
 
      94.  
        95. 
-
      95.          isCascading:false,
        96. 
-
      96.  
        97. 
-
      97.          supportsStringKey:true,
        98. 
-
      98.  
        99. 
-
      99.          supportsHashKey:true,
        100. 
-
      100.  
        101. 
-
      101.          supportsCompositeKey:true,
        102. 
-
      102.  
        103. 
-
      103.          supportsLeftAndRightKey:true,
        104. 
+
      104.          /**@lends patio.Dataset.prototype*/
        105. 
 
      105.  
        106. 
 
      106.          /**
        107. 
+
      107.           * Class that is used for querying/retirving datasets from a database.
        108. 
 
      108.           *
        109. 
-
      109.           *Method to call to look up association,
        110. 
-
      110.           *called after the model has been filtered
        111. 
-
      111.           **/
        112. 
-
      112.          _fetchMethod:"all",
        113. 
-
      113.  
        114. 
-
      114.  
        115. 
-
      115.          constructor:function (options, patio, filter) {
        116. 
-
      116. 55            options = options || {};
        117. 
-
      117. 55            if (!options.model) {
        118. 
-
      118. 0                throw new Error("Model is required for " + this.type + " association");
        119. 
-
      119.              }
        120. 
-
      120. 55            this._model = options.model;
        121. 
-
      121. 55            this.patio = patio;
        122. 
-
      122. 55            this.__opts = options;
        123. 
-
      123. 55            !isUndefined(options.isCascading) && (this.isCascading = options.isCascading);
        124. 
-
      124. 55            this.filter = filter;
        125. 
-
      125. 55            this.readOnly = isBoolean(options.readOnly) ? options.readOnly : false;
        126. 
-
      126. 55            this.__hooks =
        127. 
-
      127.              {before:{add:null, remove:null, "set":null, load:null}, after:{add:null, remove:null, "set":null, load:null}};
        128. 
-
      128. 55            var hooks = ["Add", "Remove", "Set", "Load"];
        129. 
-
      129. 55            ["before", "after"].forEach(function (h) {
        130. 
-
      130. 110                hooks.forEach(function (a) {
        131. 
-
      131. 440                    var hookName = h + a, hook;
        132. 
-
      132. 440                    if (isFunction((hook = options[hookName]))) {
        133. 
-
      133. 0                        this.__hooks[h][a.toLowerCase()] = hook;
        134. 
-
      134.                      }
        135. 
-
      135.                  }, this);
        136. 
-
      136.              }, this);
        137. 
-
      137. 55            this.fetchType = options.fetchType || fetch.LAZY;
        138. 
-
      138.          },
        139. 
-
      139.  
        140. 
-
      140.          _callHook:function (hook, action, args) {
        141. 
-
      141. 0            var func = this.__hooks[hook][action], ret;
        142. 
-
      142. 0            if (isFunction(func)) {
        143. 
-
      143. 0                ret = func.apply(this, args);
        144. 
-
      144.              }
        145. 
-
      145. 0            return ret;
        146. 
-
      146.          },
        147. 
-
      147.  
        148. 
-
      148.          _clearAssociations:function (model) {
        149. 
-
      149. 125            if (!this.readOnly) {
        150. 
-
      150. 125                delete model.__associations[this.name];
        151. 
-
      151.              }
        152. 
-
      152.          },
        153. 
-
      153.  
        154. 
-
      154.          _forceReloadAssociations:function (model) {
        155. 
-
      155. 243            if (!this.readOnly) {
        156. 
-
      156. 243                delete model.__associations[this.name];
        157. 
-
      157. 243                return model[this.name];
        158. 
-
      158.              }
        159. 
-
      159.          },
        160. 
-
      160.  
        161. 
-
      161.          /**
        162. 
-
      162.           * @return {Boolean} true if the association is eager.
        163. 
-
      163.           */
        164. 
-
      164.          isEager:function () {
        165. 
-
      165. 2114            return this.fetchType == fetch.EAGER;
        166. 
-
      166.          },
        167. 
-
      167.  
        168. 
-
      168.          _checkAssociationKey:function (parent) {
        169. 
-
      169. 785            var q = {};
        170. 
-
      170. 785            this._setAssociationKeys(parent, q);
        171. 
-
      171. 785            return Object.keys(q).every(function (k) {
        172. 
-
      172. 785                return q[k] != null
        173. 
-
      173.              });
        174. 
-
      174.          },
        175. 
-
      175.  
        176. 
-
      176.          _getAssociationKey:function () {
        177. 
-
      177. 5205            var options = this.__opts, key, ret = [], lk, rk;
        178. 
-
      178. 5205            if (!isUndefinedOrNull((key = options.key))) {
        179. 
-
      179. 722                if (this.supportsStringKey && isString(key)) {
        180. 
-
      180.                      //normalize the key first!
        181. 
-
      181. 356                    ret = [
        182. 
-
      182.                          [this.isOwner ? this.defaultLeftKey : key],
        183. 
-
      183.                          [this.isOwner ? key : this.defaultRightKey]
        184. 
-
      184.                      ];
        185. 
-
      185. 366                } else if (this.supportsHashKey && isHash(key)) {
        186. 
-
      186. 366                    var leftKey = Object.keys(key)[0];
        187. 
-
      187. 366                    var rightKey = key[leftKey];
        188. 
-
      188. 366                    ret = [
        189. 
-
      189.                          [leftKey],
        190. 
-
      190.                          [rightKey]
        191. 
-
      191.                      ];
        192. 
-
      192. 0                } else if (this.supportsCompositeKey && isArray(key)) {
        193. 
-
      193. 0                    ret = [
        194. 
-
      194.                          [key],
        195. 
-
      195.                          null
        196. 
-
      196.                      ];
        197. 
-
      197.                  }
        198. 
-
      198. 4483            } else if (this.supportsLeftAndRightKey && (!isUndefinedOrNull((lk = options.leftKey))
        199. 
-
      199.                  && !isUndefinedOrNull((rk = options.rightKey)))) {
        200. 
-
      200. 140                ret = [
        201. 
-
      201.                      array.toArray(lk), array.toArray(rk)
        202. 
-
      202.                  ];
        203. 
-
      203.              } else {
        204. 
-
      204.                  //todo handle composite primary keys
        205. 
-
      205. 4343                ret = [
        206. 
-
      206.                      [this.defaultLeftKey],
        207. 
-
      207.                      [this.defaultRightKey]
        208. 
-
      208.                  ];
        209. 
-
      209.              }
        210. 
-
      210. 5205            return ret;
        211. 
-
      211.          },
        212. 
-
      212.  
        213. 
-
      213.  
        214. 
-
      214.          _setAssociationKeys:function (parent, model, val) {
        215. 
-
      215. 1573            var keys = this._getAssociationKey(parent), leftKey = keys[0], rightKey = keys[1];
        216. 
-
      216. 1573            if (leftKey && rightKey) {
        217. 
-
      217. 1573                for (var i = 0; i < leftKey.length; i++) {
        218. 
-
      218. 1573                    model[rightKey[i]] = !isUndefined(val) ? val : parent[leftKey[i]];
        219. 
-
      219.                  }
        220. 
-
      220.              } else {
        221. 
-
      221. 0                leftKey.forEach(function (k) {
        222. 
-
      222. 0                    model[k] = !isUndefined(val) ? val : parent[k];
        223. 
-
      223.                  });
        224. 
-
      224.              }
        225. 
-
      225.          },
        226. 
-
      226.  
        227. 
-
      227.          _setDatasetOptions:function (ds) {
        228. 
-
      228. 974            var options = this.__opts || {};
        229. 
-
      229. 974            var order, limit, distinct, select, query;
        230. 
-
      230.              //allow for multi key ordering
        231. 
-
      231. 974            if (!isUndefined((select = this.select))) {
        232. 
-
      232. 0                ds = ds.select.apply(ds, array.toArray(select));
        233. 
-
      233.              }
        234. 
-
      234. 974            if (!isUndefined((query = options.query)) || !isUndefined((query = options.conditions))) {
        235. 
-
      235. 0                ds = ds.filter(query);
        236. 
-
      236.              }
        237. 
-
      237. 974            if (isFunction(this.filter)) {
        238. 
-
      238. 334                var ret = this.filter.apply(this, [ds]);
        239. 
-
      239. 334                if (isInstanceOf(ret, ds._static)) {
        240. 
-
      240. 334                    ds = ret;
        241. 
-
      241.                  }
        242. 
-
      242.              }
        243. 
-
      243. 974            if (!isUndefined((distinct = options.distinct))) {
        244. 
-
      244. 0                ds = ds.limit.apply(ds, array.toArray(distinct));
        245. 
-
      245.              }
        246. 
-
      246. 974            if (!isUndefined((order = options.orderBy)) || !isUndefined((order = options.order))) {
        247. 
-
      247. 0                ds = ds.order.apply(ds, array.toArray(order));
        248. 
-
      248.              }
        249. 
-
      249. 974            if (!isUndefined((limit = options.limit))) {
        250. 
-
      250. 0                ds = ds.limit.apply(ds, array.toArray(limit));
        251. 
-
      251.              }
        252. 
-
      252. 974            return ds;
        253. 
-
      253.  
        254. 
-
      254.          },
        255. 
-
      255.  
        256. 
-
      256.          /**
        257. 
-
      257.           *Filters our associated dataset to load our association.
        258. 
+
      258.           * <p> Dynamically genertated methods include
        259. 
+
      259.           * <ul>
        260. 
+
      260.           *     <li>Join methods from {@link patio.Dataset.CONDITIONED_JOIN_TYPES} and
        261. 
+
      261.           *         {@link  patio.Dataset.UNCONDITIONED_JOIN_TYPES}, these methods handle the type call
        262. 
+
      262.           *         to {@link patio.Dataset#joinTable}, so to invoke include all arguments that
        263. 
+
      263.           *         {@link patio.Dataset#joinTable} requires except the type parameter. The default list includes.
        264. 
+
      264.           *         <ul>
        265. 
+
      265.           *             <li>Conditioned join types that accept conditions.
        266. 
+
      266.           *                  <ul>
        267. 
+
      267.           *                      <li>inner - INNER JOIN</li>
        268. 
+
      268.           *                      <li>fullOuter - FULL OUTER</li>
        269. 
+
      269.           *                      <li>rightOuter - RIGHT OUTER JOIN</li>
        270. 
+
      270.           *                      <li>leftOuter - LEFT OUTER JOIN</li>
        271. 
+
      271.           *                      <li>full - FULL JOIN</li>
        272. 
+
      272.           *                      <li>right - RIGHT JOIN</li>
        273. 
+
      273.           *                      <li>left - LEFT JOIN</li>
        274. 
+
      274.           *                  </ul>
        275. 
+
      275.           *             </li>
        276. 
+
      276.           *             <li>Unconditioned join types that do not accept join conditions
        277. 
+
      277.           *                  <ul>
        278. 
+
      278.           *                      <li>natural - NATURAL JOIN</li>
        279. 
+
      279.           *                      <li>naturalLeft - NATURAL LEFT JOIN</li>
        280. 
+
      280.           *                      <li>naturalRight - NATURAL RIGHT JOIN</li>
        281. 
+
      281.           *                      <li>naturalFull - NATURA FULLL JOIN</li>
        282. 
+
      282.           *                      <li>cross - CROSS JOIN</li>
        283. 
+
      283.           *                  </ul>
        284. 
+
      284.           *             </li>
        285. 
+
      285.           *         </ul>
        286. 
+
      286.           *      </li>
        287. 
+
      287.           *  </li>
        288. 
+
      288.           * </ul>
        289. 
 
      289.           *
        290. 
-
      290.           *@return {Dataset} the dataset with all filters applied.
        291. 
-
      291.           **/
        292. 
-
      292.          _filter:function (parent) {
        293. 
-
      293. 648            var options = this.__opts || {};
        294. 
-
      294. 648            var ds;
        295. 
-
      295. 648            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
        296. 
-
      296. 0                ds = ds.apply(parent, [parent]);
        297. 
-
      297.              }
        298. 
-
      298. 648            if (!ds) {
        299. 
-
      299. 648                var q = {};
        300. 
-
      300. 648                this._setAssociationKeys(parent, q);
        301. 
-
      301. 648                ds = this.model.dataset.naked().filter(q);
        302. 
-
      302. 648                var recip = this.model._findAssociation(this);
        303. 
-
      303. 648                recip && (recip = recip[1]);
        304. 
-
      304. 648                ds.rowCb = hitch(this, function (item) {
        305. 
-
      305. 489                    var ret = new Promise();
        306. 
-
      306. 489                    var model = this._toModel(item, true);
        307. 
-
      307. 489                    recip && recip.__setValue(model, parent);
        308. 
-
      308.                      //call hook to finish other model associations
        309. 
-
      309. 489                    model._hook("post", "load").then(hitch(this, function () {
        310. 
-
      310. 489                        ret.callback(model);
        311. 
-
      311.                      }), ret);
        312. 
-
      312. 489                    return ret.promise();
        313. 
-
      313.                  });
        314. 
+
      314.           * <p>
        315. 
+
      315.           *     <h4>Features:</h4>
        316. 
+
      316.           *     <p>
        317. 
+
      317.           *           Features that a particular {@link patio.Dataset} supports are shown in the example below.
        318. 
+
      318.           *           If you wish to implement an adapter please override these values depending on the database that
        319. 
+
      319.           *           you are developing the adapter for.
        320. 
+
      320.           *      </p>
        321. 
+
      321.           *      <pre class="code">
        322. 
+
      322.           *          var ds = DB.from("test");
        323. 
+
      323.           *
        324. 
+
      324.           *          //The default values returned
        325. 
+
      325.           *
        326. 
+
      326.           *          //Whether this dataset quotes identifiers.
        327. 
+
      327.           *          //Whether this dataset quotes identifiers.
        328. 
+
      328.           *          ds.quoteIdentifiers //=>true
        329. 
+
      329.           *
        330. 
+
      330.           *          //Whether this dataset will provide accurate number of rows matched for
        331. 
+
      331.           *          //delete and update statements.  Accurate in this case is the number of
        332. 
+
      332.           *          //rows matched by the dataset's filter.
        333. 
+
      333.           *          ds.providesAccurateRowsMatched; //=>true
        334. 
+
      334.           *
        335. 
+
      335.           *          //Times Whether the dataset requires SQL standard datetimes (false by default,
        336. 
+
      336.           *          // as most allow strings with ISO 8601 format).
        337. 
+
      337.           *          ds.requiresSqlStandardDate; //=>false
        338. 
+
      338.           *
        339. 
+
      339.           *          //Whether the dataset supports common table expressions (the WITH clause).
        340. 
+
      340.           *          ds.supportsCte; //=>true
        341. 
+
      341.           *
        342. 
+
      342.           *          //Whether the dataset supports the DISTINCT ON clause, false by default.
        343. 
+
      343.           *          ds.supportsDistinctOn; //=>false
        344. 
+
      344.           *
        345. 
+
      345.           *          //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
        346. 
+
      346.           *          ds.supportsIntersectExcept; //=>true
        347. 
+
      347.           *
        348. 
+
      348.           *          //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default
        349. 
+
      349.           *          ds.supportsIntersectExceptAll; //=>true
        350. 
+
      350.           *
        351. 
+
      351.           *          //Whether the dataset supports the IS TRUE syntax.
        352. 
+
      352.           *          ds.supportsIsTrue; //=>true
        353. 
+
      353.           *
        354. 
+
      354.           *          //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
        355. 
+
      355.           *          ds.supportsJoinUsing; //=>true
        356. 
+
      356.           *
        357. 
+
      357.           *          //Whether modifying joined datasets is supported.
        358. 
+
      358.           *          ds.supportsModifyingJoin; //=>false
        359. 
+
      359.           *
        360. 
+
      360.           *          //Whether the IN/NOT IN operators support multiple columns when an
        361. 
+
      361.           *          ds.supportsMultipleColumnIn; //=>true
        362. 
+
      362.           *
        363. 
+
      363.           *          //Whether the dataset supports timezones in literal timestamps
        364. 
+
      364.           *          ds.supportsTimestampTimezone; //=>false
        365. 
+
      365.           *
        366. 
+
      366.           *          //Whether the dataset supports fractional seconds in literal timestamps
        367. 
+
      367.           *          ds.supportsTimestampUsecs; //=>true
        368. 
+
      368.           *
        369. 
+
      369.           *          //Whether the dataset supports window functions.
        370. 
+
      370.           *          ds.supportsWindowFunctions; //=>false
        371. 
+
      371.           *       </pre>
        372. 
+
      372.           * <p>
        373. 
+
      373.           * <p>
        374. 
+
      374.           *     <h4>Actions</h4>
        375. 
+
      375.           *     <p>
        376. 
+
      376.           *         Each dataset does not actually send any query to the database until an action method has
        377. 
+
      377.           *         been called upon it(with the exception of {@link patio.Dataset#graph} because columns
        378. 
+
      378.           *         from the other table might need retrived in order to set up the graph). Each action
        379. 
+
      379.           *         returns a <i>comb.Promise</i> that will be resolved with the result or errback, it is important
        380. 
+
      380.           *         that you account for errors otherwise it can be difficult to track down issues.
        381. 
+
      381.           *         The list of action methods is:
        382. 
+
      382.           *         <ul>
        383. 
+
      383.           *             <li>{@link patio.Dataset#all}</li>
        384. 
+
      384.           *             <li>{@link patio.Dataset#one}</li>
        385. 
+
      385.           *             <li>{@link patio.Dataset#avg}</li>
        386. 
+
      386.           *             <li>{@link patio.Dataset#count}</li>
        387. 
+
      387.           *             <li>{@link patio.Dataset#columns}</li>
        388. 
+
      388.           *             <li>{@link patio.Dataset#remove}</li>
        389. 
+
      389.           *             <li>{@link patio.Dataset#forEach}</li>
        390. 
+
      390.           *             <li>{@link patio.Dataset#empty}</li>
        391. 
+
      391.           *             <li>{@link patio.Dataset#first}</li>
        392. 
+
      392.           *             <li>{@link patio.Dataset#get}</li>
        393. 
+
      393.           *             <li>{@link patio.Dataset#import}</li>
        394. 
+
      394.           *             <li>{@link patio.Dataset#insert}</li>
        395. 
+
      395.           *             <li>{@link patio.Dataset#save}</li>
        396. 
+
      396.           *             <li>{@link patio.Dataset#insertMultiple}</li>
        397. 
+
      397.           *             <li>{@link patio.Dataset#saveMultiple}</li>
        398. 
+
      398.           *             <li>{@link patio.Dataset#interval}</li>
        399. 
+
      399.           *             <li>{@link patio.Dataset#last}</li>
        400. 
+
      400.           *             <li>{@link patio.Dataset#map}</li>
        401. 
+
      401.           *             <li>{@link patio.Dataset#max}</li>
        402. 
+
      402.           *             <li>{@link patio.Dataset#min}</li>
        403. 
+
      403.           *             <li>{@link patio.Dataset#multiInsert}</li>
        404. 
+
      404.           *             <li>{@link patio.Dataset#range}</li>
        405. 
+
      405.           *             <li>{@link patio.Dataset#selectHash}</li>
        406. 
+
      406.           *             <li>{@link patio.Dataset#selectMap}</li>
        407. 
+
      407.           *             <li>{@link patio.Dataset#selectOrderMap}</li>
        408. 
+
      408.           *             <li>{@link patio.Dataset#set}</li>
        409. 
+
      409.           *             <li>{@link patio.Dataset#singleRecord}</li>
        410. 
+
      410.           *             <li>{@link patio.Dataset#singleValue}</li>
        411. 
+
      411.           *             <li>{@link patio.Dataset#sum}</li>
        412. 
+
      412.           *             <li>{@link patio.Dataset#toCsv}</li>
        413. 
+
      413.           *             <li>{@link patio.Dataset#toHash}</li>
        414. 
+
      414.           *             <li>{@link patio.Dataset#truncate}</li>
        415. 
+
      415.           *             <li>{@link patio.Dataset#update}</li>
        416. 
+
      416.           *         </ul>
        417. 
+
      417.           *
        418. 
+
      418.           *     </p>
        419. 
+
      419.           * </p>
        420. 
+
      420.           *
        421. 
+
      421.           * @constructs
        422. 
+
      422.           *
        423. 
+
      423.           *
        424. 
+
      424.           * @param {patio.Database} db the database this dataset should use when querying for data.
        425. 
+
      425.           * @param {Object} opts options to set on this dataset instance
        426. 
+
      426.           *
        427. 
+
      427.           * @property {Function} rowCb callback to be invoked for each row returned from the database.
        428. 
+
      428.           *                      the return value will be used as the result of query. The rowCb can also return a promise,
        429. 
+
      429.           *                      The resolved value of the promise will be used as result.
        430. 
+
      430.           *
        431. 
+
      431.           * @property {String} identifierInputMethod this is the method that will be called on each identifier returned from the database.
        432. 
+
      432.           *                                          This value will be defaulted to whatever the identifierInputMethod
        433. 
+
      433.           *                                          is on the database used in initialization.
        434. 
+
      434.           *
        435. 
+
      435.           * @property {String} identifierOutputMethod this is the method that will be called on each identifier sent to the database.
        436. 
+
      436.           *                                          This value will be defaulted to whatever the identifierOutputMethod
        437. 
+
      437.           *                                          is on the database used in initialization.
        438. 
+
      438.           * @property {String} firstSourceAlias The first source (primary table) for this dataset. If the table is aliased, returns the aliased name.
        439. 
+
      439.           *                                     throws a {patio.DatasetError} tf the dataset doesn't have a table.
        440. 
+
      440.           * <pre class="code">
        441. 
+
      441.           *   DB.from("table").firstSourceAlias;
        442. 
+
      442.           *   //=> "table"
        443. 
+
      443.           *
        444. 
+
      444.           *   DB.from("table___t").firstSourceAlias;
        445. 
+
      445.           *   //=> "t"
        446. 
+
      446.           * </pre>
        447. 
+
      447.           *
        448. 
+
      448.           * @property {String} firstSourceTable  The first source (primary table) for this dataset.  If the dataset doesn't
        449. 
+
      449.           *                                      have a table, raises a {@link patio.erros.DatasetError}.
        450. 
+
      450.           *<pre class="code">
        451. 
+
      451.           *
        452. 
+
      452.           *  DB.from("table").firstSourceTable;
        453. 
+
      453.           *         //=> "table"
        454. 
+
      454.           *
        455. 
+
      455.           *  DB.from("table___t").firstSourceTable;
        456. 
+
      456.           *         //=> "t"
        457. 
+
      457.           * </pre>
        458. 
+
      458.           * @property {Boolean} isSimpleSelectAll Returns true if this dataset is a simple SELECT * FROM {table}, otherwise false.
        459. 
+
      459.           * <pre class="code">
        460. 
+
      460.           *     DB.from("items").isSimpleSelectAll; //=> true
        461. 
+
      461.           *     DB.from("items").filter({a : 1}).isSimpleSelectAll; //=> false
        462. 
+
      462.           * </pre>
        463. 
+
      463.           * @property {boolean} [quoteIdentifiers=true]  Whether this dataset quotes identifiers.
        464. 
+
      464.           * @property {boolean} [providesAccurateRowsMatched=true] Whether this dataset will provide accurate number of rows matched for
        465. 
+
      465.           *   delete and update statements.  Accurate in this case is the number of
        466. 
+
      466.           *   rows matched by the dataset's filter.
        467. 
+
      467.           * @property {boolean} [requiresSqlStandardDate=false] Whether the dataset requires SQL standard datetimes (false by default,
        468. 
+
      468.           *                                                     as most allow strings with ISO 8601 format).
        469. 
+
      469.           * @property {boolean} [supportsCte=true] Whether the dataset supports common table expressions (the WITH clause).
        470. 
+
      470.           * @property {boolean} [supportsDistinctOn=false] Whether the dataset supports the DISTINCT ON clause, false by default.
        471. 
+
      471.           * @property {boolean} [supportsIntersectExcept=true] Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
        472. 
+
      472.           * @property {boolean} [supportsIntersectExceptAll=true] Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
        473. 
+
      473.           * @property {boolean} [supportsIsTrue=true] Whether the dataset supports the IS TRUE syntax.
        474. 
+
      474.           * @property {boolean} [supportsJoinUsing=true] Whether the dataset supports the JOIN table USING (column1, ...) syntax.
        475. 
+
      475.           * @property {boolean} [supportsModifyingJoin=false] Whether modifying joined datasets is supported.
        476. 
+
      476.           * @property {boolean} [supportsMultipleColumnIn=true] Whether the IN/NOT IN operators support multiple columns when an
        477. 
+
      477.           * @property {boolean} [supportsTimestampTimezone=false] Whether the dataset supports timezones in literal timestamps
        478. 
+
      478.           * @property {boolean} [supportsTimestampUsecs=true] Whether the dataset supports fractional seconds in literal timestamps
        479. 
+
      479.           * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions.
        480. 
+
      480.           * @property {patio.sql.Identifier[]} [sourceList=[]] a list of sources for this dataset.
        481. 
+
      481.           * @property {patio.sql.Identifier[]} [joinSourceList=[]] a list of join sources
        482. 
+
      482.           * @property {Boolean} hasSelectSource true if this dataset already has a select sources.
        483. 
+
      483.           */
        484. 
+
      484.          constructor:function (db, opts) {
        485. 
+
      485. 29216            this._super(arguments);
        486. 
+
      486. 29216            this.db = db;
        487. 
+
      487. 29216            this.__opts = {};
        488. 
+
      488. 29216            this.__rowCb = null;
        489. 
+
      489. 29216            if (db) {
        490. 
+
      490. 15039                this.__quoteIdentifiers = db.quoteIdentifiers;
        491. 
+
      491. 15039                this.__identifierInputMethod = db.identifierInputMethod;
        492. 
+
      492. 15039                this.__identifierOutputMethod = db.identifierOutputMethod;
        493. 
 
      493.              }
        494. 
-
      494.  
        495. 
-
      495. 648            return this._setDatasetOptions(ds);
        496. 
 
      496.          },
        497. 
 
      497.  
        498. 
-
      498.          __setValue:function (parent, model) {
        499. 
-
      499. 2061            parent.__associations[this.name] = this._fetchMethod
        500. 
-
      500.                  == "all" ? !isArray(model) ? [model] : model : isArray(model) ? model[0] : model;
        501. 
-
      501. 2061            return parent.__associations[this.name];
        502. 
-
      502.          },
        503. 
 
      503.  
        504. 
-
      504.          fetch:function (parent) {
        505. 
-
      505. 785            var ret = new Promise();
        506. 
-
      506. 785            if (this._checkAssociationKey(parent)) {
        507. 
-
      507. 733                this._filter(parent)[this._fetchMethod]().then(hitch(this, function (result) {
        508. 
-
      508. 733                    this.__setValue(parent, result);
        509. 
-
      509. 733                    ret.callback(result);
        510. 
-
      510. 733                    parent = null;
        511. 
-
      511.                  }), ret);
        512. 
-
      512.              } else {
        513. 
-
      513. 52                this.__setValue(parent, null);
        514. 
-
      514. 52                ret.callback(null);
        515. 
+
      515.          /**
        516. 
+
      516.           * Returns a new clone of the dataset with with the given options merged into the current datasets options.
        517. 
+
      517.           * If the options changed include options in {@link patio.dataset.Query#COLUMN_CHANGE_OPTS}, the cached
        518. 
+
      518.           * columns are deleted.  This method should generally not be called
        519. 
+
      519.           * directly by user code.
        520. 
+
      520.           *
        521. 
+
      521.           * @param {Object} opts options to merge into the curred datasets options and applied to the returned dataset.
        522. 
+
      522.           * @return [patio.Dataset] a cloned dataset with the merged options
        523. 
+
      523.           **/
        524. 
+
      524.          mergeOptions:function (opts) {
        525. 
+
      525. 14948            opts = isUndefined(opts) ? {} : opts;
        526. 
+
      526. 14948            var ds = new this._static(this.db, {});
        527. 
+
      527. 14948            ds.rowCb = this.rowCb;
        528. 
+
      528. 14948            this._static.FEATURES.forEach(function (f) {
        529. 
+
      529. 209272                ds[f] = this[f];
        530. 
+
      530.              }, this);
        531. 
+
      531. 14948            ds.__opts = merge({}, this.__opts, opts);
        532. 
+
      532. 14948            ds.identifierInputMethod = this.identifierInputMethod;
        533. 
+
      533. 14948            ds.identifierOutputMethod = this.identifierOutputMethod;
        534. 
+
      534. 14948            var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
        535. 
+
      535. 14948            if (Object.keys(opts).some(function (o) {
        536. 
+
      536. 13536                return columnChangeOpts.indexOf(o) != -1;
        537. 
+
      537.              })) {
        538. 
+
      538. 2456                ds.__opts.columns = null;
        539. 
 
      539.              }
        540. 
-
      540. 785            return ret;
        541. 
+
      541. 14948            return ds;
        542. 
 
      542.          },
        543. 
 
      543.  
        544. 
+
      544.  
        545. 
 
      545.          /**
        546. 
-
      546.           * Middleware called before a model is removed.
        547. 
-
      547.           * </br>
        548. 
-
      548.           * <b> This is called in the scope of the model</b>
        549. 
-
      549.           * @param {Function} next function to pass control up the middleware stack.
        550. 
-
      550.           * @param {_Association} self reference to the Association that is being acted up.
        551. 
+
      551.           * Converts a string to an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
        552. 
+
      552.           * or {@link patio.sql.AliasedExpression}, depending on the format:
        553. 
+
      553.           *
        554. 
+
      554.           * <ul>
        555. 
+
      555.           *      <li>For columns : table__column___alias.</li>
        556. 
+
      556.           *      <li>For tables : schema__table___alias.</li>
        557. 
+
      557.           * </ul>
        558. 
+
      558.           * each portion of the identifier is optional. See example below
        559. 
+
      559.           *
        560. 
+
      560.           * @example
        561. 
+
      561.           *
        562. 
+
      562.           * ds.stringToIdentifier("a") //= > new patio.sql.Identifier("a");
        563. 
+
      563.           * ds.stringToIdentifier("table__column"); //=> new patio.sql.QualifiedIdentifier(table, column);
        564. 
+
      564.           * ds.stringToIdentifier("table__column___alias");
        565. 
+
      565.           *      //=> new patio.sql.AliasedExpression(new patio.sql.QualifiedIdentifier(table, column), alias);
        566. 
+
      566.           *
        567. 
+
      567.           * @param {String} name the name to covert to an an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
        568. 
+
      568.           * or {@link patio.sql.AliasedExpression}.
        569. 
+
      569.           *
        570. 
+
      570.           * @return  {patio.sql.Identifier|patio.sql.QualifiedIdentifier|patio.sql.AliasedExpression} an identifier generated based on the name string.
        571. 
 
      571.           */
        572. 
-
      572.          _preRemove:function (next, model) {
        573. 
-
      573. 223            if (this.isOwner && !this.isCascading) {
        574. 
-
      574. 46                var q = {};
        575. 
-
      575. 46                this._setAssociationKeys(model, q, null);
        576. 
-
      576. 46                model[this.associatedDatasetName].update(q).classic(next);
        577. 
+
      577.          stringToIdentifier:function (name) {
        578. 
+
      578. 15093            if (isString(name)) {
        579. 
+
      579. 10138                var parts = this._splitString(name);
        580. 
+
      580. 10138                var schema = parts[0], table = parts[1], alias = parts[2];
        581. 
+
      581. 10138                return (schema && table && alias
        582. 
+
      582.                      ? new AliasedExpression(new QualifiedIdentifier(schema, table), alias)
        583. 
+
      583.                      : (schema && table
        584. 
+
      584.                      ? new QualifiedIdentifier(schema, table)
        585. 
+
      585.                      : (table && alias
        586. 
+
      586.                      ? new AliasedExpression(new Identifier(table), alias) : new Identifier(table))));
        587. 
 
      587.              } else {
        588. 
-
      588. 177                next();
        589. 
+
      589. 4955                return name;
        590. 
 
      590.              }
        591. 
 
      591.          },
        592. 
 
      592.  
        593. 
 
      593.          /**
        594. 
-
      594.           * Middleware called aft era model is removed.
        595. 
-
      595.           * </br>
        596. 
-
      596.           * <b> This is called in the scope of the model</b>
        597. 
-
      597.           * @param {Function} next function to pass control up the middleware stack.
        598. 
-
      598.           * @param {_Association} self reference to the Association that is being called.
        599. 
+
      599.           * Can either be a string or null.
        600. 
+
      600.           *
        601. 
+
      601.           *
        602. 
+
      602.           * @example
        603. 
+
      603.           * //columns
        604. 
+
      604.           *  table__column___alias //=> table.column as alias
        605. 
+
      605.           *  table__column //=> table.column
        606. 
+
      606.           *  //tables
        607. 
+
      607.           *  schema__table___alias //=> schema.table as alias
        608. 
+
      608.           *  schema__table //=> schema.table
        609. 
+
      609.           *
        610. 
+
      610.           * //name and alias
        611. 
+
      611.           * columnOrTable___alias //=> columnOrTable as alias
        612. 
+
      612.           *
        613. 
+
      613.           *
        614. 
+
      614.           *
        615. 
+
      615.           * @return {String[]} an array with the elements being:
        616. 
+
      616.           * <ul>
        617. 
+
      617.           *      <li>For columns :[table, column, alias].</li>
        618. 
+
      618.           *      <li>For tables : [schema, table, alias].</li>
        619. 
+
      619.           * </ul>
        620. 
 
      620.           */
        621. 
-
      621.          _postRemove:function (next, model) {
        622. 
-
      622. 514            next();
        623. 
+
      623.          _splitString:function (s) {
        624. 
+
      624. 19662            var ret, m;
        625. 
+
      625. 19662            if ((m = s.match(this._static.COLUMN_REF_RE1)) != null) {
        626. 
+
      626. 189                ret = m.slice(1);
        627. 
+
      627.              }
        628. 
+
      628. 19473            else if ((m = s.match(this._static.COLUMN_REF_RE2)) != null) {
        629. 
+
      629. 28                ret = [null, m[1], m[2]];
        630. 
+
      630.              }
        631. 
+
      631. 19445            else if ((m = s.match(this._static.COLUMN_REF_RE3)) != null) {
        632. 
+
      632. 2079                ret = [m[1], m[2], null];
        633. 
+
      633.              }
        634. 
+
      634.              else {
        635. 
+
      635. 17366                ret = [null, s, null];
        636. 
+
      636.              }
        637. 
+
      637. 19662            return ret;
        638. 
 
      638.          },
        639. 
 
      639.  
        640. 
 
      640.          /**
        641. 
-
      641.           * Middleware called before a model is saved.
        642. 
-
      642.           * </br>
        643. 
-
      643.           * <b> This is called in the scope of the model</b>
        644. 
-
      644.           * @param {Function} next function to pass control up the middleware stack.
        645. 
-
      645.           * @param {_Association} self reference to the Association that is being called.
        646. 
-
      646.           */
        647. 
-
      647.          _preSave:function (next, model) {
        648. 
-
      648. 324            next();
        649. 
-
      649.          },
        650. 
+
      650.           * @ignore
        651. 
+
      651.           **/
        652. 
+
      652.          getters:{
        653. 
 
      653.  
        654. 
-
      654.          /**
        655. 
-
      655.           * Middleware called after a model is saved.
        656. 
-
      656.           * </br>
        657. 
-
      657.           * <b> This is called in the scope of the model</b>
        658. 
-
      658.           * @param {Function} next function to pass control up the middleware stack.
        659. 
-
      659.           * @param {_Association} self reference to the Association that is being called.
        660. 
-
      660.           */
        661. 
-
      661.          _postSave:function (next, model) {
        662. 
-
      662. 198            next();
        663. 
-
      663.          },
        664. 
+
      664.              rowCb:function () {
        665. 
+
      665. 23052                return this.__rowCb;
        666. 
+
      666.              },
        667. 
 
      667.  
        668. 
-
      668.          /**
        669. 
-
      669.           * Middleware called before a model is updated.
        670. 
-
      670.           * </br>
        671. 
-
      671.           * <b> This is called in the scope of the model</b>
        672. 
-
      672.           * @param {Function} next function to pass control up the middleware stack.
        673. 
-
      673.           * @param {_Association} self reference to the Association that is being called.
        674. 
-
      674.           */
        675. 
-
      675.          _preUpdate:function (next, model) {
        676. 
-
      676. 2            next();
        677. 
-
      677.          },
        678. 
+
      678.              identifierInputMethod:function () {
        679. 
+
      679. 14948                return this.__identifierInputMethod;
        680. 
+
      680.              },
        681. 
 
      681.  
        682. 
-
      682.          /**
        683. 
-
      683.           * Middleware called before a model is updated.
        684. 
-
      684.           * </br>
        685. 
-
      685.           * <b> This is called in the scope of the model</b>
        686. 
-
      686.           * @param {Function} next function to pass control up the middleware stack.
        687. 
-
      687.           * @param {_Association} self reference to the Association that is being called.
        688. 
-
      688.           */
        689. 
-
      689.          _postUpdate:function (next, model) {
        690. 
-
      690. 127            next();
        691. 
-
      691.          },
        692. 
+
      692.              identifierOutputMethod:function () {
        693. 
+
      693. 14948                return this.__identifierOutputMethod;
        694. 
+
      694.              },
        695. 
 
      695.  
        696. 
-
      696.          /**
        697. 
-
      697.           * Middleware called before a model is loaded.
        698. 
-
      698.           * </br>
        699. 
-
      699.           * <b> This is called in the scope of the model</b>
        700. 
-
      700.           * @param {Function} next function to pass control up the middleware stack.
        701. 
-
      701.           * @param {_Association} self reference to the Association that is being called.
        702. 
-
      702.           */
        703. 
-
      703.          _preLoad:function (next, model) {
        704. 
-
      704. 1570            next();
        705. 
-
      705.          },
        706. 
+
      706.              firstSourceAlias:function () {
        707. 
+
      707. 579                var source = this.__opts.from;
        708. 
+
      708. 579                if (isUndefinedOrNull(source) || !source.length) {
        709. 
+
      709. 2                    throw new DatasetError("No source specified for the query");
        710. 
+
      710.                  }
        711. 
+
      711. 577                source = source[0];
        712. 
+
      712. 577                if (isInstanceOf(source, AliasedExpression)) {
        713. 
+
      713. 20                    return source.alias;
        714. 
+
      714. 557                } else if (isString(source)) {
        715. 
+
      715. 0                    var parts = this._splitString(source);
        716. 
+
      716. 0                    var alias = parts[2];
        717. 
+
      717. 0                    return alias ? alias : source;
        718. 
+
      718.                  } else {
        719. 
+
      719. 557                    return source;
        720. 
+
      720.                  }
        721. 
+
      721.              },
        722. 
 
      722.  
        723. 
-
      723.          /**
        724. 
-
      724.           * Middleware called after a model is loaded.
        725. 
-
      725.           * </br>
        726. 
-
      726.           * <b> This is called in the scope of the model</b>
        727. 
-
      727.           * @param {Function} next function to pass control up the middleware stack.
        728. 
-
      728.           * @param {_Association} self reference to the Association that is being called.
        729. 
-
      729.           */
        730. 
-
      730.          _postLoad:function (next, model) {
        731. 
-
      731. 0            next();
        732. 
-
      732.          },
        733. 
+
      733.              firstSourceTable:function () {
        734. 
+
      734. 15                var source = this.__opts.from;
        735. 
+
      735. 15                if (isUndefinedOrNull(source) || !source.length) {
        736. 
+
      736. 1                    throw new QueryError("No source specified for the query");
        737. 
+
      737.                  }
        738. 
+
      738. 14                var source = source[0];
        739. 
+
      739. 14                if (isInstanceOf(source, AliasedExpression)) {
        740. 
+
      740. 3                    return source.expression;
        741. 
+
      741. 11                } else if (isString(source)) {
        742. 
+
      742. 0                    var parts = this._splitString(source);
        743. 
+
      743. 0                    return source;
        744. 
+
      744.                  } else {
        745. 
+
      745. 11                    return source;
        746. 
+
      746.                  }
        747. 
+
      747.              },
        748. 
 
      748.  
        749. 
-
      749.          /**
        750. 
-
      750.           * Alias used to explicitly set an association on a model.
        751. 
-
      751.           * @param {*} val the value to set the association to
        752. 
-
      752.           * @param {_Association} self reference to the Association that is being called.
        753. 
-
      753.           */
        754. 
-
      754.          _setter:function (val, model) {
        755. 
-
      755. 0            model.__associations[this.name] = val;
        756. 
-
      756.          },
        757. 
+
      757.              sourceList:function () {
        758. 
+
      758. 0                return (this.__opts.from || []).map(this.stringToIdentifier, this);
        759. 
+
      759.              },
        760. 
 
      760.  
        761. 
-
      761.          associationLoaded:function (model) {
        762. 
-
      762. 2707            return model.__associations.hasOwnProperty(this.name);
        763. 
-
      763.          },
        764. 
+
      764.              joinSourceList:function () {
        765. 
+
      765. 0                return (this.__opts.join || []).map(function (join) {
        766. 
+
      766. 0                    return this.stringToIdentifier(join.tableAlias || join.table);
        767. 
+
      767.                  }, this);
        768. 
+
      768.              },
        769. 
 
      769.  
        770. 
-
      770.          getAssociation:function (model) {
        771. 
-
      771. 885            return model.__associations[this.name];
        772. 
+
      772.              hasSelectSource:function () {
        773. 
+
      773. 0                var select = this.__opts.select;
        774. 
+
      774. 0                return !(isUndefinedOrNull(select) || select.length === 0);
        775. 
+
      775.              }
        776. 
 
      776.          },
        777. 
 
      777.  
        778. 
 
      778.          /**
        779. 
-
      779.           * Alias used to explicitly get an association on a model.
        780. 
-
      780.           * @param {_Association} self reference to the Association that is being called.
        781. 
-
      781.           */
        782. 
-
      782.          _getter:function (model) {
        783. 
-
      783.              //if we have them return them;
        784. 
-
      784. 612            if (this.associationLoaded(model)) {
        785. 
-
      785. 220                var assoc = this.getAssociation(model);
        786. 
-
      786. 220                return this.isEager() ? assoc : new Promise().callback(assoc).promise();
        787. 
-
      787. 392            } else if (model.isNew) {
        788. 
-
      788. 0                return null;
        789. 
-
      789.              } else {
        790. 
-
      790. 392                return this.fetch(model);
        791. 
-
      791.              }
        792. 
-
      792.          },
        793. 
+
      793.           * @ignore
        794. 
+
      794.           **/
        795. 
+
      795.          setters:{
        796. 
+
      796.              /**@lends patio.Dataset.prototype*/
        797. 
 
      797.  
        798. 
-
      798.          _toModel:function (val, fromDb) {
        799. 
-
      799. 1412            var Model = this.model;
        800. 
-
      800. 1412            if (!isUndefinedOrNull(Model)) {
        801. 
-
      801. 1412                if (!isInstanceOf(val, Model)) {
        802. 
-
      802. 1167                    val = new this.model(val, fromDb);
        803. 
-
      803.                  }
        804. 
-
      804.              } else {
        805. 
-
      805. 0                throw new PatioError("Invalid model " + this.name);
        806. 
-
      806.              }
        807. 
-
      807. 1412            return val;
        808. 
-
      808.          },
        809. 
+
      809.              identifierInputMethod:function (meth) {
        810. 
+
      810. 15038                this.__identifierInputMethod = meth;
        811. 
+
      811.              },
        812. 
 
      812.  
        813. 
-
      813.          /**
        814. 
-
      814.           * Method to inject functionality into a model. This method alters the model
        815. 
-
      815.           * to prepare it for associations, and initializes all required middleware calls
        816. 
-
      816.           * to fulfill requirements needed to loaded the associations.
        817. 
-
      817.           *
        818. 
-
      818.           * @param {Model} parent the model that is having an associtaion set on it.
        819. 
-
      819.           * @param {String} name the name of the association.
        820. 
-
      820.           */
        821. 
-
      821.          inject:function (parent, name) {
        822. 
-
      822. 55            this.name = name;
        823. 
-
      823. 55            var self = this;
        824. 
-
      824. 55            this.parent = parent;
        825. 
-
      825. 55            parent.prototype.__defineGetter__(name, function () {
        826. 
-
      826. 612                return  self._getter(this);
        827. 
-
      827.              });
        828. 
-
      828. 55            parent.prototype.__defineGetter__(this.associatedDatasetName, function () {
        829. 
-
      829. 146                return  self._filter(this);
        830. 
-
      830.              });
        831. 
+
      831.              identifierOutputMethod:function (meth) {
        832. 
+
      832. 15038                this.__identifierOutputMethod = meth;
        833. 
+
      833.              },
        834. 
 
      834.  
        835. 
-
      835. 55            if (!this.readOnly && this.createSetter) {
        836. 
-
      836.                  //define a setter because we arent read only
        837. 
-
      837. 55                parent.prototype.__defineSetter__(name, function (vals) {
        838. 
-
      838. 139                    self._setter(vals, this);
        839. 
-
      839.                  });
        840. 
+
      840.              rowCb:function (cb) {
        841. 
+
      841. 18564                if (isFunction(cb) || isNull(cb)) {
        842. 
+
      842. 18559                    this.__rowCb = cb;
        843. 
+
      843.                  } else {
        844. 
+
      844. 5                    throw new DatasetError("rowCb mus be a function");
        845. 
+
      845.                  }
        846. 
 
      846.              }
        847. 
-
      847.  
        848. 
-
      848.              //set up all callbacks
        849. 
-
      849. 55            ["pre", "post"].forEach(function (op) {
        850. 
-
      850. 110                ["save", "update", "remove", "load"].forEach(function (type) {
        851. 
-
      851. 440                    parent[op](type, function (next) {
        852. 
-
      852. 5598                        return self["_" + op + type.charAt(0).toUpperCase() + type.slice(1)](next, this);
        853. 
-
      853.                      });
        854. 
-
      854.                  }, this);
        855. 
-
      855.              }, this);
        856. 
-
      856.          },
        857. 
-
      857.  
        858. 
-
      858.          getters:{
        859. 
-
      859.  
        860. 
-
      860.              select:function () {
        861. 
-
      861. 648                return this.__opts.select;
        862. 
-
      862.              },
        863. 
-
      863.  
        864. 
-
      864.              defaultLeftKey:function () {
        865. 
-
      865. 2841                var ret = "";
        866. 
-
      866. 2841                if (this.isOwner) {
        867. 
-
      867. 2095                    ret = this.__opts.primaryKey || this.parent.primaryKey[0]
        868. 
-
      868.                  } else {
        869. 
-
      869. 746                    ret = this.model.tableName + "Id";
        870. 
-
      870.                  }
        871. 
-
      871. 2841                return ret;
        872. 
-
      872.              },
        873. 
-
      873.  
        874. 
-
      874.              defaultRightKey:function () {
        875. 
-
      875. 2721                return this.associatedModelKey;
        876. 
-
      876.              },
        877. 
-
      877.  
        878. 
-
      878.              //Returns our model
        879. 
-
      879.              model:function () {
        880. 
-
      880. 10572                return this.patio.getModel(this._model, this.parent.db);
        881. 
-
      881.              },
        882. 
-
      882.  
        883. 
-
      883.              associatedModelKey:function () {
        884. 
-
      884. 2721                var ret = "";
        885. 
-
      885. 2721                if (this.isOwner) {
        886. 
-
      886. 1857                    ret = this.__opts.primaryKey || this.parent.tableName + "Id";
        887. 
-
      887.                  } else {
        888. 
-
      888. 864                    ret = this.model.primaryKey[0];
        889. 
-
      889.                  }
        890. 
-
      890. 2721                return ret;
        891. 
-
      891.              },
        892. 
-
      892.  
        893. 
-
      893.              associatedDatasetName:function () {
        894. 
-
      894. 201                return this.name + "Dataset"
        895. 
-
      895.              },
        896. 
-
      896.  
        897. 
-
      897.              removeAssociationFlagName:function () {
        898. 
-
      898. 27                return "__remove" + this.name + "association"
        899. 
-
      899.              }
        900. 
-
      900.  
        901. 
-
      901.          }
        902. 
-
      902.      },
        903. 
+
      903.          }
        904. 
+
      904.      },
        905. 
 
      905.  
        906. 
 
      906.      static:{
        907. 
-
      907.          /**@lends patio.associations.Association*/
        908. 
-
      908.  
        909. 
-
      909.          fetch:{
        910. 
-
      910.  
        911. 
-
      911.              LAZY:"lazy",
        912. 
-
      912.  
        913. 
-
      913.              EAGER:"eager"
        914. 
-
      914.          }
        915. 
+
      915.          COLUMN_REF_RE1:/^(\w+)__(\w+)___(\w+)$/,
        916. 
+
      916.          COLUMN_REF_RE2:/^(\w+)___(\w+)$/,
        917. 
+
      917.          COLUMN_REF_RE3:/^(\w+)__(\w+)$/
        918. 
 
      918.      }
        919. 
-
      919.  }).as(module);
      
+
    3.  }).as(module);
      4. 
+
    4.  
      5. 
+
    5.
    -
    +
    -
    model.js
    +
    associations/_Association.js
    - Coverage88.51 - SLOC1067 - LOC322 - Missed37 + Coverage87.18 + SLOC515 + LOC156 + Missed20
    - 
    1. 1var comb = require("comb"),
      2. 
-
    2.      isFunction = comb.isFunction,
      3. 
+    
      1. 1var comb = require("comb-proxy"),
        2. 
+
      2.      define = comb.define,
        3. 
 
      3.      isUndefined = comb.isUndefined,
        4. 
-
      4.      isDefined = comb.isDefined,
        5. 
+
      5.      isUndefinedOrNull = comb.isUndefinedOrNull,
        6. 
 
      6.      isBoolean = comb.isBoolean,
        7. 
 
      7.      isString = comb.isString,
        8. 
-
      8.      argsToArray = comb.argsToArray,
        9. 
-
      9.      isInstanceOf = comb.isInstanceOf,
        10. 
-
      10.      serial = comb.serial,
        11. 
 
      11.      isHash = comb.isHash,
        12. 
-
      12.      when = comb.when,
        13. 
-
      13.      merge = comb.merge,
        14. 
-
      14.      toArray = comb.array.toArray,
        15. 
-
      15.      ModelError = require("./errors").ModelError,
        16. 
-
      16.      plugins = require("./plugins"),
        17. 
-
      17.      isUndefinedOrNull = comb.isUndefinedOrNull,
        18. 
-
      18.      AssociationPlugin = plugins.AssociationPlugin,
        19. 
-
      19.      QueryPlugin = plugins.QueryPlugin,
        20. 
+
      20.      isFunction = comb.isFunction,
        21. 
+
      21.      isInstanceOf = comb.isInstanceOf,
        22. 
 
      22.      Promise = comb.Promise,
        23. 
 
      23.      PromiseList = comb.PromiseList,
        24. 
-
      24.      HashTable = comb.collections.HashTable,
        25. 
 
      25.      hitch = comb.hitch,
        26. 
-
      26.      hitchIgnore = comb.hitchIgnore,
        27. 
+
      27.      array = comb.array,
        28. 
+
      28.      isArray = comb.isArray,
        29. 
 
      29.      Middleware = comb.plugins.Middleware,
        30. 
-
      30.      EventEmitter = require("events").EventEmitter,
        31. 
-
      31.      util = require("util"),
        32. 
-
      32.      define = comb.define,
        33. 
-
      33.      patio;
        34. 
-
      34.  
        35. 
-
      35.  
        36. 
-
      36. 1var MODELS = new HashTable();
        37. 
+
      37.      PatioError = require("../errors").PatioError;
        38. 
 
      38.  
        39. 
-
      39. 1var applyColumnTransformMethod = function (val, meth) {
        40. 
-
      40. 11464    return !isUndefinedOrNull(meth) ? isFunction(val[meth]) ? val[meth] : isFunction(comb[meth]) ? comb[meth](val) : val : val;
        41. 
+
      41. 1var fetch = {
        42. 
+
      42.      LAZY:"lazy",
        43. 
+
      43.      EAGER:"eager"
        44. 
 
      44.  };
        45. 
 
      45.  
        46. 
-
      46. 1var checkAndTransformName = function (name) {
        47. 
-
      47. 10693    return isString(name) ? applyColumnTransformMethod(name, Model.camelize === true ? "camelize" : Model.underscore === true ? "underscore" : null) : name;
        48. 
-
      48.  };
        49. 
 
      49.  
        50. 
-
      50. 1var Model = define([QueryPlugin, Middleware], {
        51. 
+
      51.  /**
        52. 
+
      52.   * @class
        53. 
+
      53.   * Base class for all associations.
        54. 
+
      54.   *
        55. 
+
      55.   * </br>
        56. 
+
      56.   * <b>NOT to be instantiated directly</b>
        57. 
+
      57.   * Its just documented for reference.
        58. 
+
      58.   *
        59. 
+
      59.   * @constructs
        60. 
+
      60.   * @param {Object} options
        61. 
+
      61.   * @param {String} options.model a string to look up the model that we are associated with
        62. 
+
      62.   * @param {Function} options.filter  a callback to find association if a filter is defined then
        63. 
+
      63.   *                                    the association is read only
        64. 
+
      64.   * @param {Object} options.key object with left key and right key
        65. 
+
      65.   * @param {String|Object} options.orderBy<String|Object> - how to order our association @see Dataset.order
        66. 
+
      66.   * @param {fetch.EAGER|fetch.LAZY} options.fetchType the fetch type of the model if fetch.Eager is supplied then
        67. 
+
      67.   *                                    the associations are automatically filled, if fetch.Lazy is supplied
        68. 
+
      68.   *                                    then a promise is returned and is called back with the loaded models
        69. 
+
      69.   * @property {Model} model the model associatied with this association.
        70. 
+
      70.   * @name Association
        71. 
+
      71.   * @memberOf patio.associations
        72. 
+
      72.   * */
        73. 
+
      73. 1define(Middleware, {
        74. 
 
      74.      instance:{
        75. 
+
      75.          /**@lends patio.associations.Association.prototype*/
        76. 
+
      76.  
        77. 
+
      77.          type:"",
        78. 
+
      78.  
        79. 
+
      79.          //Our associated model
        80. 
+
      80.          _model:null,
        81. 
+
      81.  
        82. 
 
      82.          /**
        83. 
-
      83.           * @lends patio.Model.prototype
        84. 
+
      84.           * Fetch type
        85. 
 
      85.           */
        86. 
+
      86.          fetchType:fetch.LAZY,
        87. 
 
      87.  
        88. 
-
      88.          __ignore:false,
        89. 
+
      89.          /**how to order our association*/
        90. 
+
      90.          orderBy:null,
        91. 
 
      91.  
        92. 
-
      92.          __changed:null,
        93. 
+
      93.          /**Our filter method*/
        94. 
+
      94.          filter:null,
        95. 
 
      95.  
        96. 
-
      96.          __values:null,
        97. 
+
      97.          __hooks:null,
        98. 
 
      98.  
        99. 
-
      99.          /**
        100. 
-
      100.           * patio  - read only
        101. 
-
      101.           *
        102. 
-
      102.           * @type patio
        103. 
-
      103.           */
        104. 
-
      104.          patio:null,
        105. 
+
      105.          isOwner:true,
        106. 
+
      106.  
        107. 
+
      107.          createSetter:true,
        108. 
+
      108.  
        109. 
+
      109.          isCascading:false,
        110. 
+
      110.  
        111. 
+
      111.          supportsStringKey:true,
        112. 
+
      112.  
        113. 
+
      113.          supportsHashKey:true,
        114. 
+
      114.  
        115. 
+
      115.          supportsCompositeKey:true,
        116. 
+
      116.  
        117. 
+
      117.          supportsLeftAndRightKey:true,
        118. 
 
      118.  
        119. 
 
      119.          /**
        120. 
-
      120.           * The database type such as mysql
        121. 
-
      121.           *
        122. 
-
      122.           * @type String
        123. 
 
      123.           *
        124. 
-
      124.           * */
        125. 
-
      125.          type:null,
        126. 
+
      126.           *Method to call to look up association,
        127. 
+
      127.           *called after the model has been filtered
        128. 
+
      128.           **/
        129. 
+
      129.          _fetchMethod:"all",
        130. 
 
      130.  
        131. 
-
      131.          /**
        132. 
-
      132.           * Whether or not this model is new
        133. 
-
      133.           * */
        134. 
-
      134.          __isNew:true,
        135. 
 
      135.  
        136. 
-
      136.          /**
        137. 
-
      137.           * Signifies if the model has changed
        138. 
-
      138.           * */
        139. 
-
      139.          __isChanged:false,
        140. 
+
      140.          constructor:function (options, patio, filter) {
        141. 
+
      141. 55            options = options || {};
        142. 
+
      142. 55            if (!options.model) {
        143. 
+
      143. 0                throw new Error("Model is required for " + this.type + " association");
        144. 
+
      144.              }
        145. 
+
      145. 55            this._model = options.model;
        146. 
+
      146. 55            this.patio = patio;
        147. 
+
      147. 55            this.__opts = options;
        148. 
+
      148. 55            !isUndefined(options.isCascading) && (this.isCascading = options.isCascading);
        149. 
+
      149. 55            this.filter = filter;
        150. 
+
      150. 55            this.readOnly = isBoolean(options.readOnly) ? options.readOnly : false;
        151. 
+
      151. 55            this.__hooks =
        152. 
+
      152.              {before:{add:null, remove:null, "set":null, load:null}, after:{add:null, remove:null, "set":null, load:null}};
        153. 
+
      153. 55            var hooks = ["Add", "Remove", "Set", "Load"];
        154. 
+
      154. 55            ["before", "after"].forEach(function (h) {
        155. 
+
      155. 110                hooks.forEach(function (a) {
        156. 
+
      156. 440                    var hookName = h + a, hook;
        157. 
+
      157. 440                    if (isFunction((hook = options[hookName]))) {
        158. 
+
      158. 0                        this.__hooks[h][a.toLowerCase()] = hook;
        159. 
+
      159.                      }
        160. 
+
      160.                  }, this);
        161. 
+
      161.              }, this);
        162. 
+
      162. 55            this.fetchType = options.fetchType || fetch.LAZY;
        163. 
+
      163.          },
        164. 
+
      164.  
        165. 
+
      165.          _callHook:function (hook, action, args) {
        166. 
+
      166. 0            var func = this.__hooks[hook][action], ret;
        167. 
+
      167. 0            if (isFunction(func)) {
        168. 
+
      168. 0                ret = func.apply(this, args);
        169. 
+
      169.              }
        170. 
+
      170. 0            return ret;
        171. 
+
      171.          },
        172. 
+
      172.  
        173. 
+
      173.          _clearAssociations:function (model) {
        174. 
+
      174. 125            if (!this.readOnly) {
        175. 
+
      175. 125                delete model.__associations[this.name];
        176. 
+
      176.              }
        177. 
+
      177.          },
        178. 
+
      178.  
        179. 
+
      179.          _forceReloadAssociations:function (model) {
        180. 
+
      180. 243            if (!this.readOnly) {
        181. 
+
      181. 243                delete model.__associations[this.name];
        182. 
+
      182. 243                return model[this.name];
        183. 
+
      183.              }
        184. 
+
      184.          },
        185. 
 
      185.  
        186. 
 
      186.          /**
        187. 
-
      187.           * Base class for all models.
        188. 
-
      188.           * <p>This is used through {@link patio.addModel}, <b>NOT directly.</b></p>
        189. 
-
      189.           *
        190. 
-
      190.           * @constructs
        191. 
-
      191.           * @augments comb.plugins.Middleware
        192. 
-
      192.           *
        193. 
-
      193.           * @param {Object} columnValues values of each column to be used by this Model.
        194. 
-
      194.           *
        195. 
-
      195.           * @property {patio.Dataset} dataset a dataset to use to retrieve models from the database. The dataset
        196. 
-
      196.           *                          has the {@link patio.Dataset#rowCb} set to create instances of this model.
        197. 
-
      197.           * @property {String[]} columns a list of columns this models table contains.
        198. 
-
      198.           * @property {Object} schema the schema of this models table.
        199. 
-
      199.           * @property {String} tableName the table name of this models table.
        200. 
-
      200.           * @property {*} primaryKeyValue the value of this models primaryKey
        201. 
-
      201.           * @property {Boolean} isNew true if this model is new and does not exist in the database.
        202. 
-
      202.           * @property {Boolean} isChanged true if the model has been changed and not saved.
        203. 
-
      203.           *
        204. 
-
      204.           * @borrows patio.Dataset#all as all
        205. 
-
      205.           * @borrows patio.Dataset#one as one
        206. 
-
      206.           * @borrows patio.Dataset#avg as avg
        207. 
-
      207.           * @borrows patio.Dataset#count as count
        208. 
-
      208.           * @borrows patio.Dataset#columns as columns
        209. 
-
      209.           * @borrows patio.Dataset#forEach as forEach
        210. 
-
      210.           * @borrows patio.Dataset#isEmpty as empty
        211. 
-
      211.           * @borrows patio.Dataset#first as first
        212. 
-
      212.           * @borrows patio.Dataset#get as get
        213. 
-
      213.           * @borrows patio.Dataset#import as import
        214. 
-
      214.           * @borrows patio.Dataset#insert as insert
        215. 
-
      215.           * @borrows patio.Dataset#insertMultiple as insertMultiple
        216. 
-
      216.           * @borrows patio.Dataset#saveMultiple as saveMultiple
        217. 
-
      217.           * @borrows patio.Dataset#interval as interval
        218. 
-
      218.           * @borrows patio.Dataset#last as last
        219. 
-
      219.           * @borrows patio.Dataset#map as map
        220. 
-
      220.           * @borrows patio.Dataset#max as max
        221. 
-
      221.           * @borrows patio.Dataset#min as min
        222. 
-
      222.           * @borrows patio.Dataset#multiInsert as multiInsert
        223. 
-
      223.           * @borrows patio.Dataset#range as range
        224. 
-
      224.           * @borrows patio.Dataset#selectHash as selectHash
        225. 
-
      225.           * @borrows patio.Dataset#selectMap as selectMap
        226. 
-
      226.           * @borrows patio.Dataset#selectOrderMap as selectOrderMap
        227. 
-
      227.           * @borrows patio.Dataset#set as set
        228. 
-
      228.           * @borrows patio.Dataset#singleRecord as singleRecord
        229. 
-
      229.           * @borrows patio.Dataset#singleValue as singleValue
        230. 
-
      230.           * @borrows patio.Dataset#sum as sum
        231. 
-
      231.           * @borrows patio.Dataset#toCsv as toCsv
        232. 
-
      232.           * @borrows patio.Dataset#toHash as toHash
        233. 
-
      233.           * @borrows patio.Dataset#truncate as truncate
        234. 
-
      234.           * @borrows patio.Dataset#addGraphAliases as addGraphAliases
        235. 
-
      235.           * @borrows patio.Dataset#and as and
        236. 
-
      236.           * @borrows patio.Dataset#distinct as distinct
        237. 
-
      237.           * @borrows patio.Dataset#except as except
        238. 
-
      238.           * @borrows patio.Dataset#exclude as exclude
        239. 
-
      239.           * @borrows patio.Dataset#is as is
        240. 
-
      240.           * @borrows patio.Dataset#isNot as isNot
        241. 
-
      241.           * @borrows patio.Dataset#eq as eq
        242. 
-
      242.           * @borrows patio.Dataset#neq as neq
        243. 
-
      243.           * @borrows patio.Dataset#lt as lt
        244. 
-
      244.           * @borrows patio.Dataset#lte as lte
        245. 
-
      245.           * @borrows patio.Dataset#gt as gt
        246. 
-
      246.           * @borrows patio.Dataset#gte as gte
        247. 
-
      247.           * @borrows patio.Dataset#forUpdate as forUpdate
        248. 
-
      248.           * @borrows patio.Dataset#from as from
        249. 
-
      249.           * @borrows patio.Dataset#fromSelf as fromSelf
        250. 
-
      250.           * @borrows patio.Dataset#graph as graph
        251. 
-
      251.           * @borrows patio.Dataset#grep as grep
        252. 
-
      252.           * @borrows patio.Dataset#group as group
        253. 
-
      253.           * @borrows patio.Dataset#groupAndCount as groupAndCount
        254. 
-
      254.           * @borrows patio.Dataset#groupBy as groupBy
        255. 
-
      255.           * @borrows patio.Dataset#having as having
        256. 
-
      256.           * @borrows patio.Dataset#intersect as intersect
        257. 
-
      257.           * @borrows patio.Dataset#invert as invert
        258. 
-
      258.           * @borrows patio.Dataset#limit as limit
        259. 
-
      259.           * @borrows patio.Dataset#lockStyle as lockStyle
        260. 
-
      260.           * @borrows patio.Dataset#naked as naked
        261. 
-
      261.           * @borrows patio.Dataset#or as or
        262. 
-
      262.           * @borrows patio.Dataset#order as order
        263. 
-
      263.           * @borrows patio.Dataset#orderAppend as orderAppend
        264. 
-
      264.           * @borrows patio.Dataset#orderBy as orderBy
        265. 
-
      265.           * @borrows patio.Dataset#orderMore as orderMore
        266. 
-
      266.           * @borrows patio.Dataset#orderPrepend as orderPrepend
        267. 
-
      267.           * @borrows patio.Dataset#qualify as qualify
        268. 
-
      268.           * @borrows patio.Dataset#reverse as reverse
        269. 
-
      269.           * @borrows patio.Dataset#reverseOrder as reverseOrder
        270. 
-
      270.           * @borrows patio.Dataset#select as select
        271. 
-
      271.           * @borrows patio.Dataset#selectAll as selectAll
        272. 
-
      272.           * @borrows patio.Dataset#selectAppend as selectAppend
        273. 
-
      273.           * @borrows patio.Dataset#selectMore as selectMore
        274. 
-
      274.           * @borrows patio.Dataset#setDefaults as setDefaults
        275. 
-
      275.           * @borrows patio.Dataset#setGraphAliases as setGraphAliases
        276. 
-
      276.           * @borrows patio.Dataset#setOverrides as setOverrides
        277. 
-
      277.           * @borrows patio.Dataset#unfiltered as unfiltered
        278. 
-
      278.           * @borrows patio.Dataset#ungraphed as ungraphed
        279. 
-
      279.           * @borrows patio.Dataset#ungrouped as ungrouped
        280. 
-
      280.           * @borrows patio.Dataset#union as union
        281. 
-
      281.           * @borrows patio.Dataset#unlimited as unlimited
        282. 
-
      282.           * @borrows patio.Dataset#unordered as unordered
        283. 
-
      283.           * @borrows patio.Dataset#where as where
        284. 
-
      284.           * @borrows patio.Dataset#with as with
        285. 
-
      285.           * @borrows patio.Dataset#withRecursive as withRecursive
        286. 
-
      286.           * @borrows patio.Dataset#withSql as withSql
        287. 
-
      287.           * @borrows patio.Dataset#naturalJoin as naturalJoin
        288. 
-
      288.           * @borrows patio.Dataset#naturalLeftJoin as naturalLeftJoin
        289. 
-
      289.           * @borrows patio.Dataset#naturalRightJoin as naturalRightJoin
        290. 
-
      290.           * @borrows patio.Dataset#naturalFullJoin as naturalFullJoin
        291. 
-
      291.           * @borrows patio.Dataset#crossJoin as crossJoin
        292. 
-
      292.           * @borrows patio.Dataset#innerJoin as innerJoin
        293. 
-
      293.           * @borrows patio.Dataset#fullOuterJoin as fullOuterJoin
        294. 
-
      294.           * @borrows patio.Dataset#rightOuterJoin as rightOuterJoin
        295. 
-
      295.           * @borrows patio.Dataset#leftOuterJoin as leftOuterJoin
        296. 
-
      296.           * @borrows patio.Dataset#fullJoin as fullJoin
        297. 
-
      297.           * @borrows patio.Dataset#rightJoin as rightJoin
        298. 
-
      298.           * @borrows patio.Dataset#leftJoin as leftJoin
        299. 
-
      299.           * */
        300. 
-
      300.          constructor:function (options, fromDb) {
        301. 
-
      301. 3111            if (this.synced) {
        302. 
-
      302. 3111                this.__emitter = new EventEmitter();
        303. 
-
      303. 3111                this._super(arguments);
        304. 
-
      304. 3111                this.patio = patio || require("./index");
        305. 
-
      305. 3111                fromDb = isBoolean(fromDb) ? fromDb : false;
        306. 
-
      306. 3111                this.__changed = {};
        307. 
-
      307. 3111                this.__values = {};
        308. 
-
      308. 3111                if (fromDb) {
        309. 
-
      309. 1754                    this._hook("pre", "load");
        310. 
-
      310. 1754                    this.__isNew = false;
        311. 
-
      311. 1754                    this.__setFromDb(options, true);
        312. 
-
      312. 1754                    if (this._static.emitOnLoad) {
        313. 
-
      313. 1754                        this.emit("load", this);
        314. 
-
      314. 1754                        this._static.emit("load", this);
        315. 
-
      315.                      }
        316. 
-
      316.                  } else {
        317. 
-
      317. 1357                    this.__isNew = true;
        318. 
-
      318. 1357                    this.__set(options);
        319. 
-
      319.                  }
        320. 
-
      320.              } else {
        321. 
-
      321. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
        322. 
-
      322.              }
        323. 
+
      323.           * @return {Boolean} true if the association is eager.
        324. 
+
      324.           */
        325. 
+
      325.          isEager:function () {
        326. 
+
      326. 2114            return this.fetchType == fetch.EAGER;
        327. 
 
      327.          },
        328. 
 
      328.  
        329. 
-
      329.          __set:function (values, ignore) {
        330. 
-
      330. 1479            values = values || {};
        331. 
-
      331. 1479            this.__ignore = ignore === true;
        332. 
-
      332. 1479            Object.keys(values).forEach(function (attribute) {
        333. 
-
      333. 6632                var value = values[attribute];
        334. 
-
      334.                  //check if the column is a constrained value and is allowed to be set
        335. 
-
      335. 6632                !ignore && this._checkIfColumnIsConstrained(attribute);
        336. 
-
      336. 6632                this[attribute] = value;
        337. 
-
      337.              }, this);
        338. 
-
      338. 1479            this.__ignore = false;
        339. 
+
      339.          _checkAssociationKey:function (parent) {
        340. 
+
      340. 785            var q = {};
        341. 
+
      341. 785            this._setAssociationKeys(parent, q);
        342. 
+
      342. 785            return Object.keys(q).every(function (k) {
        343. 
+
      343. 785                return q[k] != null
        344. 
+
      344.              });
        345. 
 
      345.          },
        346. 
 
      346.  
        347. 
-
      347.          __setFromDb:function (values, ignore) {
        348. 
-
      348. 3057            values = values || {};
        349. 
-
      349. 3057            this.__ignore = ignore === true;
        350. 
-
      350. 3057            var schema = this.schema;
        351. 
-
      351. 3057            Object.keys(values).forEach(function (column) {
        352. 
-
      352. 25150                var value = values[column];
        353. 
-
      353.                  // Typecast value retrieved from db
        354. 
-
      354. 25150                if (schema.hasOwnProperty(column)) {
        355. 
-
      355. 25149                    this.__values[column] = this._typeCastValue(column, value, ignore);
        356. 
-
      356.                  } else {
        357. 
-
      357. 1                    console.log(column);
        358. 
-
      358. 1                    this[column] = value;
        359. 
+
      359.          _getAssociationKey:function () {
        360. 
+
      360. 5205            var options = this.__opts, key, ret = [], lk, rk;
        361. 
+
      361. 5205            if (!isUndefinedOrNull((key = options.key))) {
        362. 
+
      362. 722                if (this.supportsStringKey && isString(key)) {
        363. 
+
      363.                      //normalize the key first!
        364. 
+
      364. 356                    ret = [
        365. 
+
      365.                          [this.isOwner ? this.defaultLeftKey : key],
        366. 
+
      366.                          [this.isOwner ? key : this.defaultRightKey]
        367. 
+
      367.                      ];
        368. 
+
      368. 366                } else if (this.supportsHashKey && isHash(key)) {
        369. 
+
      369. 366                    var leftKey = Object.keys(key)[0];
        370. 
+
      370. 366                    var rightKey = key[leftKey];
        371. 
+
      371. 366                    ret = [
        372. 
+
      372.                          [leftKey],
        373. 
+
      373.                          [rightKey]
        374. 
+
      374.                      ];
        375. 
+
      375. 0                } else if (this.supportsCompositeKey && isArray(key)) {
        376. 
+
      376. 0                    ret = [
        377. 
+
      377.                          [key],
        378. 
+
      378.                          null
        379. 
+
      379.                      ];
        380. 
 
      380.                  }
        381. 
-
      381.              }, this);
        382. 
-
      382. 3057            this.__ignore = false;
        383. 
-
      383.  
        384. 
+
      384. 4483            } else if (this.supportsLeftAndRightKey && (!isUndefinedOrNull((lk = options.leftKey))
        385. 
+
      385.                  && !isUndefinedOrNull((rk = options.rightKey)))) {
        386. 
+
      386. 140                ret = [
        387. 
+
      387.                      array.toArray(lk), array.toArray(rk)
        388. 
+
      388.                  ];
        389. 
+
      389.              } else {
        390. 
+
      390.                  //todo handle composite primary keys
        391. 
+
      391. 4343                ret = [
        392. 
+
      392.                      [this.defaultLeftKey],
        393. 
+
      393.                      [this.defaultRightKey]
        394. 
+
      394.                  ];
        395. 
+
      395.              }
        396. 
+
      396. 5205            return ret;
        397. 
 
      397.          },
        398. 
 
      398.  
        399. 
-
      399.          /**
        400. 
-
      400.           * Set multiple values at once. Useful if you have a hash of properties that you want to set.
        401. 
-
      401.           *
        402. 
-
      402.           * <b>NOTE:</b> This method will use the static restrictedColumns property of the model.
        403. 
-
      403.           *
        404. 
-
      404.           * @example
        405. 
-
      405.           *
        406. 
-
      406.           * myModel.setValues({firstName : "Bob", lastName : "yukon"});
        407. 
-
      407.           *
        408. 
-
      408.           * //this will throw an error by default, assuming id is a pk.
        409. 
-
      409.           * myModel.setValues({id : 1, firstName : "Bob", lastName : "yukon"});
        410. 
-
      410.           *
        411. 
-
      411.           * @param {Object} values value to set on the model.
        412. 
-
      412.           *
        413. 
-
      413.           * @return {patio.Model} return this for chaining.
        414. 
-
      414.           */
        415. 
-
      415.          setValues:function (values) {
        416. 
-
      416. 17            this.__set(values, false);
        417. 
-
      417. 17            return this;
        418. 
-
      418.          },
        419. 
 
      419.  
        420. 
-
      420.          _toObject:function () {
        421. 
-
      421. 1124            if (this.synced) {
        422. 
-
      422. 1124                var columns = this._static.columns, ret = {};
        423. 
-
      423. 1124                for (var i in columns) {
        424. 
-
      424. 10220                    var col = columns[i];
        425. 
-
      425. 10220                    var val = this.__values[col];
        426. 
-
      426. 10220                    if (!isUndefined(val)) {
        427. 
-
      427. 6169                        ret[col] = val;
        428. 
-
      428.                      }
        429. 
+
      429.          _setAssociationKeys:function (parent, model, val) {
        430. 
+
      430. 1573            var keys = this._getAssociationKey(parent), leftKey = keys[0], rightKey = keys[1];
        431. 
+
      431. 1573            if (leftKey && rightKey) {
        432. 
+
      432. 1573                for (var i = 0; i < leftKey.length; i++) {
        433. 
+
      433. 1573                    model[rightKey[i]] = !isUndefined(val) ? val : parent[leftKey[i]];
        434. 
 
      434.                  }
        435. 
-
      435. 1124                return ret;
        436. 
 
      436.              } else {
        437. 
-
      437. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
        438. 
+
      438. 0                leftKey.forEach(function (k) {
        439. 
+
      439. 0                    model[k] = !isUndefined(val) ? val : parent[k];
        440. 
+
      440.                  });
        441. 
 
      441.              }
        442. 
 
      442.          },
        443. 
 
      443.  
        444. 
-
      444.          _addColumnToIsChanged:function (name, val) {
        445. 
-
      445. 7556            if (!this.isNew && !this.__ignore) {
        446. 
-
      446. 165                this.__isChanged = true;
        447. 
-
      447. 165                this.__changed[name] = val;
        448. 
+
      448.          _setDatasetOptions:function (ds) {
        449. 
+
      449. 974            var options = this.__opts || {};
        450. 
+
      450. 974            var order, limit, distinct, select, query;
        451. 
+
      451.              //allow for multi key ordering
        452. 
+
      452. 974            if (!isUndefined((select = this.select))) {
        453. 
+
      453. 0                ds = ds.select.apply(ds, array.toArray(select));
        454. 
 
      454.              }
        455. 
-
      455.          },
        456. 
-
      456.  
        457. 
-
      457.          _checkIfColumnIsConstrained:function (name) {
        458. 
-
      458. 6632            if (this.synced && !this.__ignore) {
        459. 
-
      459. 6632                var col = this.schema[name], restrictedCols = this._static.restrictedColumns || [];
        460. 
-
      460. 6632                if (!isUndefined(col) && (col.primaryKey && this._static.isRestrictedPrimaryKey) || restrictedCols.indexOf(name) != -1) {
        461. 
-
      461. 0                    throw new ModelError("Cannot set primary key of model " + this._static.tableName);
        462. 
+
      462. 974            if (!isUndefined((query = options.query)) || !isUndefined((query = options.conditions))) {
        463. 
+
      463. 0                ds = ds.filter(query);
        464. 
+
      464.              }
        465. 
+
      465. 974            if (isFunction(this.filter)) {
        466. 
+
      466. 334                var ret = this.filter.apply(this, [ds]);
        467. 
+
      467. 334                if (isInstanceOf(ret, ds._static)) {
        468. 
+
      468. 334                    ds = ret;
        469. 
 
      469.                  }
        470. 
 
      470.              }
        471. 
-
      471.          },
        472. 
-
      472.  
        473. 
-
      473.          _getColumnValue:function (name) {
        474. 
-
      474. 5427            var val = this.__values[name];
        475. 
-
      475. 5427            var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
        476. 
-
      476. 5427            var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
        477. 
+
      477. 974            if (!isUndefined((distinct = options.distinct))) {
        478. 
+
      478. 0                ds = ds.limit.apply(ds, array.toArray(distinct));
        479. 
+
      479.              }
        480. 
+
      480. 974            if (!isUndefined((order = options.orderBy)) || !isUndefined((order = options.order))) {
        481. 
+
      481. 0                ds = ds.order.apply(ds, array.toArray(order));
        482. 
+
      482.              }
        483. 
+
      483. 974            if (!isUndefined((limit = options.limit))) {
        484. 
+
      484. 0                ds = ds.limit.apply(ds, array.toArray(limit));
        485. 
+
      485.              }
        486. 
+
      486. 974            return ds;
        487. 
 
      487.  
        488. 
-
      488. 5427            return columnValue;
        489. 
 
      489.          },
        490. 
 
      490.  
        491. 
-
      491.          _setColumnValue:function (name, val) {
        492. 
-
      492. 7556            var ignore = this.__ignore;
        493. 
-
      493. 7556            val = this._typeCastValue(name, val, ignore);
        494. 
-
      494. 7556            this._addColumnToIsChanged(name, val);
        495. 
-
      495. 7556            var setterFunc = this["_set" + name.charAt(0).toUpperCase() + name.substr(1)];
        496. 
-
      496. 7556            var columnValue = isFunction(setterFunc) ? setterFunc.call(this, val, ignore) : val;
        497. 
-
      497. 7556            this.__values[name] = columnValue;
        498. 
-
      498. 7556            if (this._static.emitOnColumnSet) {
        499. 
-
      499. 7556                this.emit("column", name, columnValue, ignore);
        500. 
+
      500.          /**
        501. 
+
      501.           *Filters our associated dataset to load our association.
        502. 
+
      502.           *
        503. 
+
      503.           *@return {Dataset} the dataset with all filters applied.
        504. 
+
      504.           **/
        505. 
+
      505.          _filter:function (parent) {
        506. 
+
      506. 648            var options = this.__opts || {};
        507. 
+
      507. 648            var ds;
        508. 
+
      508. 648            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
        509. 
+
      509. 0                ds = ds.apply(parent, [parent]);
        510. 
+
      510.              }
        511. 
+
      511. 648            if (!ds) {
        512. 
+
      512. 648                var q = {};
        513. 
+
      513. 648                this._setAssociationKeys(parent, q);
        514. 
+
      514. 648                ds = this.model.dataset.naked().filter(q);
        515. 
+
      515. 648                var recip = this.model._findAssociation(this);
        516. 
+
      516. 648                recip && (recip = recip[1]);
        517. 
+
      517. 648                ds.rowCb = hitch(this, function (item) {
        518. 
+
      518. 489                    var ret = new Promise();
        519. 
+
      519. 489                    var model = this._toModel(item, true);
        520. 
+
      520. 489                    recip && recip.__setValue(model, parent);
        521. 
+
      521.                      //call hook to finish other model associations
        522. 
+
      522. 489                    model._hook("post", "load").then(hitch(this, function () {
        523. 
+
      523. 489                        ret.callback(model);
        524. 
+
      524.                      }), ret);
        525. 
+
      525. 489                    return ret.promise();
        526. 
+
      526.                  });
        527. 
 
      527.              }
        528. 
+
      528.  
        529. 
+
      529. 648            return this._setDatasetOptions(ds);
        530. 
 
      530.          },
        531. 
 
      531.  
        532. 
+
      532.          __setValue:function (parent, model) {
        533. 
+
      533. 2061            parent.__associations[this.name] = this._fetchMethod
        534. 
+
      534.                  == "all" ? !isArray(model) ? [model] : model : isArray(model) ? model[0] : model;
        535. 
+
      535. 2061            return parent.__associations[this.name];
        536. 
+
      536.          },
        537. 
 
      537.  
        538. 
-
      538.          //Typecast the value to the column's type if typecasting.  Calls the database's
        539. 
-
      539.          //typecast_value method, so database adapters can override/augment the handling
        540. 
-
      540.          //for database specific column types.
        541. 
-
      541.          _typeCastValue:function (column, value, fromDatabase) {
        542. 
-
      542. 32705            var colSchema, clazz = this._static;
        543. 
-
      543. 32705            if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
        544. 
-
      544. 32705                var type = colSchema.type;
        545. 
-
      545. 32705                if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
        546. 
-
      546. 3                    value = null;
        547. 
-
      547.                  }
        548. 
-
      548. 32705                var raiseOnError = clazz.raiseOnTypecastError;
        549. 
-
      549. 32705                if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
        550. 
-
      550. 0                    throw new ModelError("null is not allowed for the " + column + " column.");
        551. 
-
      551.                  }
        552. 
-
      552. 32705                try {
        553. 
-
      553. 32705                    value = clazz.db.typecastValue(type, value);
        554. 
-
      554.                  } catch (e) {
        555. 
-
      555. 0                    if (raiseOnError === true) {
        556. 
-
      556. 0                        throw e;
        557. 
-
      557.                      }
        558. 
-
      558.                  }
        559. 
+
      559.          fetch:function (parent) {
        560. 
+
      560. 785            var ret = new Promise();
        561. 
+
      561. 785            if (this._checkAssociationKey(parent)) {
        562. 
+
      562. 733                this._filter(parent)[this._fetchMethod]().then(hitch(this, function (result) {
        563. 
+
      563. 733                    this.__setValue(parent, result);
        564. 
+
      564. 733                    ret.callback(result);
        565. 
+
      565. 733                    parent = null;
        566. 
+
      566.                  }), ret);
        567. 
+
      567.              } else {
        568. 
+
      568. 52                this.__setValue(parent, null);
        569. 
+
      569. 52                ret.callback(null);
        570. 
 
      570.              }
        571. 
-
      571. 32705            return value;
        572. 
+
      572. 785            return ret;
        573. 
 
      573.          },
        574. 
 
      574.  
        575. 
 
      575.          /**
        576. 
-
      576.           * Convert this model to an object, containing column, value pairs.
        577. 
-
      577.           *
        578. 
-
      578.           * @return {Object} the object version of this model.
        579. 
-
      579.           **/
        580. 
-
      580.          toObject:function () {
        581. 
-
      581. 0            return this._toObject(false);
        582. 
+
      582.           * Middleware called before a model is removed.
        583. 
+
      583.           * </br>
        584. 
+
      584.           * <b> This is called in the scope of the model</b>
        585. 
+
      585.           * @param {Function} next function to pass control up the middleware stack.
        586. 
+
      586.           * @param {_Association} self reference to the Association that is being acted up.
        587. 
+
      587.           */
        588. 
+
      588.          _preRemove:function (next, model) {
        589. 
+
      589. 223            if (this.isOwner && !this.isCascading) {
        590. 
+
      590. 46                var q = {};
        591. 
+
      591. 46                this._setAssociationKeys(model, q, null);
        592. 
+
      592. 46                model[this.associatedDatasetName].update(q).classic(next);
        593. 
+
      593.              } else {
        594. 
+
      594. 177                next();
        595. 
+
      595.              }
        596. 
 
      596.          },
        597. 
 
      597.  
        598. 
 
      598.          /**
        599. 
-
      599.           * Convert this model to JSON, containing column, value pairs.
        600. 
-
      600.           *
        601. 
-
      601.           * @return {JSON} the JSON version of this model.
        602. 
-
      602.           **/
        603. 
-
      603.          toJSON:function () {
        604. 
-
      604. 0            return this.toObject();
        605. 
+
      605.           * Middleware called aft era model is removed.
        606. 
+
      606.           * </br>
        607. 
+
      607.           * <b> This is called in the scope of the model</b>
        608. 
+
      608.           * @param {Function} next function to pass control up the middleware stack.
        609. 
+
      609.           * @param {_Association} self reference to the Association that is being called.
        610. 
+
      610.           */
        611. 
+
      611.          _postRemove:function (next, model) {
        612. 
+
      612. 514            next();
        613. 
 
      613.          },
        614. 
 
      614.  
        615. 
 
      615.          /**
        616. 
-
      616.           * Convert this model to a string, containing column, value pairs.
        617. 
-
      617.           *
        618. 
-
      618.           * @return {String} the string version of this model.
        619. 
-
      619.           **/
        620. 
-
      620.          toString:function () {
        621. 
-
      621. 0            return JSON.stringify(this.toObject(), null, 4);
        622. 
+
      622.           * Middleware called before a model is saved.
        623. 
+
      623.           * </br>
        624. 
+
      624.           * <b> This is called in the scope of the model</b>
        625. 
+
      625.           * @param {Function} next function to pass control up the middleware stack.
        626. 
+
      626.           * @param {_Association} self reference to the Association that is being called.
        627. 
+
      627.           */
        628. 
+
      628.          _preSave:function (next, model) {
        629. 
+
      629. 324            next();
        630. 
 
      630.          },
        631. 
 
      631.  
        632. 
 
      632.          /**
        633. 
-
      633.           * Convert this model to a string, containing column, value pairs.
        634. 
-
      634.           *
        635. 
-
      635.           * @return {String} the string version of this model.
        636. 
-
      636.           **/
        637. 
-
      637.          valueOf:function () {
        638. 
-
      638. 0            return this.toObject();
        639. 
+
      639.           * Middleware called after a model is saved.
        640. 
+
      640.           * </br>
        641. 
+
      641.           * <b> This is called in the scope of the model</b>
        642. 
+
      642.           * @param {Function} next function to pass control up the middleware stack.
        643. 
+
      643.           * @param {_Association} self reference to the Association that is being called.
        644. 
+
      644.           */
        645. 
+
      645.          _postSave:function (next, model) {
        646. 
+
      646. 198            next();
        647. 
 
      647.          },
        648. 
 
      648.  
        649. 
-
      649.          _checkTransaction:function (options, cb) {
        650. 
-
      650. 2493            return this._static._checkTransaction(options, cb);
        651. 
+
      651.          /**
        652. 
+
      652.           * Middleware called before a model is updated.
        653. 
+
      653.           * </br>
        654. 
+
      654.           * <b> This is called in the scope of the model</b>
        655. 
+
      655.           * @param {Function} next function to pass control up the middleware stack.
        656. 
+
      656.           * @param {_Association} self reference to the Association that is being called.
        657. 
+
      657.           */
        658. 
+
      658.          _preUpdate:function (next, model) {
        659. 
+
      659. 2            next();
        660. 
 
      660.          },
        661. 
 
      661.  
        662. 
-
      662.          addListener:function () {
        663. 
-
      663. 0            var emitter = this.__emitter;
        664. 
-
      664. 0            return emitter.addListener.apply(emitter, arguments);
        665. 
-
      665.          },
        666. 
-
      666.          on:function () {
        667. 
-
      667. 6            var emitter = this.__emitter;
        668. 
-
      668. 6            return emitter.on.apply(emitter, arguments);
        669. 
-
      669.          },
        670. 
-
      670.          once:function () {
        671. 
-
      671. 0            var emitter = this.__emitter;
        672. 
-
      672. 0            return emitter.once.apply(emitter, arguments);
        673. 
-
      673.          },
        674. 
-
      674.          removeListener:function () {
        675. 
-
      675. 6            var emitter = this.__emitter;
        676. 
-
      676. 6            return emitter.removeListener.apply(emitter, arguments);
        677. 
-
      677.          },
        678. 
-
      678.          removeAllListeners:function () {
        679. 
-
      679. 0            var emitter = this.__emitter;
        680. 
-
      680. 0            return emitter.removeAllListeners.apply(emitter, arguments);
        681. 
+
      681.          /**
        682. 
+
      682.           * Middleware called before a model is updated.
        683. 
+
      683.           * </br>
        684. 
+
      684.           * <b> This is called in the scope of the model</b>
        685. 
+
      685.           * @param {Function} next function to pass control up the middleware stack.
        686. 
+
      686.           * @param {_Association} self reference to the Association that is being called.
        687. 
+
      687.           */
        688. 
+
      688.          _postUpdate:function (next, model) {
        689. 
+
      689. 127            next();
        690. 
 
      690.          },
        691. 
-
      691.          setMaxListeners:function () {
        692. 
-
      692. 0            var emitter = this.__emitter;
        693. 
-
      693. 0            return emitter.setMaxListeners.apply(emitter, arguments);
        694. 
+
      694.  
        695. 
+
      695.          /**
        696. 
+
      696.           * Middleware called before a model is loaded.
        697. 
+
      697.           * </br>
        698. 
+
      698.           * <b> This is called in the scope of the model</b>
        699. 
+
      699.           * @param {Function} next function to pass control up the middleware stack.
        700. 
+
      700.           * @param {_Association} self reference to the Association that is being called.
        701. 
+
      701.           */
        702. 
+
      702.          _preLoad:function (next, model) {
        703. 
+
      703. 1570            next();
        704. 
 
      704.          },
        705. 
-
      705.          listeners:function () {
        706. 
-
      706. 0            var emitter = this.__emitter;
        707. 
-
      707. 0            return emitter.listeners.apply(emitter, arguments);
        708. 
+
      708.  
        709. 
+
      709.          /**
        710. 
+
      710.           * Middleware called after a model is loaded.
        711. 
+
      711.           * </br>
        712. 
+
      712.           * <b> This is called in the scope of the model</b>
        713. 
+
      713.           * @param {Function} next function to pass control up the middleware stack.
        714. 
+
      714.           * @param {_Association} self reference to the Association that is being called.
        715. 
+
      715.           */
        716. 
+
      716.          _postLoad:function (next, model) {
        717. 
+
      717. 0            next();
        718. 
 
      718.          },
        719. 
-
      719.          emit:function () {
        720. 
-
      720. 11120            var emitter = this.__emitter;
        721. 
-
      721. 11120            return emitter.emit.apply(emitter, arguments);
        722. 
+
      722.  
        723. 
+
      723.          /**
        724. 
+
      724.           * Alias used to explicitly set an association on a model.
        725. 
+
      725.           * @param {*} val the value to set the association to
        726. 
+
      726.           * @param {_Association} self reference to the Association that is being called.
        727. 
+
      727.           */
        728. 
+
      728.          _setter:function (val, model) {
        729. 
+
      729. 0            model.__associations[this.name] = val;
        730. 
 
      730.          },
        731. 
 
      731.  
        732. 
+
      732.          associationLoaded:function (model) {
        733. 
+
      733. 2707            return model.__associations.hasOwnProperty(this.name);
        734. 
+
      734.          },
        735. 
 
      735.  
        736. 
-
      736.          getters:{
        737. 
-
      737.              /**@lends patio.Model.prototype*/
        738. 
+
      738.          getAssociation:function (model) {
        739. 
+
      739. 885            return model.__associations[this.name];
        740. 
+
      740.          },
        741. 
 
      741.  
        742. 
-
      742.              /*Returns my actual primary key value*/
        743. 
-
      743.              primaryKeyValue:function () {
        744. 
-
      744. 47                return this[this.primaryKey];
        745. 
-
      745.              },
        746. 
+
      746.          /**
        747. 
+
      747.           * Alias used to explicitly get an association on a model.
        748. 
+
      748.           * @param {_Association} self reference to the Association that is being called.
        749. 
+
      749.           */
        750. 
+
      750.          _getter:function (model) {
        751. 
+
      751.              //if we have them return them;
        752. 
+
      752. 612            if (this.associationLoaded(model)) {
        753. 
+
      753. 220                var assoc = this.getAssociation(model);
        754. 
+
      754. 220                return this.isEager() ? assoc : new Promise().callback(assoc).promise();
        755. 
+
      755. 392            } else if (model.isNew) {
        756. 
+
      756. 0                return null;
        757. 
+
      757.              } else {
        758. 
+
      758. 392                return this.fetch(model);
        759. 
+
      759.              }
        760. 
+
      760.          },
        761. 
 
      761.  
        762. 
-
      762.              /*Return if Im a new object*/
        763. 
-
      763.              isNew:function () {
        764. 
-
      764. 9644                return this.__isNew;
        765. 
-
      765.              },
        766. 
+
      766.          _toModel:function (val, fromDb) {
        767. 
+
      767. 1412            var Model = this.model;
        768. 
+
      768. 1412            if (!isUndefinedOrNull(Model)) {
        769. 
+
      769. 1412                if (!isInstanceOf(val, Model)) {
        770. 
+
      770. 1167                    val = new this.model(val, fromDb);
        771. 
+
      771.                  }
        772. 
+
      772.              } else {
        773. 
+
      773. 0                throw new PatioError("Invalid model " + this.name);
        774. 
+
      774.              }
        775. 
+
      775. 1412            return val;
        776. 
+
      776.          },
        777. 
 
      777.  
        778. 
-
      778.              /*Return if Im changed*/
        779. 
-
      779.              isChanged:function () {
        780. 
-
      780. 0                return this.__isChanged;
        781. 
-
      781.              },
        782. 
+
      782.          /**
        783. 
+
      783.           * Method to inject functionality into a model. This method alters the model
        784. 
+
      784.           * to prepare it for associations, and initializes all required middleware calls
        785. 
+
      785.           * to fulfill requirements needed to loaded the associations.
        786. 
+
      786.           *
        787. 
+
      787.           * @param {Model} parent the model that is having an associtaion set on it.
        788. 
+
      788.           * @param {String} name the name of the association.
        789. 
+
      789.           */
        790. 
+
      790.          inject:function (parent, name) {
        791. 
+
      791. 55            this.name = name;
        792. 
+
      792. 55            var self = this;
        793. 
+
      793. 55            this.parent = parent;
        794. 
+
      794. 55            parent.prototype.__defineGetter__(name, function () {
        795. 
+
      795. 612                return  self._getter(this);
        796. 
+
      796.              });
        797. 
+
      797. 55            parent.prototype.__defineGetter__(this.associatedDatasetName, function () {
        798. 
+
      798. 146                return  self._filter(this);
        799. 
+
      799.              });
        800. 
 
      800.  
        801. 
-
      801.              /**@lends patio.Model.prototype*/
        802. 
+
      802. 55            if (!this.readOnly && this.createSetter) {
        803. 
+
      803.                  //define a setter because we arent read only
        804. 
+
      804. 55                parent.prototype.__defineSetter__(name, function (vals) {
        805. 
+
      805. 139                    self._setter(vals, this);
        806. 
+
      806.                  });
        807. 
+
      807.              }
        808. 
 
      808.  
        809. 
-
      809.              primaryKey:function () {
        810. 
-
      810. 2568                return this._static.primaryKey;
        811. 
+
      811.              //set up all callbacks
        812. 
+
      812. 55            ["pre", "post"].forEach(function (op) {
        813. 
+
      813. 110                ["save", "update", "remove", "load"].forEach(function (type) {
        814. 
+
      814. 440                    parent[op](type, function (next) {
        815. 
+
      815. 5598                        return self["_" + op + type.charAt(0).toUpperCase() + type.slice(1)](next, this);
        816. 
+
      816.                      });
        817. 
+
      817.                  }, this);
        818. 
+
      818.              }, this);
        819. 
+
      819.          },
        820. 
+
      820.  
        821. 
+
      821.          getters:{
        822. 
+
      822.  
        823. 
+
      823.              select:function () {
        824. 
+
      824. 648                return this.__opts.select;
        825. 
 
      825.              },
        826. 
 
      826.  
        827. 
-
      827.              tableName:function () {
        828. 
-
      828. 40                return this._static.tableName;
        829. 
+
      829.              defaultLeftKey:function () {
        830. 
+
      830. 2841                var ret = "";
        831. 
+
      831. 2841                if (this.isOwner) {
        832. 
+
      832. 2095                    ret = this.__opts.primaryKey || this.parent.primaryKey[0]
        833. 
+
      833.                  } else {
        834. 
+
      834. 746                    ret = this.model.tableName + "Id";
        835. 
+
      835.                  }
        836. 
+
      836. 2841                return ret;
        837. 
 
      837.              },
        838. 
 
      838.  
        839. 
-
      839.              dataset:function () {
        840. 
-
      840. 3085                return this.__dataset || this._static.dataset;
        841. 
+
      841.              defaultRightKey:function () {
        842. 
+
      842. 2721                return this.associatedModelKey;
        843. 
 
      843.              },
        844. 
 
      844.  
        845. 
-
      845.              db:function () {
        846. 
-
      846. 28                return this._static.db;
        847. 
+
      847.              //Returns our model
        848. 
+
      848.              model:function () {
        849. 
+
      849. 10572                return this.patio.getModel(this._model, this.parent.db);
        850. 
 
      850.              },
        851. 
 
      851.  
        852. 
-
      852.              schema:function () {
        853. 
-
      853. 75099                return this._static.schema;
        854. 
+
      854.              associatedModelKey:function () {
        855. 
+
      855. 2721                var ret = "";
        856. 
+
      856. 2721                if (this.isOwner) {
        857. 
+
      857. 1857                    ret = this.__opts.primaryKey || this.parent.tableName + "Id";
        858. 
+
      858.                  } else {
        859. 
+
      859. 864                    ret = this.model.primaryKey[0];
        860. 
+
      860.                  }
        861. 
+
      861. 2721                return ret;
        862. 
 
      862.              },
        863. 
 
      863.  
        864. 
-
      864.              columns:function () {
        865. 
-
      865. 0                return this._static.columns;
        866. 
+
      866.              associatedDatasetName:function () {
        867. 
+
      867. 201                return this.name + "Dataset"
        868. 
 
      868.              },
        869. 
 
      869.  
        870. 
-
      870.              synced:function () {
        871. 
-
      871. 12784                return this._static.synced;
        872. 
+
      872.              removeAssociationFlagName:function () {
        873. 
+
      873. 27                return "__remove" + this.name + "association"
        874. 
 
      874.              }
        875. 
 
      875.  
        876. 
 
      876.          }
        877. 
 
      877.      },
        878. 
 
      878.  
        879. 
 
      879.      static:{
        880. 
-
      880.          /**
        881. 
-
      881.           * @lends patio.Model
        882. 
-
      882.           */
        883. 
-
      883.  
        884. 
-
      884.          synced:false,
        885. 
+
      885.          /**@lends patio.associations.Association*/
        886. 
 
      886.  
        887. 
-
      887.          /**
        888. 
-
      888.           * Set to false to prevent the emitting of an event on load
        889. 
-
      889.           * @default true
        890. 
-
      890.           */
        891. 
-
      891.          emitOnLoad:true,
        892. 
+
      892.          fetch:{
        893. 
 
      893.  
        894. 
-
      894.          /**
        895. 
-
      895.           * Set to false to prevent the emitting of an event on the setting of a column value
        896. 
-
      896.           * @default true
        897. 
-
      897.           */
        898. 
-
      898.          emitOnColumnSet:true,
        899. 
+
      899.              LAZY:"lazy",
        900. 
 
      900.  
        901. 
+
      901.              EAGER:"eager"
        902. 
+
      902.          }
        903. 
+
      903.      }
        904. 
+
      904.  }).as(module);
      
+
    + +
    + + + + + +
    +
    model.js
    +     		+
    + Coverage88.47 + SLOC1066 + LOC321 + Missed37 +
    +
    + 
    1. 1var comb = require("comb"),
      2. 
+
    2.      isFunction = comb.isFunction,
      3. 
+
    3.      isUndefined = comb.isUndefined,
      4. 
+
    4.      isDefined = comb.isDefined,
      5. 
+
    5.      isBoolean = comb.isBoolean,
      6. 
+
    6.      isString = comb.isString,
      7. 
+
    7.      argsToArray = comb.argsToArray,
      8. 
+
    8.      isInstanceOf = comb.isInstanceOf,
      9. 
+
    9.      serial = comb.serial,
      10. 
+
    10.      isHash = comb.isHash,
      11. 
+
    11.      when = comb.when,
      12. 
+
    12.      merge = comb.merge,
      13. 
+
    13.      toArray = comb.array.toArray,
      14. 
+
    14.      ModelError = require("./errors").ModelError,
      15. 
+
    15.      plugins = require("./plugins"),
      16. 
+
    16.      isUndefinedOrNull = comb.isUndefinedOrNull,
      17. 
+
    17.      AssociationPlugin = plugins.AssociationPlugin,
      18. 
+
    18.      QueryPlugin = plugins.QueryPlugin,
      19. 
+
    19.      Promise = comb.Promise,
      20. 
+
    20.      PromiseList = comb.PromiseList,
      21. 
+
    21.      HashTable = comb.collections.HashTable,
      22. 
+
    22.      hitch = comb.hitch,
      23. 
+
    23.      hitchIgnore = comb.hitchIgnore,
      24. 
+
    24.      Middleware = comb.plugins.Middleware,
      25. 
+
    25.      EventEmitter = require("events").EventEmitter,
      26. 
+
    26.      util = require("util"),
      27. 
+
    27.      define = comb.define,
      28. 
+
    28.      patio;
      29. 
 
    29.  
      30. 
-
    30.          /**
      31. 
-
    31.           * Set to false to prevent empty strings from being type casted to null
      32. 
-
    32.           * @default true
      33. 
-
    33.           */
      34. 
-
    34.          typecastEmptyStringToNull:true,
      35. 
 
    35.  
      36. 
-
    36.          /**
      37. 
-
    37.           * Set to false to prevent properties from being type casted when loaded from the database.
      38. 
-
    38.           * See {@link patio.Database#typecastValue}
      39. 
-
    39.           * @default true
      40. 
-
    40.           */
      41. 
-
    41.          typecastOnLoad:true,
      42. 
+
    42. 1var MODELS = new HashTable();
      43. 
 
    43.  
      44. 
-
    44.          /**
      45. 
-
    45.           * Set to false to prevent properties from being type casted when manually set.
      46. 
-
    46.           * See {@link patio.Database#typecastValue}
      47. 
-
    47.           * @default true
      48. 
-
    48.           */
      49. 
-
    49.          typecastOnAssignment:true,
      50. 
+
    50. 1var applyColumnTransformMethod = function (val, meth) {
      51. 
+
    51. 11464    return !isUndefinedOrNull(meth) ? isFunction(val[meth]) ? val[meth] : isFunction(comb[meth]) ? comb[meth](val) : val : val;
      52. 
+
    52.  };
      53. 
 
    53.  
      54. 
-
    54.          /**
      55. 
-
    55.           * Set to false to prevent errors thrown while type casting a value from being propogated.
      56. 
-
    56.           * @default true
      57. 
-
    57.           */
      58. 
-
    58.          raiseOnTypecastError:true,
      59. 
+
    59. 1var checkAndTransformName = function (name) {
      60. 
+
    60. 10693    return isString(name) ? applyColumnTransformMethod(name, Model.camelize === true ? "camelize" : Model.underscore === true ? "underscore" : null) : name;
      61. 
+
    61.  };
      62. 
 
    62.  
      63. 
+
    63. 1var Model = define([QueryPlugin, Middleware], {
      64. 
+
    64.      instance:{
      65. 
 
    65.          /**
      66. 
-
    66.           * Set to false to allow the setting of primary keys.
      67. 
-
    67.           * @default false
      68. 
+
    68.           * @lends patio.Model.prototype
      69. 
 
    69.           */
      70. 
-
    70.          isRestrictedPrimaryKey:true,
      71. 
 
    71.  
      72. 
-
    72.          /**
      73. 
-
    73.           * Set to false to prevent models from using transactions when saving, deleting, or updating.
      74. 
-
    74.           * This applies to the model associations also.
      75. 
-
    75.           */
      76. 
-
    76.          useTransactions:true,
      77. 
+
    77.          __ignore:false,
      78. 
 
    78.  
      79. 
-
    79.          /**
      80. 
-
    80.           * See {@link patio.Dataset#identifierOutputMethod}
      81. 
-
    81.           * @default null
      82. 
-
    82.           */
      83. 
-
    83.          identifierOutputMethod:null,
      84. 
+
    84.          __changed:null,
      85. 
 
    85.  
      86. 
-
    86.          /**
      87. 
-
    87.           * See {@link patio.Dataset#identifierInputMethod}
      88. 
-
    88.           * @default null
      89. 
-
    89.           */
      90. 
-
    90.          identifierInputMethod:null,
      91. 
+
    91.          __values:null,
      92. 
 
    92.  
      93. 
 
    93.          /**
      94. 
-
    94.           * Set to false to prevent the reload of a model after saving.
      95. 
-
    95.           * @default true
      96. 
+
    96.           * patio  - read only
      97. 
+
    97.           *
      98. 
+
    98.           * @type patio
      99. 
 
    99.           */
      100. 
-
    100.          reloadOnSave:true,
      101. 
+
    101.          patio:null,
      102. 
 
    102.  
      103. 
 
    103.          /**
      104. 
-
    104.           * Columns that should be restriced when setting values through the {@link patio.Model#set} method.
      105. 
+
    105.           * The database type such as mysql
      106. 
 
    106.           *
      107. 
-
    107.           */
      108. 
-
    108.          restrictedColumns:null,
      109. 
+
    109.           * @type String
      110. 
+
    110.           *
      111. 
+
    111.           * */
      112. 
+
    112.          type:null,
      113. 
 
    113.  
      114. 
 
    114.          /**
      115. 
-
    115.           * Set to false to prevent the reload of a model after updating.
      116. 
-
    116.           * @default true
      117. 
-
    117.           */
      118. 
-
    118.          reloadOnUpdate:true,
      119. 
-
    119.  
      120. 
-
    120.  
      121. 
-
    121.          __camelize:false,
      122. 
-
    122.  
      123. 
-
    123.          __underscore:false,
      124. 
-
    124.  
      125. 
-
    125.          __columns:null,
      126. 
-
    126.  
      127. 
-
    127.          __schema:null,
      128. 
-
    128.  
      129. 
-
    129.          __primaryKey:null,
      130. 
-
    130.  
      131. 
-
    131.          __dataset:null,
      132. 
-
    132.  
      133. 
-
    133.          __db:null,
      134. 
-
    134.  
      135. 
-
    135.          __tableName:null,
      136. 
-
    136.  
      137. 
+
    137.           * Whether or not this model is new
      138. 
+
    138.           * */
      139. 
+
    139.          __isNew:true,
      140. 
 
    140.  
      141. 
 
    141.          /**
      142. 
-
    142.           * The table that this Model represents.
      143. 
-
    143.           * <b>READ ONLY</b>
      144. 
-
    144.           */
      145. 
-
    145.          table:null,
      146. 
+
    146.           * Signifies if the model has changed
      147. 
+
    147.           * */
      148. 
+
    148.          __isChanged:false,
      149. 
 
    149.  
      150. 
 
    150.          /**
      151. 
-
    151.           * patio  - read only
      152. 
+
    152.           * Base class for all models.
      153. 
+
    153.           * <p>This is used through {@link patio.addModel}, <b>NOT directly.</b></p>
      154. 
 
    154.           *
      155. 
-
    155.           * @type patio
      156. 
-
    156.           */
      157. 
-
    157.          patio:null,
      158. 
-
    158.  
      159. 
-
    159.          init:function () {
      160. 
-
    160. 92            var emitter = new EventEmitter();
      161. 
-
    161. 92            ["addListener", "on", "once", "removeListener",
      162. 
-
    162.                  "removeAllListeners", "setMaxListeners", "listeners", "emit"].forEach(function (name) {
      163. 
-
    163. 736                    this[name] = emitter[name].bind(emitter);
      164. 
-
    164.                  }, this);
      165. 
-
    165. 92            if (this.__tableName) {
      166. 
-
    166. 91                this._setTableName(this.__tableName);
      167. 
-
    167.              }
      168. 
-
    168. 92            if (this.__db) {
      169. 
-
    169. 7                this._setDb(this.__db);
      170. 
-
    170.              }
      171. 
-
    171.          },
      172. 
-
    172.  
      173. 
-
    173.  
      174. 
-
    174.          sync:function (cb) {
      175. 
-
    175. 3968            var ret = new Promise();
      176. 
-
    176. 3968            if (!this.synced) {
      177. 
-
    177. 93                var db = this.db, tableName = this.tableName, supers = this.__supers;
      178. 
-
    178. 93                db.schema(tableName).then(hitch(this, function (schema) {
      179. 
-
    179. 93                    if (!this.synced && schema) {
      180. 
-
    180. 93                        this._setSchema(schema);
      181. 
-
    181. 93                        if (supers && supers.length) {
      182. 
-
    182. 3                            new PromiseList(supers.map(function (sup) {
      183. 
-
    183. 3                                return sup.sync();
      184. 
-
    184.                              })).then(hitch(this, function () {
      185. 
-
    185. 3                                this.synced = true;
      186. 
-
    186. 3                                supers.forEach(this.inherits, this);
      187. 
-
    187. 3                                ret.callback(this);
      188. 
-
    188.                              }), ret);
      189. 
-
    189.                          } else {
      190. 
-
    190. 90                            this.synced = true;
      191. 
-
    191. 90                            ret.callback(this);
      192. 
-
    192.                          }
      193. 
-
    193. 93                        this.emit("sync", this);
      194. 
-
    194.                      } else {
      195. 
-
    195. 0                        var error = new ModelError("Unable to find schema for " + tableName);
      196. 
-
    196. 0                        this.emit("error", error);
      197. 
-
    197. 0                        ret.errback(error);
      198. 
+
    198.           * @constructs
      199. 
+
    199.           * @augments comb.plugins.Middleware
      200. 
+
    200.           *
      201. 
+
    201.           * @param {Object} columnValues values of each column to be used by this Model.
      202. 
+
    202.           *
      203. 
+
    203.           * @property {patio.Dataset} dataset a dataset to use to retrieve models from the database. The dataset
      204. 
+
    204.           *                          has the {@link patio.Dataset#rowCb} set to create instances of this model.
      205. 
+
    205.           * @property {String[]} columns a list of columns this models table contains.
      206. 
+
    206.           * @property {Object} schema the schema of this models table.
      207. 
+
    207.           * @property {String} tableName the table name of this models table.
      208. 
+
    208.           * @property {*} primaryKeyValue the value of this models primaryKey
      209. 
+
    209.           * @property {Boolean} isNew true if this model is new and does not exist in the database.
      210. 
+
    210.           * @property {Boolean} isChanged true if the model has been changed and not saved.
      211. 
+
    211.           *
      212. 
+
    212.           * @borrows patio.Dataset#all as all
      213. 
+
    213.           * @borrows patio.Dataset#one as one
      214. 
+
    214.           * @borrows patio.Dataset#avg as avg
      215. 
+
    215.           * @borrows patio.Dataset#count as count
      216. 
+
    216.           * @borrows patio.Dataset#columns as columns
      217. 
+
    217.           * @borrows patio.Dataset#forEach as forEach
      218. 
+
    218.           * @borrows patio.Dataset#isEmpty as empty
      219. 
+
    219.           * @borrows patio.Dataset#first as first
      220. 
+
    220.           * @borrows patio.Dataset#get as get
      221. 
+
    221.           * @borrows patio.Dataset#import as import
      222. 
+
    222.           * @borrows patio.Dataset#insert as insert
      223. 
+
    223.           * @borrows patio.Dataset#insertMultiple as insertMultiple
      224. 
+
    224.           * @borrows patio.Dataset#saveMultiple as saveMultiple
      225. 
+
    225.           * @borrows patio.Dataset#interval as interval
      226. 
+
    226.           * @borrows patio.Dataset#last as last
      227. 
+
    227.           * @borrows patio.Dataset#map as map
      228. 
+
    228.           * @borrows patio.Dataset#max as max
      229. 
+
    229.           * @borrows patio.Dataset#min as min
      230. 
+
    230.           * @borrows patio.Dataset#multiInsert as multiInsert
      231. 
+
    231.           * @borrows patio.Dataset#range as range
      232. 
+
    232.           * @borrows patio.Dataset#selectHash as selectHash
      233. 
+
    233.           * @borrows patio.Dataset#selectMap as selectMap
      234. 
+
    234.           * @borrows patio.Dataset#selectOrderMap as selectOrderMap
      235. 
+
    235.           * @borrows patio.Dataset#set as set
      236. 
+
    236.           * @borrows patio.Dataset#singleRecord as singleRecord
      237. 
+
    237.           * @borrows patio.Dataset#singleValue as singleValue
      238. 
+
    238.           * @borrows patio.Dataset#sum as sum
      239. 
+
    239.           * @borrows patio.Dataset#toCsv as toCsv
      240. 
+
    240.           * @borrows patio.Dataset#toHash as toHash
      241. 
+
    241.           * @borrows patio.Dataset#truncate as truncate
      242. 
+
    242.           * @borrows patio.Dataset#addGraphAliases as addGraphAliases
      243. 
+
    243.           * @borrows patio.Dataset#and as and
      244. 
+
    244.           * @borrows patio.Dataset#distinct as distinct
      245. 
+
    245.           * @borrows patio.Dataset#except as except
      246. 
+
    246.           * @borrows patio.Dataset#exclude as exclude
      247. 
+
    247.           * @borrows patio.Dataset#is as is
      248. 
+
    248.           * @borrows patio.Dataset#isNot as isNot
      249. 
+
    249.           * @borrows patio.Dataset#eq as eq
      250. 
+
    250.           * @borrows patio.Dataset#neq as neq
      251. 
+
    251.           * @borrows patio.Dataset#lt as lt
      252. 
+
    252.           * @borrows patio.Dataset#lte as lte
      253. 
+
    253.           * @borrows patio.Dataset#gt as gt
      254. 
+
    254.           * @borrows patio.Dataset#gte as gte
      255. 
+
    255.           * @borrows patio.Dataset#forUpdate as forUpdate
      256. 
+
    256.           * @borrows patio.Dataset#from as from
      257. 
+
    257.           * @borrows patio.Dataset#fromSelf as fromSelf
      258. 
+
    258.           * @borrows patio.Dataset#graph as graph
      259. 
+
    259.           * @borrows patio.Dataset#grep as grep
      260. 
+
    260.           * @borrows patio.Dataset#group as group
      261. 
+
    261.           * @borrows patio.Dataset#groupAndCount as groupAndCount
      262. 
+
    262.           * @borrows patio.Dataset#groupBy as groupBy
      263. 
+
    263.           * @borrows patio.Dataset#having as having
      264. 
+
    264.           * @borrows patio.Dataset#intersect as intersect
      265. 
+
    265.           * @borrows patio.Dataset#invert as invert
      266. 
+
    266.           * @borrows patio.Dataset#limit as limit
      267. 
+
    267.           * @borrows patio.Dataset#lockStyle as lockStyle
      268. 
+
    268.           * @borrows patio.Dataset#naked as naked
      269. 
+
    269.           * @borrows patio.Dataset#or as or
      270. 
+
    270.           * @borrows patio.Dataset#order as order
      271. 
+
    271.           * @borrows patio.Dataset#orderAppend as orderAppend
      272. 
+
    272.           * @borrows patio.Dataset#orderBy as orderBy
      273. 
+
    273.           * @borrows patio.Dataset#orderMore as orderMore
      274. 
+
    274.           * @borrows patio.Dataset#orderPrepend as orderPrepend
      275. 
+
    275.           * @borrows patio.Dataset#qualify as qualify
      276. 
+
    276.           * @borrows patio.Dataset#reverse as reverse
      277. 
+
    277.           * @borrows patio.Dataset#reverseOrder as reverseOrder
      278. 
+
    278.           * @borrows patio.Dataset#select as select
      279. 
+
    279.           * @borrows patio.Dataset#selectAll as selectAll
      280. 
+
    280.           * @borrows patio.Dataset#selectAppend as selectAppend
      281. 
+
    281.           * @borrows patio.Dataset#selectMore as selectMore
      282. 
+
    282.           * @borrows patio.Dataset#setDefaults as setDefaults
      283. 
+
    283.           * @borrows patio.Dataset#setGraphAliases as setGraphAliases
      284. 
+
    284.           * @borrows patio.Dataset#setOverrides as setOverrides
      285. 
+
    285.           * @borrows patio.Dataset#unfiltered as unfiltered
      286. 
+
    286.           * @borrows patio.Dataset#ungraphed as ungraphed
      287. 
+
    287.           * @borrows patio.Dataset#ungrouped as ungrouped
      288. 
+
    288.           * @borrows patio.Dataset#union as union
      289. 
+
    289.           * @borrows patio.Dataset#unlimited as unlimited
      290. 
+
    290.           * @borrows patio.Dataset#unordered as unordered
      291. 
+
    291.           * @borrows patio.Dataset#where as where
      292. 
+
    292.           * @borrows patio.Dataset#with as with
      293. 
+
    293.           * @borrows patio.Dataset#withRecursive as withRecursive
      294. 
+
    294.           * @borrows patio.Dataset#withSql as withSql
      295. 
+
    295.           * @borrows patio.Dataset#naturalJoin as naturalJoin
      296. 
+
    296.           * @borrows patio.Dataset#naturalLeftJoin as naturalLeftJoin
      297. 
+
    297.           * @borrows patio.Dataset#naturalRightJoin as naturalRightJoin
      298. 
+
    298.           * @borrows patio.Dataset#naturalFullJoin as naturalFullJoin
      299. 
+
    299.           * @borrows patio.Dataset#crossJoin as crossJoin
      300. 
+
    300.           * @borrows patio.Dataset#innerJoin as innerJoin
      301. 
+
    301.           * @borrows patio.Dataset#fullOuterJoin as fullOuterJoin
      302. 
+
    302.           * @borrows patio.Dataset#rightOuterJoin as rightOuterJoin
      303. 
+
    303.           * @borrows patio.Dataset#leftOuterJoin as leftOuterJoin
      304. 
+
    304.           * @borrows patio.Dataset#fullJoin as fullJoin
      305. 
+
    305.           * @borrows patio.Dataset#rightJoin as rightJoin
      306. 
+
    306.           * @borrows patio.Dataset#leftJoin as leftJoin
      307. 
+
    307.           * */
      308. 
+
    308.          constructor:function (options, fromDb) {
      309. 
+
    309. 3107            if (this.synced) {
      310. 
+
    310. 3107                this.__emitter = new EventEmitter();
      311. 
+
    311. 3107                this._super(arguments);
      312. 
+
    312. 3107                this.patio = patio || require("./index");
      313. 
+
    313. 3107                fromDb = isBoolean(fromDb) ? fromDb : false;
      314. 
+
    314. 3107                this.__changed = {};
      315. 
+
    315. 3107                this.__values = {};
      316. 
+
    316. 3107                if (fromDb) {
      317. 
+
    317. 1754                    this._hook("pre", "load");
      318. 
+
    318. 1754                    this.__isNew = false;
      319. 
+
    319. 1754                    this.__setFromDb(options, true);
      320. 
+
    320. 1754                    if (this._static.emitOnLoad) {
      321. 
+
    321. 1754                        this.emit("load", this);
      322. 
+
    322. 1754                        this._static.emit("load", this);
      323. 
 
    323.                      }
      324. 
-
    324.                  }), ret);
      325. 
+
    325.                  } else {
      326. 
+
    326. 1353                    this.__isNew = true;
      327. 
+
    327. 1353                    this.__set(options);
      328. 
+
    328.                  }
      329. 
 
    329.              } else {
      330. 
-
    330. 3875                ret.callback(this);
      331. 
-
    331.              }
      332. 
-
    332. 3968            if (isFunction(cb)) {
      333. 
-
    333. 0                ret.classic(cb);
      334. 
+
    334. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
      335. 
 
    335.              }
      336. 
-
    336. 3968            return ret.promise();
      337. 
 
    337.          },
      338. 
 
    338.  
      339. 
-
    339.          /**
      340. 
-
    340.           * Stub for plugins to notified of model inheritance
      341. 
-
    341.           *
      342. 
-
    342.           * @param {patio.Model} model a model class to inherit from
      343. 
-
    343.           */
      344. 
-
    344.          inherits:function (model) {
      345. 
+
    345.          __set:function (values, ignore) {
      346. 
+
    346. 1475            values = values || {};
      347. 
+
    347. 1475            this.__ignore = ignore === true;
      348. 
+
    348. 1475            Object.keys(values).forEach(function (attribute) {
      349. 
+
    349. 6632                var value = values[attribute];
      350. 
+
    350.                  //check if the column is a constrained value and is allowed to be set
      351. 
+
    351. 6632                !ignore && this._checkIfColumnIsConstrained(attribute);
      352. 
+
    352. 6632                this[attribute] = value;
      353. 
+
    353.              }, this);
      354. 
+
    354. 1475            this.__ignore = false;
      355. 
 
    355.          },
      356. 
 
    356.  
      357. 
+
    357.          __setFromDb:function (values, ignore) {
      358. 
+
    358. 3057            values = values || {};
      359. 
+
    359. 3057            this.__ignore = ignore === true;
      360. 
+
    360. 3057            var schema = this.schema;
      361. 
+
    361. 3057            Object.keys(values).forEach(function (column) {
      362. 
+
    362. 25830                var value = values[column];
      363. 
+
    363.                  // Typecast value retrieved from db
      364. 
+
    364. 25830                if (schema.hasOwnProperty(column)) {
      365. 
+
    365. 25149                    this.__values[column] = this._typeCastValue(column, value, ignore);
      366. 
+
    366.                  } else {
      367. 
+
    367. 681                    this[column] = value;
      368. 
+
    368.                  }
      369. 
+
    369.              }, this);
      370. 
+
    370. 3057            this.__ignore = false;
      371. 
+
    371.  
      372. 
+
    372.          },
      373. 
 
    373.  
      374. 
 
    374.          /**
      375. 
-
    375.           * Create a new model initialized with the specified values.
      376. 
+
    376.           * Set multiple values at once. Useful if you have a hash of properties that you want to set.
      377. 
 
    377.           *
      378. 
-
    378.           * @param {Object} values  the values to initialize the model with.
      379. 
+
    379.           * <b>NOTE:</b> This method will use the static restrictedColumns property of the model.
      380. 
 
    380.           *
      381. 
-
    381.           * @returns {Model} instantiated model initialized with the values passed in.
      382. 
+
    382.           * @example
      383. 
+
    383.           *
      384. 
+
    384.           * myModel.setValues({firstName : "Bob", lastName : "yukon"});
      385. 
+
    385.           *
      386. 
+
    386.           * //this will throw an error by default, assuming id is a pk.
      387. 
+
    387.           * myModel.setValues({id : 1, firstName : "Bob", lastName : "yukon"});
      388. 
+
    388.           *
      389. 
+
    389.           * @param {Object} values value to set on the model.
      390. 
+
    390.           *
      391. 
+
    391.           * @return {patio.Model} return this for chaining.
      392. 
 
    392.           */
      393. 
-
    393.          create:function (values) {
      394. 
-
    394.              //load an object from an object
      395. 
-
    395. 0            return new this(values, false);
      396. 
+
    396.          setValues:function (values) {
      397. 
+
    397. 17            this.__set(values, false);
      398. 
+
    398. 17            return this;
      399. 
 
    399.          },
      400. 
 
    400.  
      401. 
-
    401.          load:function (vals) {
      402. 
-
    402. 924            var ret = new Promise();
      403. 
-
    403.              //sync our model
      404. 
-
    404. 924            this.sync().then(hitch(this, function () {
      405. 
-
    405. 924                var m = new this(vals, true);
      406. 
-
    406.                  //call the hooks!
      407. 
-
    407. 924                m._hook("post", "load").then(function () {
      408. 
-
    408. 924                    ret.callback(m);
      409. 
-
    409.                  }, ret);
      410. 
-
    410.              }), ret);
      411. 
-
    411. 924            return ret.promise();
      412. 
+
    412.          _toObject:function () {
      413. 
+
    413. 1124            if (this.synced) {
      414. 
+
    414. 1124                var columns = this._static.columns, ret = {};
      415. 
+
    415. 1124                for (var i in columns) {
      416. 
+
    416. 10220                    var col = columns[i];
      417. 
+
    417. 10220                    var val = this.__values[col];
      418. 
+
    418. 10220                    if (!isUndefined(val)) {
      419. 
+
    419. 6169                        ret[col] = val;
      420. 
+
    420.                      }
      421. 
+
    421.                  }
      422. 
+
    422. 1124                return ret;
      423. 
+
    423.              } else {
      424. 
+
    424. 0                throw new ModelError("Model " + this.tableName + " has not been synced");
      425. 
+
    425.              }
      426. 
 
    426.          },
      427. 
 
    427.  
      428. 
-
    428.          _checkTransaction:function (opts, cb) {
      429. 
-
    429. 2892            if (isFunction(opts)) {
      430. 
-
    430. 639                cb = opts;
      431. 
-
    431. 639                opts = {};
      432. 
-
    432.              } else {
      433. 
-
    433. 2253                opts = opts || {};
      434. 
+
    434.          _addColumnToIsChanged:function (name, val) {
      435. 
+
    435. 7556            if (!this.isNew && !this.__ignore) {
      436. 
+
    436. 165                this.__isChanged = true;
      437. 
+
    437. 165                this.__changed[name] = val;
      438. 
 
    438.              }
      439. 
-
    439. 2892            var ret = new Promise(), retVal = null, errored = false;
      440. 
-
    440. 2892            this.sync().then(hitch(this, function () {
      441. 
-
    441. 2892                if (this.useTransaction(opts)) {
      442. 
-
    442. 2892                    this.db.transaction(opts, hitch(this, function () {
      443. 
-
    443. 2892                        return when(cb()).then(function () {
      444. 
-
    444. 2848                            retVal = argsToArray(arguments);
      445. 
-
    445.                          }, function () {
      446. 
-
    446. 44                            retVal = argsToArray(arguments);
      447. 
-
    447. 44                            errored = true;
      448. 
-
    448.                          });
      449. 
-
    449.                      })).then(hitch(this, function () {
      450. 
-
    450. 2848                        ret[errored ? "errback" : "callback"].apply(ret, retVal);
      451. 
-
    451.                      }), hitch(this, function () {
      452. 
-
    452. 44                        if (errored) {
      453. 
-
    453. 44                            ret.errback.apply(ret, retVal);
      454. 
-
    454.                          } else {
      455. 
-
    455. 0                            ret.errback.apply(ret, arguments);
      456. 
-
    456.                          }
      457. 
-
    457.                      }));
      458. 
-
    458.                  } else {
      459. 
-
    459. 0                    when(cb()).then(ret);
      460. 
+
    460.          },
      461. 
+
    461.  
      462. 
+
    462.          _checkIfColumnIsConstrained:function (name) {
      463. 
+
    463. 6632            if (this.synced && !this.__ignore) {
      464. 
+
    464. 6632                var col = this.schema[name], restrictedCols = this._static.restrictedColumns || [];
      465. 
+
    465. 6632                if (!isUndefined(col) && (col.primaryKey && this._static.isRestrictedPrimaryKey) || restrictedCols.indexOf(name) != -1) {
      466. 
+
    466. 0                    throw new ModelError("Cannot set primary key of model " + this._static.tableName);
      467. 
 
    467.                  }
      468. 
-
    468.              }), ret);
      469. 
-
    469. 2892            return ret.promise();
      470. 
+
    470.              }
      471. 
 
    471.          },
      472. 
 
    472.  
      473. 
-
    473.          /**
      474. 
-
    474.           * @private
      475. 
-
    475.           * Returns a boolean indicating whether or not to use a transaction.
      476. 
-
    476.           * @param {Object} [opts] set a transaction property to override the {@link patio.Model#useTransaction}.
      477. 
-
    477.           */
      478. 
-
    478.          useTransaction:function (opts) {
      479. 
-
    479. 2892            opts = opts || {};
      480. 
-
    480. 2892            return isBoolean(opts.transaction) ? opts.transaction === true : this.useTransactions === true;
      481. 
+
    481.          _getColumnValue:function (name) {
      482. 
+
    482. 5427            var val = this.__values[name];
      483. 
+
    483. 5427            var getterFunc = this["_get" + name.charAt(0).toUpperCase() + name.substr(1)];
      484. 
+
    484. 5427            var columnValue = isFunction(getterFunc) ? getterFunc.call(this, val) : val;
      485. 
+
    485.  
      486. 
+
    486. 5427            return columnValue;
      487. 
 
    487.          },
      488. 
 
    488.  
      489. 
-
    489.          _setDataset:function (ds) {
      490. 
-
    490. 3            this.__dataset = ds;
      491. 
-
    491. 3            if (ds.db) {
      492. 
-
    492. 3                this._setDb(ds.db);
      493. 
+
    493.          _setColumnValue:function (name, val) {
      494. 
+
    494. 7556            var ignore = this.__ignore;
      495. 
+
    495. 7556            val = this._typeCastValue(name, val, ignore);
      496. 
+
    496. 7556            this._addColumnToIsChanged(name, val);
      497. 
+
    497. 7556            var setterFunc = this["_set" + name.charAt(0).toUpperCase() + name.substr(1)];
      498. 
+
    498. 7556            var columnValue = isFunction(setterFunc) ? setterFunc.call(this, val, ignore) : val;
      499. 
+
    499. 7556            this.__values[name] = columnValue;
      500. 
+
    500. 7556            if (this._static.emitOnColumnSet) {
      501. 
+
    501. 7556                this.emit("column", name, columnValue, ignore);
      502. 
 
    502.              }
      503. 
 
    503.          },
      504. 
 
    504.  
      505. 
-
    505.          _setDb:function (db) {
      506. 
-
    506. 10            this.__db = db;
      507. 
+
    507.  
      508. 
+
    508.          //Typecast the value to the column's type if typecasting.  Calls the database's
      509. 
+
    509.          //typecast_value method, so database adapters can override/augment the handling
      510. 
+
    510.          //for database specific column types.
      511. 
+
    511.          _typeCastValue:function (column, value, fromDatabase) {
      512. 
+
    512. 32705            var colSchema, clazz = this._static;
      513. 
+
    513. 32705            if (((fromDatabase && clazz.typecastOnLoad) || (!fromDatabase && clazz.typecastOnAssignment)) && !isUndefinedOrNull(this.schema) && !isUndefinedOrNull((colSchema = this.schema[column]))) {
      514. 
+
    514. 32705                var type = colSchema.type;
      515. 
+
    515. 32705                if (value === "" && clazz.typecastEmptyStringToNull === true && !isUndefinedOrNull(type) && ["string", "blob"].indexOf(type) === -1) {
      516. 
+
    516. 3                    value = null;
      517. 
+
    517.                  }
      518. 
+
    518. 32705                var raiseOnError = clazz.raiseOnTypecastError;
      519. 
+
    519. 32705                if (raiseOnError === true && isUndefinedOrNull(value) && colSchema.allowNull === false) {
      520. 
+
    520. 0                    throw new ModelError("null is not allowed for the " + column + " column.");
      521. 
+
    521.                  }
      522. 
+
    522. 32705                try {
      523. 
+
    523. 32705                    value = clazz.db.typecastValue(type, value);
      524. 
+
    524.                  } catch (e) {
      525. 
+
    525. 0                    if (raiseOnError === true) {
      526. 
+
    526. 0                        throw e;
      527. 
+
    527.                      }
      528. 
+
    528.                  }
      529. 
+
    529.              }
      530. 
+
    530. 32705            return value;
      531. 
 
    531.          },
      532. 
 
    532.  
      533. 
-
    533.          _setTableName:function (name) {
      534. 
-
    534. 91            this.__tableName = name;
      535. 
+
    535.          /**
      536. 
+
    536.           * Convert this model to an object, containing column, value pairs.
      537. 
+
    537.           *
      538. 
+
    538.           * @return {Object} the object version of this model.
      539. 
+
    539.           **/
      540. 
+
    540.          toObject:function () {
      541. 
+
    541. 0            return this._toObject(false);
      542. 
 
    542.          },
      543. 
 
    543.  
      544. 
-
    544.          _setColumns:function (cols) {
      545. 
-
    545. 96            var proto = this.prototype;
      546. 
-
    546. 96            if (this.__columns) {
      547. 
-
    547. 6                this.__columns.forEach(function (name) {
      548. 
-
    548. 16                    delete proto[name];
      549. 
-
    549.                  });
      550. 
-
    550.              }
      551. 
-
    551. 96            this.__columns = cols;
      552. 
-
    552. 96            cols.forEach(function (name) {
      553. 
-
    553. 779                this._defineColumnSetter(name);
      554. 
-
    554. 779                this._defineColumnGetter(name);
      555. 
-
    555.              }, this);
      556. 
+
    556.          /**
      557. 
+
    557.           * Convert this model to JSON, containing column, value pairs.
      558. 
+
    558.           *
      559. 
+
    559.           * @return {JSON} the JSON version of this model.
      560. 
+
    560.           **/
      561. 
+
    561.          toJSON:function () {
      562. 
+
    562. 0            return this.toObject();
      563. 
 
    563.          },
      564. 
 
    564.  
      565. 
-
    565.          _setPrimaryKey:function (pks) {
      566. 
-
    566. 99            this.__primaryKey = pks || [];
      567. 
+
    567.          /**
      568. 
+
    568.           * Convert this model to a string, containing column, value pairs.
      569. 
+
    569.           *
      570. 
+
    570.           * @return {String} the string version of this model.
      571. 
+
    571.           **/
      572. 
+
    572.          toString:function () {
      573. 
+
    573. 0            return JSON.stringify(this.toObject(), null, 4);
      574. 
 
    574.          },
      575. 
 
    575.  
      576. 
-
    576.          _setSchema:function (schema) {
      577. 
-
    577. 96            var columns = [];
      578. 
-
    578. 96            var pks = [];
      579. 
-
    579. 96            for (var i in schema) {
      580. 
-
    580. 779                var col = schema[i];
      581. 
-
    581. 779                var name = applyColumnTransformMethod(i, this.identifierOutputMethod);
      582. 
-
    582. 779                schema[name] = col;
      583. 
-
    583. 779                columns.push(name);
      584. 
-
    584. 779                col.primaryKey && pks.push(name);
      585. 
-
    585.              }
      586. 
-
    586. 96            this.__schema = schema;
      587. 
-
    587. 96            this._setPrimaryKey(pks);
      588. 
-
    588. 96            this._setColumns(columns);
      589. 
+
    589.          /**
      590. 
+
    590.           * Convert this model to a string, containing column, value pairs.
      591. 
+
    591.           *
      592. 
+
    592.           * @return {String} the string version of this model.
      593. 
+
    593.           **/
      594. 
+
    594.          valueOf:function () {
      595. 
+
    595. 0            return this.toObject();
      596. 
 
    596.          },
      597. 
 
    597.  
      598. 
-
    598.          _defineColumnSetter:function (name) {
      599. 
-
    599.              /*Adds a setter to an object*/
      600. 
-
    600. 779            this.prototype.__defineSetter__(name, function (val) {
      601. 
-
    601. 7556                this._setColumnValue(name, val);
      602. 
-
    602.              });
      603. 
+
    603.          _checkTransaction:function (options, cb) {
      604. 
+
    604. 2493            return this._static._checkTransaction(options, cb);
      605. 
 
    605.          },
      606. 
 
    606.  
      607. 
-
    607.          _defineColumnGetter:function (name) {
      608. 
-
    608. 779            this.prototype.__defineGetter__(name, function () {
      609. 
-
    609. 5427                return this._getColumnValue(name);
      610. 
-
    610.              });
      611. 
+
    611.          addListener:function () {
      612. 
+
    612. 0            var emitter = this.__emitter;
      613. 
+
    613. 0            return emitter.addListener.apply(emitter, arguments);
      614. 
+
    614.          },
      615. 
+
    615.          on:function () {
      616. 
+
    616. 6            var emitter = this.__emitter;
      617. 
+
    617. 6            return emitter.on.apply(emitter, arguments);
      618. 
+
    618.          },
      619. 
+
    619.          once:function () {
      620. 
+
    620. 0            var emitter = this.__emitter;
      621. 
+
    621. 0            return emitter.once.apply(emitter, arguments);
      622. 
+
    622.          },
      623. 
+
    623.          removeListener:function () {
      624. 
+
    624. 6            var emitter = this.__emitter;
      625. 
+
    625. 6            return emitter.removeListener.apply(emitter, arguments);
      626. 
+
    626.          },
      627. 
+
    627.          removeAllListeners:function () {
      628. 
+
    628. 0            var emitter = this.__emitter;
      629. 
+
    629. 0            return emitter.removeAllListeners.apply(emitter, arguments);
      630. 
+
    630.          },
      631. 
+
    631.          setMaxListeners:function () {
      632. 
+
    632. 0            var emitter = this.__emitter;
      633. 
+
    633. 0            return emitter.setMaxListeners.apply(emitter, arguments);
      634. 
+
    634.          },
      635. 
+
    635.          listeners:function () {
      636. 
+
    636. 0            var emitter = this.__emitter;
      637. 
+
    637. 0            return emitter.listeners.apply(emitter, arguments);
      638. 
+
    638.          },
      639. 
+
    639.          emit:function () {
      640. 
+
    640. 11120            var emitter = this.__emitter;
      641. 
+
    641. 11120            return emitter.emit.apply(emitter, arguments);
      642. 
 
    642.          },
      643. 
 
    643.  
      644. 
 
    644.  
      645. 
-
    645.          /**
      646. 
-
    646.           * @ignore
      647. 
-
    647.           */
      648. 
 
    648.          getters:{
      649. 
-
    649.              /**@lends patio.Model*/
      650. 
-
    650.  
      651. 
-
    651.              /**
      652. 
-
    652.               * Set to true if this models column names should be use the "underscore" method when sending
      653. 
-
    653.               * keys to the database and to "camelize" method on columns returned from the database. If set to false see
      654. 
-
    654.               * {@link patio.Model#underscore}.
      655. 
-
    655.               * @field
      656. 
-
    656.               * @default false
      657. 
-
    657.               * @type {Boolean}
      658. 
-
    658.               */
      659. 
-
    659.              camelize:function (camelize) {
      660. 
-
    660. 10686                return  this.__camelize;
      661. 
+
    661.              /**@lends patio.Model.prototype*/
      662. 
 
    662.  
      663. 
+
    663.              /*Returns my actual primary key value*/
      664. 
+
    664.              primaryKeyValue:function () {
      665. 
+
    665. 47                return this[this.primaryKey];
      666. 
 
    666.              },
      667. 
 
    667.  
      668. 
-
    668.              /**
      669. 
-
    669.               * Set to true if this models column names should be use the "camelize" method when sending
      670. 
-
    670.               * keys to the database and to "underscore" method on columns returned from the database. If set to false see
      671. 
-
    671.               * {@link patio.Model#underscore}.
      672. 
-
    672.               * @field
      673. 
-
    673.               * @default false
      674. 
-
    674.               * @type {Boolean}
      675. 
-
    675.               */
      676. 
-
    676.              underscore:function (underscore) {
      677. 
-
    677. 36                return this.__underscore;
      678. 
+
    678.              /*Return if Im a new object*/
      679. 
+
    679.              isNew:function () {
      680. 
+
    680. 9644                return this.__isNew;
      681. 
+
    681.              },
      682. 
 
    682.  
      683. 
+
    683.              /*Return if Im changed*/
      684. 
+
    684.              isChanged:function () {
      685. 
+
    685. 0                return this.__isChanged;
      686. 
 
    686.              },
      687. 
 
    687.  
      688. 
-
    688.              /**@lends patio.Model*/
      689. 
+
    689.              /**@lends patio.Model.prototype*/
      690. 
 
    690.  
      691. 
-
    691.              /**
      692. 
-
    692.               * The name of the table all instances of the this {@link patio.Model} use.
      693. 
-
    693.               * @field
      694. 
-
    694.               * @ignoreCode
      695. 
-
    695.               * @type String
      696. 
-
    696.               */
      697. 
-
    697.              tableName:function () {
      698. 
-
    698. 6318                return this.__tableName;
      699. 
+
    699.              primaryKey:function () {
      700. 
+
    700. 2568                return this._static.primaryKey;
      701. 
 
    701.              },
      702. 
 
    702.  
      703. 
-
    703.              /**
      704. 
-
    704.               * The database all instances of this {@link patio.Model} use.
      705. 
-
    705.               * @field
      706. 
-
    706.               *  @ignoreCode
      707. 
-
    707.               * @type patio.Database
      708. 
-
    708.               */
      709. 
-
    709.              db:function () {
      710. 
-
    710. 46374                var db = this.__db;
      711. 
-
    711. 46374                if (!db) {
      712. 
-
    712. 86                    db = this.__db = patio.defaultDatabase;
      713. 
-
    713.                  }
      714. 
-
    714. 46374                if (!db) {
      715. 
-
    715. 0                    throw new ModelError("patio has not been connected to a database");
      716. 
-
    716.                  }
      717. 
-
    717. 46374                return db;
      718. 
+
    718.              tableName:function () {
      719. 
+
    719. 40                return this._static.tableName;
      720. 
 
    720.              },
      721. 
 
    721.  
      722. 
-
    722.              /**
      723. 
-
    723.               * A dataset to use to retrieve instances of this {@link patio.Model{ from the database. The dataset
      724. 
-
    724.               * has the {@link patio.Dataset#rowCb} set to create instances of this model.
      725. 
-
    725.               * @field
      726. 
-
    726.               *  @ignoreCode
      727. 
-
    727.               * @type patio.Dataset
      728. 
-
    728.               */
      729. 
 
    729.              dataset:function () {
      730. 
-
    730. 4836                var ds = this.__dataset;
      731. 
-
    731. 4836                if (!ds) {
      732. 
-
    732. 84                    ds = this.db.from(this.tableName);
      733. 
-
    733. 84                    ds.rowCb = hitch(this, function (vals) {
      734. 
-
    734. 873                        return this.load(vals);
      735. 
-
    735.                      });
      736. 
-
    736. 84                    this.identifierInputMethod && (ds.identifierInputMethod = this.identifierInputMethod);
      737. 
-
    737. 84                    this.identifierOutputMethod && (ds.identifierOutputMethod = this.identifierOutputMethod);
      738. 
-
    738. 84                    this.__dataset = ds;
      739. 
-
    739. 4752                } else if (!ds.rowCb) {
      740. 
-
    740. 6                    ds.rowCb = hitch(this, function rowCb(vals) {
      741. 
-
    741. 25                        return this.load(vals);
      742. 
-
    742.                      });
      743. 
-
    743.                  }
      744. 
-
    744. 4836                return ds;
      745. 
+
    745. 3085                return this.__dataset || this._static.dataset;
      746. 
 
    746.              },
      747. 
 
    747.  
      748. 
-
    748.              /**
      749. 
-
    749.               * A list of columns this models table contains.
      750. 
-
    750.               * @field
      751. 
-
    751.               *  @ignoreCode
      752. 
-
    752.               * @type String[]
      753. 
-
    753.  
      754. 
-
    754.               */
      755. 
-
    755.              columns:function () {
      756. 
-
    756. 1128                return this.__columns;
      757. 
+
    757.              db:function () {
      758. 
+
    758. 28                return this._static.db;
      759. 
 
    759.              },
      760. 
 
    760.  
      761. 
-
    761.              /**
      762. 
-
    762.               * The schema of this {@link patio.Model}'s table. See {@link patio.Database#schema} for details
      763. 
-
    763.               * on the schema object.
      764. 
-
    764.               * @field
      765. 
-
    765.               *  @ignoreCode
      766. 
-
    766.               * @type Object
      767. 
-
    767.               */
      768. 
 
    768.              schema:function () {
      769. 
-
    769. 75103                if (this.synced) {
      770. 
-
    770. 75103                    return this.__schema;
      771. 
-
    771.                  } else {
      772. 
-
    772. 0                    throw new ModelError("Model has not been synced yet");
      773. 
-
    773.                  }
      774. 
+
    774. 75099                return this._static.schema;
      775. 
 
    775.              },
      776. 
 
    776.  
      777. 
-
    777.              /**
      778. 
-
    778.               * The primaryKey column/s of this {@link patio.Model}
      779. 
-
    779.               * @field
      780. 
-
    780.               *  @ignoreCode
      781. 
-
    781.               */
      782. 
-
    782.              primaryKey:function () {
      783. 
-
    783. 8221                if (this.synced) {
      784. 
-
    784. 8221                    return this.__primaryKey.slice(0);
      785. 
-
    785.                  } else {
      786. 
-
    786. 0                    throw new ModelError("Model has not been synced yet");
      787. 
-
    787.                  }
      788. 
+
    788.              columns:function () {
      789. 
+
    789. 0                return this._static.columns;
      790. 
 
    790.              },
      791. 
 
    791.  
      792. 
-
    792.              /**
      793. 
-
    793.               * A reference to the global {@link patio}.
      794. 
-
    794.               * @field
      795. 
-
    795.               *  @ignoreCode
      796. 
-
    796.               */
      797. 
-
    797.              patio:function () {
      798. 
-
    798. 81                return patio || require("./index");
      799. 
+
    799.              synced:function () {
      800. 
+
    800. 12780                return this._static.synced;
      801. 
 
    801.              }
      802. 
-
    802.          },
      803. 
 
    803.  
      804. 
-
    804.          /**@ignore*/
      805. 
-
    805.          setters:{
      806. 
-
    806.              /**@lends patio.Model*/
      807. 
-
    807.              /**@ignore*/
      808. 
-
    808.              camelize:function (camelize) {
      809. 
-
    809. 26                camelize = camelize === true;
      810. 
-
    810. 26                if (camelize) {
      811. 
-
    811. 26                    this.identifierOutputMethod = "camelize";
      812. 
-
    812. 26                    this.identifierInputMethod = "underscore";
      813. 
-
    813.                  }
      814. 
-
    814. 26                this.__camelize = camelize;
      815. 
-
    815. 26                this.__underscore = !camelize;
      816. 
+
    816.          }
      817. 
+
    817.      },
      818. 
 
    818.  
      819. 
-
    819.              },
      820. 
-
    820.              /**@ignore*/
      821. 
-
    821.              underscore:function (underscore) {
      822. 
-
    822. 1                underscore = underscore === true;
      823. 
-
    823. 1                if (underscore) {
      824. 
-
    824. 1                    this.identifierOutputMethod = "underscore";
      825. 
-
    825. 1                    this.identifierInputMethod = "camelize";
      826. 
-
    826.                  }
      827. 
-
    827. 1                this.__underscore = underscore;
      828. 
-
    828. 1                this.__camelize = !underscore;
      829. 
+
    829.      static:{
      830. 
+
    830.          /**
      831. 
+
    831.           * @lends patio.Model
      832. 
+
    832.           */
      833. 
 
    833.  
      834. 
-
    834.              }
      835. 
-
    835.          }
      836. 
-
    836.      }
      837. 
+
    837.          synced:false,
      838. 
 
    838.  
      839. 
-
    839.  }).as(exports, "Model");
      840. 
+
    840.          /**
      841. 
+
    841.           * Set to false to prevent the emitting of an event on load
      842. 
+
    842.           * @default true
      843. 
+
    843.           */
      844. 
+
    844.          emitOnLoad:true,
      845. 
 
    845.  
      846. 
+
    846.          /**
      847. 
+
    847.           * Set to false to prevent the emitting of an event on the setting of a column value
      848. 
+
    848.           * @default true
      849. 
+
    849.           */
      850. 
+
    850.          emitOnColumnSet:true,
      851. 
 
    851.  
      852. 
-
    852. 1function checkAndAddDBToTable(db, table) {
      853. 
-
    853. 93    if (!table.contains(db)) {
      854. 
-
    854. 34        table.set(db, new HashTable());
      855. 
-
    855.      }
      856. 
-
    856.  }
      857. 
 
    857.  
      858. 
-
    858.  /**@ignore*/
      859. 
-
    859. 1exports.create = function (name, supers, modelOptions) {
      860. 
-
    860. 93    if (!patio) {
      861. 
-
    861. 1        (patio = require("./index"));
      862. 
-
    862. 1        patio.on("disconnect", function () {
      863. 
-
    863. 40            MODELS.clear();
      864. 
-
    864.          });
      865. 
-
    865.      }
      866. 
-
    866. 93    var db, ds, tableName;
      867. 
-
    867. 93    var key, modelKey;
      868. 
-
    868. 93    if (isString(name)) {
      869. 
-
    869. 87        tableName = name;
      870. 
-
    870. 87        key = db = patio.defaultDatabase || "default";
      871. 
-
    871. 6    } else if (isInstanceOf(name, patio.Dataset)) {
      872. 
-
    872. 6        ds = name;
      873. 
-
    873. 6        tableName = ds.firstSourceAlias;
      874. 
-
    874. 6        key = db = ds.db;
      875. 
-
    875.      }
      876. 
-
    876. 93    var hasSuper = false;
      877. 
-
    877. 93    if (isHash(supers) || isUndefinedOrNull(supers)) {
      878. 
-
    878. 90        modelOptions = supers;
      879. 
-
    879. 90        supers = [Model];
      880. 
-
    880.      } else {
      881. 
-
    881. 3        supers = toArray(supers);
      882. 
-
    882. 3        supers = supers.map(function (sup) {
      883. 
-
    883. 3            return exports.getModel(sup, db);
      884. 
-
    884.          });
      885. 
-
    885. 3        hasSuper = true;
      886. 
-
    886.      }
      887. 
+
    887.          /**
      888. 
+
    888.           * Set to false to prevent empty strings from being type casted to null
      889. 
+
    889.           * @default true
      890. 
+
    890.           */
      891. 
+
    891.          typecastEmptyStringToNull:true,
      892. 
 
    892.  
      893. 
-
    893. 93    var model;
      894. 
-
    894. 93    checkAndAddDBToTable(key, MODELS);
      895. 
+
    895.          /**
      896. 
+
    896.           * Set to false to prevent properties from being type casted when loaded from the database.
      897. 
+
    897.           * See {@link patio.Database#typecastValue}
      898. 
+
    898.           * @default true
      899. 
+
    899.           */
      900. 
+
    900.          typecastOnLoad:true,
      901. 
 
    901.  
      902. 
-
    902. 93    var DEFAULT_PROTO = {instance:{}, "static":{}};
      903. 
-
    903. 93    modelOptions = merge(DEFAULT_PROTO, modelOptions || {});
      904. 
-
    904. 93    modelOptions.instance._hooks = ["save", "update", "remove", "load"];
      905. 
-
    905. 93    modelOptions.instance.__hooks = {pre:{}, post:{}};
      906. 
-
    906.      //Mixin the column setter/getters
      907. 
-
    907. 93    modelOptions["static"].synced = false;
      908. 
-
    908. 93    modelOptions["static"].__tableName = tableName;
      909. 
-
    909. 93    modelOptions["static"].__db = (db === "default" ? null : db);
      910. 
-
    910. 93    modelOptions["static"].__supers = hasSuper ? supers : [];
      911. 
-
    911. 93    modelOptions["static"].__dataset = ds;
      912. 
-
    912. 93    model = define(supers.concat(modelOptions.plugins || []).concat([AssociationPlugin]), modelOptions);
      913. 
-
    913. 93    ["pre", "post"].forEach(function (op) {
      914. 
-
    914. 186        var optionsOp = modelOptions[op];
      915. 
-
    915. 186        if (optionsOp) {
      916. 
-
    916. 0            for (var i in optionsOp) {
      917. 
-
    917. 0                model[op](i, optionsOp[i]);
      918. 
-
    918.              }
      919. 
-
    919.          }
      920. 
-
    920.      });
      921. 
-
    921. 93    if (!(MODELS.get(key).contains(checkAndTransformName(name)))) {
      922. 
-
    922. 61        MODELS.get(key).set(name, model);
      923. 
-
    923.      }
      924. 
-
    924. 93    return model;
      925. 
-
    925.  };
      926. 
+
    926.          /**
      927. 
+
    927.           * Set to false to prevent properties from being type casted when manually set.
      928. 
+
    928.           * See {@link patio.Database#typecastValue}
      929. 
+
    929.           * @default true
      930. 
+
    930.           */
      931. 
+
    931.          typecastOnAssignment:true,
      932. 
 
    932.  
      933. 
-
    933. 1exports.syncModels = function (cb) {
      934. 
-
    934. 35    var ret = new Promise();
      935. 
-
    935. 35    serial(MODELS.entrySet.map(function (entry) {
      936. 
-
    936. 34        return function () {
      937. 
-
    937. 34            var value = entry.value;
      938. 
-
    938. 34            return serial(value.entrySet.map(function (m) {
      939. 
-
    939. 61                return hitch(m.value, "sync");
      940. 
-
    940.              }));
      941. 
-
    941.          };
      942. 
-
    942.      })).then(hitchIgnore(ret, "callback", true), ret);
      943. 
-
    943. 35    if (isFunction(cb)) {
      944. 
-
    944. 0        ret.classic(cb);
      945. 
-
    945.      }
      946. 
-
    946. 35    return ret.promise();
      947. 
-
    947.  };
      948. 
+
    948.          /**
      949. 
+
    949.           * Set to false to prevent errors thrown while type casting a value from being propogated.
      950. 
+
    950.           * @default true
      951. 
+
    951.           */
      952. 
+
    952.          raiseOnTypecastError:true,
      953. 
 
    953.  
      954. 
-
    954. 1var checkAndGetModel = function (db, name) {
      955. 
-
    955. 21198    var ret;
      956. 
-
    956. 21198    if (MODELS.contains(db)) {
      957. 
-
    957. 10600        ret = MODELS.get(db).get(checkAndTransformName(name));
      958. 
-
    958.      }
      959. 
-
    959. 21198    return ret;
      960. 
-
    960.  };
      961. 
+
    961.          /**
      962. 
+
    962.           * Set to false to allow the setting of primary keys.
      963. 
+
    963.           * @default false
      964. 
+
    964.           */
      965. 
+
    965.          isRestrictedPrimaryKey:true,
      966. 
 
    966.  
      967. 
+
    967.          /**
      968. 
+
    968.           * Set to false to prevent models from using transactions when saving, deleting, or updating.
      969. 
+
    969.           * This applies to the model associations also.
      970. 
+
    970.           */
      971. 
+
    971.          useTransactions:true,
      972. 
 
    972.  
      973. 
-
    973. 1exports.getModel = function (name, db) {
      974. 
-
    974. 10603    var ret = null;
      975. 
-
    975. 10603    if (isDefined(name)) {
      976. 
-
    976. 10603        !patio && (patio = require("./index"));
      977. 
-
    977. 10603        if (isFunction(name)) {
      978. 
-
    978. 3            ret = name;
      979. 
-
    979.          } else {
      980. 
-
    980. 10600            if (!db && isInstanceOf(name, patio.Dataset)) {
      981. 
-
    981. 2                db = name.db;
      982. 
-
    982.              }
      983. 
-
    983. 10600            var defaultDb = patio.defaultDatabase;
      984. 
-
    984. 10600            if (db) {
      985. 
-
    985. 10574                ret = checkAndGetModel(db, name);
      986. 
-
    986. 10574                if (!ret && db === defaultDb) {
      987. 
-
    987. 10572                    ret = checkAndGetModel("default", name);
      988. 
-
    988.                  }
      989. 
-
    989.              } else {
      990. 
-
    990. 26                db = patio.defaultDatabase;
      991. 
-
    991. 26                ret = checkAndGetModel(db, name);
      992. 
-
    992. 26                if (!ret) {
      993. 
-
    993. 26                    ret = checkAndGetModel("default", name);
      994. 
-
    994.                  }
      995. 
-
    995.              }
      996. 
-
    996.          }
      997. 
-
    997.      } else {
      998. 
-
    998. 0        ret = name;
      999. 
-
    999.      }
      1000. 
-
    1000. 10603    if (isUndefinedOrNull(ret)) {
      1001. 
-
    1001. 0        throw new ModelError("Model " + name + " has not been registered with patio");
      1002. 
-
    1002.      }
      1003. 
-
    1003. 10603    return ret;
      1004. 
-
    1004.  };
      1005. 
+
    1005.          /**
      1006. 
+
    1006.           * See {@link patio.Dataset#identifierOutputMethod}
      1007. 
+
    1007.           * @default null
      1008. 
+
    1008.           */
      1009. 
+
    1009.          identifierOutputMethod:null,
      1010. 
 
    1010.  
      1011. 
-
    1011.
    -
    - -
    - - - - - -
    -
    associations/manyToMany.js
    -     		-
    - Coverage89.13 - SLOC309 - LOC138 - Missed15 -
    -
    - 
    1. 1var comb = require("comb-proxy"),
      2. 
-
    2.      define = comb.define,
      3. 
-
    3.      isUndefined = comb.isUndefined,
      4. 
-
    4.      isUndefinedOrNull = comb.isUndefinedOrNull,
      5. 
-
    5.      isFunction = comb.isFunction,
      6. 
-
    6.      isInstanceOf = comb.isInstanceOf,
      7. 
-
    7.      sql = require("../sql").sql,
      8. 
-
    8.      hitch = comb.hitch,
      9. 
-
    9.      array = comb.array,
      10. 
-
    10.      isBoolean = comb.isBoolean,
      11. 
-
    11.      serial = comb.serial,
      12. 
-
    12.      when = comb.when,
      13. 
-
    13.      zip = array.zip,
      14. 
-
    14.      Promise = comb.Promise,
      15. 
-
    15.      PromiseList = comb.PromiseList,
      16. 
-
    16.      hitchIgnore = comb.hitchIgnore,
      17. 
-
    17.      OneToMany = require("./oneToMany"),
      18. 
-
    18.      pluralize = comb.pluralize,
      19. 
-
    19.      AssociationError = require("../errors").AssociationError;
      20. 
+
    20.          /**
      21. 
+
    21.           * See {@link patio.Dataset#identifierInputMethod}
      22. 
+
    22.           * @default null
      23. 
+
    23.           */
      24. 
+
    24.          identifierInputMethod:null,
      25. 
 
    25.  
      26. 
-
    26. 1var LOGGER = comb.logger("comb.associations.ManyToMany");
      27. 
-
    27.  /**
      28. 
-
    28.   * @class Class to define a manyToMany association.
      29. 
-
    29.   *
      30. 
-
    30.   * </br>
      31. 
-
    31.   * <b>NOT to be instantiated directly</b>
      32. 
-
    32.   * Its just documented for reference.
      33. 
-
    33.   *
      34. 
-
    34.   * @name ManyToMany
      35. 
-
    35.   * @augments patio.associations.OneToMany
      36. 
-
    36.   * @memberOf patio.associations
      37. 
-
    37.   *
      38. 
-
    38.   * @param {String} options.joinTable the joinTable of the association.
      39. 
-
    39.   *
      40. 
-
    40.   *
      41. 
-
    41.   * @property {String} joinTable the join table used in the relation.
      42. 
-
    42.   * */
      43. 
-
    43. 1module.exports = define(OneToMany, {
      44. 
-
    44.      instance:{
      45. 
-
    45.          /**@lends patio.associations.ManyToMany.prototype*/
      46. 
-
    46.          type:"manyToMany",
      47. 
+
    47.          /**
      48. 
+
    48.           * Set to false to prevent the reload of a model after saving.
      49. 
+
    49.           * @default true
      50. 
+
    50.           */
      51. 
+
    51.          reloadOnSave:true,
      52. 
 
    52.  
      53. 
-
    53.          _fetchMethod:"all",
      54. 
+
    54.          /**
      55. 
+
    55.           * Columns that should be restriced when setting values through the {@link patio.Model#set} method.
      56. 
+
    56.           *
      57. 
+
    57.           */
      58. 
+
    58.          restrictedColumns:null,
      59. 
 
    59.  
      60. 
-
    60.          supportsStringKey:false,
      61. 
+
    61.          /**
      62. 
+
    62.           * Set to false to prevent the reload of a model after updating.
      63. 
+
    63.           * @default true
      64. 
+
    64.           */
      65. 
+
    65.          reloadOnUpdate:true,
      66. 
 
    66.  
      67. 
-
    67.          supportsCompositeKey:false,
      68. 
 
    68.  
      69. 
+
    69.          __camelize:false,
      70. 
+
    70.  
      71. 
+
    71.          __underscore:false,
      72. 
 
    72.  
      73. 
-
    73.          _filter:function (parent) {
      74. 
-
    74. 326            var keys = this._getAssociationKey(parent);
      75. 
-
    75. 326            var options = this.__opts || {};
      76. 
-
    76. 326            var ds;
      77. 
-
    77. 326            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
      78. 
-
    78. 0                ds = ds.apply(parent, [parent]);
      79. 
-
    79.              }
      80. 
-
    80. 326            if (!ds) {
      81. 
-
    81. 326                ds = this.model.dataset;
      82. 
-
    82. 326                ds = ds.select(ds.firstSourceAlias.all()).naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
      83. 
-
    83. 326                    return sql.stringToIdentifier(k);
      84. 
-
    84.                  })).concat(zip(keys[0], this.parentPrimaryKey.map(function (k) {
      85. 
-
    85. 326                    return parent[k];
      86. 
-
    86.                  }))));
      87. 
-
    87. 326                var recip = this.model._findAssociation(this);
      88. 
-
    88. 326                if (recip) {
      89. 
-
    89. 326                    recip = recip[1];
      90. 
-
    90.                  }
      91. 
-
    91. 326                ds.rowCb = hitch(this, function (item) {
      92. 
-
    92. 340                    var ret = new Promise();
      93. 
-
    93. 340                    var model = this._toModel(item, true);
      94. 
-
    94. 340                    if (recip) {
      95. 
-
    95. 340                        recip.__setValue(model, parent);
      96. 
-
    96.                      }
      97. 
-
    97.                      //call hook to finish other model associations
      98. 
-
    98. 340                    model._hook("post", "load").then(hitch(this, function () {
      99. 
-
    99. 340                        ret.callback(model);
      100. 
-
    100.                      }), ret);
      101. 
-
    101. 340                    return ret.promise();
      102. 
-
    102.                  });
      103. 
+
    103.          __columns:null,
      104. 
 
    104.  
      105. 
-
    105.              }
      106. 
+
    106.          __schema:null,
      107. 
 
    107.  
      108. 
-
    108. 326            return this._setDatasetOptions(ds);
      109. 
-
    109.          },
      110. 
+
    110.          __primaryKey:null,
      111. 
 
    111.  
      112. 
-
    112.          _setAssociationKeys:function (parent, model, val) {
      113. 
-
    113. 534            var keys = this._getAssociationKey(parent),
      114. 
-
    114.                  leftKey = keys[0],
      115. 
-
    115.                  parentPk = this.parentPrimaryKey;
      116. 
-
    116. 534            if (!(leftKey && leftKey.length === parentPk.length)) {
      117. 
-
    117. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
      118. 
+
    118.          __dataset:null,
      119. 
+
    119.  
      120. 
+
    120.          __db:null,
      121. 
+
    121.  
      122. 
+
    122.          __tableName:null,
      123. 
+
    123.  
      124. 
+
    124.  
      125. 
+
    125.          /**
      126. 
+
    126.           * The table that this Model represents.
      127. 
+
    127.           * <b>READ ONLY</b>
      128. 
+
    128.           */
      129. 
+
    129.          table:null,
      130. 
+
    130.  
      131. 
+
    131.          /**
      132. 
+
    132.           * patio  - read only
      133. 
+
    133.           *
      134. 
+
    134.           * @type patio
      135. 
+
    135.           */
      136. 
+
    136.          patio:null,
      137. 
+
    137.  
      138. 
+
    138.          init:function () {
      139. 
+
    139. 92            var emitter = new EventEmitter();
      140. 
+
    140. 92            ["addListener", "on", "once", "removeListener",
      141. 
+
    141.                  "removeAllListeners", "setMaxListeners", "listeners", "emit"].forEach(function (name) {
      142. 
+
    142. 736                    this[name] = emitter[name].bind(emitter);
      143. 
+
    143.                  }, this);
      144. 
+
    144. 92            if (this.__tableName) {
      145. 
+
    145. 91                this._setTableName(this.__tableName);
      146. 
 
    146.              }
      147. 
-
    147. 534            for (var i = 0; i < leftKey.length; i++) {
      148. 
-
    148. 534                model[leftKey[i]] = !isUndefined(val) ? val : parent[parentPk[i]];
      149. 
+
    149. 92            if (this.__db) {
      150. 
+
    150. 7                this._setDb(this.__db);
      151. 
 
    151.              }
      152. 
 
    152.          },
      153. 
 
    153.  
      154. 
 
    154.  
      155. 
-
    155.          __createJoinTableInsertRemoveQuery:function (model, item) {
      156. 
-
    156. 176            var q = {};
      157. 
-
    157. 176            var keys = this._getAssociationKey(model),
      158. 
-
    158.                  leftKey = keys[0],
      159. 
-
    159.                  rightKey = keys[1],
      160. 
-
    160.                  parentPk = this.parentPrimaryKey,
      161. 
-
    161.                  modelPk = this.modelPrimaryKey;
      162. 
-
    162. 176            if (!(leftKey && leftKey.length === parentPk.length)) {
      163. 
-
    163. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
      164. 
-
    164.              }
      165. 
-
    165. 176            if (!(rightKey && rightKey.length === modelPk.length)) {
      166. 
-
    166. 0                throw new AssociationError("Invalid rightKey for " + this.name + " : " + rightKey);
      167. 
-
    167.              }
      168. 
-
    168. 176            for (var i = 0; i < leftKey.length; i++) {
      169. 
-
    169. 176                q[leftKey[i]] = model[parentPk[i]];
      170. 
+
    170.          sync:function (cb) {
      171. 
+
    171. 3968            var ret = new Promise();
      172. 
+
    172. 3968            if (!this.synced) {
      173. 
+
    173. 93                var db = this.db, tableName = this.tableName, supers = this.__supers;
      174. 
+
    174. 93                db.schema(tableName).then(hitch(this, function (schema) {
      175. 
+
    175. 93                    if (!this.synced && schema) {
      176. 
+
    176. 93                        this._setSchema(schema);
      177. 
+
    177. 93                        if (supers && supers.length) {
      178. 
+
    178. 3                            new PromiseList(supers.map(function (sup) {
      179. 
+
    179. 3                                return sup.sync();
      180. 
+
    180.                              })).then(hitch(this, function () {
      181. 
+
    181. 3                                this.synced = true;
      182. 
+
    182. 3                                supers.forEach(this.inherits, this);
      183. 
+
    183. 3                                ret.callback(this);
      184. 
+
    184.                              }), ret);
      185. 
+
    185.                          } else {
      186. 
+
    186. 90                            this.synced = true;
      187. 
+
    187. 90                            ret.callback(this);
      188. 
+
    188.                          }
      189. 
+
    189. 93                        this.emit("sync", this);
      190. 
+
    190.                      } else {
      191. 
+
    191. 0                        var error = new ModelError("Unable to find schema for " + tableName);
      192. 
+
    192. 0                        this.emit("error", error);
      193. 
+
    193. 0                        ret.errback(error);
      194. 
+
    194.                      }
      195. 
+
    195.                  }), ret);
      196. 
+
    196.              } else {
      197. 
+
    197. 3875                ret.callback(this);
      198. 
 
    198.              }
      199. 
-
    199. 176            for (i = 0; i < rightKey.length; i++) {
      200. 
-
    200. 176                q[rightKey[i]] = item[modelPk[i]];
      201. 
+
    201. 3968            if (isFunction(cb)) {
      202. 
+
    202. 0                ret.classic(cb);
      203. 
 
    203.              }
      204. 
-
    204. 176            return q;
      205. 
+
    205. 3968            return ret.promise();
      206. 
 
    206.          },
      207. 
 
    207.  
      208. 
-
    208.          _preRemove:function (next, model) {
      209. 
-
    209. 202            if (this.isOwner && !this.isCascading) {
      210. 
-
    210. 202                var q = {};
      211. 
-
    211. 202                this._setAssociationKeys(model, q);
      212. 
-
    212. 202                this.joinTable.where(q).remove().classic(next);
      213. 
-
    213.              } else {
      214. 
-
    214. 0                next();
      215. 
-
    215.              }
      216. 
+
    216.          /**
      217. 
+
    217.           * Stub for plugins to notified of model inheritance
      218. 
+
    218.           *
      219. 
+
    219.           * @param {patio.Model} model a model class to inherit from
      220. 
+
    220.           */
      221. 
+
    221.          inherits:function (model) {
      222. 
 
    222.          },
      223. 
 
    223.  
      224. 
 
    224.  
      225. 
-
    225.          addAssociation:function (item, model, reload) {
      226. 
-
    226. 260            reload = isBoolean(reload) ? reload : false;
      227. 
-
    227. 260            var ret = new Promise().callback(model);
      228. 
-
    228. 260            if (!isUndefinedOrNull(item)) {
      229. 
-
    229. 260                if (!model.isNew) {
      230. 
-
    230. 148                    item = this._toModel(item);
      231. 
-
    231. 148                    var loaded = this.associationLoaded(model);
      232. 
-
    232. 148                    var recip = this.model._findAssociation(this), save = item.isNew;
      233. 
-
    233. 148                    ret = model._checkTransaction(hitch(this, function () {
      234. 
-
    234. 148                        var joinTable = this.joinTable, ret = new Promise();
      235. 
-
    235. 148                        serial([
      236. 
-
    236.                              function () {
      237. 
-
    237. 148                                return save ? item.save() : null;
      238. 
-
    238.                              },
      239. 
-
    239.                              function () {
      240. 
-
    240. 148                                return joinTable.insert(this.__createJoinTableInsertRemoveQuery(model, item));
      241. 
-
    241.                              }.bind(this),
      242. 
-
    242.                              function () {
      243. 
-
    243. 148                                if (recip) {
      244. 
-
    244. 148                                    recip[1].__setValue(item, [model]);
      245. 
-
    245.                                  }
      246. 
-
    246.                              },
      247. 
-
    247.                              function () {
      248. 
-
    248. 148                                if (loaded && reload) {
      249. 
-
    249. 3                                    return this.parent._reloadAssociationsForType(this.type, this.model, model);
      250. 
-
    250.                                  } else {
      251. 
-
    251. 145                                    return model;
      252. 
-
    252.                                  }
      253. 
-
    253.                              }.bind(this)
      254. 
-
    254.                          ]).then(hitchIgnore(ret, "callback", model), ret);
      255. 
-
    255. 148                        return ret.promise();
      256. 
-
    256.                      }));
      257. 
-
    257.                  } else {
      258. 
-
    258. 112                    item = this._toModel(item);
      259. 
-
    259. 112                    var items = this.getAssociation(model);
      260. 
-
    260. 112                    if (isUndefinedOrNull(items)) {
      261. 
-
    261. 39                        this.__setValue(model, [item]);
      262. 
-
    262.                      } else {
      263. 
-
    263. 73                        items.push(item);
      264. 
-
    264.                      }
      265. 
-
    265.                  }
      266. 
-
    266.              }
      267. 
-
    267. 260            return ret.promise();
      268. 
+
    268.          /**
      269. 
+
    269.           * Create a new model initialized with the specified values.
      270. 
+
    270.           *
      271. 
+
    271.           * @param {Object} values  the values to initialize the model with.
      272. 
+
    272.           *
      273. 
+
    273.           * @returns {Model} instantiated model initialized with the values passed in.
      274. 
+
    274.           */
      275. 
+
    275.          create:function (values) {
      276. 
+
    276.              //load an object from an object
      277. 
+
    277. 0            return new this(values, false);
      278. 
 
    278.          },
      279. 
 
    279.  
      280. 
-
    280.          removeItem:function (item, model, remove, reload) {
      281. 
-
    281. 56            reload = isBoolean(reload) ? reload : false;
      282. 
-
    282. 56            remove = isBoolean(remove) ? remove : false;
      283. 
-
    283. 56            var ret = new Promise().callback(model);
      284. 
-
    284. 56            if (!isUndefinedOrNull(item)) {
      285. 
-
    285. 56                if (!model.isNew) {
      286. 
-
    286. 56                    if (isInstanceOf(item, this.model) && !item.isNew) {
      287. 
-
    287. 56                        var loaded = this.associationLoaded(model);
      288. 
-
    288. 56                        remove = remove && !item.isNew;
      289. 
-
    289. 56                        ret = new Promise();
      290. 
-
    290. 56                        model._checkTransaction(hitch(this, function () {
      291. 
-
    291. 56                            return remove ? item.remove() : this.joinTable.where(this.__createJoinTableInsertRemoveQuery(model, item)).remove();
      292. 
-
    292.                          })).then(hitch(this, function () {
      293. 
-
    293. 56                            if (loaded && reload) {
      294. 
-
    294. 18                                return this.parent._reloadAssociationsForType(this.type, this.model, model).then(ret);
      295. 
-
    295.                              } else {
      296. 
-
    296. 38                                ret.callback(model);
      297. 
-
    297.                              }
      298. 
-
    298.                          }), ret);
      299. 
-
    299. 56                        return ret.promise();
      300. 
-
    300.                      }
      301. 
+
    301.          load:function (vals) {
      302. 
+
    302. 924            var ret = new Promise();
      303. 
+
    303.              //sync our model
      304. 
+
    304. 924            this.sync().then(hitch(this, function () {
      305. 
+
    305. 924                var m = new this(vals, true);
      306. 
+
    306.                  //call the hooks!
      307. 
+
    307. 924                m._hook("post", "load").then(function () {
      308. 
+
    308. 924                    ret.callback(m);
      309. 
+
    309.                  }, ret);
      310. 
+
    310.              }), ret);
      311. 
+
    311. 924            return ret.promise();
      312. 
+
    312.          },
      313. 
+
    313.  
      314. 
+
    314.          _checkTransaction:function (opts, cb) {
      315. 
+
    315. 2892            if (isFunction(opts)) {
      316. 
+
    316. 639                cb = opts;
      317. 
+
    317. 639                opts = {};
      318. 
+
    318.              } else {
      319. 
+
    319. 2253                opts = opts || {};
      320. 
+
    320.              }
      321. 
+
    321. 2892            var ret = new Promise(), retVal = null, errored = false;
      322. 
+
    322. 2892            this.sync().then(hitch(this, function () {
      323. 
+
    323. 2892                if (this.useTransaction(opts)) {
      324. 
+
    324. 2892                    this.db.transaction(opts, hitch(this, function () {
      325. 
+
    325. 2892                        return when(cb()).then(function () {
      326. 
+
    326. 2848                            retVal = argsToArray(arguments);
      327. 
+
    327.                          }, function () {
      328. 
+
    328. 44                            retVal = argsToArray(arguments);
      329. 
+
    329. 44                            errored = true;
      330. 
+
    330.                          });
      331. 
+
    331.                      })).then(hitch(this, function () {
      332. 
+
    332. 2848                        ret[errored ? "errback" : "callback"].apply(ret, retVal);
      333. 
+
    333.                      }), hitch(this, function () {
      334. 
+
    334. 44                        if (errored) {
      335. 
+
    335. 44                            ret.errback.apply(ret, retVal);
      336. 
+
    336.                          } else {
      337. 
+
    337. 0                            ret.errback.apply(ret, arguments);
      338. 
+
    338.                          }
      339. 
+
    339.                      }));
      340. 
 
    340.                  } else {
      341. 
-
    341. 0                    item = this._toModel(item);
      342. 
-
    342. 0                    var items = this.getAssociation(model), index;
      343. 
-
    343. 0                    if (!isUndefinedOrNull(items) && (index = items.indexOf(item)) !== -1) {
      344. 
-
    344. 0                        items.splice(index, 1);
      345. 
-
    345.                      }
      346. 
+
    346. 0                    when(cb()).then(ret);
      347. 
 
    347.                  }
      348. 
+
    348.              }), ret);
      349. 
+
    349. 2892            return ret.promise();
      350. 
+
    350.          },
      351. 
+
    351.  
      352. 
+
    352.          /**
      353. 
+
    353.           * @private
      354. 
+
    354.           * Returns a boolean indicating whether or not to use a transaction.
      355. 
+
    355.           * @param {Object} [opts] set a transaction property to override the {@link patio.Model#useTransaction}.
      356. 
+
    356.           */
      357. 
+
    357.          useTransaction:function (opts) {
      358. 
+
    358. 2892            opts = opts || {};
      359. 
+
    359. 2892            return isBoolean(opts.transaction) ? opts.transaction === true : this.useTransactions === true;
      360. 
+
    360.          },
      361. 
+
    361.  
      362. 
+
    362.          _setDataset:function (ds) {
      363. 
+
    363. 3            this.__dataset = ds;
      364. 
+
    364. 3            if (ds.db) {
      365. 
+
    365. 3                this._setDb(ds.db);
      366. 
 
    366.              }
      367. 
-
    367. 0            return ret.promise();
      368. 
 
    368.          },
      369. 
 
    369.  
      370. 
-
    370.          removeAllItems:function (model, remove) {
      371. 
-
    371. 4            remove = isBoolean(remove) ? remove : false;
      372. 
-
    372. 4            var ret = new Promise();
      373. 
-
    373. 4            if (!model.isNew) {
      374. 
-
    374. 4                var q = {}, removeQ = {};
      375. 
-
    375. 4                this._setAssociationKeys(model, q);
      376. 
-
    376. 4                this._setAssociationKeys(model, removeQ, null);
      377. 
-
    377. 4                var loaded = this.associationLoaded(model);
      378. 
-
    378. 4                return model._checkTransaction(hitch(this, function () {
      379. 
-
    379. 4                    var ds = this.model.dataset, ret = new Promise();
      380. 
-
    380. 4                    when(remove ? this._filter(model).forEach(function (m) {
      381. 
-
    381. 6                        return m.remove();
      382. 
-
    382.                      }) : this.joinTable.filter(q).update(removeQ)).then(function () {
      383. 
-
    383. 4                        if (loaded) {
      384. 
-
    384. 2                            this.parent._reloadAssociationsForType(this.type, this.model, model)
      385. 
-
    385.                                  .then(hitchIgnore(ret, "callback", model), ret);
      386. 
-
    386.                          } else {
      387. 
-
    387. 2                            ret.callback(model);
      388. 
-
    388.                          }
      389. 
-
    389.                      }.bind(this), ret);
      390. 
-
    390. 4                    return ret.promise();
      391. 
-
    391.                  }));
      392. 
-
    392.              } else {
      393. 
-
    393.                  //todo we may want to check if any of the items were previously saved items;
      394. 
-
    394. 0                this._clearAssociations(model);
      395. 
-
    395. 0                ret.callback(model);
      396. 
+
    396.          _setDb:function (db) {
      397. 
+
    397. 10            this.__db = db;
      398. 
+
    398.          },
      399. 
+
    399.  
      400. 
+
    400.          _setTableName:function (name) {
      401. 
+
    401. 91            this.__tableName = name;
      402. 
+
    402.          },
      403. 
+
    403.  
      404. 
+
    404.          _setColumns:function (cols) {
      405. 
+
    405. 96            var proto = this.prototype;
      406. 
+
    406. 96            if (this.__columns) {
      407. 
+
    407. 6                this.__columns.forEach(function (name) {
      408. 
+
    408. 16                    delete proto[name];
      409. 
+
    409.                  });
      410. 
 
    410.              }
      411. 
-
    411. 0            return ret.promise();
      412. 
+
    412. 96            this.__columns = cols;
      413. 
+
    413. 96            cols.forEach(function (name) {
      414. 
+
    414. 779                this._defineColumnSetter(name);
      415. 
+
    415. 779                this._defineColumnGetter(name);
      416. 
+
    416.              }, this);
      417. 
+
    417.          },
      418. 
+
    418.  
      419. 
+
    419.          _setPrimaryKey:function (pks) {
      420. 
+
    420. 99            this.__primaryKey = pks || [];
      421. 
+
    421.          },
      422. 
+
    422.  
      423. 
+
    423.          _setSchema:function (schema) {
      424. 
+
    424. 96            var columns = [];
      425. 
+
    425. 96            var pks = [];
      426. 
+
    426. 96            for (var i in schema) {
      427. 
+
    427. 779                var col = schema[i];
      428. 
+
    428. 779                var name = applyColumnTransformMethod(i, this.identifierOutputMethod);
      429. 
+
    429. 779                schema[name] = col;
      430. 
+
    430. 779                columns.push(name);
      431. 
+
    431. 779                col.primaryKey && pks.push(name);
      432. 
+
    432.              }
      433. 
+
    433. 96            this.__schema = schema;
      434. 
+
    434. 96            this._setPrimaryKey(pks);
      435. 
+
    435. 96            this._setColumns(columns);
      436. 
+
    436.          },
      437. 
+
    437.  
      438. 
+
    438.          _defineColumnSetter:function (name) {
      439. 
+
    439.              /*Adds a setter to an object*/
      440. 
+
    440. 779            this.prototype.__defineSetter__(name, function (val) {
      441. 
+
    441. 7556                this._setColumnValue(name, val);
      442. 
+
    442.              });
      443. 
+
    443.          },
      444. 
+
    444.  
      445. 
+
    445.          _defineColumnGetter:function (name) {
      446. 
+
    446. 779            this.prototype.__defineGetter__(name, function () {
      447. 
+
    447. 5427                return this._getColumnValue(name);
      448. 
+
    448.              });
      449. 
 
    449.          },
      450. 
 
    450.  
      451. 
 
    451.  
      452. 
+
    452.          /**
      453. 
+
    453.           * @ignore
      454. 
+
    454.           */
      455. 
 
    455.          getters:{
      456. 
+
    456.              /**@lends patio.Model*/
      457. 
 
    457.  
      458. 
-
    458.              select:function () {
      459. 
-
    459. 326                return this.__select;
      460. 
-
    460.              },
      461. 
+
    461.              /**
      462. 
+
    462.               * Set to true if this models column names should be use the "underscore" method when sending
      463. 
+
    463.               * keys to the database and to "camelize" method on columns returned from the database. If set to false see
      464. 
+
    464.               * {@link patio.Model#underscore}.
      465. 
+
    465.               * @field
      466. 
+
    466.               * @default false
      467. 
+
    467.               * @type {Boolean}
      468. 
+
    468.               */
      469. 
+
    469.              camelize:function (camelize) {
      470. 
+
    470. 10686                return  this.__camelize;
      471. 
 
    471.  
      472. 
-
    472.              defaultLeftKey:function () {
      473. 
-
    473. 1740                return this.__opts.leftKey || this.parent.tableName + "Id";
      474. 
 
    474.              },
      475. 
 
    475.  
      476. 
-
    476.              defaultRightKey:function () {
      477. 
-
    477. 1740                return this.__opts.rightKey || this.model.tableName + "Id";
      478. 
-
    478.              },
      479. 
+
    479.              /**
      480. 
+
    480.               * Set to true if this models column names should be use the "camelize" method when sending
      481. 
+
    481.               * keys to the database and to "underscore" method on columns returned from the database. If set to false see
      482. 
+
    482.               * {@link patio.Model#underscore}.
      483. 
+
    483.               * @field
      484. 
+
    484.               * @default false
      485. 
+
    485.               * @type {Boolean}
      486. 
+
    486.               */
      487. 
+
    487.              underscore:function (underscore) {
      488. 
+
    488. 36                return this.__underscore;
      489. 
 
    489.  
      490. 
-
    490.              parentPrimaryKey:function () {
      491. 
-
    491. 1036                return this.__opts.leftPrimaryKey || this.parent.primaryKey;
      492. 
 
    492.              },
      493. 
 
    493.  
      494. 
-
    494.              modelPrimaryKey:function () {
      495. 
-
    495. 502                return this.__opts.rightPrimaryKey || this.model.primaryKey;
      496. 
-
    496.              },
      497. 
+
    497.              /**@lends patio.Model*/
      498. 
 
    498.  
      499. 
-
    499.              joinTableName:function () {
      500. 
-
    500. 344                if (!this._joinTable) {
      501. 
-
    501. 18                    var options = this.__opts;
      502. 
-
    502. 18                    var joinTable = options.joinTable;
      503. 
-
    503. 18                    if (isUndefined(joinTable)) {
      504. 
-
    504. 18                        var defaultJoinTable = this.defaultJoinTable;
      505. 
-
    505. 18                        if (isUndefined(defaultJoinTable)) {
      506. 
-
    506. 0                            throw new Error("Unable to determine jointable for " + this.name);
      507. 
-
    507.                          } else {
      508. 
-
    508. 18                            this._joinTable = defaultJoinTable;
      509. 
-
    509.                          }
      510. 
-
    510.                      } else {
      511. 
-
    511. 0                        this._joinTable = joinTable;
      512. 
-
    512.                      }
      513. 
-
    513.                  }
      514. 
-
    514. 344                return this._joinTable;
      515. 
+
    515.              /**
      516. 
+
    516.               * The name of the table all instances of the this {@link patio.Model} use.
      517. 
+
    517.               * @field
      518. 
+
    518.               * @ignoreCode
      519. 
+
    519.               * @type String
      520. 
+
    520.               */
      521. 
+
    521.              tableName:function () {
      522. 
+
    522. 6318                return this.__tableName;
      523. 
 
    523.              },
      524. 
 
    524.  
      525. 
-
    525.              //returns our join table model
      526. 
-
    526.              joinTable:function () {
      527. 
-
    527. 380                if (!this.__joinTableDataset) {
      528. 
-
    528. 18                    var ds = this.__joinTableDataset = this.model.dataset.db.from(this.joinTableName), model = this.model, options = this.__opts;
      529. 
-
    529. 18                    var identifierInputMethod = isUndefined(options.identifierInputMethod) ? model.identifierInputMethod : options.identifierInputMethod,
      530. 
-
    530.                          identifierOutputMethod = isUndefined(options.identifierOutputMethod) ? model.identifierOutputMethod : options.identifierOutputMethod;
      531. 
-
    531. 18                    if (identifierInputMethod) {
      532. 
-
    532. 14                        ds.identifierInputMethod = identifierInputMethod;
      533. 
-
    533.                      }
      534. 
-
    534. 18                    if (identifierOutputMethod) {
      535. 
-
    535. 14                        ds.identifierOutputMethod = identifierOutputMethod;
      536. 
-
    536.                      }
      537. 
+
    537.              /**
      538. 
+
    538.               * The database all instances of this {@link patio.Model} use.
      539. 
+
    539.               * @field
      540. 
+
    540.               *  @ignoreCode
      541. 
+
    541.               * @type patio.Database
      542. 
+
    542.               */
      543. 
+
    543.              db:function () {
      544. 
+
    544. 46374                var db = this.__db;
      545. 
+
    545. 46374                if (!db) {
      546. 
+
    546. 86                    db = this.__db = patio.defaultDatabase;
      547. 
 
    547.                  }
      548. 
-
    548. 380                return this.__joinTableDataset;
      549. 
+
    549. 46374                if (!db) {
      550. 
+
    550. 0                    throw new ModelError("patio has not been connected to a database");
      551. 
+
    551.                  }
      552. 
+
    552. 46374                return db;
      553. 
 
    553.              },
      554. 
 
    554.  
      555. 
-
    555.              defaultJoinTable:function () {
      556. 
-
    556. 18                var ret;
      557. 
-
    557. 18                var recip = this.model._findAssociation(this);
      558. 
-
    558. 18                if (recip && recip.length) {
      559. 
-
    559. 18                    var names = [pluralize(this._model), pluralize(recip[1]._model)].sort();
      560. 
-
    560. 18                    names[1] = names[1].charAt(0).toUpperCase() + names[1].substr(1);
      561. 
-
    561. 18                    ret = names.join("");
      562. 
+
    562.              /**
      563. 
+
    563.               * A dataset to use to retrieve instances of this {@link patio.Model{ from the database. The dataset
      564. 
+
    564.               * has the {@link patio.Dataset#rowCb} set to create instances of this model.
      565. 
+
    565.               * @field
      566. 
+
    566.               *  @ignoreCode
      567. 
+
    567.               * @type patio.Dataset
      568. 
+
    568.               */
      569. 
+
    569.              dataset:function () {
      570. 
+
    570. 4836                var ds = this.__dataset;
      571. 
+
    571. 4836                if (!ds) {
      572. 
+
    572. 84                    ds = this.db.from(this.tableName);
      573. 
+
    573. 84                    ds.rowCb = hitch(this, function (vals) {
      574. 
+
    574. 873                        return this.load(vals);
      575. 
+
    575.                      });
      576. 
+
    576. 84                    this.identifierInputMethod && (ds.identifierInputMethod = this.identifierInputMethod);
      577. 
+
    577. 84                    this.identifierOutputMethod && (ds.identifierOutputMethod = this.identifierOutputMethod);
      578. 
+
    578. 84                    this.__dataset = ds;
      579. 
+
    579. 4752                } else if (!ds.rowCb) {
      580. 
+
    580. 6                    ds.rowCb = hitch(this, function rowCb(vals) {
      581. 
+
    581. 25                        return this.load(vals);
      582. 
+
    582.                      });
      583. 
 
    583.                  }
      584. 
-
    584. 18                return ret;
      585. 
+
    585. 4836                return ds;
      586. 
+
    586.              },
      587. 
+
    587.  
      588. 
+
    588.              /**
      589. 
+
    589.               * A list of columns this models table contains.
      590. 
+
    590.               * @field
      591. 
+
    591.               *  @ignoreCode
      592. 
+
    592.               * @type String[]
      593. 
+
    593.  
      594. 
+
    594.               */
      595. 
+
    595.              columns:function () {
      596. 
+
    596. 1128                return this.__columns;
      597. 
+
    597.              },
      598. 
+
    598.  
      599. 
+
    599.              /**
      600. 
+
    600.               * The schema of this {@link patio.Model}'s table. See {@link patio.Database#schema} for details
      601. 
+
    601.               * on the schema object.
      602. 
+
    602.               * @field
      603. 
+
    603.               *  @ignoreCode
      604. 
+
    604.               * @type Object
      605. 
+
    605.               */
      606. 
+
    606.              schema:function () {
      607. 
+
    607. 75103                if (this.synced) {
      608. 
+
    608. 75103                    return this.__schema;
      609. 
+
    609.                  } else {
      610. 
+
    610. 0                    throw new ModelError("Model has not been synced yet");
      611. 
+
    611.                  }
      612. 
+
    612.              },
      613. 
+
    613.  
      614. 
+
    614.              /**
      615. 
+
    615.               * The primaryKey column/s of this {@link patio.Model}
      616. 
+
    616.               * @field
      617. 
+
    617.               *  @ignoreCode
      618. 
+
    618.               */
      619. 
+
    619.              primaryKey:function () {
      620. 
+
    620. 8221                if (this.synced) {
      621. 
+
    621. 8221                    return this.__primaryKey.slice(0);
      622. 
+
    622.                  } else {
      623. 
+
    623. 0                    throw new ModelError("Model has not been synced yet");
      624. 
+
    624.                  }
      625. 
+
    625.              },
      626. 
+
    626.  
      627. 
+
    627.              /**
      628. 
+
    628.               * A reference to the global {@link patio}.
      629. 
+
    629.               * @field
      630. 
+
    630.               *  @ignoreCode
      631. 
+
    631.               */
      632. 
+
    632.              patio:function () {
      633. 
+
    633. 81                return patio || require("./index");
      634. 
+
    634.              }
      635. 
+
    635.          },
      636. 
+
    636.  
      637. 
+
    637.          /**@ignore*/
      638. 
+
    638.          setters:{
      639. 
+
    639.              /**@lends patio.Model*/
      640. 
+
    640.              /**@ignore*/
      641. 
+
    641.              camelize:function (camelize) {
      642. 
+
    642. 26                camelize = camelize === true;
      643. 
+
    643. 26                if (camelize) {
      644. 
+
    644. 26                    this.identifierOutputMethod = "camelize";
      645. 
+
    645. 26                    this.identifierInputMethod = "underscore";
      646. 
+
    646.                  }
      647. 
+
    647. 26                this.__camelize = camelize;
      648. 
+
    648. 26                this.__underscore = !camelize;
      649. 
+
    649.  
      650. 
+
    650.              },
      651. 
+
    651.              /**@ignore*/
      652. 
+
    652.              underscore:function (underscore) {
      653. 
+
    653. 1                underscore = underscore === true;
      654. 
+
    654. 1                if (underscore) {
      655. 
+
    655. 1                    this.identifierOutputMethod = "underscore";
      656. 
+
    656. 1                    this.identifierInputMethod = "camelize";
      657. 
+
    657.                  }
      658. 
+
    658. 1                this.__underscore = underscore;
      659. 
+
    659. 1                this.__camelize = !underscore;
      660. 
+
    660.  
      661. 
 
    661.              }
      662. 
 
    662.          }
      663. 
 
    663.      }
      664. 
-
    664.  });
      665. 
+
    665.  
      666. 
+
    666.  }).as(exports, "Model");
      667. 
+
    667.  
      668. 
+
    668.  
      669. 
+
    669. 1function checkAndAddDBToTable(db, table) {
      670. 
+
    670. 93    if (!table.contains(db)) {
      671. 
+
    671. 34        table.set(db, new HashTable());
      672. 
+
    672.      }
      673. 
+
    673.  }
      674. 
+
    674.  
      675. 
+
    675.  /**@ignore*/
      676. 
+
    676. 1exports.create = function (name, supers, modelOptions) {
      677. 
+
    677. 93    if (!patio) {
      678. 
+
    678. 1        (patio = require("./index"));
      679. 
+
    679. 1        patio.on("disconnect", function () {
      680. 
+
    680. 40            MODELS.clear();
      681. 
+
    681.          });
      682. 
+
    682.      }
      683. 
+
    683. 93    var db, ds, tableName;
      684. 
+
    684. 93    var key, modelKey;
      685. 
+
    685. 93    if (isString(name)) {
      686. 
+
    686. 87        tableName = name;
      687. 
+
    687. 87        key = db = patio.defaultDatabase || "default";
      688. 
+
    688. 6    } else if (isInstanceOf(name, patio.Dataset)) {
      689. 
+
    689. 6        ds = name;
      690. 
+
    690. 6        tableName = ds.firstSourceAlias;
      691. 
+
    691. 6        key = db = ds.db;
      692. 
+
    692.      }
      693. 
+
    693. 93    var hasSuper = false;
      694. 
+
    694. 93    if (isHash(supers) || isUndefinedOrNull(supers)) {
      695. 
+
    695. 90        modelOptions = supers;
      696. 
+
    696. 90        supers = [Model];
      697. 
+
    697.      } else {
      698. 
+
    698. 3        supers = toArray(supers);
      699. 
+
    699. 3        supers = supers.map(function (sup) {
      700. 
+
    700. 3            return exports.getModel(sup, db);
      701. 
+
    701.          });
      702. 
+
    702. 3        hasSuper = true;
      703. 
+
    703.      }
      704. 
+
    704.  
      705. 
+
    705. 93    var model;
      706. 
+
    706. 93    checkAndAddDBToTable(key, MODELS);
      707. 
+
    707.  
      708. 
+
    708. 93    var DEFAULT_PROTO = {instance:{}, "static":{}};
      709. 
+
    709. 93    modelOptions = merge(DEFAULT_PROTO, modelOptions || {});
      710. 
+
    710. 93    modelOptions.instance._hooks = ["save", "update", "remove", "load"];
      711. 
+
    711. 93    modelOptions.instance.__hooks = {pre:{}, post:{}};
      712. 
+
    712.      //Mixin the column setter/getters
      713. 
+
    713. 93    modelOptions["static"].synced = false;
      714. 
+
    714. 93    modelOptions["static"].__tableName = tableName;
      715. 
+
    715. 93    modelOptions["static"].__db = (db === "default" ? null : db);
      716. 
+
    716. 93    modelOptions["static"].__supers = hasSuper ? supers : [];
      717. 
+
    717. 93    modelOptions["static"].__dataset = ds;
      718. 
+
    718. 93    model = define(supers.concat(modelOptions.plugins || []).concat([AssociationPlugin]), modelOptions);
      719. 
+
    719. 93    ["pre", "post"].forEach(function (op) {
      720. 
+
    720. 186        var optionsOp = modelOptions[op];
      721. 
+
    721. 186        if (optionsOp) {
      722. 
+
    722. 0            for (var i in optionsOp) {
      723. 
+
    723. 0                model[op](i, optionsOp[i]);
      724. 
+
    724.              }
      725. 
+
    725.          }
      726. 
+
    726.      });
      727. 
+
    727. 93    if (!(MODELS.get(key).contains(checkAndTransformName(name)))) {
      728. 
+
    728. 61        MODELS.get(key).set(name, model);
      729. 
+
    729.      }
      730. 
+
    730. 93    return model;
      731. 
+
    731.  };
      732. 
+
    732.  
      733. 
+
    733. 1exports.syncModels = function (cb) {
      734. 
+
    734. 35    var ret = new Promise();
      735. 
+
    735. 35    serial(MODELS.entrySet.map(function (entry) {
      736. 
+
    736. 34        return function () {
      737. 
+
    737. 34            var value = entry.value;
      738. 
+
    738. 34            return serial(value.entrySet.map(function (m) {
      739. 
+
    739. 61                return hitch(m.value, "sync");
      740. 
+
    740.              }));
      741. 
+
    741.          };
      742. 
+
    742.      })).then(hitchIgnore(ret, "callback", true), ret);
      743. 
+
    743. 35    if (isFunction(cb)) {
      744. 
+
    744. 0        ret.classic(cb);
      745. 
+
    745.      }
      746. 
+
    746. 35    return ret.promise();
      747. 
+
    747.  };
      748. 
+
    748.  
      749. 
+
    749. 1var checkAndGetModel = function (db, name) {
      750. 
+
    750. 21198    var ret;
      751. 
+
    751. 21198    if (MODELS.contains(db)) {
      752. 
+
    752. 10600        ret = MODELS.get(db).get(checkAndTransformName(name));
      753. 
+
    753.      }
      754. 
+
    754. 21198    return ret;
      755. 
+
    755.  };
      756. 
+
    756.  
      757. 
+
    757.  
      758. 
+
    758. 1exports.getModel = function (name, db) {
      759. 
+
    759. 10603    var ret = null;
      760. 
+
    760. 10603    if (isDefined(name)) {
      761. 
+
    761. 10603        !patio && (patio = require("./index"));
      762. 
+
    762. 10603        if (isFunction(name)) {
      763. 
+
    763. 3            ret = name;
      764. 
+
    764.          } else {
      765. 
+
    765. 10600            if (!db && isInstanceOf(name, patio.Dataset)) {
      766. 
+
    766. 2                db = name.db;
      767. 
+
    767.              }
      768. 
+
    768. 10600            var defaultDb = patio.defaultDatabase;
      769. 
+
    769. 10600            if (db) {
      770. 
+
    770. 10574                ret = checkAndGetModel(db, name);
      771. 
+
    771. 10574                if (!ret && db === defaultDb) {
      772. 
+
    772. 10572                    ret = checkAndGetModel("default", name);
      773. 
+
    773.                  }
      774. 
+
    774.              } else {
      775. 
+
    775. 26                db = patio.defaultDatabase;
      776. 
+
    776. 26                ret = checkAndGetModel(db, name);
      777. 
+
    777. 26                if (!ret) {
      778. 
+
    778. 26                    ret = checkAndGetModel("default", name);
      779. 
+
    779.                  }
      780. 
+
    780.              }
      781. 
+
    781.          }
      782. 
+
    782.      } else {
      783. 
+
    783. 0        ret = name;
      784. 
+
    784.      }
      785. 
+
    785. 10603    if (isUndefinedOrNull(ret)) {
      786. 
+
    786. 0        throw new ModelError("Model " + name + " has not been registered with patio");
      787. 
+
    787.      }
      788. 
+
    788. 10603    return ret;
      789. 
+
    789.  };
      790. 
+
    790.  
      791. 
 
    791.
    -
    +
    -
    database/schema.js
    +
    associations/manyToMany.js
    - Coverage89.45 - SLOC1230 - LOC275 - Missed29 + Coverage89.05 + SLOC308 + LOC137 + Missed15
    - 
    1. 1"use strict";
      2. 
-
    2. 1var comb = require("comb"),
      3. 
-
    3.      isFunction = comb.isFunction,
      4. 
-
    4.      argsToArray = comb.argsToArray,
      5. 
-
    5.      array = comb.array,
      6. 
-
    6.      isArray = comb.isArray,
      7. 
-
    7.      isString = comb.isString,
      8. 
+    
      1. 1var comb = require("comb-proxy"),
        2. 
+
      2.      define = comb.define,
        3. 
 
      3.      isUndefined = comb.isUndefined,
        4. 
-
      4.      isNumber = comb.isNumber,
        5. 
-
      5.      toArray = comb.array.toArray,
        6. 
+
      6.      isUndefinedOrNull = comb.isUndefinedOrNull,
        7. 
+
      7.      isFunction = comb.isFunction,
        8. 
+
      8.      isInstanceOf = comb.isInstanceOf,
        9. 
+
      9.      sql = require("../sql").sql,
        10. 
 
      10.      hitch = comb.hitch,
        11. 
-
      11.      format = comb.string.format,
        12. 
-
      12.      Dataset = require("../dataset"),
        13. 
-
      13.      Promise = comb.Promise,
        14. 
-
      14.      PromiseList = comb.PromiseList,
        15. 
-
      15.      errors = require("../errors"),
        16. 
-
      16.      DatabaseError = errors.DatabaseError,
        17. 
-
      17.      generators = require("./schemaGenerators"),
        18. 
-
      18.      SchemaGenerator = generators.SchemaGenerator,
        19. 
-
      19.      AlterTableGenerator = generators.AlterTableGenerator,
        20. 
-
      20.      sql = require("../sql").sql,
        21. 
-
      21.      Time = sql.Time,
        22. 
-
      22.      TimeStamp = sql.TimeStamp,
        23. 
-
      23.      DateTime = sql.DateTime,
        24. 
-
      24.      Year = sql.Year,
        25. 
-
      25.      Float = sql.Float,
        26. 
-
      26.      Decimal = sql.Decimal,
        27. 
-
      27.      isInstanceOf = comb.isInstanceOf,
        28. 
-
      28.      Identifier = sql.Identifier,
        29. 
-
      29.      QualifiedIdentifier = sql.QualifiedIdentifier,
        30. 
-
      30.      define = comb.define;
        31. 
-
      31.  
        32. 
+
      32.      array = comb.array,
        33. 
+
      33.      isBoolean = comb.isBoolean,
        34. 
+
      34.      serial = comb.serial,
        35. 
+
      35.      when = comb.when,
        36. 
+
      36.      zip = array.zip,
        37. 
+
      37.      Promise = comb.Promise,
        38. 
+
      38.      PromiseList = comb.PromiseList,
        39. 
+
      39.      hitchIgnore = comb.hitchIgnore,
        40. 
+
      40.      OneToMany = require("./oneToMany"),
        41. 
+
      41.      pluralize = comb.pluralize,
        42. 
+
      42.      AssociationError = require("../errors").AssociationError;
        43. 
 
      43.  
        44. 
-
      44. 1define(null, {
        45. 
+
      45. 1var LOGGER = comb.logger("comb.associations.ManyToMany");
        46. 
+
      46.  /**
        47. 
+
      47.   * @class Class to define a manyToMany association.
        48. 
+
      48.   *
        49. 
+
      49.   * </br>
        50. 
+
      50.   * <b>NOT to be instantiated directly</b>
        51. 
+
      51.   * Its just documented for reference.
        52. 
+
      52.   *
        53. 
+
      53.   * @name ManyToMany
        54. 
+
      54.   * @augments patio.associations.OneToMany
        55. 
+
      55.   * @memberOf patio.associations
        56. 
+
      56.   *
        57. 
+
      57.   * @param {String} options.joinTable the joinTable of the association.
        58. 
+
      58.   *
        59. 
+
      59.   *
        60. 
+
      60.   * @property {String} joinTable the join table used in the relation.
        61. 
+
      61.   * */
        62. 
+
      62. 1module.exports = define(OneToMany, {
        63. 
 
      63.      instance:{
        64. 
-
      64.          /**@lends patio.Database.prototype*/
        65. 
+
      65.          /**@lends patio.associations.ManyToMany.prototype*/
        66. 
+
      66.          type:"manyToMany",
        67. 
 
      67.  
        68. 
-
      68.          /**@ignore*/
        69. 
-
      69.          constructor:function () {
        70. 
-
      70. 123            this._super(arguments);
        71. 
-
      71. 123            this.schemas = {};
        72. 
-
      72.          },
        73. 
+
      73.          _fetchMethod:"all",
        74. 
 
      74.  
        75. 
-
      75.          /**
        76. 
-
      76.           * Adds a column to the specified table. This method expects a column name,
        77. 
-
      77.           * a datatype and optionally a hash with additional constraints and options:
        78. 
-
      78.           *
        79. 
-
      79.           * <p>
        80. 
-
      80.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        81. 
-
      81.           *     addColumn call.
        82. 
-
      82.           * </p>
        83. 
-
      83.           *
        84. 
-
      84.           *
        85. 
-
      85.           * @example
        86. 
-
      86.           * //Outside of a table
        87. 
-
      87.           * //ALTER TABLE test ADD COLUMN name text UNIQUE'
        88. 
-
      88.           * DB.addColumn("test", "name", "text", {unique : true});
        89. 
-
      89.           *
        90. 
-
      90.           * @param {String} table the table to add the column to.
        91. 
-
      91.           * @param {String} column the name of the column to add.
        92. 
-
      92.           * @param type datatype of the column
        93. 
-
      93.           * @param {Object} [opts] additional options that can be used when adding a column.
        94. 
-
      94.           * @param {Boolean} [opts.primaryKey] set to true if this column is a primary key.
        95. 
-
      95.           * @param {Boolean} [opts.allowNull] whether or not this column should allow null.
        96. 
-
      96.           * @param {Boolean} [opts.unique] set to true to add a UNIQUE constraint to a column,
        97. 
-
      97.           *
        98. 
-
      98.           * @return {Promise} a promise that is resolved when the ADD COLUMN action is complete.
        99. 
-
      99.           **/
        100. 
-
      100.          addColumn:function (table, column, type, opts) {
        101. 
-
      101. 9            var args = argsToArray(arguments).slice(1);
        102. 
-
      102. 9            return this.alterTable(table, function () {
        103. 
-
      103. 9                this.addColumn.apply(this, args);
        104. 
-
      104.              });
        105. 
-
      105.          },
        106. 
+
      106.          supportsStringKey:false,
        107. 
 
      107.  
        108. 
-
      108.          /**
        109. 
-
      109.           * Adds an index to a table for the given columns
        110. 
-
      110.           *
        111. 
-
      111.           * <p>
        112. 
-
      112.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        113. 
-
      113.           *     addIndex call.
        114. 
-
      114.           * </p>
        115. 
-
      115.           * @example
        116. 
-
      116.           * DB.addIndex("test", "name", {unique : true});
        117. 
-
      117.           *      //=> 'CREATE UNIQUE INDEX test_name_index ON test (name)'
        118. 
-
      118.           * DB.addIndex("test", ["one", "two"]);
        119. 
-
      119.           *      //=> ''CREATE INDEX test_one_two_index ON test (one, two)''
        120. 
-
      120.           *
        121. 
-
      121.           * @param {String} table the table to add the index to.
        122. 
-
      122.           * @param {String|String[]} columns the name of the column/s to create an index for.
        123. 
-
      123.           * @param {Object} [options] additional options that can be used when adding an index.
        124. 
-
      124.           * @param {Boolean} [options.unique] set to true if this this index should have a UNIQUE constraint.
        125. 
-
      125.           * @param {Boolean} [options.ignoreErrors] set to true to ignore errors.
        126. 
-
      126.           *
        127. 
-
      127.           * @return {Promise} a promise that is resolved when the CREATE INDEX action is complete.
        128. 
-
      128.           * */
        129. 
-
      129.          addIndex:function (table, columns, options) {
        130. 
-
      130. 4            options = options || {};
        131. 
-
      131. 4            var ignoreErrors = options.ignoreErrors === true;
        132. 
-
      132. 4            var ret = new Promise();
        133. 
-
      133. 4            this.alterTable(table,function () {
        134. 
-
      134. 4                this.addIndex(columns, options);
        135. 
-
      135.              }).then(ret, function (err) {
        136. 
-
      136. 0                    if (!ignoreErrors) {
        137. 
-
      137. 0                        ret.errback(err);
        138. 
-
      138.                      } else {
        139. 
-
      139. 0                        ret.callback();
        140. 
+
      140.          supportsCompositeKey:false,
        141. 
+
      141.  
        142. 
+
      142.  
        143. 
+
      143.          _filter:function (parent) {
        144. 
+
      144. 326            var keys = this._getAssociationKey(parent);
        145. 
+
      145. 326            var options = this.__opts || {};
        146. 
+
      146. 326            var ds;
        147. 
+
      147. 326            if (!isUndefined((ds = options.dataset)) && isFunction(ds)) {
        148. 
+
      148. 0                ds = ds.apply(parent, [parent]);
        149. 
+
      149.              }
        150. 
+
      150. 326            if (!ds) {
        151. 
+
      151. 326                ds = this.model.dataset.naked().innerJoin(this.joinTableName, zip(keys[1], this.modelPrimaryKey.map(function (k) {
        152. 
+
      152. 326                    return sql.stringToIdentifier(k);
        153. 
+
      153.                  })).concat(zip(keys[0], this.parentPrimaryKey.map(function (k) {
        154. 
+
      154. 326                    return parent[k];
        155. 
+
      155.                  }))));
        156. 
+
      156. 326                var recip = this.model._findAssociation(this);
        157. 
+
      157. 326                if (recip) {
        158. 
+
      158. 326                    recip = recip[1];
        159. 
+
      159.                  }
        160. 
+
      160. 326                ds.rowCb = hitch(this, function (item) {
        161. 
+
      161. 340                    var ret = new Promise();
        162. 
+
      162. 340                    var model = this._toModel(item, true);
        163. 
+
      163. 340                    if (recip) {
        164. 
+
      164. 340                        recip.__setValue(model, parent);
        165. 
 
      165.                      }
        166. 
+
      166.                      //call hook to finish other model associations
        167. 
+
      167. 340                    model._hook("post", "load").then(hitch(this, function () {
        168. 
+
      168. 340                        ret.callback(model);
        169. 
+
      169.                      }), ret);
        170. 
+
      170. 340                    return ret.promise();
        171. 
 
      171.                  });
        172. 
-
      172. 4            return ret.promise();
        173. 
-
      173.          },
        174. 
-
      174.  
        175. 
-
      175.          /**
        176. 
-
      176.           *  Removes a column from the specified table.
        177. 
-
      177.           * <p>
        178. 
-
      178.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        179. 
-
      179.           *     dropColumn call.
        180. 
-
      180.           * </p>
        181. 
-
      181.           *
        182. 
-
      182.           * @example
        183. 
-
      183.           *   DB.dropColumn("items", "category");
        184. 
-
      184.           *          //=> 'ALTER TABLE items DROP COLUMN category',
        185. 
-
      185.           *
        186. 
-
      186.           * @param {String|patio.sql.Identifier} table the table to alter.
        187. 
-
      187.           * @param {String|patio.sql.Identifier} column the column to drop.
        188. 
-
      188.           *
        189. 
-
      189.           * @return {Promise} a promise that is resolved once the DROP COLUMN action is complete.
        190. 
-
      190.           * */
        191. 
-
      191.          dropColumn:function (table, column) {
        192. 
-
      192. 3            column = argsToArray(arguments).slice(1);
        193. 
-
      193. 3            return this.alterTable(table, function () {
        194. 
-
      194. 3                this.dropColumn.apply(this, column);
        195. 
-
      195.              });
        196. 
-
      196.          },
        197. 
 
      197.  
        198. 
-
      198.          /**
        199. 
-
      199.           * Removes an index for the given table and column/s.
        200. 
-
      200.           *
        201. 
-
      201.           * <p>
        202. 
-
      202.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        203. 
-
      203.           *     dropIndex call.
        204. 
-
      204.           * </p>
        205. 
-
      205.           *
        206. 
-
      206.           * @example
        207. 
-
      207.           *   DB.dropIndex("posts", "title");
        208. 
-
      208.           *      //=>'DROP INDEX posts_title_index
        209. 
-
      209.           *   DB.dropIndex("posts", ["author", "title"]);
        210. 
-
      210.           *      //'DROP INDEX posts_author_title_index'
        211. 
-
      211.           *
        212. 
-
      212.           * @param {String|patio.sql.Identifier} table the table to alter.
        213. 
-
      213.           * @param {String|patio.sql.Identifier} column the name of the column/s the index was created from.
        214. 
-
      214.           *
        215. 
-
      215.           * @return {Promise} a promise that is resolved once the DROP INDEX action is complete.
        216. 
-
      216.           * */
        217. 
-
      217.          dropIndex:function (table, columns, options) {
        218. 
-
      218. 1            var args = argsToArray(arguments).slice(1);
        219. 
-
      219. 1            return this.alterTable(table, function () {
        220. 
-
      220. 1                this.dropIndex.apply(this, args);
        221. 
-
      221.              });
        222. 
-
      222.          },
        223. 
+
      223.              }
        224. 
 
      224.  
        225. 
-
      225.          /**
        226. 
-
      226.           * Renames a column in the specified table.
        227. 
-
      227.           *
        228. 
-
      228.           * <p>
        229. 
-
      229.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        230. 
-
      230.           *     renameColumn call.
        231. 
-
      231.           * </p>
        232. 
-
      232.           *
        233. 
-
      233.           * @example
        234. 
-
      234.           * DB.renameColumn("items", "cntr", "counter");
        235. 
-
      235.           *      //=> ALTER TABLE items RENAME COLUMN cntr TO counter
        236. 
-
      236.           *
        237. 
-
      237.           * @param {String|patio.sql.Identifier} table the table to alter.
        238. 
-
      238.           * @param {String|patio.sql.Identifier} column the name of the column to rename.
        239. 
-
      239.           * @param {String|patio.sql.Identifier} newColumn the new name of the column.
        240. 
-
      240.           *
        241. 
-
      241.           * @return {Promise} a promise that is resolved once the RENAME COLUMN action is complete.
        242. 
-
      242.           * */
        243. 
-
      243.          renameColumn:function (table, column, newColumn) {
        244. 
-
      244. 4            var args = argsToArray(arguments).slice(1);
        245. 
-
      245. 4            return this.alterTable(table, function () {
        246. 
-
      246. 4                this.renameColumn.apply(this, args);
        247. 
-
      247.              });
        248. 
+
      248. 326            return this._setDatasetOptions(ds);
        249. 
 
      249.          },
        250. 
 
      250.  
        251. 
-
      251.  
        252. 
-
      252.          /**
        253. 
-
      253.           *Sets the default value for the given column in the given table:
        254. 
-
      254.           *
        255. 
-
      255.           * <p>
        256. 
-
      256.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        257. 
-
      257.           *     setColumnDefault call.
        258. 
-
      258.           * </p>
        259. 
-
      259.           *
        260. 
-
      260.           * @example
        261. 
-
      261.           * DB.setColumnDefault("items", "category", "misc");
        262. 
-
      262.           *      //=> ALTER TABLE items ALTER COLUMN category SET DEFAULT 'misc'
        263. 
-
      263.           *
        264. 
-
      264.           * @param {String|patio.sql.Identifier} table the table to alter.
        265. 
-
      265.           * @param {String|patio.sql.Identifier} column the name of the column to set the DEFAULT on.
        266. 
-
      266.           * @param  def the new default value of the column.
        267. 
-
      267.           *
        268. 
-
      268.           * @return {Promise} a promise that is resolved once the SET DEFAULT action is complete.
        269. 
-
      269.           * */
        270. 
-
      270.          setColumnDefault:function (table, column, def) {
        271. 
-
      271. 1            var args = argsToArray(arguments).slice(1);
        272. 
-
      272. 1            return this.alterTable(table, function () {
        273. 
-
      273. 1                this.setColumnDefault.apply(this, args);
        274. 
-
      274.              });
        275. 
+
      275.          _setAssociationKeys:function (parent, model, val) {
        276. 
+
      276. 534            var keys = this._getAssociationKey(parent),
        277. 
+
      277.                  leftKey = keys[0],
        278. 
+
      278.                  parentPk = this.parentPrimaryKey;
        279. 
+
      279. 534            if (!(leftKey && leftKey.length === parentPk.length)) {
        280. 
+
      280. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
        281. 
+
      281.              }
        282. 
+
      282. 534            for (var i = 0; i < leftKey.length; i++) {
        283. 
+
      283. 534                model[leftKey[i]] = !isUndefined(val) ? val : parent[parentPk[i]];
        284. 
+
      284.              }
        285. 
 
      285.          },
        286. 
 
      286.  
        287. 
 
      287.  
        288. 
-
      288.          /**
        289. 
-
      289.           *  Set the data type for the given column in the given table:
        290. 
-
      290.           * <p>
        291. 
-
      291.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
        292. 
-
      292.           *     setColumnType call.
        293. 
-
      293.           * </p>
        294. 
-
      294.           *
        295. 
-
      295.           * @example
        296. 
-
      296.           * DB.setColumnType("items", "category", String);
        297. 
-
      297.           *      //=> ALTER TABLE items ALTER COLUMN category TYPE varchar(255)
        298. 
-
      298.           *
        299. 
-
      299.           * @param {String|patio.sql.Identifier} table the table to alter.
        300. 
-
      300.           * @param {String|patio.sql.Identifier} column the name of the column to set the TYPE on.
        301. 
-
      301.           * @param  type the datatype of the column.
        302. 
-
      302.           *
        303. 
-
      303.           * @return {Promise} a promise that is resolved once the SET TYPE action is complete.
        304. 
-
      304.           * */
        305. 
-
      305.          setColumnType:function (table, column, type) {
        306. 
-
      306. 3            var args = argsToArray(arguments).slice(1);
        307. 
-
      307. 3            return this.alterTable(table, function () {
        308. 
-
      308. 3                this.setColumnType.apply(this, args);
        309. 
-
      309.              });
        310. 
-
      310.          },
        311. 
-
      311.  
        312. 
-
      312.  
        313. 
-
      313.          /**
        314. 
-
      314.           *  Alters the given table with the specified block.
        315. 
-
      315.           *  <p>
        316. 
-
      316.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being altered. The block
        317. 
-
      317.           *      is also called with the table as the first argument. Within the block you must use
        318. 
-
      318.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
        319. 
-
      319.           *      that is passed in for all alter table operations. See {@link patio.AlterTableGenerator} for
        320. 
-
      320.           *      avaiable operations.
        321. 
-
      321.           *  </p>
        322. 
-
      322.           *
        323. 
-
      323.           *  <p>
        324. 
-
      324.           *      <b>Note</b> that addColumn accepts all the options available for column
        325. 
-
      325.           *      definitions using createTable, and addIndex accepts all the options
        326. 
-
      326.           *      available for index definition.
        327. 
-
      327.           *  </p>
        328. 
-
      328.           *
        329. 
-
      329.           * @example
        330. 
-
      330.           *   //using the table object
        331. 
-
      331.           *   DB.alterTable("items", function(table){
        332. 
-
      332.           *      //you must use the passed in table object.
        333. 
-
      333.           *     table.addColumn("category", "text", {default : 'javascript'});
        334. 
-
      334.           *     table.dropColumn("category");
        335. 
-
      335.           *     table.renameColumn("cntr", "counter");
        336. 
-
      336.           *     table.setColumnType("value", "float");
        337. 
-
      337.           *     table.setColumnDefault("value", "float");
        338. 
-
      338.           *     table.addIndex(["group", "category"]);
        339. 
-
      339.           *     table.dropIndex [:group, :category]
        340. 
-
      340.           *   });
        341. 
-
      341.           *
        342. 
-
      342.           *   //using this
        343. 
-
      343.           *    DB.alterTable("items", function(){
        344. 
-
      344.           *     this.addColumn("category", "text", {default : 'javascript'});
        345. 
-
      345.           *     this.dropColumn("category");
        346. 
-
      346.           *     this.renameColumn("cntr", "counter");
        347. 
-
      347.           *     this.setColumnType("value", "float");
        348. 
-
      348.           *     this.setColumnDefault("value", "float");
        349. 
-
      349.           *     this.addIndex(["group", "category"]);
        350. 
-
      350.           *     this.dropIndex [:group, :category]
        351. 
-
      351.           *   });
        352. 
-
      352.           *
        353. 
-
      353.           *   //This will not work
        354. 
-
      354.           *   DB.alterTable("items", comb.hitch(someObject, function(){
        355. 
-
      355.           *    //This is called in the scope of someObject so this
        356. 
-
      356.           *    //will not work and will throw an error
        357. 
-
      357.           *     this.addColumn("category", "text", {default : 'javascript'});
        358. 
-
      358.           *   }));
        359. 
-
      359.           *
        360. 
-
      360.           *    //This will work
        361. 
-
      361.           *   DB.alterTable("items", comb.hitch(someObject, function(table){
        362. 
-
      362.           *    //This is called in the scope of someObject so you must
        363. 
-
      363.           *    //use the table argument
        364. 
-
      364.           *     table.category("text", {default : 'javascript'});
        365. 
-
      365.           *   }));
        366. 
-
      366.           *
        367. 
-
      367.           *
        368. 
-
      368.           * @param {String|patio.sql.Identifier} table to the table to perform the ALTER TABLE operations on.
        369. 
-
      369.           * @param {Function} block the block to invoke for the ALTER TABLE operations
        370. 
-
      370.           *
        371. 
-
      371.           * @return {Promise} a promise that is resolved once all ALTER TABLE operations have completed.
        372. 
-
      372.           * */
        373. 
-
      373.          alterTable:function (name, generator, block) {
        374. 
-
      374. 84            if (isFunction(generator)) {
        375. 
-
      375. 84                block = generator;
        376. 
-
      376. 84                generator = new AlterTableGenerator(this, block);
        377. 
+
      377.          __createJoinTableInsertRemoveQuery:function (model, item) {
        378. 
+
      378. 176            var q = {};
        379. 
+
      379. 176            var keys = this._getAssociationKey(model),
        380. 
+
      380.                  leftKey = keys[0],
        381. 
+
      381.                  rightKey = keys[1],
        382. 
+
      382.                  parentPk = this.parentPrimaryKey,
        383. 
+
      383.                  modelPk = this.modelPrimaryKey;
        384. 
+
      384. 176            if (!(leftKey && leftKey.length === parentPk.length)) {
        385. 
+
      385. 0                throw new AssociationError("Invalid leftKey for " + this.name + " : " + leftKey);
        386. 
 
      386.              }
        387. 
-
      387. 84            var ret = new Promise();
        388. 
-
      388. 84            this.__alterTableSqlList(name, generator.operations).then(hitch(this, function (res) {
        389. 
-
      389. 84                var sqls = array.flatten(res.map(function (r) {
        390. 
-
      390. 93                    return r[1];
        391. 
-
      391.                  }));
        392. 
-
      392. 84                var l = sqls.length;
        393. 
-
      393. 84                var drop = hitch(this, function (i) {
        394. 
-
      394. 179                    if (i < l) {
        395. 
-
      395. 95                        var sql = sqls[i++];
        396. 
-
      396. 95                        this.executeDdl(sql).then(hitch(this, drop, i), ret);
        397. 
-
      397.                      } else {
        398. 
-
      398. 84                        this.removeCachedSchema(name);
        399. 
-
      399. 84                        ret.callback();
        400. 
-
      400.                      }
        401. 
-
      401.                  });
        402. 
-
      402. 84                drop(0);
        403. 
-
      403.              }));
        404. 
-
      404. 84            return ret.promise();
        405. 
-
      405.          },
        406. 
-
      406.  
        407. 
-
      407.          /**
        408. 
-
      408.           * Creates a table with the columns given in the provided block:
        409. 
-
      409.           *
        410. 
-
      410.           * <p>
        411. 
-
      411.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being created. The block
        412. 
-
      412.           *      is also called with the table as the first argument. Within the block you must use
        413. 
-
      413.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
        414. 
-
      414.           *      that is passed in for all create table operations. See {@link patio.SchemaGenerator} for
        415. 
-
      415.           *      available operations.
        416. 
-
      416.           *  </p>
        417. 
-
      417.           *
        418. 
-
      418.           *
        419. 
-
      419.           * @example
        420. 
-
      420.           *
        421. 
-
      421.           *   //using the table to create the table
        422. 
-
      422.           *   DB.createTable("posts", function(table){
        423. 
-
      423.           *     table.primaryKey("id");
        424. 
-
      424.           *     table.column('title", "text");
        425. 
-
      425.           *     //you may also invoke the column name as
        426. 
-
      426.           *     //function on the table
        427. 
-
      427.           *     table.content(String);
        428. 
-
      428.           *     table.index(title);
        429. 
-
      429.           *   });
        430. 
-
      430.           *
        431. 
-
      431.           *   //using this to create the table
        432. 
-
      432.           *   DB.createTable("posts", function(){
        433. 
-
      433.           *     this.primaryKey("id");
        434. 
-
      434.           *     this.column('title", "text");
        435. 
-
      435.           *     //you may also invoke the column name as
        436. 
-
      436.           *     //function on the table
        437. 
-
      437.           *     this.content(String);
        438. 
-
      438.           *     this.index(title);
        439. 
-
      439.           *   });
        440. 
-
      440.           *
        441. 
-
      441.           * @param {String|patio.sql.Identifier} name the name of the table to create.
        442. 
-
      442.           * @param {Object} [options] an optional options object
        443. 
-
      443.           * @param {Boolean} [options.temp] set to true if this table is a TEMPORARY table.
        444. 
-
      444.           * @param {Boolean} [options.ignoreIndexErrors] Ignore any errors when creating indexes.
        445. 
-
      445.           * @param {Function} block the block to invoke when creating the table.
        446. 
-
      446.           *
        447. 
-
      447.           * @return {Promise} a promise that is resolved when the CREATE TABLE action is completed.
        448. 
-
      448.           *
        449. 
-
      449.           */
        450. 
-
      450.          createTable:function (name, options, block) {
        451. 
-
      451. 218            if (isFunction(options)) {
        452. 
-
      452. 208                block = options;
        453. 
-
      453. 208                options = {};
        454. 
+
      454. 176            if (!(rightKey && rightKey.length === modelPk.length)) {
        455. 
+
      455. 0                throw new AssociationError("Invalid rightKey for " + this.name + " : " + rightKey);
        456. 
 
      456.              }
        457. 
-
      457. 218            this.removeCachedSchema(name);
        458. 
-
      458. 218            if (isInstanceOf(options, SchemaGenerator)) {
        459. 
-
      459. 0                options = {generator:options};
        460. 
+
      460. 176            for (var i = 0; i < leftKey.length; i++) {
        461. 
+
      461. 176                q[leftKey[i]] = model[parentPk[i]];
        462. 
 
      462.              }
        463. 
-
      463. 218            var generator = options.generator || new SchemaGenerator(this, block);
        464. 
-
      464. 218            return this.__createTableFromGenerator(name, generator, options)
        465. 
-
      465.                  .chain(hitch(this, "__createTableIndexesFromGenerator", name, generator, options))
        466. 
-
      466.                  .promise();
        467. 
+
      467. 176            for (i = 0; i < rightKey.length; i++) {
        468. 
+
      468. 176                q[rightKey[i]] = item[modelPk[i]];
        469. 
+
      469.              }
        470. 
+
      470. 176            return q;
        471. 
 
      471.          },
        472. 
 
      472.  
        473. 
-
      473.          /**
        474. 
-
      474.           * Forcibly creates a table, attempting to drop it unconditionally (and catching any errors), then creating it.
        475. 
-
      475.           * <p>
        476. 
-
      476.           *      See {@link patio.Database#createTable} for parameter types.
        477. 
-
      477.           * </p>
        478. 
-
      478.           *
        479. 
-
      479.           * @example
        480. 
-
      480.           *  // DROP TABLE a
        481. 
-
      481.           *  // CREATE TABLE a (a integer)
        482. 
-
      482.           *   DB.forceCreateTable("a", function(){
        483. 
-
      483.           *      this.a("integer");
        484. 
-
      484.           *   });
        485. 
-
      485.           *
        486. 
-
      486.           **/
        487. 
-
      487.          forceCreateTable:function (name, options, block) {
        488. 
-
      488. 18            return this.dropTable(name)
        489. 
-
      489.                  .chainBoth(hitch(this, this.createTable, name, options, block))
        490. 
-
      490.                  .promise();
        491. 
+
      491.          _preRemove:function (next, model) {
        492. 
+
      492. 202            if (this.isOwner && !this.isCascading) {
        493. 
+
      493. 202                var q = {};
        494. 
+
      494. 202                this._setAssociationKeys(model, q);
        495. 
+
      495. 202                this.joinTable.where(q).remove().classic(next);
        496. 
+
      496.              } else {
        497. 
+
      497. 0                next();
        498. 
+
      498.              }
        499. 
 
      499.          },
        500. 
 
      500.  
        501. 
 
      501.  
        502. 
-
      502.          /**
        503. 
-
      503.           * Creates the table unless the table already exists.
        504. 
-
      504.           * <p>
        505. 
-
      505.           *      See {@link patio.Database#createTable} for parameter types.
        506. 
-
      506.           * </p>
        507. 
-
      507.           */
        508. 
-
      508.          createTableUnlessExists:function (name, options, block) {
        509. 
-
      509. 0            var ret = new Promise();
        510. 
-
      510. 0            this.tableExists(name).then(hitch(this, function (exists) {
        511. 
-
      511. 0                if (!exists) {
        512. 
-
      512. 0                    this.createTable(name, options, block).then(ret);
        513. 
+
      513.          addAssociation:function (item, model, reload) {
        514. 
+
      514. 260            reload = isBoolean(reload) ? reload : false;
        515. 
+
      515. 260            var ret = new Promise().callback(model);
        516. 
+
      516. 260            if (!isUndefinedOrNull(item)) {
        517. 
+
      517. 260                if (!model.isNew) {
        518. 
+
      518. 148                    item = this._toModel(item);
        519. 
+
      519. 148                    var loaded = this.associationLoaded(model);
        520. 
+
      520. 148                    var recip = this.model._findAssociation(this), save = item.isNew;
        521. 
+
      521. 148                    ret = model._checkTransaction(hitch(this, function () {
        522. 
+
      522. 148                        var joinTable = this.joinTable, ret = new Promise();
        523. 
+
      523. 148                        serial([
        524. 
+
      524.                              function () {
        525. 
+
      525. 148                                return save ? item.save() : null;
        526. 
+
      526.                              },
        527. 
+
      527.                              function () {
        528. 
+
      528. 148                                return joinTable.insert(this.__createJoinTableInsertRemoveQuery(model, item));
        529. 
+
      529.                              }.bind(this),
        530. 
+
      530.                              function () {
        531. 
+
      531. 148                                if (recip) {
        532. 
+
      532. 148                                    recip[1].__setValue(item, [model]);
        533. 
+
      533.                                  }
        534. 
+
      534.                              },
        535. 
+
      535.                              function () {
        536. 
+
      536. 148                                if (loaded && reload) {
        537. 
+
      537. 3                                    return this.parent._reloadAssociationsForType(this.type, this.model, model);
        538. 
+
      538.                                  } else {
        539. 
+
      539. 145                                    return model;
        540. 
+
      540.                                  }
        541. 
+
      541.                              }.bind(this)
        542. 
+
      542.                          ]).then(hitchIgnore(ret, "callback", model), ret);
        543. 
+
      543. 148                        return ret.promise();
        544. 
+
      544.                      }));
        545. 
 
      545.                  } else {
        546. 
-
      546. 0                    ret.callback();
        547. 
-
      547.                  }
        548. 
-
      548.              }), ret);
        549. 
-
      549. 0            return ret.promise();
        550. 
-
      550.          },
        551. 
-
      551.  
        552. 
-
      552.          /**
        553. 
-
      553.           * Creates a view, replacing it if it already exists:
        554. 
-
      554.           * @example
        555. 
-
      555.           *   DB.createOrReplaceView("cheapItems", "SELECT * FROM items WHERE price < 100");
        556. 
-
      556.           *      //=> CREATE OR REPLACE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
        557. 
-
      557.           *   DB.createOrReplaceView("miscItems", DB[:items].filter({category : 'misc'}));
        558. 
-
      558.           *     //=> CREATE OR REPLACE VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
        559. 
-
      559.           *
        560. 
-
      560.           * @param {String|patio.sql.Identifier} name the name of the view to create.
        561. 
-
      561.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
        562. 
-
      562.           * view.
        563. 
-
      563.           *
        564. 
-
      564.           * @return {Promise} a promise that is resolved when the CREATE OR REPLACE VIEW action is complete.
        565. 
-
      565.           **/
        566. 
-
      566.          createOrReplaceView:function (name, source) {
        567. 
-
      567. 4            if (isInstanceOf(source, Dataset)) {
        568. 
-
      568. 2                source = source.sql;
        569. 
-
      569.              }
        570. 
-
      570. 4            var ret = new Promise();
        571. 
-
      571. 4            this.executeDdl(format("CREATE OR REPLACE VIEW %s AS %s", this.__quoteSchemaTable(name), source)).then(hitch(this, function () {
        572. 
-
      572. 4                this.removeCachedSchema(name);
        573. 
-
      573. 4                ret.callback();
        574. 
-
      574.              }), ret);
        575. 
-
      575. 4            return ret.promise();
        576. 
-
      576.          },
        577. 
-
      577.  
        578. 
-
      578.          /**
        579. 
-
      579.           * Creates a view based on a dataset or an SQL string:
        580. 
-
      580.           * @example
        581. 
-
      581.           *   DB.createView("cheapItems", "SELECT * FROM items WHERE price < 100");
        582. 
-
      582.           *      //=> CREATE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
        583. 
-
      583.           *   DB.createView("miscItems", DB[:items].filter({category : 'misc'}));
        584. 
-
      584.           *     //=> CREATE  VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
        585. 
-
      585.           *
        586. 
-
      586.           * @param {String|patio.sql.Identifier} name the name of the view to create.
        587. 
-
      587.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
        588. 
-
      588.           * view.
        589. 
-
      589.           **/
        590. 
-
      590.          createView:function (name, source) {
        591. 
-
      591. 4            if (isInstanceOf(source, Dataset)) {
        592. 
-
      592. 2                source = source.sql;
        593. 
+
      593. 112                    item = this._toModel(item);
        594. 
+
      594. 112                    var items = this.getAssociation(model);
        595. 
+
      595. 112                    if (isUndefinedOrNull(items)) {
        596. 
+
      596. 39                        this.__setValue(model, [item]);
        597. 
+
      597.                      } else {
        598. 
+
      598. 73                        items.push(item);
        599. 
+
      599.                      }
        600. 
+
      600.                  }
        601. 
 
      601.              }
        602. 
-
      602. 4            return this.executeDdl(format("CREATE VIEW %s AS %s", this.__quoteSchemaTable(name), source));
        603. 
+
      603. 260            return ret.promise();
        604. 
 
      604.          },
        605. 
 
      605.  
        606. 
-
      606.          /**
        607. 
-
      607.           *  Drops one or more tables corresponding to the given names.
        608. 
-
      608.           *
        609. 
-
      609.           * @example
        610. 
-
      610.           * DB.dropTable("test");
        611. 
-
      611.           *      //=>'DROP TABLE test'
        612. 
-
      612.           * DB.dropTable("a", "bb", "ccc");
        613. 
-
      613.           *      //=>'DROP TABLE a',
        614. 
-
      614.           *      //=>'DROP TABLE bb',
        615. 
-
      615.           *      //=>'DROP TABLE ccc'
        616. 
-
      616.           *
        617. 
-
      617.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
        618. 
-
      618.           * to drop.
        619. 
-
      619.           *
        620. 
-
      620.           * @return {Promise} a promise that is resolved once all tables have been dropped.
        621. 
-
      621.           **/
        622. 
-
      622.          dropTable:function (names) {
        623. 
-
      623. 81            var ret = new Promise(), l = names.length;
        624. 
-
      624. 81            if (isArray(names)) {
        625. 
-
      625. 48                var drop = hitch(this, function (i) {
        626. 
-
      626. 104                    if (i < l) {
        627. 
-
      627. 65                        var name = names[i++];
        628. 
-
      628. 65                        this.executeDdl(this.__dropTableSql(name)).then(hitch(this, function () {
        629. 
-
      629. 56                            this.removeCachedSchema(name);
        630. 
-
      630. 56                            drop(i);
        631. 
+
      631.          removeItem:function (item, model, remove, reload) {
        632. 
+
      632. 56            reload = isBoolean(reload) ? reload : false;
        633. 
+
      633. 56            remove = isBoolean(remove) ? remove : false;
        634. 
+
      634. 56            var ret = new Promise().callback(model);
        635. 
+
      635. 56            if (!isUndefinedOrNull(item)) {
        636. 
+
      636. 56                if (!model.isNew) {
        637. 
+
      637. 56                    if (isInstanceOf(item, this.model) && !item.isNew) {
        638. 
+
      638. 56                        var loaded = this.associationLoaded(model);
        639. 
+
      639. 56                        remove = remove && !item.isNew;
        640. 
+
      640. 56                        ret = new Promise();
        641. 
+
      641. 56                        model._checkTransaction(hitch(this, function () {
        642. 
+
      642. 56                            return remove ? item.remove() : this.joinTable.where(this.__createJoinTableInsertRemoveQuery(model, item)).remove();
        643. 
+
      643.                          })).then(hitch(this, function () {
        644. 
+
      644. 56                            if (loaded && reload) {
        645. 
+
      645. 18                                return this.parent._reloadAssociationsForType(this.type, this.model, model).then(ret);
        646. 
+
      646.                              } else {
        647. 
+
      647. 38                                ret.callback(model);
        648. 
+
      648.                              }
        649. 
 
      649.                          }), ret);
        650. 
-
      650.                      } else {
        651. 
-
      651. 39                        ret.callback();
        652. 
+
      652. 56                        return ret.promise();
        653. 
 
      653.                      }
        654. 
-
      654.                  });
        655. 
-
      655. 48                drop(0);
        656. 
-
      656. 48                return ret.promise();
        657. 
-
      657.              } else {
        658. 
-
      658. 33                return this.dropTable(argsToArray(arguments).filter(function (t) {
        659. 
-
      659. 38                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
        660. 
-
      660.                  }));
        661. 
-
      661.  
        662. 
+
      662.                  } else {
        663. 
+
      663. 0                    item = this._toModel(item);
        664. 
+
      664. 0                    var items = this.getAssociation(model), index;
        665. 
+
      665. 0                    if (!isUndefinedOrNull(items) && (index = items.indexOf(item)) !== -1) {
        666. 
+
      666. 0                        items.splice(index, 1);
        667. 
+
      667.                      }
        668. 
+
      668.                  }
        669. 
 
      669.              }
        670. 
+
      670. 0            return ret.promise();
        671. 
 
      671.          },
        672. 
 
      672.  
        673. 
-
      673.          /**
        674. 
-
      674.           *  Forcible drops one or more tables corresponding to the given names, ignoring errors.
        675. 
-
      675.           *
        676. 
-
      676.           * @example
        677. 
-
      677.           * DB.dropTable("test");
        678. 
-
      678.           *      //=>'DROP TABLE test'
        679. 
-
      679.           * DB.dropTable("a", "bb", "ccc");
        680. 
-
      680.           *      //=>'DROP TABLE a',
        681. 
-
      681.           *      //=>'DROP TABLE bb',
        682. 
-
      682.           *      //=>'DROP TABLE ccc'
        683. 
-
      683.           *
        684. 
-
      684.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
        685. 
-
      685.           * to drop.
        686. 
-
      686.           *
        687. 
-
      687.           * @return {Promise} a promise that is resolved once all tables have been dropped.
        688. 
-
      688.           **/
        689. 
-
      689.          forceDropTable:function (names) {
        690. 
-
      690. 158            var ret = new Promise(), l = names.length;
        691. 
-
      691. 158            if (isArray(names)) {
        692. 
-
      692. 96                var drop = hitch(this, function (i) {
        693. 
-
      693. 241                    if (i < l) {
        694. 
-
      694. 145                        var name = names[i++];
        695. 
-
      695. 145                        this.executeDdl(this.__dropTableSql(name)).both(hitch(this, function () {
        696. 
-
      696. 145                            this.removeCachedSchema(name);
        697. 
-
      697. 145                            drop(i);
        698. 
-
      698.                          }));
        699. 
-
      699.                      } else {
        700. 
-
      700. 96                        ret.callback();
        701. 
-
      701.                      }
        702. 
-
      702.                  });
        703. 
-
      703. 96                drop(0);
        704. 
+
      704.          removeAllItems:function (model, remove) {
        705. 
+
      705. 4            remove = isBoolean(remove) ? remove : false;
        706. 
+
      706. 4            var ret = new Promise();
        707. 
+
      707. 4            if (!model.isNew) {
        708. 
+
      708. 4                var q = {}, removeQ = {};
        709. 
+
      709. 4                this._setAssociationKeys(model, q);
        710. 
+
      710. 4                this._setAssociationKeys(model, removeQ, null);
        711. 
+
      711. 4                var loaded = this.associationLoaded(model);
        712. 
+
      712. 4                return model._checkTransaction(hitch(this, function () {
        713. 
+
      713. 4                    var ds = this.model.dataset, ret = new Promise();
        714. 
+
      714. 4                    when(remove ? this._filter(model).forEach(function (m) {
        715. 
+
      715. 6                        return m.remove();
        716. 
+
      716.                      }) : this.joinTable.filter(q).update(removeQ)).then(function () {
        717. 
+
      717. 4                        if (loaded) {
        718. 
+
      718. 2                            this.parent._reloadAssociationsForType(this.type, this.model, model)
        719. 
+
      719.                                  .then(hitchIgnore(ret, "callback", model), ret);
        720. 
+
      720.                          } else {
        721. 
+
      721. 2                            ret.callback(model);
        722. 
+
      722.                          }
        723. 
+
      723.                      }.bind(this), ret);
        724. 
+
      724. 4                    return ret.promise();
        725. 
+
      725.                  }));
        726. 
 
      726.              } else {
        727. 
-
      727. 62                this.forceDropTable(argsToArray(arguments).filter(function (t) {
        728. 
-
      728. 62                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
        729. 
-
      729.                  })).both(ret);
        730. 
+
      730.                  //todo we may want to check if any of the items were previously saved items;
        731. 
+
      731. 0                this._clearAssociations(model);
        732. 
+
      732. 0                ret.callback(model);
        733. 
 
      733.              }
        734. 
-
      734. 158            return ret.promise();
        735. 
+
      735. 0            return ret.promise();
        736. 
 
      736.          },
        737. 
 
      737.  
        738. 
-
      738.          /**
        739. 
-
      739.           *  Drops one or more views corresponding to the given names.
        740. 
-
      740.           *
        741. 
-
      741.           * @example
        742. 
-
      742.           * DB.dropView("test_view");
        743. 
-
      743.           *      //=>'DROP VIEW test_view'
        744. 
-
      744.           * DB.dropTable("test_view_1", "test_view_2", "test_view_3");
        745. 
-
      745.           *      //=>'DROP VIEW test_view_1',
        746. 
-
      746.           *      //=>'DROP VIEW test_view_2',
        747. 
-
      747.           *      //=>'DROP VIEW test_view_3'
        748. 
-
      748.           *
        749. 
-
      749.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the views
        750. 
-
      750.           * to drop.
        751. 
-
      751.           *
        752. 
-
      752.           * @return {Promise} a promise that is resolved once the view/s have been dropped.
        753. 
-
      753.           **/
        754. 
-
      754.          dropView:function (names) {
        755. 
-
      755. 8            var ret = new Promise(), l = names.length;
        756. 
-
      756. 8            if (isArray(names)) {
        757. 
-
      757. 4                var drop = hitch(this, function (i) {
        758. 
-
      758. 8                    if (i < l) {
        759. 
-
      759. 4                        var name = names[i++];
        760. 
-
      760. 4                        this.executeDdl(format("DROP VIEW %s", this.__quoteSchemaTable(name))).then(hitch(this, function () {
        761. 
-
      761. 4                            this.removeCachedSchema(name);
        762. 
-
      762. 4                            drop(i);
        763. 
-
      763.                          }), ret);
        764. 
-
      764.                      } else {
        765. 
-
      765. 4                        ret.callback();
        766. 
-
      766.                      }
        767. 
-
      767.                  });
        768. 
-
      768. 4                drop(0);
        769. 
-
      769. 4                return ret.promise();
        770. 
-
      770.              } else {
        771. 
-
      771. 4                return this.dropView(argsToArray(arguments).filter(function (t) {
        772. 
-
      772. 4                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
        773. 
-
      773.                  }));
        774. 
 
      774.  
        775. 
-
      775.              }
        776. 
-
      776.          },
        777. 
+
      777.          getters:{
        778. 
 
      778.  
        779. 
-
      779.          /**
        780. 
-
      780.           * Renames a table.
        781. 
-
      781.           *
        782. 
-
      782.           * @example
        783. 
-
      783.           * comb.executeInOrder(DB, function(DB){
        784. 
-
      784.           *   DB.tables(); //=> ["items"]
        785. 
-
      785.           *   DB.renameTable("items", "old_items");
        786. 
-
      786.           *          //=>'ALTER TABLE items RENAME TO old_items'
        787. 
-
      787.           *   DB.tables; //=> ["old_items"]
        788. 
-
      788.           *});
        789. 
-
      789.           *
        790. 
-
      790.           * @param {String|patio.sql.Identifier} name the name of the table to rename
        791. 
-
      791.           * @param {String|patio.sql.Identifier} newName the new name of the table
        792. 
-
      792.           * @return {Promise} a promise that is resolved once the table is renamed.
        793. 
-
      793.           **/
        794. 
-
      794.          renameTable:function (name, newName) {
        795. 
-
      795. 2            return this.executeDdl(this.__renameTableSql(name, newName)).chain(hitch(this, function () {
        796. 
-
      796. 2                this.removeCachedSchema(name);
        797. 
-
      797.              })).promise();
        798. 
+
      798.              select:function () {
        799. 
+
      799. 326                return this.__select;
        800. 
+
      800.              },
        801. 
 
      801.  
        802. 
-
      802.          },
        803. 
+
      803.              defaultLeftKey:function () {
        804. 
+
      804. 1740                return this.__opts.leftKey || this.parent.tableName + "Id";
        805. 
+
      805.              },
        806. 
 
      806.  
        807. 
-
      807.          /**
        808. 
-
      808.           * @private
        809. 
-
      809.           *  The SQL to execute to modify the DDL for the given table name.  op
        810. 
-
      810.           * should be one of the operations returned by the AlterTableGenerator.
        811. 
-
      811.           * */
        812. 
-
      812.          __alterTableSql:function (table, op) {
        813. 
-
      813. 83            var ret = new Promise();
        814. 
-
      814. 83            var quotedName = op.name ? this.__quoteIdentifier(op.name) : null;
        815. 
-
      815. 83            var alterTableOp = null;
        816. 
-
      816. 83            switch (op.op) {
        817. 
-
      817.                  case "addColumn":
        818. 
-
      818. 13                    alterTableOp = format("ADD COLUMN %s", this.__columnDefinitionSql(op));
        819. 
-
      819. 13                    break;
        820. 
-
      820.                  case "dropColumn":
        821. 
-
      821. 4                    alterTableOp = format("DROP COLUMN %s", quotedName);
        822. 
-
      822. 4                    break;
        823. 
-
      823.                  case "renameColumn":
        824. 
-
      824. 52                    alterTableOp = format("RENAME COLUMN %s TO %s", quotedName, this.__quoteIdentifier(op.newName));
        825. 
-
      825. 52                    break;
        826. 
-
      826.                  case "setColumnType":
        827. 
-
      827. 3                    alterTableOp = format("ALTER COLUMN %s TYPE %s", quotedName, this.typeLiteral(op));
        828. 
-
      828. 3                    break;
        829. 
-
      829.                  case "setColumnDefault":
        830. 
-
      830. 2                    alterTableOp = format("ALTER COLUMN %s SET DEFAULT %s", quotedName, this.literal(op["default"]));
        831. 
-
      831. 2                    break;
        832. 
-
      832.                  case "setColumnNull":
        833. 
-
      833. 0                    alterTableOp = format("ALTER COLUMN %s %s NOT NULL", quotedName, op["null"] ? "DROP" : "SET");
        834. 
-
      834. 0                    break;
        835. 
-
      835.                  case "addIndex":
        836. 
-
      836. 5                    return ret.callback(this.__indexDefinitionSql(table, op)).promise();
        837. 
-
      837.                  case "dropIndex":
        838. 
-
      838. 2                    return ret.callback(this.__dropIndexSql(table, op)).promise();
        839. 
-
      839.                  case "addConstraint":
        840. 
-
      840. 1                    alterTableOp = format("ADD %s", this.__constraintDefinitionSql(op));
        841. 
-
      841. 1                    break;
        842. 
-
      842.                  case "dropConstraint":
        843. 
-
      843. 0                    alterTableOp = format("DROP CONSTRAINT %s", quotedName);
        844. 
-
      844. 0                    break;
        845. 
-
      845.                  default :
        846. 
-
      846. 1                    throw new DatabaseError("Invalid altertable operator");
        847. 
+
      847.              defaultRightKey:function () {
        848. 
+
      848. 1740                return this.__opts.rightKey || this.model.tableName + "Id";
        849. 
+
      849.              },
        850. 
+
      850.  
        851. 
+
      851.              parentPrimaryKey:function () {
        852. 
+
      852. 1036                return this.__opts.leftPrimaryKey || this.parent.primaryKey;
        853. 
+
      853.              },
        854. 
+
      854.  
        855. 
+
      855.              modelPrimaryKey:function () {
        856. 
+
      856. 502                return this.__opts.rightPrimaryKey || this.model.primaryKey;
        857. 
+
      857.              },
        858. 
+
      858.  
        859. 
+
      859.              joinTableName:function () {
        860. 
+
      860. 344                if (!this._joinTable) {
        861. 
+
      861. 18                    var options = this.__opts;
        862. 
+
      862. 18                    var joinTable = options.joinTable;
        863. 
+
      863. 18                    if (isUndefined(joinTable)) {
        864. 
+
      864. 18                        var defaultJoinTable = this.defaultJoinTable;
        865. 
+
      865. 18                        if (isUndefined(defaultJoinTable)) {
        866. 
+
      866. 0                            throw new Error("Unable to determine jointable for " + this.name);
        867. 
+
      867.                          } else {
        868. 
+
      868. 18                            this._joinTable = defaultJoinTable;
        869. 
+
      869.                          }
        870. 
+
      870.                      } else {
        871. 
+
      871. 0                        this._joinTable = joinTable;
        872. 
+
      872.                      }
        873. 
+
      873.                  }
        874. 
+
      874. 344                return this._joinTable;
        875. 
+
      875.              },
        876. 
+
      876.  
        877. 
+
      877.              //returns our join table model
        878. 
+
      878.              joinTable:function () {
        879. 
+
      879. 380                if (!this.__joinTableDataset) {
        880. 
+
      880. 18                    var ds = this.__joinTableDataset = this.model.dataset.db.from(this.joinTableName), model = this.model, options = this.__opts;
        881. 
+
      881. 18                    var identifierInputMethod = isUndefined(options.identifierInputMethod) ? model.identifierInputMethod : options.identifierInputMethod,
        882. 
+
      882.                          identifierOutputMethod = isUndefined(options.identifierOutputMethod) ? model.identifierOutputMethod : options.identifierOutputMethod;
        883. 
+
      883. 18                    if (identifierInputMethod) {
        884. 
+
      884. 14                        ds.identifierInputMethod = identifierInputMethod;
        885. 
+
      885.                      }
        886. 
+
      886. 18                    if (identifierOutputMethod) {
        887. 
+
      887. 14                        ds.identifierOutputMethod = identifierOutputMethod;
        888. 
+
      888.                      }
        889. 
+
      889.                  }
        890. 
+
      890. 380                return this.__joinTableDataset;
        891. 
+
      891.              },
        892. 
+
      892.  
        893. 
+
      893.              defaultJoinTable:function () {
        894. 
+
      894. 18                var ret;
        895. 
+
      895. 18                var recip = this.model._findAssociation(this);
        896. 
+
      896. 18                if (recip && recip.length) {
        897. 
+
      897. 18                    var names = [pluralize(this._model), pluralize(recip[1]._model)].sort();
        898. 
+
      898. 18                    names[1] = names[1].charAt(0).toUpperCase() + names[1].substr(1);
        899. 
+
      899. 18                    ret = names.join("");
        900. 
+
      900.                  }
        901. 
+
      901. 18                return ret;
        902. 
 
      902.              }
        903. 
-
      903. 75            return ret.callback(format("ALTER TABLE %s %s", this.__quoteSchemaTable(table), alterTableOp)).promise();
        904. 
-
      904.          },
        905. 
+
      905.          }
        906. 
+
      906.      }
        907. 
+
      907.  });
        908. 
+
      908.  
      
+
    + +
    + + + + + +
    +
    database/schema.js
    +     		+
    + Coverage89.45 + SLOC1230 + LOC275 + Missed29 +
    +
    + 
    1. 1"use strict";
      2. 
+
    2. 1var comb = require("comb"),
      3. 
+
    3.      isFunction = comb.isFunction,
      4. 
+
    4.      argsToArray = comb.argsToArray,
      5. 
+
    5.      array = comb.array,
      6. 
+
    6.      isArray = comb.isArray,
      7. 
+
    7.      isString = comb.isString,
      8. 
+
    8.      isUndefined = comb.isUndefined,
      9. 
+
    9.      isNumber = comb.isNumber,
      10. 
+
    10.      toArray = comb.array.toArray,
      11. 
+
    11.      hitch = comb.hitch,
      12. 
+
    12.      format = comb.string.format,
      13. 
+
    13.      Dataset = require("../dataset"),
      14. 
+
    14.      Promise = comb.Promise,
      15. 
+
    15.      PromiseList = comb.PromiseList,
      16. 
+
    16.      errors = require("../errors"),
      17. 
+
    17.      DatabaseError = errors.DatabaseError,
      18. 
+
    18.      generators = require("./schemaGenerators"),
      19. 
+
    19.      SchemaGenerator = generators.SchemaGenerator,
      20. 
+
    20.      AlterTableGenerator = generators.AlterTableGenerator,
      21. 
+
    21.      sql = require("../sql").sql,
      22. 
+
    22.      Time = sql.Time,
      23. 
+
    23.      TimeStamp = sql.TimeStamp,
      24. 
+
    24.      DateTime = sql.DateTime,
      25. 
+
    25.      Year = sql.Year,
      26. 
+
    26.      Float = sql.Float,
      27. 
+
    27.      Decimal = sql.Decimal,
      28. 
+
    28.      isInstanceOf = comb.isInstanceOf,
      29. 
+
    29.      Identifier = sql.Identifier,
      30. 
+
    30.      QualifiedIdentifier = sql.QualifiedIdentifier,
      31. 
+
    31.      define = comb.define;
      32. 
 
    32.  
      33. 
-
    33.          /**
      34. 
-
    34.           * @private
      35. 
-
    35.           * Array of SQL DDL modification statements for the given table,
      36. 
-
    36.           * corresponding to the DDL changes specified by the operations.
      37. 
-
    37.           * */
      38. 
-
    38.          __alterTableSqlList:function (table, operations) {
      39. 
-
    39. 84            return new PromiseList(operations.map(hitch(this, "__alterTableSql", table)));
      40. 
+
    40.  
      41. 
+
    41. 1define(null, {
      42. 
+
    42.      instance:{
      43. 
+
    43.          /**@lends patio.Database.prototype*/
      44. 
+
    44.  
      45. 
+
    45.          /**@ignore*/
      46. 
+
    46.          constructor:function () {
      47. 
+
    47. 123            this._super(arguments);
      48. 
+
    48. 123            this.schemas = {};
      49. 
 
    49.          },
      50. 
 
    50.  
      51. 
 
    51.          /**
      52. 
-
    52.           * @private
      53. 
-
    53.           * SQL DDL fragment containing the column creation SQL for the given column.
      54. 
+
    54.           * Adds a column to the specified table. This method expects a column name,
      55. 
+
    55.           * a datatype and optionally a hash with additional constraints and options:
      56. 
 
    56.           *
      57. 
-
    57.           * @param column
      58. 
-
    58.           */
      59. 
-
    59.          __columnDefinitionSql:function (column) {
      60. 
-
    60. 644            var sql = [format("%s %s", this.__quoteIdentifier(column.name), this.typeLiteral(column))];
      61. 
-
    61. 644            column.unique && sql.push(this._static.UNIQUE);
      62. 
-
    62. 644            (column.allowNull === false || column["null"] === false) && sql.push(this._static.NOT_NULL);
      63. 
-
    63. 644            (column.allowNull === true || column["null"] === true) && sql.push(this._static.NULL);
      64. 
-
    64. 644            !isUndefined(column["default"]) && sql.push(format(" DEFAULT %s", this.literal(column["default"])));
      65. 
-
    65. 644            column.primaryKey && sql.push(this._static.PRIMARY_KEY);
      66. 
-
    66. 644            column.autoIncrement && sql.push(" " + this.autoIncrementSql);
      67. 
-
    67. 644            column.table && sql.push(this.__columnReferencesColumnConstraintSql(column));
      68. 
-
    68. 644            return sql.join("");
      69. 
+
    69.           * <p>
      70. 
+
    70.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      71. 
+
    71.           *     addColumn call.
      72. 
+
    72.           * </p>
      73. 
+
    73.           *
      74. 
+
    74.           *
      75. 
+
    75.           * @example
      76. 
+
    76.           * //Outside of a table
      77. 
+
    77.           * //ALTER TABLE test ADD COLUMN name text UNIQUE'
      78. 
+
    78.           * DB.addColumn("test", "name", "text", {unique : true});
      79. 
+
    79.           *
      80. 
+
    80.           * @param {String} table the table to add the column to.
      81. 
+
    81.           * @param {String} column the name of the column to add.
      82. 
+
    82.           * @param type datatype of the column
      83. 
+
    83.           * @param {Object} [opts] additional options that can be used when adding a column.
      84. 
+
    84.           * @param {Boolean} [opts.primaryKey] set to true if this column is a primary key.
      85. 
+
    85.           * @param {Boolean} [opts.allowNull] whether or not this column should allow null.
      86. 
+
    86.           * @param {Boolean} [opts.unique] set to true to add a UNIQUE constraint to a column,
      87. 
+
    87.           *
      88. 
+
    88.           * @return {Promise} a promise that is resolved when the ADD COLUMN action is complete.
      89. 
+
    89.           **/
      90. 
+
    90.          addColumn:function (table, column, type, opts) {
      91. 
+
    91. 9            var args = argsToArray(arguments).slice(1);
      92. 
+
    92. 9            return this.alterTable(table, function () {
      93. 
+
    93. 9                this.addColumn.apply(this, args);
      94. 
+
    94.              });
      95. 
 
    95.          },
      96. 
 
    96.  
      97. 
 
    97.          /**
      98. 
-
    98.           * @private
      99. 
-
    99.           * SQL DDL fragment containing the column creation
      100. 
-
    100.           * SQL for all given columns, used inside a CREATE TABLE block.
      101. 
-
    101.           */
      102. 
-
    102.          __columnListSql:function (generator) {
      103. 
-
    103. 218            return generator.columns.map(hitch(this, "__columnDefinitionSql")).concat(generator.constraints.map(hitch(this, "__constraintDefinitionSql"))).join(this._static.COMMA_SEPARATOR);
      104. 
+
    104.           * Adds an index to a table for the given columns
      105. 
+
    105.           *
      106. 
+
    106.           * <p>
      107. 
+
    107.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      108. 
+
    108.           *     addIndex call.
      109. 
+
    109.           * </p>
      110. 
+
    110.           * @example
      111. 
+
    111.           * DB.addIndex("test", "name", {unique : true});
      112. 
+
    112.           *      //=> 'CREATE UNIQUE INDEX test_name_index ON test (name)'
      113. 
+
    113.           * DB.addIndex("test", ["one", "two"]);
      114. 
+
    114.           *      //=> ''CREATE INDEX test_one_two_index ON test (one, two)''
      115. 
+
    115.           *
      116. 
+
    116.           * @param {String} table the table to add the index to.
      117. 
+
    117.           * @param {String|String[]} columns the name of the column/s to create an index for.
      118. 
+
    118.           * @param {Object} [options] additional options that can be used when adding an index.
      119. 
+
    119.           * @param {Boolean} [options.unique] set to true if this this index should have a UNIQUE constraint.
      120. 
+
    120.           * @param {Boolean} [options.ignoreErrors] set to true to ignore errors.
      121. 
+
    121.           *
      122. 
+
    122.           * @return {Promise} a promise that is resolved when the CREATE INDEX action is complete.
      123. 
+
    123.           * */
      124. 
+
    124.          addIndex:function (table, columns, options) {
      125. 
+
    125. 4            options = options || {};
      126. 
+
    126. 4            var ignoreErrors = options.ignoreErrors === true;
      127. 
+
    127. 4            var ret = new Promise();
      128. 
+
    128. 4            this.alterTable(table,function () {
      129. 
+
    129. 4                this.addIndex(columns, options);
      130. 
+
    130.              }).then(ret, function (err) {
      131. 
+
    131. 0                    if (!ignoreErrors) {
      132. 
+
    132. 0                        ret.errback(err);
      133. 
+
    133.                      } else {
      134. 
+
    134. 0                        ret.callback();
      135. 
+
    135.                      }
      136. 
+
    136.                  });
      137. 
+
    137. 4            return ret.promise();
      138. 
 
    138.          },
      139. 
 
    139.  
      140. 
 
    140.          /**
      141. 
-
    141.           * @private
      142. 
-
    142.           *SQL DDL fragment for column foreign key references (column constraints)
      143. 
-
    143.           */
      144. 
-
    144.          __columnReferencesColumnConstraintSql:function (column) {
      145. 
-
    145. 30            return this.__columnReferencesSql(column);
      146. 
+
    146.           *  Removes a column from the specified table.
      147. 
+
    147.           * <p>
      148. 
+
    148.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      149. 
+
    149.           *     dropColumn call.
      150. 
+
    150.           * </p>
      151. 
+
    151.           *
      152. 
+
    152.           * @example
      153. 
+
    153.           *   DB.dropColumn("items", "category");
      154. 
+
    154.           *          //=> 'ALTER TABLE items DROP COLUMN category',
      155. 
+
    155.           *
      156. 
+
    156.           * @param {String|patio.sql.Identifier} table the table to alter.
      157. 
+
    157.           * @param {String|patio.sql.Identifier} column the column to drop.
      158. 
+
    158.           *
      159. 
+
    159.           * @return {Promise} a promise that is resolved once the DROP COLUMN action is complete.
      160. 
+
    160.           * */
      161. 
+
    161.          dropColumn:function (table, column) {
      162. 
+
    162. 3            column = argsToArray(arguments).slice(1);
      163. 
+
    163. 3            return this.alterTable(table, function () {
      164. 
+
    164. 3                this.dropColumn.apply(this, column);
      165. 
+
    165.              });
      166. 
 
    166.          },
      167. 
 
    167.  
      168. 
 
    168.          /**
      169. 
-
    169.           * @private
      170. 
-
    170.           * SQL DDL fragment for column foreign key references
      171. 
-
    171.           */
      172. 
-
    172.          __columnReferencesSql:function (column) {
      173. 
-
    173. 38            var sql = format(" REFERENCES %s", this.__quoteSchemaTable(column.table));
      174. 
-
    174. 38            column.key && (sql += format("(%s)", array.toArray(column.key).map(this.__quoteIdentifier, this).join(this._static.COMMA_SEPARATOR)));
      175. 
-
    175. 38            column.onDelete && (sql += format(" ON DELETE %s", this.__onDeleteClause(column.onDelete)));
      176. 
-
    176. 38            column.onUpdate && (sql += format(" ON UPDATE %s", this.__onUpdateClause(column.onUpdate)));
      177. 
-
    177. 38            column.deferrable && (sql += " DEFERRABLE INITIALLY DEFERRED");
      178. 
-
    178. 38            return sql;
      179. 
+
    179.           * Removes an index for the given table and column/s.
      180. 
+
    180.           *
      181. 
+
    181.           * <p>
      182. 
+
    182.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      183. 
+
    183.           *     dropIndex call.
      184. 
+
    184.           * </p>
      185. 
+
    185.           *
      186. 
+
    186.           * @example
      187. 
+
    187.           *   DB.dropIndex("posts", "title");
      188. 
+
    188.           *      //=>'DROP INDEX posts_title_index
      189. 
+
    189.           *   DB.dropIndex("posts", ["author", "title"]);
      190. 
+
    190.           *      //'DROP INDEX posts_author_title_index'
      191. 
+
    191.           *
      192. 
+
    192.           * @param {String|patio.sql.Identifier} table the table to alter.
      193. 
+
    193.           * @param {String|patio.sql.Identifier} column the name of the column/s the index was created from.
      194. 
+
    194.           *
      195. 
+
    195.           * @return {Promise} a promise that is resolved once the DROP INDEX action is complete.
      196. 
+
    196.           * */
      197. 
+
    197.          dropIndex:function (table, columns, options) {
      198. 
+
    198. 1            var args = argsToArray(arguments).slice(1);
      199. 
+
    199. 1            return this.alterTable(table, function () {
      200. 
+
    200. 1                this.dropIndex.apply(this, args);
      201. 
+
    201.              });
      202. 
 
    202.          },
      203. 
 
    203.  
      204. 
 
    204.          /**
      205. 
-
    205.           * @private
      206. 
-
    206.           * SQL DDL fragment for table foreign key references (table constraints)
      207. 
+
    207.           * Renames a column in the specified table.
      208. 
+
    208.           *
      209. 
+
    209.           * <p>
      210. 
+
    210.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      211. 
+
    211.           *     renameColumn call.
      212. 
+
    212.           * </p>
      213. 
+
    213.           *
      214. 
+
    214.           * @example
      215. 
+
    215.           * DB.renameColumn("items", "cntr", "counter");
      216. 
+
    216.           *      //=> ALTER TABLE items RENAME COLUMN cntr TO counter
      217. 
+
    217.           *
      218. 
+
    218.           * @param {String|patio.sql.Identifier} table the table to alter.
      219. 
+
    219.           * @param {String|patio.sql.Identifier} column the name of the column to rename.
      220. 
+
    220.           * @param {String|patio.sql.Identifier} newColumn the new name of the column.
      221. 
+
    221.           *
      222. 
+
    222.           * @return {Promise} a promise that is resolved once the RENAME COLUMN action is complete.
      223. 
 
    223.           * */
      224. 
-
    224.          __columnReferencesTableConstraintSql:function (constraint) {
      225. 
-
    225. 6            return format("FOREIGN KEY %s%s", this.literal(constraint.columns.map(function (c) {
      226. 
-
    226. 6                return isString(c) ? sql.stringToIdentifier(c) : c;
      227. 
-
    227.              })), this.__columnReferencesSql(constraint));
      228. 
+
    228.          renameColumn:function (table, column, newColumn) {
      229. 
+
    229. 4            var args = argsToArray(arguments).slice(1);
      230. 
+
    230. 4            return this.alterTable(table, function () {
      231. 
+
    231. 4                this.renameColumn.apply(this, args);
      232. 
+
    232.              });
      233. 
 
    233.          },
      234. 
 
    234.  
      235. 
-
    235.          /**
      236. 
-
    236.           * @private
      237. 
-
    237.           * SQL DDL fragment specifying a constraint on a table.
      238. 
-
    238.           */
      239. 
-
    239.          __constraintDefinitionSql:function (constraint) {
      240. 
-
    240. 6            var ret = [constraint.name ? format("CONSTRAINT %s ", this.__quoteIdentifier(constraint.name)) : ""];
      241. 
-
    241. 6            switch (constraint.type) {
      242. 
-
    242.                  case "check":
      243. 
-
    243. 0                    var check = constraint.check;
      244. 
-
    244. 0                    ret.push(format("CHECK %s", this.__filterExpr(isArray(check) && check.length === 1 ? check[0] : check)));
      245. 
-
    245. 0                    break;
      246. 
-
    246.                  case "primaryKey":
      247. 
-
    247. 0                    ret.push(format("PRIMARY KEY %s", this.literal(constraint.columns.map(function (c) {
      248. 
-
    248. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      249. 
-
    249.                      }))));
      250. 
-
    250. 0                    break;
      251. 
-
    251.                  case "foreignKey":
      252. 
-
    252. 6                    ret.push(this.__columnReferencesTableConstraintSql(constraint));
      253. 
-
    253. 6                    break;
      254. 
-
    254.                  case "unique":
      255. 
-
    255. 0                    ret.push(format("UNIQUE %s", this.literal(constraint.columns.map(function (c) {
      256. 
-
    256. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      257. 
-
    257.                      }))));
      258. 
-
    258. 0                    break;
      259. 
-
    259.                  default:
      260. 
-
    260. 0                    throw new DatabaseError(format("Invalid constriant type %s, should be 'check', 'primaryKey', foreignKey', or 'unique'", constraint.type));
      261. 
-
    261.              }
      262. 
-
    262. 6            return ret.join("");
      263. 
-
    263.          },
      264. 
 
    264.  
      265. 
 
    265.          /**
      266. 
-
    266.           * @private
      267. 
-
    267.           * Execute the create table statements using the generator.
      268. 
+
    268.           *Sets the default value for the given column in the given table:
      269. 
+
    269.           *
      270. 
+
    270.           * <p>
      271. 
+
    271.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      272. 
+
    272.           *     setColumnDefault call.
      273. 
+
    273.           * </p>
      274. 
+
    274.           *
      275. 
+
    275.           * @example
      276. 
+
    276.           * DB.setColumnDefault("items", "category", "misc");
      277. 
+
    277.           *      //=> ALTER TABLE items ALTER COLUMN category SET DEFAULT 'misc'
      278. 
+
    278.           *
      279. 
+
    279.           * @param {String|patio.sql.Identifier} table the table to alter.
      280. 
+
    280.           * @param {String|patio.sql.Identifier} column the name of the column to set the DEFAULT on.
      281. 
+
    281.           * @param  def the new default value of the column.
      282. 
+
    282.           *
      283. 
+
    283.           * @return {Promise} a promise that is resolved once the SET DEFAULT action is complete.
      284. 
 
    284.           * */
      285. 
-
    285.          __createTableFromGenerator:function (name, generator, options) {
      286. 
-
    286. 218            return this.executeDdl(this.__createTableSql(name, generator, options));
      287. 
+
    287.          setColumnDefault:function (table, column, def) {
      288. 
+
    288. 1            var args = argsToArray(arguments).slice(1);
      289. 
+
    289. 1            return this.alterTable(table, function () {
      290. 
+
    290. 1                this.setColumnDefault.apply(this, args);
      291. 
+
    291.              });
      292. 
 
    292.          },
      293. 
 
    293.  
      294. 
-
    294.          /**
      295. 
-
    295.           * @private
      296. 
-
    296.           * Execute the create index statements using the generator.
      297. 
-
    297.           * */
      298. 
-
    298.          __createTableIndexesFromGenerator:function (name, generator, options) {
      299. 
-
    299. 218            var e = options.ignoreIndexErrors;
      300. 
-
    300. 218            var ret = new Promise();
      301. 
-
    301. 218            var promises = generator.indexes.map(function (index) {
      302. 
-
    302. 18                var ps = this.__indexSqlList(name, [index]).map(this.executeDdl, this);
      303. 
-
    303. 18                return new PromiseList(ps);
      304. 
-
    304.              }, this);
      305. 
-
    305. 218            if (promises.length) {
      306. 
-
    306. 16                new PromiseList(promises).then(ret, hitch(ret, e ? "callback" : "errback"));
      307. 
-
    307.              } else {
      308. 
-
    308. 202                ret.callback();
      309. 
-
    309.              }
      310. 
-
    310. 218            return ret.promise();
      311. 
-
    311.          },
      312. 
 
    312.  
      313. 
 
    313.          /**
      314. 
-
    314.           * @private
      315. 
-
    315.           * DDL statement for creating a table with the given name, columns, and options
      316. 
+
    316.           *  Set the data type for the given column in the given table:
      317. 
+
    317.           * <p>
      318. 
+
    318.           *     This method is a shortcut to {@link patio.Database#alterTable} with an
      319. 
+
    319.           *     setColumnType call.
      320. 
+
    320.           * </p>
      321. 
+
    321.           *
      322. 
+
    322.           * @example
      323. 
+
    323.           * DB.setColumnType("items", "category", String);
      324. 
+
    324.           *      //=> ALTER TABLE items ALTER COLUMN category TYPE varchar(255)
      325. 
+
    325.           *
      326. 
+
    326.           * @param {String|patio.sql.Identifier} table the table to alter.
      327. 
+
    327.           * @param {String|patio.sql.Identifier} column the name of the column to set the TYPE on.
      328. 
+
    328.           * @param  type the datatype of the column.
      329. 
+
    329.           *
      330. 
+
    330.           * @return {Promise} a promise that is resolved once the SET TYPE action is complete.
      331. 
 
    331.           * */
      332. 
-
    332.          __createTableSql:function (name, generator, options) {
      333. 
-
    333. 218            return format("CREATE %sTABLE %s (%s)", options.temp ? this.temporaryTableSql : "", this.__quoteSchemaTable(name), this.__columnListSql(generator));
      334. 
+
    334.          setColumnType:function (table, column, type) {
      335. 
+
    335. 3            var args = argsToArray(arguments).slice(1);
      336. 
+
    336. 3            return this.alterTable(table, function () {
      337. 
+
    337. 3                this.setColumnType.apply(this, args);
      338. 
+
    338.              });
      339. 
 
    339.          },
      340. 
 
    340.  
      341. 
+
    341.  
      342. 
 
    342.          /**
      343. 
-
    343.           * @private
      344. 
-
    344.           * Default index name for the table and columns, may be too long
      345. 
-
    345.           * for certain databases.
      346. 
-
    346.           */
      347. 
-
    347.          __defaultIndexName:function (tableName, columns) {
      348. 
-
    348. 25            var parts = this.__schemaAndTable(tableName);
      349. 
-
    349. 25            var schema = parts[0], table = parts[1];
      350. 
-
    350. 25            var index = [];
      351. 
-
    351. 25            if (schema && schema !== this.defaultSchema) {
      352. 
-
    352. 0                index.push(schema);
      353. 
+
    353.           *  Alters the given table with the specified block.
      354. 
+
    354.           *  <p>
      355. 
+
    355.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being altered. The block
      356. 
+
    356.           *      is also called with the table as the first argument. Within the block you must use
      357. 
+
    357.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
      358. 
+
    358.           *      that is passed in for all alter table operations. See {@link patio.AlterTableGenerator} for
      359. 
+
    359.           *      avaiable operations.
      360. 
+
    360.           *  </p>
      361. 
+
    361.           *
      362. 
+
    362.           *  <p>
      363. 
+
    363.           *      <b>Note</b> that addColumn accepts all the options available for column
      364. 
+
    364.           *      definitions using createTable, and addIndex accepts all the options
      365. 
+
    365.           *      available for index definition.
      366. 
+
    366.           *  </p>
      367. 
+
    367.           *
      368. 
+
    368.           * @example
      369. 
+
    369.           *   //using the table object
      370. 
+
    370.           *   DB.alterTable("items", function(table){
      371. 
+
    371.           *      //you must use the passed in table object.
      372. 
+
    372.           *     table.addColumn("category", "text", {default : 'javascript'});
      373. 
+
    373.           *     table.dropColumn("category");
      374. 
+
    374.           *     table.renameColumn("cntr", "counter");
      375. 
+
    375.           *     table.setColumnType("value", "float");
      376. 
+
    376.           *     table.setColumnDefault("value", "float");
      377. 
+
    377.           *     table.addIndex(["group", "category"]);
      378. 
+
    378.           *     table.dropIndex [:group, :category]
      379. 
+
    379.           *   });
      380. 
+
    380.           *
      381. 
+
    381.           *   //using this
      382. 
+
    382.           *    DB.alterTable("items", function(){
      383. 
+
    383.           *     this.addColumn("category", "text", {default : 'javascript'});
      384. 
+
    384.           *     this.dropColumn("category");
      385. 
+
    385.           *     this.renameColumn("cntr", "counter");
      386. 
+
    386.           *     this.setColumnType("value", "float");
      387. 
+
    387.           *     this.setColumnDefault("value", "float");
      388. 
+
    388.           *     this.addIndex(["group", "category"]);
      389. 
+
    389.           *     this.dropIndex [:group, :category]
      390. 
+
    390.           *   });
      391. 
+
    391.           *
      392. 
+
    392.           *   //This will not work
      393. 
+
    393.           *   DB.alterTable("items", comb.hitch(someObject, function(){
      394. 
+
    394.           *    //This is called in the scope of someObject so this
      395. 
+
    395.           *    //will not work and will throw an error
      396. 
+
    396.           *     this.addColumn("category", "text", {default : 'javascript'});
      397. 
+
    397.           *   }));
      398. 
+
    398.           *
      399. 
+
    399.           *    //This will work
      400. 
+
    400.           *   DB.alterTable("items", comb.hitch(someObject, function(table){
      401. 
+
    401.           *    //This is called in the scope of someObject so you must
      402. 
+
    402.           *    //use the table argument
      403. 
+
    403.           *     table.category("text", {default : 'javascript'});
      404. 
+
    404.           *   }));
      405. 
+
    405.           *
      406. 
+
    406.           *
      407. 
+
    407.           * @param {String|patio.sql.Identifier} table to the table to perform the ALTER TABLE operations on.
      408. 
+
    408.           * @param {Function} block the block to invoke for the ALTER TABLE operations
      409. 
+
    409.           *
      410. 
+
    410.           * @return {Promise} a promise that is resolved once all ALTER TABLE operations have completed.
      411. 
+
    411.           * */
      412. 
+
    412.          alterTable:function (name, generator, block) {
      413. 
+
    413. 84            if (isFunction(generator)) {
      414. 
+
    414. 84                block = generator;
      415. 
+
    415. 84                generator = new AlterTableGenerator(this, block);
      416. 
 
    416.              }
      417. 
-
    417. 25            index.push(table);
      418. 
-
    418. 25            index = index.concat(columns.map(function (c) {
      419. 
-
    419. 28                return isString(c) ? c : this.literal(c).replace(/\W/g, "");
      420. 
-
    420.              }, this));
      421. 
-
    421. 25            index.push("index");
      422. 
-
    422. 25            return index.join(this._static.UNDERSCORE);
      423. 
-
    423.  
      424. 
+
    424. 84            var ret = new Promise();
      425. 
+
    425. 84            this.__alterTableSqlList(name, generator.operations).then(hitch(this, function (res) {
      426. 
+
    426. 84                var sqls = array.flatten(res.map(function (r) {
      427. 
+
    427. 93                    return r[1];
      428. 
+
    428.                  }));
      429. 
+
    429. 84                var l = sqls.length;
      430. 
+
    430. 84                var drop = hitch(this, function (i) {
      431. 
+
    431. 179                    if (i < l) {
      432. 
+
    432. 95                        var sql = sqls[i++];
      433. 
+
    433. 95                        this.executeDdl(sql).then(hitch(this, drop, i), ret);
      434. 
+
    434.                      } else {
      435. 
+
    435. 84                        this.removeCachedSchema(name);
      436. 
+
    436. 84                        ret.callback();
      437. 
+
    437.                      }
      438. 
+
    438.                  });
      439. 
+
    439. 84                drop(0);
      440. 
+
    440.              }));
      441. 
+
    441. 84            return ret.promise();
      442. 
 
    442.          },
      443. 
 
    443.  
      444. 
 
    444.          /**
      445. 
-
    445.           * @private
      446. 
-
    446.           * The SQL to drop an index for the table.
      447. 
-
    447.           * */
      448. 
-
    448.          __dropIndexSql:function (table, op) {
      449. 
-
    449. 2            return format("DROP INDEX %s", this.__quoteIdentifier(op.name || this.__defaultIndexName(table, op.columns)));
      450. 
-
    450.          },
      451. 
-
    451.  
      452. 
-
    452.          /**
      453. 
-
    453.           * @private
      454. 
+
    454.           * Creates a table with the columns given in the provided block:
      455. 
+
    455.           *
      456. 
+
    456.           * <p>
      457. 
+
    457.           *      <b>NOTE:</b> The block is invoked in the scope of the table that is being created. The block
      458. 
+
    458.           *      is also called with the table as the first argument. Within the block you must use
      459. 
+
    459.           *      <b>this</b>(If the block has not been bound to a different scope), or the table object
      460. 
+
    460.           *      that is passed in for all create table operations. See {@link patio.SchemaGenerator} for
      461. 
+
    461.           *      available operations.
      462. 
+
    462.           *  </p>
      463. 
+
    463.           *
      464. 
+
    464.           *
      465. 
+
    465.           * @example
      466. 
+
    466.           *
      467. 
+
    467.           *   //using the table to create the table
      468. 
+
    468.           *   DB.createTable("posts", function(table){
      469. 
+
    469.           *     table.primaryKey("id");
      470. 
+
    470.           *     table.column('title", "text");
      471. 
+
    471.           *     //you may also invoke the column name as
      472. 
+
    472.           *     //function on the table
      473. 
+
    473.           *     table.content(String);
      474. 
+
    474.           *     table.index(title);
      475. 
+
    475.           *   });
      476. 
+
    476.           *
      477. 
+
    477.           *   //using this to create the table
      478. 
+
    478.           *   DB.createTable("posts", function(){
      479. 
+
    479.           *     this.primaryKey("id");
      480. 
+
    480.           *     this.column('title", "text");
      481. 
+
    481.           *     //you may also invoke the column name as
      482. 
+
    482.           *     //function on the table
      483. 
+
    483.           *     this.content(String);
      484. 
+
    484.           *     this.index(title);
      485. 
+
    485.           *   });
      486. 
+
    486.           *
      487. 
+
    487.           * @param {String|patio.sql.Identifier} name the name of the table to create.
      488. 
+
    488.           * @param {Object} [options] an optional options object
      489. 
+
    489.           * @param {Boolean} [options.temp] set to true if this table is a TEMPORARY table.
      490. 
+
    490.           * @param {Boolean} [options.ignoreIndexErrors] Ignore any errors when creating indexes.
      491. 
+
    491.           * @param {Function} block the block to invoke when creating the table.
      492. 
+
    492.           *
      493. 
+
    493.           * @return {Promise} a promise that is resolved when the CREATE TABLE action is completed.
      494. 
 
    494.           *
      495. 
-
    495.           *  SQL DDL statement to drop the table with the given name.
      496. 
-
    496.           **/
      497. 
-
    497.          __dropTableSql:function (name) {
      498. 
-
    498. 210            return format("DROP TABLE %s", this.__quoteSchemaTable(name));
      499. 
-
    499.          },
      500. 
-
    500.  
      501. 
-
    501.          /**
      502. 
-
    502.           * @private
      503. 
-
    503.           * Proxy the filterExpr call to the dataset, used for creating constraints.
      504. 
-
    504.           * */
      505. 
-
    505.          __filterExpr:function (args, block) {
      506. 
-
    506. 2            var ds = this.__schemaUtiltyDataset;
      507. 
-
    507. 2            return ds.literal(ds._filterExpr.apply(ds, arguments));
      508. 
-
    508.          },
      509. 
-
    509.  
      510. 
-
    510.  
      511. 
-
    511.          /**
      512. 
-
    512.           * @private
      513. 
-
    513.           * SQL DDL statement for creating an index for the table with the given name
      514. 
-
    514.           * and index specifications.
      515. 
 
    515.           */
      516. 
-
    516.          __indexDefinitionSql:function (tableName, index) {
      517. 
-
    517. 7            var indexName = index.name || this.__defaultIndexName(tableName, index.columns);
      518. 
-
    518. 7            if (index.type) {
      519. 
-
    519. 0                throw new DatabaseError("Index types are not supported for this database");
      520. 
-
    520. 7            } else if (index.where) {
      521. 
-
    521. 0                throw new DatabaseError("Partial indexes are not supported for this database");
      522. 
-
    522.              } else {
      523. 
-
    523. 7                return format("CREATE %sINDEX %s ON %s %s", index.unique ? "UNIQUE " : "", this.__quoteIdentifier(indexName), this.__quoteSchemaTable(tableName), this.literal(index.columns.map(function (c) {
      524. 
-
    524. 8                    return isString(c) ? new Identifier(c) : c;
      525. 
-
    525.                  })));
      526. 
+
    526.          createTable:function (name, options, block) {
      527. 
+
    527. 218            if (isFunction(options)) {
      528. 
+
    528. 208                block = options;
      529. 
+
    529. 208                options = {};
      530. 
+
    530.              }
      531. 
+
    531. 218            this.removeCachedSchema(name);
      532. 
+
    532. 218            if (isInstanceOf(options, SchemaGenerator)) {
      533. 
+
    533. 0                options = {generator:options};
      534. 
 
    534.              }
      535. 
+
    535. 218            var generator = options.generator || new SchemaGenerator(this, block);
      536. 
+
    536. 218            return this.__createTableFromGenerator(name, generator, options)
      537. 
+
    537.                  .chain(hitch(this, "__createTableIndexesFromGenerator", name, generator, options))
      538. 
+
    538.                  .promise();
      539. 
 
    539.          },
      540. 
 
    540.  
      541. 
 
    541.          /**
      542. 
-
    542.           * Array of SQL DDL statements, one for each index specification,
      543. 
-
    543.           * for the given table.
      544. 
-
    544.           */
      545. 
-
    545.          __indexSqlList:function (tableName, indexes) {
      546. 
-
    546. 18            return indexes.map(hitch(this, this.__indexDefinitionSql, tableName));
      547. 
+
    547.           * Forcibly creates a table, attempting to drop it unconditionally (and catching any errors), then creating it.
      548. 
+
    548.           * <p>
      549. 
+
    549.           *      See {@link patio.Database#createTable} for parameter types.
      550. 
+
    550.           * </p>
      551. 
+
    551.           *
      552. 
+
    552.           * @example
      553. 
+
    553.           *  // DROP TABLE a
      554. 
+
    554.           *  // CREATE TABLE a (a integer)
      555. 
+
    555.           *   DB.forceCreateTable("a", function(){
      556. 
+
    556.           *      this.a("integer");
      557. 
+
    557.           *   });
      558. 
+
    558.           *
      559. 
+
    559.           **/
      560. 
+
    560.          forceCreateTable:function (name, options, block) {
      561. 
+
    561. 18            return this.dropTable(name)
      562. 
+
    562.                  .chainBoth(hitch(this, this.createTable, name, options, block))
      563. 
+
    563.                  .promise();
      564. 
 
    564.          },
      565. 
 
    565.  
      566. 
-
    566.          /**
      567. 
-
    567.           * @private
      568. 
-
    568.           * SQL DDL ON DELETE fragment to use, based on the given action.
      569. 
-
    569.           *The following actions are recognized:
      570. 
-
    570.           * <ul>
      571. 
-
    571.           *  <li>cascade - Delete rows referencing this row.</li>
      572. 
-
    572.           *  <li>noAction (default) - Raise an error if other rows reference this
      573. 
-
    573.           *   row, allow deferring of the integrity check.
      574. 
-
    574.           *  </li>
      575. 
-
    575.           *  <li>restrict - Raise an error if other rows reference this row,
      576. 
-
    576.           *   but do not allow deferring the integrity check.</li>
      577. 
-
    577.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      578. 
-
    578.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      579. 
-
    579.           * </ul>
      580. 
-
    580.           */
      581. 
-
    581.          __onDeleteClause:function (action) {
      582. 
-
    582. 23            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      583. 
-
    583.          },
      584. 
 
    584.  
      585. 
 
    585.          /**
      586. 
-
    586.           * @private
      587. 
-
    587.           * SQL DDL ON UPDATE fragment to use, based on the given action.
      588. 
-
    588.           *The following actions are recognized:
      589. 
-
    589.           * <ul>
      590. 
-
    590.           *  <li>cascade - Delete rows referencing this row.</li>
      591. 
-
    591.           *  <li>noAction (default) - Raise an error if other rows reference this
      592. 
-
    592.           *   row, allow deferring of the integrity check.
      593. 
-
    593.           *  </li>
      594. 
-
    594.           *  <li>restrict - Raise an error if other rows reference this row,
      595. 
-
    595.           *   but do not allow deferring the integrity check.</li>
      596. 
-
    596.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      597. 
-
    597.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      598. 
-
    598.           * </ul>
      599. 
+
    599.           * Creates the table unless the table already exists.
      600. 
+
    600.           * <p>
      601. 
+
    601.           *      See {@link patio.Database#createTable} for parameter types.
      602. 
+
    602.           * </p>
      603. 
 
    603.           */
      604. 
-
    604.          __onUpdateClause:function (action) {
      605. 
-
    605. 1            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      606. 
+
    606.          createTableUnlessExists:function (name, options, block) {
      607. 
+
    607. 0            var ret = new Promise();
      608. 
+
    608. 0            this.tableExists(name).then(hitch(this, function (exists) {
      609. 
+
    609. 0                if (!exists) {
      610. 
+
    610. 0                    this.createTable(name, options, block).then(ret);
      611. 
+
    611.                  } else {
      612. 
+
    612. 0                    ret.callback();
      613. 
+
    613.                  }
      614. 
+
    614.              }), ret);
      615. 
+
    615. 0            return ret.promise();
      616. 
 
    616.          },
      617. 
 
    617.  
      618. 
 
    618.          /**
      619. 
-
    619.           * @private
      620. 
-
    620.           * Proxy the quoteSchemaTable method to the dataset
      621. 
-
    621.           * */
      622. 
-
    622.          __quoteSchemaTable:function (table) {
      623. 
-
    623. 2212            return this.__schemaUtiltyDataset.quoteSchemaTable(table);
      624. 
+
    624.           * Creates a view, replacing it if it already exists:
      625. 
+
    625.           * @example
      626. 
+
    626.           *   DB.createOrReplaceView("cheapItems", "SELECT * FROM items WHERE price < 100");
      627. 
+
    627.           *      //=> CREATE OR REPLACE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
      628. 
+
    628.           *   DB.createOrReplaceView("miscItems", DB[:items].filter({category : 'misc'}));
      629. 
+
    629.           *     //=> CREATE OR REPLACE VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
      630. 
+
    630.           *
      631. 
+
    631.           * @param {String|patio.sql.Identifier} name the name of the view to create.
      632. 
+
    632.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
      633. 
+
    633.           * view.
      634. 
+
    634.           *
      635. 
+
    635.           * @return {Promise} a promise that is resolved when the CREATE OR REPLACE VIEW action is complete.
      636. 
+
    636.           **/
      637. 
+
    637.          createOrReplaceView:function (name, source) {
      638. 
+
    638. 4            if (isInstanceOf(source, Dataset)) {
      639. 
+
    639. 2                source = source.sql;
      640. 
+
    640.              }
      641. 
+
    641. 4            var ret = new Promise();
      642. 
+
    642. 4            this.executeDdl(format("CREATE OR REPLACE VIEW %s AS %s", this.__quoteSchemaTable(name), source)).then(hitch(this, function () {
      643. 
+
    643. 4                this.removeCachedSchema(name);
      644. 
+
    644. 4                ret.callback();
      645. 
+
    645.              }), ret);
      646. 
+
    646. 4            return ret.promise();
      647. 
 
    647.          },
      648. 
 
    648.  
      649. 
 
    649.          /**
      650. 
-
    650.           * @private
      651. 
-
    651.           * Proxy the quoteIdentifier method to the dataset, used for quoting tables and columns.
      652. 
-
    652.           * */
      653. 
-
    653.          __quoteIdentifier:function (v) {
      654. 
-
    654. 846            return this.__schemaUtiltyDataset.quoteIdentifier(v);
      655. 
+
    655.           * Creates a view based on a dataset or an SQL string:
      656. 
+
    656.           * @example
      657. 
+
    657.           *   DB.createView("cheapItems", "SELECT * FROM items WHERE price < 100");
      658. 
+
    658.           *      //=> CREATE VIEW cheapItems AS SELECT * FROM items WHERE price < 100
      659. 
+
    659.           *   DB.createView("miscItems", DB[:items].filter({category : 'misc'}));
      660. 
+
    660.           *     //=> CREATE  VIEW miscItems AS SELECT * FROM items WHERE category = 'misc'
      661. 
+
    661.           *
      662. 
+
    662.           * @param {String|patio.sql.Identifier} name the name of the view to create.
      663. 
+
    663.           * @param {String|patio.Dataset} source the SQL or {@link patio.Dataset} to use as the source of the
      664. 
+
    664.           * view.
      665. 
+
    665.           **/
      666. 
+
    666.          createView:function (name, source) {
      667. 
+
    667. 4            if (isInstanceOf(source, Dataset)) {
      668. 
+
    668. 2                source = source.sql;
      669. 
+
    669.              }
      670. 
+
    670. 4            return this.executeDdl(format("CREATE VIEW %s AS %s", this.__quoteSchemaTable(name), source));
      671. 
 
    671.          },
      672. 
 
    672.  
      673. 
 
    673.          /**
      674. 
-
    674.           * @private
      675. 
-
    675.           * SQL DDL statement for renaming a table.
      676. 
-
    676.           * */
      677. 
-
    677.          __renameTableSql:function (name, newName) {
      678. 
-
    678. 1            return format("ALTER TABLE %s RENAME TO %s", this.__quoteSchemaTable(name), this.__quoteSchemaTable(newName));
      679. 
-
    679.          },
      680. 
+
    680.           *  Drops one or more tables corresponding to the given names.
      681. 
+
    681.           *
      682. 
+
    682.           * @example
      683. 
+
    683.           * DB.dropTable("test");
      684. 
+
    684.           *      //=>'DROP TABLE test'
      685. 
+
    685.           * DB.dropTable("a", "bb", "ccc");
      686. 
+
    686.           *      //=>'DROP TABLE a',
      687. 
+
    687.           *      //=>'DROP TABLE bb',
      688. 
+
    688.           *      //=>'DROP TABLE ccc'
      689. 
+
    689.           *
      690. 
+
    690.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
      691. 
+
    691.           * to drop.
      692. 
+
    692.           *
      693. 
+
    693.           * @return {Promise} a promise that is resolved once all tables have been dropped.
      694. 
+
    694.           **/
      695. 
+
    695.          dropTable:function (names) {
      696. 
+
    696. 81            var ret = new Promise(), l = names.length;
      697. 
+
    697. 81            if (isArray(names)) {
      698. 
+
    698. 48                var drop = hitch(this, function (i) {
      699. 
+
    699. 104                    if (i < l) {
      700. 
+
    700. 65                        var name = names[i++];
      701. 
+
    701. 65                        this.executeDdl(this.__dropTableSql(name)).then(hitch(this, function () {
      702. 
+
    702. 56                            this.removeCachedSchema(name);
      703. 
+
    703. 56                            drop(i);
      704. 
+
    704.                          }), ret);
      705. 
+
    705.                      } else {
      706. 
+
    706. 39                        ret.callback();
      707. 
+
    707.                      }
      708. 
+
    708.                  });
      709. 
+
    709. 48                drop(0);
      710. 
+
    710. 48                return ret.promise();
      711. 
+
    711.              } else {
      712. 
+
    712. 33                return this.dropTable(argsToArray(arguments).filter(function (t) {
      713. 
+
    713. 38                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
      714. 
+
    714.                  }));
      715. 
 
    715.  
      716. 
-
    716.          /**
      717. 
-
    717.           * @private
      718. 
-
    718.           * Remove the cached schemaUtilityDataset, because the identifier
      719. 
-
    719.           * quoting has changed.
      720. 
-
    720.           */
      721. 
-
    721.          __resetSchemaUtilityDataset:function () {
      722. 
-
    722. 0            this.__schemaUtiltyDs = null;
      723. 
+
    723.              }
      724. 
 
    724.          },
      725. 
 
    725.  
      726. 
 
    726.          /**
      727. 
-
    727.           * @private
      728. 
-
    728.           * Split the schema information from the table
      729. 
-
    729.           * */
      730. 
-
    730.          __schemaAndTable:function (tableName) {
      731. 
-
    731. 244            return  this.__schemaUtiltyDataset.schemaAndTable(tableName);
      732. 
+
    732.           *  Forcible drops one or more tables corresponding to the given names, ignoring errors.
      733. 
+
    733.           *
      734. 
+
    734.           * @example
      735. 
+
    735.           * DB.dropTable("test");
      736. 
+
    736.           *      //=>'DROP TABLE test'
      737. 
+
    737.           * DB.dropTable("a", "bb", "ccc");
      738. 
+
    738.           *      //=>'DROP TABLE a',
      739. 
+
    739.           *      //=>'DROP TABLE bb',
      740. 
+
    740.           *      //=>'DROP TABLE ccc'
      741. 
+
    741.           *
      742. 
+
    742.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the tables
      743. 
+
    743.           * to drop.
      744. 
+
    744.           *
      745. 
+
    745.           * @return {Promise} a promise that is resolved once all tables have been dropped.
      746. 
+
    746.           **/
      747. 
+
    747.          forceDropTable:function (names) {
      748. 
+
    748. 158            var ret = new Promise(), l = names.length;
      749. 
+
    749. 158            if (isArray(names)) {
      750. 
+
    750. 96                var drop = hitch(this, function (i) {
      751. 
+
    751. 241                    if (i < l) {
      752. 
+
    752. 145                        var name = names[i++];
      753. 
+
    753. 145                        this.executeDdl(this.__dropTableSql(name)).both(hitch(this, function () {
      754. 
+
    754. 145                            this.removeCachedSchema(name);
      755. 
+
    755. 145                            drop(i);
      756. 
+
    756.                          }));
      757. 
+
    757.                      } else {
      758. 
+
    758. 96                        ret.callback();
      759. 
+
    759.                      }
      760. 
+
    760.                  });
      761. 
+
    761. 96                drop(0);
      762. 
+
    762.              } else {
      763. 
+
    763. 62                this.forceDropTable(argsToArray(arguments).filter(function (t) {
      764. 
+
    764. 62                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
      765. 
+
    765.                  })).both(ret);
      766. 
+
    766.              }
      767. 
+
    767. 158            return ret.promise();
      768. 
 
    768.          },
      769. 
 
    769.  
      770. 
 
    770.          /**
      771. 
-
    771.           * @private
      772. 
-
    772.           * Return true if the given column schema represents an autoincrementing primary key.
      773. 
+
    773.           *  Drops one or more views corresponding to the given names.
      774. 
 
    774.           *
      775. 
-
    775.           */
      776. 
-
    776.          _schemaAutoincrementingPrimaryKey:function (schema) {
      777. 
-
    777. 0            return !!schema.primaryKey;
      778. 
+
    778.           * @example
      779. 
+
    779.           * DB.dropView("test_view");
      780. 
+
    780.           *      //=>'DROP VIEW test_view'
      781. 
+
    781.           * DB.dropTable("test_view_1", "test_view_2", "test_view_3");
      782. 
+
    782.           *      //=>'DROP VIEW test_view_1',
      783. 
+
    783.           *      //=>'DROP VIEW test_view_2',
      784. 
+
    784.           *      //=>'DROP VIEW test_view_3'
      785. 
+
    785.           *
      786. 
+
    786.           * @param {String|String[]|essom.sql.Identifier|essom.sql.Identifier[]} names the names of the views
      787. 
+
    787.           * to drop.
      788. 
+
    788.           *
      789. 
+
    789.           * @return {Promise} a promise that is resolved once the view/s have been dropped.
      790. 
+
    790.           **/
      791. 
+
    791.          dropView:function (names) {
      792. 
+
    792. 8            var ret = new Promise(), l = names.length;
      793. 
+
    793. 8            if (isArray(names)) {
      794. 
+
    794. 4                var drop = hitch(this, function (i) {
      795. 
+
    795. 8                    if (i < l) {
      796. 
+
    796. 4                        var name = names[i++];
      797. 
+
    797. 4                        this.executeDdl(format("DROP VIEW %s", this.__quoteSchemaTable(name))).then(hitch(this, function () {
      798. 
+
    798. 4                            this.removeCachedSchema(name);
      799. 
+
    799. 4                            drop(i);
      800. 
+
    800.                          }), ret);
      801. 
+
    801.                      } else {
      802. 
+
    802. 4                        ret.callback();
      803. 
+
    803.                      }
      804. 
+
    804.                  });
      805. 
+
    805. 4                drop(0);
      806. 
+
    806. 4                return ret.promise();
      807. 
+
    807.              } else {
      808. 
+
    808. 4                return this.dropView(argsToArray(arguments).filter(function (t) {
      809. 
+
    809. 4                    return isString(t) || isInstanceOf(t, Identifier, QualifiedIdentifier);
      810. 
+
    810.                  }));
      811. 
+
    811.  
      812. 
+
    812.              }
      813. 
 
    813.          },
      814. 
 
    814.  
      815. 
 
    815.          /**
      816. 
-
    816.           * @private
      817. 
-
    817.           * SQL fragment specifying the type of a given column.
      818. 
-
    818.           * */
      819. 
-
    819.          typeLiteral:function (column) {
      820. 
-
    820. 690            return this.__typeLiteralGeneric(column);
      821. 
+
    821.           * Renames a table.
      822. 
+
    822.           *
      823. 
+
    823.           * @example
      824. 
+
    824.           * comb.executeInOrder(DB, function(DB){
      825. 
+
    825.           *   DB.tables(); //=> ["items"]
      826. 
+
    826.           *   DB.renameTable("items", "old_items");
      827. 
+
    827.           *          //=>'ALTER TABLE items RENAME TO old_items'
      828. 
+
    828.           *   DB.tables; //=> ["old_items"]
      829. 
+
    829.           *});
      830. 
+
    830.           *
      831. 
+
    831.           * @param {String|patio.sql.Identifier} name the name of the table to rename
      832. 
+
    832.           * @param {String|patio.sql.Identifier} newName the new name of the table
      833. 
+
    833.           * @return {Promise} a promise that is resolved once the table is renamed.
      834. 
+
    834.           **/
      835. 
+
    835.          renameTable:function (name, newName) {
      836. 
+
    836. 2            return this.executeDdl(this.__renameTableSql(name, newName)).chain(hitch(this, function () {
      837. 
+
    837. 2                this.removeCachedSchema(name);
      838. 
+
    838.              })).promise();
      839. 
+
    839.  
      840. 
 
    840.          },
      841. 
 
    841.  
      842. 
 
    842.          /**
      843. 
 
    843.           * @private
      844. 
-
    844.           * SQL fragment specifying the full type of a column,
      845. 
-
    845.           * consider the type with possible modifiers.
      846. 
-
    846.           */
      847. 
-
    847.          __typeLiteralGeneric:function (column) {
      848. 
-
    848. 690            var type = column.type;
      849. 
-
    849. 690            var meth = "__typeLiteralGeneric";
      850. 
-
    850. 690            var isStr = isString(type);
      851. 
-
    851. 690            var proper = isStr ? type.charAt(0).toUpperCase() + type.substr(1) : null;
      852. 
-
    852. 690            if (type === String || (isStr && type.match(/string/i))) {
      853. 
-
    853. 198                meth += "String";
      854. 
-
    854. 492            } else if ((isStr && type.match(/number/i)) || type === Number) {
      855. 
-
    855. 12                meth += "Numeric";
      856. 
-
    856. 480            } else if ((isStr && type.match(/datetime/i)) || type === DateTime) {
      857. 
-
    857. 8                meth += "DateTime";
      858. 
-
    858. 472            } else if ((isStr && type.match(/date/i)) || type === Date) {
      859. 
-
    859. 11                meth += "Date";
      860. 
-
    860. 461            } else if ((isStr && type.match(/year/i)) || type === Year) {
      861. 
-
    861. 2                meth += "Year";
      862. 
-
    862. 459            } else if ((isStr && type.match(/timestamp/i))|| type === TimeStamp) {
      863. 
-
    863. 4                meth += "Timestamp";
      864. 
-
    864. 455            } else if ((isStr && type.match(/time/i)) || type === Time) {
      865. 
-
    865. 2                meth += "Time";
      866. 
-
    866. 453            } else if ((isStr && type.match(/decimal/i)) || type === Decimal) {
      867. 
-
    867. 2                meth += "Decimal";
      868. 
-
    868. 451            } else if ((isStr && type.match(/float/i)) || type === Float) {
      869. 
-
    869. 15                meth += "Float";
      870. 
-
    870. 436            } else if ((isStr && type.match(/boolean/i)) || type === Boolean) {
      871. 
-
    871. 5                meth += "Boolean";
      872. 
-
    872. 431            } else if ((isStr && type.match(/buffer/i)) || type === Buffer) {
      873. 
-
    873. 29                meth += "Blob";
      874. 
-
    874. 402            } else if (isStr && isFunction(this[meth + proper])) {
      875. 
-
    875. 138                meth += proper;
      876. 
-
    876.              } else {
      877. 
-
    877. 264                return this.__typeLiteralSpecific(column);
      878. 
+
    878.           *  The SQL to execute to modify the DDL for the given table name.  op
      879. 
+
    879.           * should be one of the operations returned by the AlterTableGenerator.
      880. 
+
    880.           * */
      881. 
+
    881.          __alterTableSql:function (table, op) {
      882. 
+
    882. 83            var ret = new Promise();
      883. 
+
    883. 83            var quotedName = op.name ? this.__quoteIdentifier(op.name) : null;
      884. 
+
    884. 83            var alterTableOp = null;
      885. 
+
    885. 83            switch (op.op) {
      886. 
+
    886.                  case "addColumn":
      887. 
+
    887. 13                    alterTableOp = format("ADD COLUMN %s", this.__columnDefinitionSql(op));
      888. 
+
    888. 13                    break;
      889. 
+
    889.                  case "dropColumn":
      890. 
+
    890. 4                    alterTableOp = format("DROP COLUMN %s", quotedName);
      891. 
+
    891. 4                    break;
      892. 
+
    892.                  case "renameColumn":
      893. 
+
    893. 52                    alterTableOp = format("RENAME COLUMN %s TO %s", quotedName, this.__quoteIdentifier(op.newName));
      894. 
+
    894. 52                    break;
      895. 
+
    895.                  case "setColumnType":
      896. 
+
    896. 3                    alterTableOp = format("ALTER COLUMN %s TYPE %s", quotedName, this.typeLiteral(op));
      897. 
+
    897. 3                    break;
      898. 
+
    898.                  case "setColumnDefault":
      899. 
+
    899. 2                    alterTableOp = format("ALTER COLUMN %s SET DEFAULT %s", quotedName, this.literal(op["default"]));
      900. 
+
    900. 2                    break;
      901. 
+
    901.                  case "setColumnNull":
      902. 
+
    902. 0                    alterTableOp = format("ALTER COLUMN %s %s NOT NULL", quotedName, op["null"] ? "DROP" : "SET");
      903. 
+
    903. 0                    break;
      904. 
+
    904.                  case "addIndex":
      905. 
+
    905. 5                    return ret.callback(this.__indexDefinitionSql(table, op)).promise();
      906. 
+
    906.                  case "dropIndex":
      907. 
+
    907. 2                    return ret.callback(this.__dropIndexSql(table, op)).promise();
      908. 
+
    908.                  case "addConstraint":
      909. 
+
    909. 1                    alterTableOp = format("ADD %s", this.__constraintDefinitionSql(op));
      910. 
+
    910. 1                    break;
      911. 
+
    911.                  case "dropConstraint":
      912. 
+
    912. 0                    alterTableOp = format("DROP CONSTRAINT %s", quotedName);
      913. 
+
    913. 0                    break;
      914. 
+
    914.                  default :
      915. 
+
    915. 1                    throw new DatabaseError("Invalid altertable operator");
      916. 
 
    916.              }
      917. 
-
    917. 426            return this[meth](column);
      918. 
+
    918. 75            return ret.callback(format("ALTER TABLE %s %s", this.__quoteSchemaTable(table), alterTableOp)).promise();
      919. 
 
    919.          },
      920. 
 
    920.  
      921. 
 
    921.          /**
      922. 
 
    922.           * @private
      923. 
-
    923.           * patio uses the date type by default for Dates.
      924. 
-
    924.           * <ul>
      925. 
-
    925.           *      <li>if onlyTime is present then time is used</li>
      926. 
-
    926.           *      <li>if timeStamp is present then timestamp is used,</li>
      927. 
-
    927.           *      <li>if dateTime is present then datetime is used</li>
      928. 
-
    928.           *      <li>if yearOnly is present then year is used</li>
      929. 
-
    929.           *       <li>else date is used</li>
      930. 
-
    930.           * </ul>
      931. 
-
    931.           */
      932. 
-
    932.          __typeLiteralGenericDate:function (column) {
      933. 
-
    933. 11            var type = column.type, ret = "date";
      934. 
-
    934. 11            if (column.onlyTime) {
      935. 
-
    935. 2                ret = "time";
      936. 
-
    936. 9            } else if (column.timeStamp) {
      937. 
-
    937. 2                ret = "timestamp";
      938. 
-
    938. 7            } else if (column.dateTime) {
      939. 
-
    939. 2                ret = "datetime";
      940. 
-
    940. 5            } else if (column.yearOnly) {
      941. 
-
    941. 2                ret = "year";
      942. 
-
    942.              }
      943. 
-
    943. 11            return ret;
      944. 
+
    944.           * Array of SQL DDL modification statements for the given table,
      945. 
+
    945.           * corresponding to the DDL changes specified by the operations.
      946. 
+
    946.           * */
      947. 
+
    947.          __alterTableSqlList:function (table, operations) {
      948. 
+
    948. 84            return new PromiseList(operations.map(hitch(this, "__alterTableSql", table)));
      949. 
 
    949.          },
      950. 
 
    950.  
      951. 
 
    951.          /**
      952. 
 
    952.           * @private
      953. 
-
    953.           * * patio uses the blob type by default for Buffers.
      954. 
+
    954.           * SQL DDL fragment containing the column creation SQL for the given column.
      955. 
+
    955.           *
      956. 
+
    956.           * @param column
      957. 
 
    957.           */
      958. 
-
    958.          __typeLiteralGenericBlob:function (column) {
      959. 
-
    959. 25            return "blob";
      960. 
+
    960.          __columnDefinitionSql:function (column) {
      961. 
+
    961. 644            var sql = [format("%s %s", this.__quoteIdentifier(column.name), this.typeLiteral(column))];
      962. 
+
    962. 644            column.unique && sql.push(this._static.UNIQUE);
      963. 
+
    963. 644            (column.allowNull === false || column["null"] === false) && sql.push(this._static.NOT_NULL);
      964. 
+
    964. 644            (column.allowNull === true || column["null"] === true) && sql.push(this._static.NULL);
      965. 
+
    965. 644            !isUndefined(column["default"]) && sql.push(format(" DEFAULT %s", this.literal(column["default"])));
      966. 
+
    966. 644            column.primaryKey && sql.push(this._static.PRIMARY_KEY);
      967. 
+
    967. 644            column.autoIncrement && sql.push(" " + this.autoIncrementSql);
      968. 
+
    968. 644            column.table && sql.push(this.__columnReferencesColumnConstraintSql(column));
      969. 
+
    969. 644            return sql.join("");
      970. 
 
    970.          },
      971. 
 
    971.  
      972. 
 
    972.          /**
      973. 
 
    973.           * @private
      974. 
-
    974.           * * patio uses the year type by default for {@link patio.sql.DateTime}.
      975. 
+
    975.           * SQL DDL fragment containing the column creation
      976. 
+
    976.           * SQL for all given columns, used inside a CREATE TABLE block.
      977. 
 
    977.           */
      978. 
-
    978.          __typeLiteralGenericDateTime:function (column) {
      979. 
-
    979. 2            return "datetime";
      980. 
+
    980.          __columnListSql:function (generator) {
      981. 
+
    981. 218            return generator.columns.map(hitch(this, "__columnDefinitionSql")).concat(generator.constraints.map(hitch(this, "__constraintDefinitionSql"))).join(this._static.COMMA_SEPARATOR);
      982. 
 
    982.          },
      983. 
 
    983.  
      984. 
 
    984.          /**
      985. 
 
    985.           * @private
      986. 
-
    986.           * patio uses the timestamp type by default for {@link patio.sql.TimeStamp}.
      987. 
+
    987.           *SQL DDL fragment for column foreign key references (column constraints)
      988. 
 
    988.           */
      989. 
-
    989.          __typeLiteralGenericTimestamp:function (column) {
      990. 
-
    990. 4            return "timestamp";
      991. 
+
    991.          __columnReferencesColumnConstraintSql:function (column) {
      992. 
+
    992. 30            return this.__columnReferencesSql(column);
      993. 
 
    993.          },
      994. 
 
    994.  
      995. 
 
    995.          /**
      996. 
 
    996.           * @private
      997. 
-
    997.           * patio uses the time type by default for {@link patio.sql.Time}.
      998. 
+
    998.           * SQL DDL fragment for column foreign key references
      999. 
 
    999.           */
      1000. 
-
    1000.          __typeLiteralGenericTime:function (column) {
      1001. 
-
    1001. 2            return "time";
      1002. 
+
    1002.          __columnReferencesSql:function (column) {
      1003. 
+
    1003. 38            var sql = format(" REFERENCES %s", this.__quoteSchemaTable(column.table));
      1004. 
+
    1004. 38            column.key && (sql += format("(%s)", array.toArray(column.key).map(this.__quoteIdentifier, this).join(this._static.COMMA_SEPARATOR)));
      1005. 
+
    1005. 38            column.onDelete && (sql += format(" ON DELETE %s", this.__onDeleteClause(column.onDelete)));
      1006. 
+
    1006. 38            column.onUpdate && (sql += format(" ON UPDATE %s", this.__onUpdateClause(column.onUpdate)));
      1007. 
+
    1007. 38            column.deferrable && (sql += " DEFERRABLE INITIALLY DEFERRED");
      1008. 
+
    1008. 38            return sql;
      1009. 
 
    1009.          },
      1010. 
 
    1010.  
      1011. 
 
    1011.          /**
      1012. 
 
    1012.           * @private
      1013. 
-
    1013.           * patio uses the year type by default for {@link patio.sql.Year}.
      1014. 
-
    1014.           */
      1015. 
-
    1015.          __typeLiteralGenericYear:function (column) {
      1016. 
-
    1016. 2            return "year";
      1017. 
+
    1017.           * SQL DDL fragment for table foreign key references (table constraints)
      1018. 
+
    1018.           * */
      1019. 
+
    1019.          __columnReferencesTableConstraintSql:function (constraint) {
      1020. 
+
    1020. 6            return format("FOREIGN KEY %s%s", this.literal(constraint.columns.map(function (c) {
      1021. 
+
    1021. 6                return isString(c) ? sql.stringToIdentifier(c) : c;
      1022. 
+
    1022.              })), this.__columnReferencesSql(constraint));
      1023. 
 
    1023.          },
      1024. 
 
    1024.  
      1025. 
 
    1025.          /**
      1026. 
 
    1026.           * @private
      1027. 
-
    1027.           * patio uses the boolean type by default for Boolean class
      1028. 
-
    1028.           * */
      1029. 
-
    1029.          __typeLiteralGenericBoolean:function (column) {
      1030. 
-
    1030. 3            return "boolean";
      1031. 
+
    1031.           * SQL DDL fragment specifying a constraint on a table.
      1032. 
+
    1032.           */
      1033. 
+
    1033.          __constraintDefinitionSql:function (constraint) {
      1034. 
+
    1034. 6            var ret = [constraint.name ? format("CONSTRAINT %s ", this.__quoteIdentifier(constraint.name)) : ""];
      1035. 
+
    1035. 6            switch (constraint.type) {
      1036. 
+
    1036.                  case "check":
      1037. 
+
    1037. 0                    var check = constraint.check;
      1038. 
+
    1038. 0                    ret.push(format("CHECK %s", this.__filterExpr(isArray(check) && check.length === 1 ? check[0] : check)));
      1039. 
+
    1039. 0                    break;
      1040. 
+
    1040.                  case "primaryKey":
      1041. 
+
    1041. 0                    ret.push(format("PRIMARY KEY %s", this.literal(constraint.columns.map(function (c) {
      1042. 
+
    1042. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      1043. 
+
    1043.                      }))));
      1044. 
+
    1044. 0                    break;
      1045. 
+
    1045.                  case "foreignKey":
      1046. 
+
    1046. 6                    ret.push(this.__columnReferencesTableConstraintSql(constraint));
      1047. 
+
    1047. 6                    break;
      1048. 
+
    1048.                  case "unique":
      1049. 
+
    1049. 0                    ret.push(format("UNIQUE %s", this.literal(constraint.columns.map(function (c) {
      1050. 
+
    1050. 0                        return isString(c) ? sql.stringToIdentifier(c) : c;
      1051. 
+
    1051.                      }))));
      1052. 
+
    1052. 0                    break;
      1053. 
+
    1053.                  default:
      1054. 
+
    1054. 0                    throw new DatabaseError(format("Invalid constriant type %s, should be 'check', 'primaryKey', foreignKey', or 'unique'", constraint.type));
      1055. 
+
    1055.              }
      1056. 
+
    1056. 6            return ret.join("");
      1057. 
 
    1057.          },
      1058. 
 
    1058.  
      1059. 
 
    1059.          /**
      1060. 
 
    1060.           * @private
      1061. 
-
    1061.           * patio uses the numeric type by default for NumericTypes
      1062. 
-
    1062.           * If a size is given, it is used, otherwise, it will default to whatever
      1063. 
-
    1063.           * the database default is for an unsized value.
      1064. 
-
    1064.           * <ul>
      1065. 
-
    1065.           * <li> if isInt is present the int is used</li>
      1066. 
-
    1066.           * <li> if isDouble is present then double precision is used</li>
      1067. 
-
    1067.           * </ul>
      1068. 
-
    1068.           */
      1069. 
-
    1069.          __typeLiteralGenericNumeric:function (column) {
      1070. 
-
    1070. 10            return column.size ? format("numeric(%s)", array.toArray(column.size).join(', ')) : column.isInt ? "integer" : column.isDouble ? "double precision" : "numeric";
      1071. 
+
    1071.           * Execute the create table statements using the generator.
      1072. 
+
    1072.           * */
      1073. 
+
    1073.          __createTableFromGenerator:function (name, generator, options) {
      1074. 
+
    1074. 218            return this.executeDdl(this.__createTableSql(name, generator, options));
      1075. 
 
    1075.          },
      1076. 
 
    1076.  
      1077. 
-
    1077.  
      1078. 
 
    1078.          /**
      1079. 
 
    1079.           * @private
      1080. 
-
    1080.           */
      1081. 
-
    1081.          __typeLiteralGenericFloat:function (column) {
      1082. 
-
    1082. 15            return "double precision";
      1083. 
+
    1083.           * Execute the create index statements using the generator.
      1084. 
+
    1084.           * */
      1085. 
+
    1085.          __createTableIndexesFromGenerator:function (name, generator, options) {
      1086. 
+
    1086. 218            var e = options.ignoreIndexErrors;
      1087. 
+
    1087. 218            var ret = new Promise();
      1088. 
+
    1088. 218            var promises = generator.indexes.map(function (index) {
      1089. 
+
    1089. 18                var ps = this.__indexSqlList(name, [index]).map(this.executeDdl, this);
      1090. 
+
    1090. 18                return new PromiseList(ps);
      1091. 
+
    1091.              }, this);
      1092. 
+
    1092. 218            if (promises.length) {
      1093. 
+
    1093. 16                new PromiseList(promises).then(ret, hitch(ret, e ? "callback" : "errback"));
      1094. 
+
    1094.              } else {
      1095. 
+
    1095. 202                ret.callback();
      1096. 
+
    1096.              }
      1097. 
+
    1097. 218            return ret.promise();
      1098. 
 
    1098.          },
      1099. 
 
    1099.  
      1100. 
 
    1100.          /**
      1101. 
 
    1101.           * @private
      1102. 
-
    1102.           */
      1103. 
-
    1103.          __typeLiteralGenericDecimal:function (column) {
      1104. 
-
    1104. 2            return "double precision";
      1105. 
+
    1105.           * DDL statement for creating a table with the given name, columns, and options
      1106. 
+
    1106.           * */
      1107. 
+
    1107.          __createTableSql:function (name, generator, options) {
      1108. 
+
    1108. 218            return format("CREATE %sTABLE %s (%s)", options.temp ? this.temporaryTableSql : "", this.__quoteSchemaTable(name), this.__columnListSql(generator));
      1109. 
 
    1109.          },
      1110. 
 
    1110.  
      1111. 
 
    1111.          /**
      1112. 
 
    1112.           * @private
      1113. 
-
    1113.           * patio uses the varchar type by default for Strings.  If a
      1114. 
-
    1114.           * size isn't present, patio assumes a size of 255.  If the
      1115. 
-
    1115.           * fixed option is used, patio uses the char type.  If the
      1116. 
-
    1116.           * text option is used, patio uses the :text type.
      1117. 
+
    1117.           * Default index name for the table and columns, may be too long
      1118. 
+
    1118.           * for certain databases.
      1119. 
 
    1119.           */
      1120. 
-
    1120.          __typeLiteralGenericString:function (column) {
      1121. 
-
    1121. 41            return column.text ? "text" : format("%s(%s)", column.fixed ? "char" : "varchar", column.size || 255);
      1122. 
+
    1122.          __defaultIndexName:function (tableName, columns) {
      1123. 
+
    1123. 25            var parts = this.__schemaAndTable(tableName);
      1124. 
+
    1124. 25            var schema = parts[0], table = parts[1];
      1125. 
+
    1125. 25            var index = [];
      1126. 
+
    1126. 25            if (schema && schema !== this.defaultSchema) {
      1127. 
+
    1127. 0                index.push(schema);
      1128. 
+
    1128.              }
      1129. 
+
    1129. 25            index.push(table);
      1130. 
+
    1130. 25            index = index.concat(columns.map(function (c) {
      1131. 
+
    1131. 28                return isString(c) ? c : this.literal(c).replace(/\W/g, "");
      1132. 
+
    1132.              }, this));
      1133. 
+
    1133. 25            index.push("index");
      1134. 
+
    1134. 25            return index.join(this._static.UNDERSCORE);
      1135. 
+
    1135.  
      1136. 
 
    1136.          },
      1137. 
 
    1137.  
      1138. 
 
    1138.          /**
      1139. 
 
    1139.           * @private
      1140. 
-
    1140.           * SQL fragment for the given type of a column if the column is not one of the
      1141. 
-
    1141.           * generic types specified with a native javascript type class.
      1142. 
-
    1142.           */
      1143. 
-
    1143.          __typeLiteralSpecific:function (column) {
      1144. 
-
    1144. 336            var type = column.type;
      1145. 
-
    1145. 336            type = type === "double" ? "double precision" : type;
      1146. 
-
    1146. 336            if (type === "varchar") {
      1147. 
-
    1147. 7                column.size = isNumber(column.size) ? column.size : 255;
      1148. 
-
    1148.              }
      1149. 
-
    1149. 336            var elements = column.size || column.elements;
      1150. 
-
    1150. 336            return format("%s%s%s", type, elements ? this.literal(toArray(elements)) : "", column.unsigned ? " UNSIGNED" : "");
      1151. 
+
    1151.           * The SQL to drop an index for the table.
      1152. 
+
    1152.           * */
      1153. 
+
    1153.          __dropIndexSql:function (table, op) {
      1154. 
+
    1154. 2            return format("DROP INDEX %s", this.__quoteIdentifier(op.name || this.__defaultIndexName(table, op.columns)));
      1155. 
 
    1155.          },
      1156. 
 
    1156.  
      1157. 
-
    1157.          /**@ignore*/
      1158. 
-
    1158.          getters:{
      1159. 
-
    1159.              /**@lends patio.Database.prototype*/
      1160. 
-
    1160.              /**
      1161. 
-
    1161.               * @private
      1162. 
-
    1162.               *  The SQL string specify the autoincrement property, generally used by
      1163. 
-
    1163.               * primary keys.
      1164. 
-
    1164.               *
      1165. 
-
    1165.               * @field
      1166. 
-
    1166.               * */
      1167. 
-
    1167.              autoIncrementSql:function () {
      1168. 
-
    1168. 10                return this._static.AUTOINCREMENT;
      1169. 
-
    1169.              },
      1170. 
-
    1170.  
      1171. 
-
    1171.              /**
      1172. 
-
    1172.               * @private
      1173. 
-
    1173.               * @field
      1174. 
-
    1174.               * */
      1175. 
-
    1175.              temporaryTableSql:function () {
      1176. 
-
    1176. 3                return this._static.TEMPORARY;
      1177. 
-
    1177.              },
      1178. 
-
    1178.  
      1179. 
-
    1179.              /**
      1180. 
-
    1180.               * @private
      1181. 
-
    1181.               * @field
      1182. 
-
    1182.               * */
      1183. 
-
    1183.              __schemaUtiltyDataset:function () {
      1184. 
-
    1184. 3304                this.__schemaUtiltyDs = this.__schemaUtiltyDs || this.dataset;
      1185. 
-
    1185. 3304                return this.__schemaUtiltyDs;
      1186. 
-
    1186.              }
      1187. 
-
    1187.          }
      1188. 
+
    1188.          /**
      1189. 
+
    1189.           * @private
      1190. 
+
    1190.           *
      1191. 
+
    1191.           *  SQL DDL statement to drop the table with the given name.
      1192. 
+
    1192.           **/
      1193. 
+
    1193.          __dropTableSql:function (name) {
      1194. 
+
    1194. 210            return format("DROP TABLE %s", this.__quoteSchemaTable(name));
      1195. 
+
    1195.          },
      1196. 
 
    1196.  
      1197. 
-
    1197.      },
      1198. 
+
    1198.          /**
      1199. 
+
    1199.           * @private
      1200. 
+
    1200.           * Proxy the filterExpr call to the dataset, used for creating constraints.
      1201. 
+
    1201.           * */
      1202. 
+
    1202.          __filterExpr:function (args, block) {
      1203. 
+
    1203. 2            var ds = this.__schemaUtiltyDataset;
      1204. 
+
    1204. 2            return ds.literal(ds._filterExpr.apply(ds, arguments));
      1205. 
+
    1205.          },
      1206. 
 
    1206.  
      1207. 
-
    1207.      "static":{
      1208. 
-
    1208.          /**@lends patio.Database*/
      1209. 
 
    1209.  
      1210. 
 
    1210.          /**
      1211. 
-
    1211.           *Default  AUTO INCREMENT SQL
      1212. 
+
    1212.           * @private
      1213. 
+
    1213.           * SQL DDL statement for creating an index for the table with the given name
      1214. 
+
    1214.           * and index specifications.
      1215. 
 
    1215.           */
      1216. 
-
    1216.          AUTOINCREMENT:'AUTOINCREMENT',
      1217. 
+
    1217.          __indexDefinitionSql:function (tableName, index) {
      1218. 
+
    1218. 7            var indexName = index.name || this.__defaultIndexName(tableName, index.columns);
      1219. 
+
    1219. 7            if (index.type) {
      1220. 
+
    1220. 0                throw new DatabaseError("Index types are not supported for this database");
      1221. 
+
    1221. 7            } else if (index.where) {
      1222. 
+
    1222. 0                throw new DatabaseError("Partial indexes are not supported for this database");
      1223. 
+
    1223.              } else {
      1224. 
+
    1224. 7                return format("CREATE %sINDEX %s ON %s %s", index.unique ? "UNIQUE " : "", this.__quoteIdentifier(indexName), this.__quoteSchemaTable(tableName), this.literal(index.columns.map(function (c) {
      1225. 
+
    1225. 8                    return isString(c) ? new Identifier(c) : c;
      1226. 
+
    1226.                  })));
      1227. 
+
    1227.              }
      1228. 
+
    1228.          },
      1229. 
 
    1229.  
      1230. 
 
    1230.          /**
      1231. 
-
    1231.           *Default  CASCACDE SQL
      1232. 
+
    1232.           * Array of SQL DDL statements, one for each index specification,
      1233. 
+
    1233.           * for the given table.
      1234. 
 
    1234.           */
      1235. 
-
    1235.          CASCADE:'CASCADE',
      1236. 
+
    1236.          __indexSqlList:function (tableName, indexes) {
      1237. 
+
    1237. 18            return indexes.map(hitch(this, this.__indexDefinitionSql, tableName));
      1238. 
+
    1238.          },
      1239. 
 
    1239.  
      1240. 
 
    1240.          /**
      1241. 
-
    1241.           *Default comma
      1242. 
+
    1242.           * @private
      1243. 
+
    1243.           * SQL DDL ON DELETE fragment to use, based on the given action.
      1244. 
+
    1244.           *The following actions are recognized:
      1245. 
+
    1245.           * <ul>
      1246. 
+
    1246.           *  <li>cascade - Delete rows referencing this row.</li>
      1247. 
+
    1247.           *  <li>noAction (default) - Raise an error if other rows reference this
      1248. 
+
    1248.           *   row, allow deferring of the integrity check.
      1249. 
+
    1249.           *  </li>
      1250. 
+
    1250.           *  <li>restrict - Raise an error if other rows reference this row,
      1251. 
+
    1251.           *   but do not allow deferring the integrity check.</li>
      1252. 
+
    1252.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      1253. 
+
    1253.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      1254. 
+
    1254.           * </ul>
      1255. 
 
    1255.           */
      1256. 
-
    1256.          COMMA_SEPARATOR:', ',
      1257. 
+
    1257.          __onDeleteClause:function (action) {
      1258. 
+
    1258. 23            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      1259. 
+
    1259.          },
      1260. 
 
    1260.  
      1261. 
 
    1261.          /**
      1262. 
-
    1262.           *Default  NO ACTION SQL
      1263. 
+
    1263.           * @private
      1264. 
+
    1264.           * SQL DDL ON UPDATE fragment to use, based on the given action.
      1265. 
+
    1265.           *The following actions are recognized:
      1266. 
+
    1266.           * <ul>
      1267. 
+
    1267.           *  <li>cascade - Delete rows referencing this row.</li>
      1268. 
+
    1268.           *  <li>noAction (default) - Raise an error if other rows reference this
      1269. 
+
    1269.           *   row, allow deferring of the integrity check.
      1270. 
+
    1270.           *  </li>
      1271. 
+
    1271.           *  <li>restrict - Raise an error if other rows reference this row,
      1272. 
+
    1272.           *   but do not allow deferring the integrity check.</li>
      1273. 
+
    1273.           *  <li> setDefault - Set columns referencing this row to their default value.</li>
      1274. 
+
    1274.           *   <li>setNull - Set columns referencing this row to NULL.</li>
      1275. 
+
    1275.           * </ul>
      1276. 
 
    1276.           */
      1277. 
-
    1277.          NO_ACTION:'NO ACTION',
      1278. 
+
    1278.          __onUpdateClause:function (action) {
      1279. 
+
    1279. 1            return this._static[action.toUpperCase()] || this._static.NO_ACTION;
      1280. 
+
    1280.          },
      1281. 
 
    1281.  
      1282. 
 
    1282.          /**
      1283. 
-
    1283.           *Default  NOT NULL SQL
      1284. 
-
    1284.           */
      1285. 
-
    1285.          NOT_NULL:' NOT NULL',
      1286. 
+
    1286.           * @private
      1287. 
+
    1287.           * Proxy the quoteSchemaTable method to the dataset
      1288. 
+
    1288.           * */
      1289. 
+
    1289.          __quoteSchemaTable:function (table) {
      1290. 
+
    1290. 2212            return this.__schemaUtiltyDataset.quoteSchemaTable(table);
      1291. 
+
    1291.          },
      1292. 
 
    1292.  
      1293. 
 
    1293.          /**
      1294. 
-
    1294.           * Default NULL SQL
      1295. 
-
    1295.           */
      1296. 
-
    1296.          NULL:' NULL',
      1297. 
+
    1297.           * @private
      1298. 
+
    1298.           * Proxy the quoteIdentifier method to the dataset, used for quoting tables and columns.
      1299. 
+
    1299.           * */
      1300. 
+
    1300.          __quoteIdentifier:function (v) {
      1301. 
+
    1301. 846            return this.__schemaUtiltyDataset.quoteIdentifier(v);
      1302. 
+
    1302.          },
      1303. 
 
    1303.  
      1304. 
 
    1304.          /**
      1305. 
-
    1305.           *Default  PRIMARY KEY SQL
      1306. 
-
    1306.           */
      1307. 
-
    1307.          PRIMARY_KEY:' PRIMARY KEY',
      1308. 
+
    1308.           * @private
      1309. 
+
    1309.           * SQL DDL statement for renaming a table.
      1310. 
+
    1310.           * */
      1311. 
+
    1311.          __renameTableSql:function (name, newName) {
      1312. 
+
    1312. 1            return format("ALTER TABLE %s RENAME TO %s", this.__quoteSchemaTable(name), this.__quoteSchemaTable(newName));
      1313. 
+
    1313.          },
      1314. 
 
    1314.  
      1315. 
 
    1315.          /**
      1316. 
-
    1316.           *Default  RESTRICT SQL
      1317. 
+
    1317.           * @private
      1318. 
+
    1318.           * Remove the cached schemaUtilityDataset, because the identifier
      1319. 
+
    1319.           * quoting has changed.
      1320. 
 
    1320.           */
      1321. 
-
    1321.          RESTRICT:'RESTRICT',
      1322. 
+
    1322.          __resetSchemaUtilityDataset:function () {
      1323. 
+
    1323. 0            this.__schemaUtiltyDs = null;
      1324. 
+
    1324.          },
      1325. 
 
    1325.  
      1326. 
 
    1326.          /**
      1327. 
-
    1327.           *Default  SET DEFAULT SQL
      1328. 
-
    1328.           */
      1329. 
-
    1329.          SET_DEFAULT:'SET DEFAULT',
      1330. 
-
    1330.  
      1331. 
+
    1331.           * @private
      1332. 
+
    1332.           * Split the schema information from the table
      1333. 
+
    1333.           * */
      1334. 
+
    1334.          __schemaAndTable:function (tableName) {
      1335. 
+
    1335. 244            return  this.__schemaUtiltyDataset.schemaAndTable(tableName);
      1336. 
+
    1336.          },
      1337. 
+
    1337.  
      1338. 
 
    1338.          /**
      1339. 
-
    1339.           *Default  SET NULL SQL
      1340. 
+
    1340.           * @private
      1341. 
+
    1341.           * Return true if the given column schema represents an autoincrementing primary key.
      1342. 
+
    1342.           *
      1343. 
 
    1343.           */
      1344. 
-
    1344.          SET_NULL:'SET NULL',
      1345. 
+
    1345.          _schemaAutoincrementingPrimaryKey:function (schema) {
      1346. 
+
    1346. 0            return !!schema.primaryKey;
      1347. 
+
    1347.          },
      1348. 
 
    1348.  
      1349. 
 
    1349.          /**
      1350. 
-
    1350.           *Default  TEMPORARY SQL
      1351. 
-
    1351.           */
      1352. 
-
    1352.          TEMPORARY:'TEMPORARY ',
      1353. 
+
    1353.           * @private
      1354. 
+
    1354.           * SQL fragment specifying the type of a given column.
      1355. 
+
    1355.           * */
      1356. 
+
    1356.          typeLiteral:function (column) {
      1357. 
+
    1357. 690            return this.__typeLiteralGeneric(column);
      1358. 
+
    1358.          },
      1359. 
 
    1359.  
      1360. 
 
    1360.          /**
      1361. 
-
    1361.           *Default  UNDERSCORE SQL, used in index creation.
      1362. 
+
    1362.           * @private
      1363. 
+
    1363.           * SQL fragment specifying the full type of a column,
      1364. 
+
    1364.           * consider the type with possible modifiers.
      1365. 
 
    1365.           */
      1366. 
-
    1366.          UNDERSCORE:'_',
      1367. 
+
    1367.          __typeLiteralGeneric:function (column) {
      1368. 
+
    1368. 690            var type = column.type;
      1369. 
+
    1369. 690            var meth = "__typeLiteralGeneric";
      1370. 
+
    1370. 690            var isStr = isString(type);
      1371. 
+
    1371. 690            var proper = isStr ? type.charAt(0).toUpperCase() + type.substr(1) : null;
      1372. 
+
    1372. 690            if (type === String || (isStr && type.match(/string/i))) {
      1373. 
+
    1373. 198                meth += "String";
      1374. 
+
    1374. 492            } else if ((isStr && type.match(/number/i)) || type === Number) {
      1375. 
+
    1375. 12                meth += "Numeric";
      1376. 
+
    1376. 480            } else if ((isStr && type.match(/datetime/i)) || type === DateTime) {
      1377. 
+
    1377. 8                meth += "DateTime";
      1378. 
+
    1378. 472            } else if ((isStr && type.match(/date/i)) || type === Date) {
      1379. 
+
    1379. 11                meth += "Date";
      1380. 
+
    1380. 461            } else if ((isStr && type.match(/year/i)) || type === Year) {
      1381. 
+
    1381. 2                meth += "Year";
      1382. 
+
    1382. 459            } else if ((isStr && type.match(/timestamp/i))|| type === TimeStamp) {
      1383. 
+
    1383. 4                meth += "Timestamp";
      1384. 
+
    1384. 455            } else if ((isStr && type.match(/time/i)) || type === Time) {
      1385. 
+
    1385. 2                meth += "Time";
      1386. 
+
    1386. 453            } else if ((isStr && type.match(/decimal/i)) || type === Decimal) {
      1387. 
+
    1387. 2                meth += "Decimal";
      1388. 
+
    1388. 451            } else if ((isStr && type.match(/float/i)) || type === Float) {
      1389. 
+
    1389. 15                meth += "Float";
      1390. 
+
    1390. 436            } else if ((isStr && type.match(/boolean/i)) || type === Boolean) {
      1391. 
+
    1391. 5                meth += "Boolean";
      1392. 
+
    1392. 431            } else if ((isStr && type.match(/buffer/i)) || type === Buffer) {
      1393. 
+
    1393. 29                meth += "Blob";
      1394. 
+
    1394. 402            } else if (isStr && isFunction(this[meth + proper])) {
      1395. 
+
    1395. 138                meth += proper;
      1396. 
+
    1396.              } else {
      1397. 
+
    1397. 264                return this.__typeLiteralSpecific(column);
      1398. 
+
    1398.              }
      1399. 
+
    1399. 426            return this[meth](column);
      1400. 
+
    1400.          },
      1401. 
 
    1401.  
      1402. 
 
    1402.          /**
      1403. 
-
    1403.           *Default  UNIQUE SQL
      1404. 
+
    1404.           * @private
      1405. 
+
    1405.           * patio uses the date type by default for Dates.
      1406. 
+
    1406.           * <ul>
      1407. 
+
    1407.           *      <li>if onlyTime is present then time is used</li>
      1408. 
+
    1408.           *      <li>if timeStamp is present then timestamp is used,</li>
      1409. 
+
    1409.           *      <li>if dateTime is present then datetime is used</li>
      1410. 
+
    1410.           *      <li>if yearOnly is present then year is used</li>
      1411. 
+
    1411.           *       <li>else date is used</li>
      1412. 
+
    1412.           * </ul>
      1413. 
 
    1413.           */
      1414. 
-
    1414.          UNIQUE:' UNIQUE',
      1415. 
+
    1415.          __typeLiteralGenericDate:function (column) {
      1416. 
+
    1416. 11            var type = column.type, ret = "date";
      1417. 
+
    1417. 11            if (column.onlyTime) {
      1418. 
+
    1418. 2                ret = "time";
      1419. 
+
    1419. 9            } else if (column.timeStamp) {
      1420. 
+
    1420. 2                ret = "timestamp";
      1421. 
+
    1421. 7            } else if (column.dateTime) {
      1422. 
+
    1422. 2                ret = "datetime";
      1423. 
+
    1423. 5            } else if (column.yearOnly) {
      1424. 
+
    1424. 2                ret = "year";
      1425. 
+
    1425.              }
      1426. 
+
    1426. 11            return ret;
      1427. 
+
    1427.          },
      1428. 
 
    1428.  
      1429. 
 
    1429.          /**
      1430. 
-
    1430.           * Default  UNSIGNED SQL
      1431. 
+
    1431.           * @private
      1432. 
+
    1432.           * * patio uses the blob type by default for Buffers.
      1433. 
 
    1433.           */
      1434. 
-
    1434.          UNSIGNED:' UNSIGNED'
      1435. 
-
    1435.  
      1436. 
-
    1436.      }
      1437. 
-
    1437.  }).as(module);
      1438. 
-
    1438.
    -
    - -
    - - - - - -
    -
    errors.js
    -     		-
    - Coverage89.47 - SLOC81 - LOC19 - Missed2 -
    -
    - 
    1. 1var patio = exports;
      2. 
+
    2.          __typeLiteralGenericBlob:function (column) {
      3. 
+
    3. 25            return "blob";
      4. 
+
    4.          },
      5. 
 
    5.  
      6. 
+
    6.          /**
      7. 
+
    7.           * @private
      8. 
+
    8.           * * patio uses the year type by default for {@link patio.sql.DateTime}.
      9. 
+
    9.           */
      10. 
+
    10.          __typeLiteralGenericDateTime:function (column) {
      11. 
+
    11. 2            return "datetime";
      12. 
+
    12.          },
      13. 
 
    13.  
      14. 
-
    14.  /**
      15. 
-
    15.   * @class Thrown if a function is not impltemened
      16. 
-
    16.   *
      17. 
-
    17.   * @param {String} message the message to show.
      18. 
-
    18.   */
      19. 
-
    19. 1patio.NotImplemented = function(message) {
      20. 
-
    20. 4  return new Error("Not Implemented :  " + message);
      21. 
-
    21.  };
      22. 
+
    22.          /**
      23. 
+
    23.           * @private
      24. 
+
    24.           * patio uses the timestamp type by default for {@link patio.sql.TimeStamp}.
      25. 
+
    25.           */
      26. 
+
    26.          __typeLiteralGenericTimestamp:function (column) {
      27. 
+
    27. 4            return "timestamp";
      28. 
+
    28.          },
      29. 
 
    29.  
      30. 
-
    30.  /**
      31. 
-
    31.   * @class Thrown if there is an Expression Error.
      32. 
-
    32.   *
      33. 
-
    33.   * @param {String} message the message to show.
      34. 
-
    34.   */
      35. 
-
    35. 1patio.ExpressionError = function(message) {
      36. 
-
    36. 0  return new Error("Expression Error :" + message);
      37. 
-
    37.  };
      38. 
+
    38.          /**
      39. 
+
    39.           * @private
      40. 
+
    40.           * patio uses the time type by default for {@link patio.sql.Time}.
      41. 
+
    41.           */
      42. 
+
    42.          __typeLiteralGenericTime:function (column) {
      43. 
+
    43. 2            return "time";
      44. 
+
    44.          },
      45. 
 
    45.  
      46. 
-
    46.  /**
      47. 
-
    47.   * @class Thrown if there is a Query Error.
      48. 
-
    48.   *
      49. 
-
    49.   * @param {String} message the message to show.
      50. 
-
    50.   */
      51. 
-
    51. 1patio.QueryError = function(message) {
      52. 
-
    52. 121  return new Error("QueryError : " + message);
      53. 
-
    53.  };
      54. 
+
    54.          /**
      55. 
+
    55.           * @private
      56. 
+
    56.           * patio uses the year type by default for {@link patio.sql.Year}.
      57. 
+
    57.           */
      58. 
+
    58.          __typeLiteralGenericYear:function (column) {
      59. 
+
    59. 2            return "year";
      60. 
+
    60.          },
      61. 
 
    61.  
      62. 
-
    62.  /**
      63. 
-
    63.   * @class Thrown if there is a Dataset Error.
      64. 
-
    64.   *
      65. 
-
    65.   * @param {String} message the message to show.
      66. 
-
    66.   */
      67. 
-
    67. 1patio.DatasetError = function(message) {
      68. 
-
    68. 7  return new Error("DatasetError : " + message);
      69. 
-
    69.  };
      70. 
+
    70.          /**
      71. 
+
    71.           * @private
      72. 
+
    72.           * patio uses the boolean type by default for Boolean class
      73. 
+
    73.           * */
      74. 
+
    74.          __typeLiteralGenericBoolean:function (column) {
      75. 
+
    75. 3            return "boolean";
      76. 
+
    76.          },
      77. 
 
    77.  
      78. 
-
    78.  /**
      79. 
-
    79.   * @class Thrown if there is a Database Error.
      80. 
-
    80.   *
      81. 
-
    81.   * @param {String} message the message to show.
      82. 
-
    82.   */
      83. 
-
    83. 1patio.DatabaseError = function(message) {
      84. 
-
    84. 5  return new Error("Database error : " + message);
      85. 
-
    85.  };
      86. 
+
    86.          /**
      87. 
+
    87.           * @private
      88. 
+
    88.           * patio uses the numeric type by default for NumericTypes
      89. 
+
    89.           * If a size is given, it is used, otherwise, it will default to whatever
      90. 
+
    90.           * the database default is for an unsized value.
      91. 
+
    91.           * <ul>
      92. 
+
    92.           * <li> if isInt is present the int is used</li>
      93. 
+
    93.           * <li> if isDouble is present then double precision is used</li>
      94. 
+
    94.           * </ul>
      95. 
+
    95.           */
      96. 
+
    96.          __typeLiteralGenericNumeric:function (column) {
      97. 
+
    97. 10            return column.size ? format("numeric(%s)", array.toArray(column.size).join(', ')) : column.isInt ? "integer" : column.isDouble ? "double precision" : "numeric";
      98. 
+
    98.          },
      99. 
 
    99.  
      100. 
-
    100.  /**
      101. 
-
    101.   * @class Thrown if there is a unexpected Error.
      102. 
-
    102.   *
      103. 
-
    103.   * @param {String} message the message to show.
      104. 
-
    104.   */
      105. 
-
    105. 1patio.PatioError = function(message) {
      106. 
-
    106. 31  return new Error("Patio error : " + message);
      107. 
-
    107.  };
      108. 
 
    108.  
      109. 
-
    109.  /**
      110. 
-
    110.   * @class Thrown if there is a error thrown within a model.
      111. 
-
    111.   * @param {String} message the message to show.
      112. 
-
    112.   */
      113. 
-
    113. 1patio.ModelError = function(message) {
      114. 
-
    114. 2  return new Error("Model error : " + message);
      115. 
-
    115.  };
      116. 
+
    116.          /**
      117. 
+
    117.           * @private
      118. 
+
    118.           */
      119. 
+
    119.          __typeLiteralGenericFloat:function (column) {
      120. 
+
    120. 15            return "double precision";
      121. 
+
    121.          },
      122. 
 
    122.  
      123. 
-
    123.  /**
      124. 
-
    124.   * @class Thrown if there is an error when loading/creating/deleteing an association.
      125. 
-
    125.   * @param {String} message the message to show.
      126. 
-
    126.   */
      127. 
-
    127. 1patio.AssociationError = function(message) {
      128. 
-
    128. 0  return new Error("Association error : " + message);
      129. 
-
    129.  };
      130. 
+
    130.          /**
      131. 
+
    131.           * @private
      132. 
+
    132.           */
      133. 
+
    133.          __typeLiteralGenericDecimal:function (column) {
      134. 
+
    134. 2            return "double precision";
      135. 
+
    135.          },
      136. 
 
    136.  
      137. 
+
    137.          /**
      138. 
+
    138.           * @private
      139. 
+
    139.           * patio uses the varchar type by default for Strings.  If a
      140. 
+
    140.           * size isn't present, patio assumes a size of 255.  If the
      141. 
+
    141.           * fixed option is used, patio uses the char type.  If the
      142. 
+
    142.           * text option is used, patio uses the :text type.
      143. 
+
    143.           */
      144. 
+
    144.          __typeLiteralGenericString:function (column) {
      145. 
+
    145. 41            return column.text ? "text" : format("%s(%s)", column.fixed ? "char" : "varchar", column.size || 255);
      146. 
+
    146.          },
      147. 
 
    147.  
      148. 
-
    148.  /**
      149. 
-
    149.   * Thrown if there is an error when performing a migration.
      150. 
-
    150.   * @param {String} message the message to show.
      151. 
-
    151.   */
      152. 
-
    152. 1patio.MigrationError = function(message) {
      153. 
-
    153. 2    return new Error("Migration error : " + message);
      154. 
-
    154.  };
    +
  • /**
    • +
  • * @private
    • +
  • * SQL fragment for the given type of a column if the column is not one of the
    • +
  • * generic types specified with a native javascript type class.
    • +
  • */
    • +
  • __typeLiteralSpecific:function (column) {
    • +
  • 336 var type = column.type;
    • +
  • 336 type = type === "double" ? "double precision" : type;
    • +
  • 336 if (type === "varchar") {
    • +
  • 7 column.size = isNumber(column.size) ? column.size : 255;
    • +
  • }
    • +
  • 336 var elements = column.size || column.elements;
    • +
  • 336 return format("%s%s%s", type, elements ? this.literal(toArray(elements)) : "", column.unsigned ? " UNSIGNED" : "");
    • +
  • },
    • +
    • +
  • /**@ignore*/
    • +
  • getters:{
    • +
  • /**@lends patio.Database.prototype*/
    • +
  • /**
    • +
  • * @private
    • +
  • * The SQL string specify the autoincrement property, generally used by
    • +
  • * primary keys.
    • +
  • *
    • +
  • * @field
    • +
  • * */
    • +
  • autoIncrementSql:function () {
    • +
  • 10 return this._static.AUTOINCREMENT;
    • +
  • },
    • +
    • +
  • /**
    • +
  • * @private
    • +
  • * @field
    • +
  • * */
    • +
  • temporaryTableSql:function () {
    • +
  • 3 return this._static.TEMPORARY;
    • +
  • },
    • +
    • +
  • /**
    • +
  • * @private
    • +
  • * @field
    • +
  • * */
    • +
  • __schemaUtiltyDataset:function () {
    • +
  • 3304 this.__schemaUtiltyDs = this.__schemaUtiltyDs || this.dataset;
    • +
  • 3304 return this.__schemaUtiltyDs;
    • +
  • }
    • +
  • }
    • +
    • +
  • },
    • +
    • +
  • "static":{
    • +
  • /**@lends patio.Database*/
    • +
    • +
  • /**
    • +
  • *Default AUTO INCREMENT SQL
    • +
  • */
    • +
  • AUTOINCREMENT:'AUTOINCREMENT',
    • +
    • +
  • /**
    • +
  • *Default CASCACDE SQL
    • +
  • */
    • +
  • CASCADE:'CASCADE',
    • +
    • +
  • /**
    • +
  • *Default comma
    • +
  • */
    • +
  • COMMA_SEPARATOR:', ',
    • +
    • +
  • /**
    • +
  • *Default NO ACTION SQL
    • +
  • */
    • +
  • NO_ACTION:'NO ACTION',
    • +
    • +
  • /**
    • +
  • *Default NOT NULL SQL
    • +
  • */
    • +
  • NOT_NULL:' NOT NULL',
    • +
    • +
  • /**
    • +
  • * Default NULL SQL
    • +
  • */
    • +
  • NULL:' NULL',
    • +
    • +
  • /**
    • +
  • *Default PRIMARY KEY SQL
    • +
  • */
    • +
  • PRIMARY_KEY:' PRIMARY KEY',
    • +
    • +
  • /**
    • +
  • *Default RESTRICT SQL
    • +
  • */
    • +
  • RESTRICT:'RESTRICT',
    • +
    • +
  • /**
    • +
  • *Default SET DEFAULT SQL
    • +
  • */
    • +
  • SET_DEFAULT:'SET DEFAULT',
    • +
    • +
  • /**
    • +
  • *Default SET NULL SQL
    • +
  • */
    • +
  • SET_NULL:'SET NULL',
    • +
    • +
  • /**
    • +
  • *Default TEMPORARY SQL
    • +
  • */
    • +
  • TEMPORARY:'TEMPORARY ',
    • +
    • +
  • /**
    • +
  • *Default UNDERSCORE SQL, used in index creation.
    • +
  • */
    • +
  • UNDERSCORE:'_',
    • +
    • +
  • /**
    • +
  • *Default UNIQUE SQL
    • +
  • */
    • +
  • UNIQUE:' UNIQUE',
    • +
    • +
  • /**
    • +
  • * Default UNSIGNED SQL
    • +
  • */
    • +
  • UNSIGNED:' UNSIGNED'
    • +
    • +
  • }
    • +
  • }).as(module);
    • +
    • +
    + +
    + + + + + +
    +
    errors.js
    +     		+
    + Coverage89.47 + SLOC81 + LOC19 + Missed2 +
    +
    + 
    1. 1var patio = exports;
      2. 
+
    2.  
      3. 
+
    3.  
      4. 
+
    4.  /**
      5. 
+
    5.   * @class Thrown if a function is not impltemened
      6. 
+
    6.   *
      7. 
+
    7.   * @param {String} message the message to show.
      8. 
+
    8.   */
      9. 
+
    9. 1patio.NotImplemented = function(message) {
      10. 
+
    10. 4  return new Error("Not Implemented :  " + message);
      11. 
+
    11.  };
      12. 
+
    12.  
      13. 
+
    13.  /**
      14. 
+
    14.   * @class Thrown if there is an Expression Error.
      15. 
+
    15.   *
      16. 
+
    16.   * @param {String} message the message to show.
      17. 
+
    17.   */
      18. 
+
    18. 1patio.ExpressionError = function(message) {
      19. 
+
    19. 0  return new Error("Expression Error :" + message);
      20. 
+
    20.  };
      21. 
+
    21.  
      22. 
+
    22.  /**
      23. 
+
    23.   * @class Thrown if there is a Query Error.
      24. 
+
    24.   *
      25. 
+
    25.   * @param {String} message the message to show.
      26. 
+
    26.   */
      27. 
+
    27. 1patio.QueryError = function(message) {
      28. 
+
    28. 121  return new Error("QueryError : " + message);
      29. 
+
    29.  };
      30. 
+
    30.  
      31. 
+
    31.  /**
      32. 
+
    32.   * @class Thrown if there is a Dataset Error.
      33. 
+
    33.   *
      34. 
+
    34.   * @param {String} message the message to show.
      35. 
+
    35.   */
      36. 
+
    36. 1patio.DatasetError = function(message) {
      37. 
+
    37. 7  return new Error("DatasetError : " + message);
      38. 
+
    38.  };
      39. 
+
    39.  
      40. 
+
    40.  /**
      41. 
+
    41.   * @class Thrown if there is a Database Error.
      42. 
+
    42.   *
      43. 
+
    43.   * @param {String} message the message to show.
      44. 
+
    44.   */
      45. 
+
    45. 1patio.DatabaseError = function(message) {
      46. 
+
    46. 5  return new Error("Database error : " + message);
      47. 
+
    47.  };
      48. 
+
    48.  
      49. 
+
    49.  /**
      50. 
+
    50.   * @class Thrown if there is a unexpected Error.
      51. 
+
    51.   *
      52. 
+
    52.   * @param {String} message the message to show.
      53. 
+
    53.   */
      54. 
+
    54. 1patio.PatioError = function(message) {
      55. 
+
    55. 31  return new Error("Patio error : " + message);
      56. 
+
    56.  };
      57. 
+
    57.  
      58. 
+
    58.  /**
      59. 
+
    59.   * @class Thrown if there is a error thrown within a model.
      60. 
+
    60.   * @param {String} message the message to show.
      61. 
+
    61.   */
      62. 
+
    62. 1patio.ModelError = function(message) {
      63. 
+
    63. 2  return new Error("Model error : " + message);
      64. 
+
    64.  };
      65. 
+
    65.  
      66. 
+
    66.  /**
      67. 
+
    67.   * @class Thrown if there is an error when loading/creating/deleteing an association.
      68. 
+
    68.   * @param {String} message the message to show.
      69. 
+
    69.   */
      70. 
+
    70. 1patio.AssociationError = function(message) {
      71. 
+
    71. 0  return new Error("Association error : " + message);
      72. 
+
    72.  };
      73. 
+
    73.  
      74. 
+
    74.  
      75. 
+
    75.  /**
      76. 
+
    76.   * Thrown if there is an error when performing a migration.
      77. 
+
    77.   * @param {String} message the message to show.
      78. 
+
    78.   */
      79. 
+
    79. 1patio.MigrationError = function(message) {
      80. 
+
    80. 2    return new Error("Migration error : " + message);
      81. 
+
    81.  };
    @@ -9069,21 +9542,21 @@
  • 1var virtualRow = function (name) {
    • -
  • 874 var WILDCARD = new LiteralString('*');
    • -
  • 874 var QUESTION_MARK = new LiteralString('?');
    • -
  • 874 var COMMA_SEPARATOR = new LiteralString(', ');
    • -
  • 874 var DOUBLE_UNDERSCORE = '__';
    • -
    • -
  • 874 var parts = name.split(DOUBLE_UNDERSCORE);
    • -
  • 874 var table = parts[0], column = parts[1];
    • -
  • 874 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • -
  • 874 var prox = methodMissing(ident, function (m) {
    • +
  • 875 var WILDCARD = new LiteralString('*');
    • +
  • 875 var QUESTION_MARK = new LiteralString('?');
    • +
  • 875 var COMMA_SEPARATOR = new LiteralString(', ');
    • +
  • 875 var DOUBLE_UNDERSCORE = '__';
    • +
    • +
  • 875 var parts = name.split(DOUBLE_UNDERSCORE);
    • +
  • 875 var table = parts[0], column = parts[1];
    • +
  • 875 var ident = column ? QualifiedIdentifier.fromArgs([table, column]) : Identifier.fromArgs([name]);
    • +
  • 875 var prox = methodMissing(ident, function (m) {
  • 4 return function () {
  • 3 var args = argsToArray(arguments);
  • 3 return SQLFunction.fromArgs([m, name].concat(args));
  • }
  • }, column ? QualifiedIdentifier : Identifier);
    • -
  • 874 var ret = createFunctionWrapper(prox, function (m) {
    • +
  • 875 var ret = createFunctionWrapper(prox, function (m) {
  • 548 var args = argsToArray(arguments);
  • 548 if (args.length) {
  • 542 return SQLFunction.fromArgs([name].concat(args));
    • @@ -9093,8 +9566,8 @@
  • }, function () {
  • 0 return SQLFunction.fromArgs(arguments);
  • });
    • -
  • 874 ret.__proto__ = ident;
    • -
  • 874 return ret;
    • +
  • 875 ret.__proto__ = ident;
    • +
  • 875 return ret;
  • };
  • 1var DATE_METHODS = ["getDate", "getDay", "getFullYear", "getHours", "getMilliseconds", "getMinutes", "getMonth", "getSeconds",
    • @@ -9546,7 +10019,7 @@
  • });
  • 1exports.sql = methodMissing(sql, function (name) {
    • -
  • 874 return virtualRow(name);
    • +
  • 875 return virtualRow(name);
  • });
  • 1var OPERTATOR_INVERSIONS = {
    • @@ -10198,7 +10671,7 @@
  • * @return {patio.sql.ColumnAll}
  • */
  • all:function () {
    • -
  • 329 return new ColumnAll(this);
    • +
  • 3 return new ColumnAll(this);
  • }
    • @@ -10356,13 +10829,13 @@
  • * @return {patio.sql.Expression} an expression.
  • */
  • fromArgs:function (args) {
    • -
  • 2215 var ret;
    • -
  • 2215 try {
    • -
  • 2215 ret = new this();
    • +
  • 2216 var ret;
    • +
  • 2216 try {
    • +
  • 2216 ret = new this();
  • } catch (ignore) {
  • }
    • -
  • 2215 this.apply(ret, args);
    • -
  • 2215 return ret;
    • +
  • 2216 this.apply(ret, args);
    • +
  • 2216 return ret;
  • },
  • /**
    • @@ -10554,7 +11027,7 @@
  • * @property table the table this all column expression represents.
  • */
  • constructor:function (table) {
    • -
  • 346 this.table = table;
    • +
  • 20 this.table = table;
  • },
  • /**
    • @@ -10566,9 +11039,9 @@
  • * @return String the SQL columnAll expression fragment.
  • */
  • toString:function (ds) {
    • -
  • 345 !Dataset && (Dataset = require("./dataset"));
    • -
  • 345 ds = ds || new Dataset();
    • -
  • 345 return ds.columnAllSql(this);
    • +
  • 19 !Dataset && (Dataset = require("./dataset"));
    • +
  • 19 ds = ds || new Dataset();
    • +
  • 19 return ds.columnAllSql(this);
  • }
  • }
  • }).as(sql, "ColumnAll");
    • @@ -11165,7 +11638,7 @@
  • * @property {String} value <b>READ ONLY</b> the column or table this identifier represents.
  • */
  • constructor:function (value) {
    • -
  • 16412 this.__value = value;
    • +
  • 16414 this.__value = value;
  • },
  • /**
    • @@ -11185,7 +11658,7 @@
  • /**@ignore*/
  • getters:{
  • value:function () {
    • -
  • 25480 return this.__value;
    • +
  • 25154 return this.__value;
  • }
  • }
  • }
    • @@ -11742,7 +12215,7 @@
  • 1var addStringMethod = function (op) {
  • 24 return function () {
    • -
  • 3968 return this.__str[op].apply(this.__str, arguments);
    • +
  • 4294 return this.__str[op].apply(this.__str, arguments);
  • }
  • };
    • @@ -11765,7 +12238,7 @@
  • * @param {String} str the literal string.
  • */
  • constructor:function (str) {
    • -
  • 3092 this.__str = str;
    • +
  • 3095 this.__str = str;
  • }
  • }
  • }).as(sql, "LiteralString");
    • @@ -12275,601 +12748,144 @@
  • } else {
  • 0 ret.callback(this.__appliedMigrations);
  • }
    • -
  • 18 return ret.promise();
    • -
  • },
    • -
    • -
  • __getMirationFiles:function () {
    • -
  • 18 var ret = new Promise();
    • -
  • 18 var upMigrations = [], downMigrations = [], target = this.target;
    • -
  • 18 if (!this.__migrationFiles) {
    • -
  • 18 when(
    • -
  • this.getFileNames(),
    • -
  • this.__getAppliedMigrations()
    • -
  • ).then(hitch(this, function (res) {
    • -
  • 18 var files = res[0], appliedMigrations = res[1];
    • -
  • 18 var l = files.length, inserts = [];
    • -
  • 18 if (l > 0) {
    • -
  • 18 try {
    • -
  • 18 for (var i = 0; i < l; i++) {
    • -
  • 92 var file = files[i], f = path.basename(file), fLowerCase = f.toLowerCase();
    • -
  • 92 if (!isUndefined(target)) {
    • -
  • 48 var version = this.getMigrationVersionFromFile(f);
    • -
  • 48 if (version > target || (version === 0 && target === version)) {
    • -
  • 35 if (appliedMigrations.indexOf(fLowerCase) != -1) {
    • -
  • 26 downMigrations.push([f, require(file), "down"]);
    • -
  • }
    • -
  • 13 } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
    • -
  • 9 upMigrations.push([f, require(file), "up"]);
    • -
  • }
    • -
  • 44 } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
    • -
  • 35 upMigrations.push([f, require(file), "up"]);
    • -
  • }
    • -
  • }
    • -
  • } catch (e) {
    • -
  • 0 return ret.errback(e)
    • -
  • }
    • -
  • 18 this.__migrationFiles = upMigrations.concat(downMigrations.reverse())
    • -
  • 18 ret.callback(this.__migrationFiles);
    • -
  • } else {
    • -
  • 0 return ret.callback();
    • -
  • }
    • -
  • }), ret);
    • -
  • } else {
    • -
  • 0 ret.callback(this.__migrationFiles);
    • -
  • }
    • -
  • 18 return ret.promise();
    • -
  • },
    • -
    • -
    • -
  • // Returns the dataset for the schema_migrations table. If no such table
    • -
  • // exists, it is automatically created.
    • -
  • _getSchemaDataset:function () {
    • -
  • 36 var ret = new Promise();
    • -
  • 36 if (!this.__schemaDataset) {
    • -
  • 18 var ds = this.db.from(this.table);
    • -
  • 18 this.__createTable().then(hitch(this, function () {
    • -
  • 18 this.__schemaDataset = ds;
    • -
  • 18 ret.callback(ds);
    • -
  • }), ret);
    • -
  • } else {
    • -
  • 18 ret.callback(this.__schemaDataset);
    • -
  • }
    • -
  • 36 return ret.promise();
    • -
  • },
    • -
    • -
  • __convertSchemaInfo:function () {
    • -
  • 1 var ret = new Promise(), c = this.column;
    • -
  • 1 var ds = this.db.from(this.table);
    • -
  • 1 this.db.from(IntegerMigrator.DEFAULT_SCHEMA_TABLE).get(IntegerMigrator.DEFAULT_SCHEMA_COLUMN).then(hitch(this, function (version) {
    • -
  • 1 this.getFileNames().then(hitch(this, function (files) {
    • -
  • 1 var l = files.length, inserts = [];
    • -
  • 1 if (l > 0) {
    • -
  • 1 for (var i = 0; i < l; i++) {
    • -
  • 7 var f = path.basename(files[i]);
    • -
  • 7 if (this.getMigrationVersionFromFile(f) <= version) {
    • -
  • 5 var insert = {};
    • -
  • 5 insert[c] = f;
    • -
  • 5 inserts.push(ds.insert(insert));
    • -
  • }
    • -
  • }
    • -
  • }
    • -
  • 1 if (inserts.length) {
    • -
  • 1 when.apply(comb, inserts).then(ret);
    • -
  • } else {
    • -
  • 0 ret.callback();
    • -
  • }
    • -
  • }), ret);
    • -
  • }), ret);
    • -
  • 1 return ret.promise();
    • -
    • -
  • },
    • -
    • -
  • __createTable:function () {
    • -
  • 18 var c = this.column, table = this.table, db = this.db, intMigrationTable = IntegerMigrator.DEFAULT_SCHEMA_TABLE;
    • -
  • 18 var ds = this.db.from(table);
    • -
  • 18 var ret = new Promise();
    • -
  • 18 when(
    • -
  • db.tableExists(table),
    • -
  • db.tableExists(intMigrationTable)
    • -
  • ).then(hitch(this, function (res) {
    • -
  • 18 var exists = res[0], intMigratorExists = res[1];
    • -
  • 18 if (!exists) {
    • -
  • 10 db.createTable(table,
    • -
  • function () {
    • -
  • 10 this.column(c, String, {primaryKey:true});
    • -
  • }).addErrback(ret);
    • -
  • 10 if (intMigratorExists) {
    • -
  • 1 db.from(intMigrationTable).all().then(hitch(this, function (versions) {
    • -
  • 1 var version;
    • -
  • 1 if (versions.length === 1 && (version = versions[0]) && isNumber(version[Object.keys(version)[0]])) {
    • -
  • 1 this.__convertSchemaInfo().then(ret);
    • -
  • } else {
    • -
  • 0 ret.callback();
    • -
  • }
    • -
  • }));
    • -
  • } else {
    • -
  • 9 ret.callback();
    • -
  • }
    • -
  • } else {
    • -
  • 8 ds.columns.then(hitch(this, function (columns) {
    • -
  • 8 if (columns.indexOf(c) === -1) {
    • -
  • 0 ret.errback(new MigrationError(format("Migration table %s does not contain column %s", table, c)));
    • -
  • } else {
    • -
  • 8 ret.callback();
    • -
  • }
    • -
  • }), ret);
    • -
  • }
    • -
  • }), ret);
    • -
  • 18 return ret.promise();
    • -
  • }
    • -
  • },
    • -
    • -
  • static:{
    • -
  • DEFAULT_SCHEMA_COLUMN:"filename",
    • -
  • DEFAULT_SCHEMA_TABLE:"schema_migrations"
    • -
  • }
    • -
  • }).as(exports, "TimestampMigrator");
    • -
    • -
  • 1exports.run = function () {
    • -
  • 31 return Migrator.run.apply(Migrator, arguments);
    • -
  • };
    • -
    - -
    - - - - - -
    -
    dataset/index.js
    -     		-
    - Coverage92.54 - SLOC439 - LOC67 - Missed5 -
    -
    - 
    1. 1var comb = require("comb"),
      2. 
-
    2.      hitch = comb.hitch,
      3. 
-
    3.      logging = comb.logging,
      4. 
-
    4.      Logger = logging.Logger,
      5. 
-
    5.      errors = require("../errors"),
      6. 
-
    6.      QueryError = errors.QueryError,
      7. 
-
    7.      DatasetError = errors.DatasetError,
      8. 
-
    8.      Promise = comb.Promise,
      9. 
-
    9.      PromiseList = comb.PromiseList,
      10. 
-
    10.      isUndefined = comb.isUndefined,
      11. 
-
    11.      isUndefinedOrNull = comb.isUndefinedOrNull,
      12. 
-
    12.      isString = comb.isString,
      13. 
-
    13.      isInstanceOf = comb.isInstanceOf,
      14. 
-
    14.      isString = comb.isString,
      15. 
-
    15.      isFunction = comb.isFunction,
      16. 
-
    16.      isNull = comb.isNull,
      17. 
-
    17.      merge = comb.merge,
      18. 
-
    18.      define = comb.define,
      19. 
-
    19.      graph = require("./graph"),
      20. 
-
    20.      actions = require("./actions"),
      21. 
-
    21.      features = require("./features"),
      22. 
-
    22.      query = require("./query"),
      23. 
-
    23.      sql = require("./sql"),
      24. 
-
    24.      SQL = require("../sql").sql,
      25. 
-
    25.      AliasedExpression = SQL.AliasedExpression,
      26. 
-
    26.      Identifier = SQL.Identifier,
      27. 
-
    27.      QualifiedIdentifier = SQL.QualifiedIdentifier;
      28. 
-
    28.  
      29. 
-
    29.  
      30. 
-
    30. 1var LOGGER = comb.logger("patio.Dataset");
      31. 
-
    31. 1define([actions, graph, features, query, sql], {
      32. 
-
    32.      instance:{
      33. 
-
    33.  
      34. 
-
    34.          /**@lends patio.Dataset.prototype*/
      35. 
-
    35.  
      36. 
-
    36.          /**
      37. 
-
    37.           * Class that is used for querying/retirving datasets from a database.
      38. 
-
    38.           *
      39. 
-
    39.           * <p> Dynamically genertated methods include
      40. 
-
    40.           * <ul>
      41. 
-
    41.           *     <li>Join methods from {@link patio.Dataset.CONDITIONED_JOIN_TYPES} and
      42. 
-
    42.           *         {@link  patio.Dataset.UNCONDITIONED_JOIN_TYPES}, these methods handle the type call
      43. 
-
    43.           *         to {@link patio.Dataset#joinTable}, so to invoke include all arguments that
      44. 
-
    44.           *         {@link patio.Dataset#joinTable} requires except the type parameter. The default list includes.
      45. 
-
    45.           *         <ul>
      46. 
-
    46.           *             <li>Conditioned join types that accept conditions.
      47. 
-
    47.           *                  <ul>
      48. 
-
    48.           *                      <li>inner - INNER JOIN</li>
      49. 
-
    49.           *                      <li>fullOuter - FULL OUTER</li>
      50. 
-
    50.           *                      <li>rightOuter - RIGHT OUTER JOIN</li>
      51. 
-
    51.           *                      <li>leftOuter - LEFT OUTER JOIN</li>
      52. 
-
    52.           *                      <li>full - FULL JOIN</li>
      53. 
-
    53.           *                      <li>right - RIGHT JOIN</li>
      54. 
-
    54.           *                      <li>left - LEFT JOIN</li>
      55. 
-
    55.           *                  </ul>
      56. 
-
    56.           *             </li>
      57. 
-
    57.           *             <li>Unconditioned join types that do not accept join conditions
      58. 
-
    58.           *                  <ul>
      59. 
-
    59.           *                      <li>natural - NATURAL JOIN</li>
      60. 
-
    60.           *                      <li>naturalLeft - NATURAL LEFT JOIN</li>
      61. 
-
    61.           *                      <li>naturalRight - NATURAL RIGHT JOIN</li>
      62. 
-
    62.           *                      <li>naturalFull - NATURA FULLL JOIN</li>
      63. 
-
    63.           *                      <li>cross - CROSS JOIN</li>
      64. 
-
    64.           *                  </ul>
      65. 
-
    65.           *             </li>
      66. 
-
    66.           *         </ul>
      67. 
-
    67.           *      </li>
      68. 
-
    68.           *  </li>
      69. 
-
    69.           * </ul>
      70. 
-
    70.           *
      71. 
-
    71.           * <p>
      72. 
-
    72.           *     <h4>Features:</h4>
      73. 
-
    73.           *     <p>
      74. 
-
    74.           *           Features that a particular {@link patio.Dataset} supports are shown in the example below.
      75. 
-
    75.           *           If you wish to implement an adapter please override these values depending on the database that
      76. 
-
    76.           *           you are developing the adapter for.
      77. 
-
    77.           *      </p>
      78. 
-
    78.           *      <pre class="code">
      79. 
-
    79.           *          var ds = DB.from("test");
      80. 
-
    80.           *
      81. 
-
    81.           *          //The default values returned
      82. 
-
    82.           *
      83. 
-
    83.           *          //Whether this dataset quotes identifiers.
      84. 
-
    84.           *          //Whether this dataset quotes identifiers.
      85. 
-
    85.           *          ds.quoteIdentifiers //=>true
      86. 
-
    86.           *
      87. 
-
    87.           *          //Whether this dataset will provide accurate number of rows matched for
      88. 
-
    88.           *          //delete and update statements.  Accurate in this case is the number of
      89. 
-
    89.           *          //rows matched by the dataset's filter.
      90. 
-
    90.           *          ds.providesAccurateRowsMatched; //=>true
      91. 
-
    91.           *
      92. 
-
    92.           *          //Times Whether the dataset requires SQL standard datetimes (false by default,
      93. 
-
    93.           *          // as most allow strings with ISO 8601 format).
      94. 
-
    94.           *          ds.requiresSqlStandardDate; //=>false
      95. 
-
    95.           *
      96. 
-
    96.           *          //Whether the dataset supports common table expressions (the WITH clause).
      97. 
-
    97.           *          ds.supportsCte; //=>true
      98. 
-
    98.           *
      99. 
-
    99.           *          //Whether the dataset supports the DISTINCT ON clause, false by default.
      100. 
-
    100.           *          ds.supportsDistinctOn; //=>false
      101. 
-
    101.           *
      102. 
-
    102.           *          //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
      103. 
-
    103.           *          ds.supportsIntersectExcept; //=>true
      104. 
-
    104.           *
      105. 
-
    105.           *          //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default
      106. 
-
    106.           *          ds.supportsIntersectExceptAll; //=>true
      107. 
-
    107.           *
      108. 
-
    108.           *          //Whether the dataset supports the IS TRUE syntax.
      109. 
-
    109.           *          ds.supportsIsTrue; //=>true
      110. 
-
    110.           *
      111. 
-
    111.           *          //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
      112. 
-
    112.           *          ds.supportsJoinUsing; //=>true
      113. 
-
    113.           *
      114. 
-
    114.           *          //Whether modifying joined datasets is supported.
      115. 
-
    115.           *          ds.supportsModifyingJoin; //=>false
      116. 
-
    116.           *
      117. 
-
    117.           *          //Whether the IN/NOT IN operators support multiple columns when an
      118. 
-
    118.           *          ds.supportsMultipleColumnIn; //=>true
      119. 
-
    119.           *
      120. 
-
    120.           *          //Whether the dataset supports timezones in literal timestamps
      121. 
-
    121.           *          ds.supportsTimestampTimezone; //=>false
      122. 
-
    122.           *
      123. 
-
    123.           *          //Whether the dataset supports fractional seconds in literal timestamps
      124. 
-
    124.           *          ds.supportsTimestampUsecs; //=>true
      125. 
-
    125.           *
      126. 
-
    126.           *          //Whether the dataset supports window functions.
      127. 
-
    127.           *          ds.supportsWindowFunctions; //=>false
      128. 
-
    128.           *       </pre>
      129. 
-
    129.           * <p>
      130. 
-
    130.           * <p>
      131. 
-
    131.           *     <h4>Actions</h4>
      132. 
-
    132.           *     <p>
      133. 
-
    133.           *         Each dataset does not actually send any query to the database until an action method has
      134. 
-
    134.           *         been called upon it(with the exception of {@link patio.Dataset#graph} because columns
      135. 
-
    135.           *         from the other table might need retrived in order to set up the graph). Each action
      136. 
-
    136.           *         returns a <i>comb.Promise</i> that will be resolved with the result or errback, it is important
      137. 
-
    137.           *         that you account for errors otherwise it can be difficult to track down issues.
      138. 
-
    138.           *         The list of action methods is:
      139. 
-
    139.           *         <ul>
      140. 
-
    140.           *             <li>{@link patio.Dataset#all}</li>
      141. 
-
    141.           *             <li>{@link patio.Dataset#one}</li>
      142. 
-
    142.           *             <li>{@link patio.Dataset#avg}</li>
      143. 
-
    143.           *             <li>{@link patio.Dataset#count}</li>
      144. 
-
    144.           *             <li>{@link patio.Dataset#columns}</li>
      145. 
-
    145.           *             <li>{@link patio.Dataset#remove}</li>
      146. 
-
    146.           *             <li>{@link patio.Dataset#forEach}</li>
      147. 
-
    147.           *             <li>{@link patio.Dataset#empty}</li>
      148. 
-
    148.           *             <li>{@link patio.Dataset#first}</li>
      149. 
-
    149.           *             <li>{@link patio.Dataset#get}</li>
      150. 
-
    150.           *             <li>{@link patio.Dataset#import}</li>
      151. 
-
    151.           *             <li>{@link patio.Dataset#insert}</li>
      152. 
-
    152.           *             <li>{@link patio.Dataset#save}</li>
      153. 
-
    153.           *             <li>{@link patio.Dataset#insertMultiple}</li>
      154. 
-
    154.           *             <li>{@link patio.Dataset#saveMultiple}</li>
      155. 
-
    155.           *             <li>{@link patio.Dataset#interval}</li>
      156. 
-
    156.           *             <li>{@link patio.Dataset#last}</li>
      157. 
-
    157.           *             <li>{@link patio.Dataset#map}</li>
      158. 
-
    158.           *             <li>{@link patio.Dataset#max}</li>
      159. 
-
    159.           *             <li>{@link patio.Dataset#min}</li>
      160. 
-
    160.           *             <li>{@link patio.Dataset#multiInsert}</li>
      161. 
-
    161.           *             <li>{@link patio.Dataset#range}</li>
      162. 
-
    162.           *             <li>{@link patio.Dataset#selectHash}</li>
      163. 
-
    163.           *             <li>{@link patio.Dataset#selectMap}</li>
      164. 
-
    164.           *             <li>{@link patio.Dataset#selectOrderMap}</li>
      165. 
-
    165.           *             <li>{@link patio.Dataset#set}</li>
      166. 
-
    166.           *             <li>{@link patio.Dataset#singleRecord}</li>
      167. 
-
    167.           *             <li>{@link patio.Dataset#singleValue}</li>
      168. 
-
    168.           *             <li>{@link patio.Dataset#sum}</li>
      169. 
-
    169.           *             <li>{@link patio.Dataset#toCsv}</li>
      170. 
-
    170.           *             <li>{@link patio.Dataset#toHash}</li>
      171. 
-
    171.           *             <li>{@link patio.Dataset#truncate}</li>
      172. 
-
    172.           *             <li>{@link patio.Dataset#update}</li>
      173. 
-
    173.           *         </ul>
      174. 
-
    174.           *
      175. 
-
    175.           *     </p>
      176. 
-
    176.           * </p>
      177. 
-
    177.           *
      178. 
-
    178.           * @constructs
      179. 
-
    179.           *
      180. 
-
    180.           *
      181. 
-
    181.           * @param {patio.Database} db the database this dataset should use when querying for data.
      182. 
-
    182.           * @param {Object} opts options to set on this dataset instance
      183. 
-
    183.           *
      184. 
-
    184.           * @property {Function} rowCb callback to be invoked for each row returned from the database.
      185. 
-
    185.           *                      the return value will be used as the result of query. The rowCb can also return a promise,
      186. 
-
    186.           *                      The resolved value of the promise will be used as result.
      187. 
-
    187.           *
      188. 
-
    188.           * @property {String} identifierInputMethod this is the method that will be called on each identifier returned from the database.
      189. 
-
    189.           *                                          This value will be defaulted to whatever the identifierInputMethod
      190. 
-
    190.           *                                          is on the database used in initialization.
      191. 
-
    191.           *
      192. 
-
    192.           * @property {String} identifierOutputMethod this is the method that will be called on each identifier sent to the database.
      193. 
-
    193.           *                                          This value will be defaulted to whatever the identifierOutputMethod
      194. 
-
    194.           *                                          is on the database used in initialization.
      195. 
-
    195.           * @property {String} firstSourceAlias The first source (primary table) for this dataset. If the table is aliased, returns the aliased name.
      196. 
-
    196.           *                                     throws a {patio.DatasetError} tf the dataset doesn't have a table.
      197. 
-
    197.           * <pre class="code">
      198. 
-
    198.           *   DB.from("table").firstSourceAlias;
      199. 
-
    199.           *   //=> "table"
      200. 
-
    200.           *
      201. 
-
    201.           *   DB.from("table___t").firstSourceAlias;
      202. 
-
    202.           *   //=> "t"
      203. 
-
    203.           * </pre>
      204. 
-
    204.           *
      205. 
-
    205.           * @property {String} firstSourceTable  The first source (primary table) for this dataset.  If the dataset doesn't
      206. 
-
    206.           *                                      have a table, raises a {@link patio.erros.DatasetError}.
      207. 
-
    207.           *<pre class="code">
      208. 
-
    208.           *
      209. 
-
    209.           *  DB.from("table").firstSourceTable;
      210. 
-
    210.           *         //=> "table"
      211. 
-
    211.           *
      212. 
-
    212.           *  DB.from("table___t").firstSourceTable;
      213. 
-
    213.           *         //=> "t"
      214. 
-
    214.           * </pre>
      215. 
-
    215.           * @property {Boolean} isSimpleSelectAll Returns true if this dataset is a simple SELECT * FROM {table}, otherwise false.
      216. 
-
    216.           * <pre class="code">
      217. 
-
    217.           *     DB.from("items").isSimpleSelectAll; //=> true
      218. 
-
    218.           *     DB.from("items").filter({a : 1}).isSimpleSelectAll; //=> false
      219. 
-
    219.           * </pre>
      220. 
-
    220.           * @property {boolean} [quoteIdentifiers=true]  Whether this dataset quotes identifiers.
      221. 
-
    221.           * @property {boolean} [providesAccurateRowsMatched=true] Whether this dataset will provide accurate number of rows matched for
      222. 
-
    222.           *   delete and update statements.  Accurate in this case is the number of
      223. 
-
    223.           *   rows matched by the dataset's filter.
      224. 
-
    224.           * @property {boolean} [requiresSqlStandardDate=false] Whether the dataset requires SQL standard datetimes (false by default,
      225. 
-
    225.           *                                                     as most allow strings with ISO 8601 format).
      226. 
-
    226.           * @property {boolean} [supportsCte=true] Whether the dataset supports common table expressions (the WITH clause).
      227. 
-
    227.           * @property {boolean} [supportsDistinctOn=false] Whether the dataset supports the DISTINCT ON clause, false by default.
      228. 
-
    228.           * @property {boolean} [supportsIntersectExcept=true] Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
      229. 
-
    229.           * @property {boolean} [supportsIntersectExceptAll=true] Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
      230. 
-
    230.           * @property {boolean} [supportsIsTrue=true] Whether the dataset supports the IS TRUE syntax.
      231. 
-
    231.           * @property {boolean} [supportsJoinUsing=true] Whether the dataset supports the JOIN table USING (column1, ...) syntax.
      232. 
-
    232.           * @property {boolean} [supportsModifyingJoin=false] Whether modifying joined datasets is supported.
      233. 
-
    233.           * @property {boolean} [supportsMultipleColumnIn=true] Whether the IN/NOT IN operators support multiple columns when an
      234. 
-
    234.           * @property {boolean} [supportsTimestampTimezone=false] Whether the dataset supports timezones in literal timestamps
      235. 
-
    235.           * @property {boolean} [supportsTimestampUsecs=true] Whether the dataset supports fractional seconds in literal timestamps
      236. 
-
    236.           * @property {boolean} [supportsWindowFunctions=false] Whether the dataset supports window functions.
      237. 
-
    237.           */
      238. 
-
    238.          constructor:function (db, opts) {
      239. 
-
    239. 29542            this._super(arguments);
      240. 
-
    240. 29542            this.db = db;
      241. 
-
    241. 29542            this.__opts = {};
      242. 
-
    242. 29542            this.__rowCb = null;
      243. 
-
    243. 29542            if (db) {
      244. 
-
    244. 15365                this.__quoteIdentifiers = db.quoteIdentifiers;
      245. 
-
    245. 15365                this.__identifierInputMethod = db.identifierInputMethod;
      246. 
-
    246. 15365                this.__identifierOutputMethod = db.identifierOutputMethod;
      247. 
-
    247.              }
      248. 
+
    248. 18            return ret.promise();
      249. 
 
    249.          },
      250. 
 
    250.  
      251. 
-
    251.  
      252. 
-
    252.          /**
      253. 
-
    253.           * Returns a new clone of the dataset with with the given options merged into the current datasets options.
      254. 
-
    254.           * If the options changed include options in {@link patio.dataset.Query#COLUMN_CHANGE_OPTS}, the cached
      255. 
-
    255.           * columns are deleted.  This method should generally not be called
      256. 
-
    256.           * directly by user code.
      257. 
-
    257.           *
      258. 
-
    258.           * @param {Object} opts options to merge into the curred datasets options and applied to the returned dataset.
      259. 
-
    259.           * @return [patio.Dataset] a cloned dataset with the merged options
      260. 
-
    260.           **/
      261. 
-
    261.          mergeOptions:function (opts) {
      262. 
-
    262. 15274            opts = isUndefined(opts) ? {} : opts;
      263. 
-
    263. 15274            var ds = new this._static(this.db, {});
      264. 
-
    264. 15274            ds.rowCb = this.rowCb;
      265. 
-
    265. 15274            this._static.FEATURES.forEach(function (f) {
      266. 
-
    266. 213836                ds[f] = this[f];
      267. 
-
    267.              }, this);
      268. 
-
    268. 15274            ds.__opts = merge({}, this.__opts, opts);
      269. 
-
    269. 15274            ds.identifierInputMethod = this.identifierInputMethod;
      270. 
-
    270. 15274            ds.identifierOutputMethod = this.identifierOutputMethod;
      271. 
-
    271. 15274            var columnChangeOpts = this._static.COLUMN_CHANGE_OPTS;
      272. 
-
    272. 15274            if (Object.keys(opts).some(function (o) {
      273. 
-
    273. 13862                return columnChangeOpts.indexOf(o) != -1;
      274. 
-
    274.              })) {
      275. 
-
    275. 2782                ds.__opts.columns = null;
      276. 
+
    276.          __getMirationFiles:function () {
      277. 
+
    277. 18            var ret = new Promise();
      278. 
+
    278. 18            var upMigrations = [], downMigrations = [], target = this.target;
      279. 
+
    279. 18            if (!this.__migrationFiles) {
      280. 
+
    280. 18                when(
      281. 
+
    281.                      this.getFileNames(),
      282. 
+
    282.                      this.__getAppliedMigrations()
      283. 
+
    283.                  ).then(hitch(this, function (res) {
      284. 
+
    284. 18                    var files = res[0], appliedMigrations = res[1];
      285. 
+
    285. 18                    var l = files.length, inserts = [];
      286. 
+
    286. 18                    if (l > 0) {
      287. 
+
    287. 18                        try {
      288. 
+
    288. 18                            for (var i = 0; i < l; i++) {
      289. 
+
    289. 92                                var file = files[i], f = path.basename(file), fLowerCase = f.toLowerCase();
      290. 
+
    290. 92                                if (!isUndefined(target)) {
      291. 
+
    291. 48                                    var version = this.getMigrationVersionFromFile(f);
      292. 
+
    292. 48                                    if (version > target || (version === 0 && target === version)) {
      293. 
+
    293. 35                                        if (appliedMigrations.indexOf(fLowerCase) != -1) {
      294. 
+
    294. 26                                            downMigrations.push([f, require(file), "down"]);
      295. 
+
    295.                                          }
      296. 
+
    296. 13                                    } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
      297. 
+
    297. 9                                        upMigrations.push([f, require(file), "up"]);
      298. 
+
    298.                                      }
      299. 
+
    299. 44                                } else if (appliedMigrations.indexOf(fLowerCase) == -1) {
      300. 
+
    300. 35                                    upMigrations.push([f, require(file), "up"]);
      301. 
+
    301.                                  }
      302. 
+
    302.                              }
      303. 
+
    303.                          } catch (e) {
      304. 
+
    304. 0                            return ret.errback(e)
      305. 
+
    305.                          }
      306. 
+
    306. 18                        this.__migrationFiles = upMigrations.concat(downMigrations.reverse())
      307. 
+
    307. 18                        ret.callback(this.__migrationFiles);
      308. 
+
    308.                      } else {
      309. 
+
    309. 0                        return ret.callback();
      310. 
+
    310.                      }
      311. 
+
    311.                  }), ret);
      312. 
+
    312.              } else {
      313. 
+
    313. 0                ret.callback(this.__migrationFiles);
      314. 
 
    314.              }
      315. 
-
    315. 15274            return ds;
      316. 
+
    316. 18            return ret.promise();
      317. 
 
    317.          },
      318. 
 
    318.  
      319. 
 
    319.  
      320. 
-
    320.          /**
      321. 
-
    321.           * Converts a string to an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
      322. 
-
    322.           * or {@link patio.sql.AliasedExpression}, depending on the format:
      323. 
-
    323.           *
      324. 
-
    324.           * <ul>
      325. 
-
    325.           *      <li>For columns : table__column___alias.</li>
      326. 
-
    326.           *      <li>For tables : schema__table___alias.</li>
      327. 
-
    327.           * </ul>
      328. 
-
    328.           * each portion of the identifier is optional. See example below
      329. 
-
    329.           *
      330. 
-
    330.           * @example
      331. 
-
    331.           *
      332. 
-
    332.           * ds.stringToIdentifier("a") //= > new patio.sql.Identifier("a");
      333. 
-
    333.           * ds.stringToIdentifier("table__column"); //=> new patio.sql.QualifiedIdentifier(table, column);
      334. 
-
    334.           * ds.stringToIdentifier("table__column___alias");
      335. 
-
    335.           *      //=> new patio.sql.AliasedExpression(new patio.sql.QualifiedIdentifier(table, column), alias);
      336. 
-
    336.           *
      337. 
-
    337.           * @param {String} name the name to covert to an an {@link patio.sql.Identifier}, {@link patio.sql.QualifiedIdentifier},
      338. 
-
    338.           * or {@link patio.sql.AliasedExpression}.
      339. 
-
    339.           *
      340. 
-
    340.           * @return  {patio.sql.Identifier|patio.sql.QualifiedIdentifier|patio.sql.AliasedExpression} an identifier generated based on the name string.
      341. 
-
    341.           */
      342. 
-
    342.          stringToIdentifier:function (name) {
      343. 
-
    343. 15093            if (isString(name)) {
      344. 
-
    344. 10138                var parts = this._splitString(name);
      345. 
-
    345. 10138                var schema = parts[0], table = parts[1], alias = parts[2];
      346. 
-
    346. 10138                return (schema && table && alias
      347. 
-
    347.                      ? new AliasedExpression(new QualifiedIdentifier(schema, table), alias)
      348. 
-
    348.                      : (schema && table
      349. 
-
    349.                      ? new QualifiedIdentifier(schema, table)
      350. 
-
    350.                      : (table && alias
      351. 
-
    351.                      ? new AliasedExpression(new Identifier(table), alias) : new Identifier(table))));
      352. 
+
    352.          // Returns the dataset for the schema_migrations table. If no such table
      353. 
+
    353.          // exists, it is automatically created.
      354. 
+
    354.          _getSchemaDataset:function () {
      355. 
+
    355. 36            var ret = new Promise();
      356. 
+
    356. 36            if (!this.__schemaDataset) {
      357. 
+
    357. 18                var ds = this.db.from(this.table);
      358. 
+
    358. 18                this.__createTable().then(hitch(this, function () {
      359. 
+
    359. 18                    this.__schemaDataset = ds;
      360. 
+
    360. 18                    ret.callback(ds);
      361. 
+
    361.                  }), ret);
      362. 
 
    362.              } else {
      363. 
-
    363. 4955                return name;
      364. 
-
    364.              }
      365. 
-
    365.          },
      366. 
-
    366.  
      367. 
-
    367.          /**
      368. 
-
    368.           * Can either be a string or null.
      369. 
-
    369.           *
      370. 
-
    370.           *
      371. 
-
    371.           * @example
      372. 
-
    372.           * //columns
      373. 
-
    373.           *  table__column___alias //=> table.column as alias
      374. 
-
    374.           *  table__column //=> table.column
      375. 
-
    375.           *  //tables
      376. 
-
    376.           *  schema__table___alias //=> schema.table as alias
      377. 
-
    377.           *  schema__table //=> schema.table
      378. 
-
    378.           *
      379. 
-
    379.           * //name and alias
      380. 
-
    380.           * columnOrTable___alias //=> columnOrTable as alias
      381. 
-
    381.           *
      382. 
-
    382.           *
      383. 
-
    383.           *
      384. 
-
    384.           * @return {String[]} an array with the elements being:
      385. 
-
    385.           * <ul>
      386. 
-
    386.           *      <li>For columns :[table, column, alias].</li>
      387. 
-
    387.           *      <li>For tables : [schema, table, alias].</li>
      388. 
-
    388.           * </ul>
      389. 
-
    389.           */
      390. 
-
    390.          _splitString:function (s) {
      391. 
-
    391. 19662            var ret, m;
      392. 
-
    392. 19662            if ((m = s.match(this._static.COLUMN_REF_RE1)) != null) {
      393. 
-
    393. 189                ret = m.slice(1);
      394. 
-
    394.              }
      395. 
-
    395. 19473            else if ((m = s.match(this._static.COLUMN_REF_RE2)) != null) {
      396. 
-
    396. 28                ret = [null, m[1], m[2]];
      397. 
-
    397.              }
      398. 
-
    398. 19445            else if ((m = s.match(this._static.COLUMN_REF_RE3)) != null) {
      399. 
-
    399. 2079                ret = [m[1], m[2], null];
      400. 
-
    400.              }
      401. 
-
    401.              else {
      402. 
-
    402. 17366                ret = [null, s, null];
      403. 
+
    403. 18                ret.callback(this.__schemaDataset);
      404. 
 
    404.              }
      405. 
-
    405. 19662            return ret;
      406. 
+
    406. 36            return ret.promise();
      407. 
 
    407.          },
      408. 
 
    408.  
      409. 
-
    409.          /**
      410. 
-
    410.           * @ignore
      411. 
-
    411.           **/
      412. 
-
    412.          getters:{
      413. 
-
    413.  
      414. 
-
    414.              rowCb:function () {
      415. 
-
    415. 23378                return this.__rowCb;
      416. 
-
    416.              },
      417. 
-
    417.  
      418. 
-
    418.              identifierInputMethod:function () {
      419. 
-
    419. 15274                return this.__identifierInputMethod;
      420. 
-
    420.              },
      421. 
-
    421.  
      422. 
-
    422.              identifierOutputMethod:function () {
      423. 
-
    423. 15274                return this.__identifierOutputMethod;
      424. 
-
    424.              },
      425. 
-
    425.  
      426. 
-
    426.              firstSourceAlias:function () {
      427. 
-
    427. 905                var source = this.__opts.from;
      428. 
-
    428. 905                if (isUndefinedOrNull(source) || !source.length) {
      429. 
-
    429. 2                    throw new DatasetError("No source specified for the query");
      430. 
-
    430.                  }
      431. 
-
    431. 903                source = source[0];
      432. 
-
    432. 903                if (isInstanceOf(source, AliasedExpression)) {
      433. 
-
    433. 20                    return source.alias;
      434. 
-
    434. 883                } else if (isString(source)) {
      435. 
-
    435. 0                    var parts = this._splitString(source);
      436. 
-
    436. 0                    var alias = parts[2];
      437. 
-
    437. 0                    return alias ? alias : source;
      438. 
-
    438.                  } else {
      439. 
-
    439. 883                    return source;
      440. 
-
    440.                  }
      441. 
-
    441.              },
      442. 
+
    442.          __convertSchemaInfo:function () {
      443. 
+
    443. 1            var ret = new Promise(), c = this.column;
      444. 
+
    444. 1            var ds = this.db.from(this.table);
      445. 
+
    445. 1            this.db.from(IntegerMigrator.DEFAULT_SCHEMA_TABLE).get(IntegerMigrator.DEFAULT_SCHEMA_COLUMN).then(hitch(this, function (version) {
      446. 
+
    446. 1                this.getFileNames().then(hitch(this, function (files) {
      447. 
+
    447. 1                    var l = files.length, inserts = [];
      448. 
+
    448. 1                    if (l > 0) {
      449. 
+
    449. 1                        for (var i = 0; i < l; i++) {
      450. 
+
    450. 7                            var f = path.basename(files[i]);
      451. 
+
    451. 7                            if (this.getMigrationVersionFromFile(f) <= version) {
      452. 
+
    452. 5                                var insert = {};
      453. 
+
    453. 5                                insert[c] = f;
      454. 
+
    454. 5                                inserts.push(ds.insert(insert));
      455. 
+
    455.                              }
      456. 
+
    456.                          }
      457. 
+
    457.                      }
      458. 
+
    458. 1                    if (inserts.length) {
      459. 
+
    459. 1                        when.apply(comb, inserts).then(ret);
      460. 
+
    460.                      } else {
      461. 
+
    461. 0                        ret.callback();
      462. 
+
    462.                      }
      463. 
+
    463.                  }), ret);
      464. 
+
    464.              }), ret);
      465. 
+
    465. 1            return ret.promise();
      466. 
 
    466.  
      467. 
-
    467.              firstSourceTable:function () {
      468. 
-
    468. 15                var source = this.__opts.from;
      469. 
-
    469. 15                if (isUndefinedOrNull(source) || !source.length) {
      470. 
-
    470. 1                    throw new QueryError("No source specified for the query");
      471. 
-
    471.                  }
      472. 
-
    472. 14                var source = source[0];
      473. 
-
    473. 14                if (isInstanceOf(source, AliasedExpression)) {
      474. 
-
    474. 3                    return source.expression;
      475. 
-
    475. 11                } else if (isString(source)) {
      476. 
-
    476. 0                    var parts = this._splitString(source);
      477. 
-
    477. 0                    return source;
      478. 
-
    478.                  } else {
      479. 
-
    479. 11                    return source;
      480. 
-
    480.                  }
      481. 
-
    481.              }
      482. 
 
    482.          },
      483. 
 
    483.  
      484. 
-
    484.          /**
      485. 
-
    485.           * @ignore
      486. 
-
    486.           **/
      487. 
-
    487.          setters:{
      488. 
-
    488.              /**@lends patio.Dataset.prototype*/
      489. 
-
    489.  
      490. 
-
    490.              identifierInputMethod:function (meth) {
      491. 
-
    491. 15364                this.__identifierInputMethod = meth;
      492. 
-
    492.              },
      493. 
-
    493.  
      494. 
-
    494.              identifierOutputMethod:function (meth) {
      495. 
-
    495. 15364                this.__identifierOutputMethod = meth;
      496. 
-
    496.              },
      497. 
-
    497.  
      498. 
-
    498.              rowCb:function (cb) {
      499. 
-
    499. 18890                if (isFunction(cb) || isNull(cb)) {
      500. 
-
    500. 18885                    this.__rowCb = cb;
      501. 
+
    501.          __createTable:function () {
      502. 
+
    502. 18            var c = this.column, table = this.table, db = this.db, intMigrationTable = IntegerMigrator.DEFAULT_SCHEMA_TABLE;
      503. 
+
    503. 18            var ds = this.db.from(table);
      504. 
+
    504. 18            var ret = new Promise();
      505. 
+
    505. 18            when(
      506. 
+
    506.                  db.tableExists(table),
      507. 
+
    507.                  db.tableExists(intMigrationTable)
      508. 
+
    508.              ).then(hitch(this, function (res) {
      509. 
+
    509. 18                var exists = res[0], intMigratorExists = res[1];
      510. 
+
    510. 18                if (!exists) {
      511. 
+
    511. 10                    db.createTable(table,
      512. 
+
    512.                          function () {
      513. 
+
    513. 10                            this.column(c, String, {primaryKey:true});
      514. 
+
    514.                          }).addErrback(ret);
      515. 
+
    515. 10                    if (intMigratorExists) {
      516. 
+
    516. 1                        db.from(intMigrationTable).all().then(hitch(this, function (versions) {
      517. 
+
    517. 1                            var version;
      518. 
+
    518. 1                            if (versions.length === 1 && (version = versions[0]) && isNumber(version[Object.keys(version)[0]])) {
      519. 
+
    519. 1                                this.__convertSchemaInfo().then(ret);
      520. 
+
    520.                              } else {
      521. 
+
    521. 0                                ret.callback();
      522. 
+
    522.                              }
      523. 
+
    523.                          }));
      524. 
+
    524.                      } else {
      525. 
+
    525. 9                        ret.callback();
      526. 
+
    526.                      }
      527. 
 
    527.                  } else {
      528. 
-
    528. 5                    throw new DatasetError("rowCb mus be a function");
      529. 
+
    529. 8                    ds.columns.then(hitch(this, function (columns) {
      530. 
+
    530. 8                        if (columns.indexOf(c) === -1) {
      531. 
+
    531. 0                            ret.errback(new MigrationError(format("Migration table %s does not contain column %s", table, c)));
      532. 
+
    532.                          } else {
      533. 
+
    533. 8                            ret.callback();
      534. 
+
    534.                          }
      535. 
+
    535.                      }), ret);
      536. 
 
    536.                  }
      537. 
-
    537.              }
      538. 
+
    538.              }), ret);
      539. 
+
    539. 18            return ret.promise();
      540. 
 
    540.          }
      541. 
 
    541.      },
      542. 
 
    542.  
      543. 
 
    543.      static:{
      544. 
-
    544.          COLUMN_REF_RE1:/^(\w+)__(\w+)___(\w+)$/,
      545. 
-
    545.          COLUMN_REF_RE2:/^(\w+)___(\w+)$/,
      546. 
-
    546.          COLUMN_REF_RE3:/^(\w+)__(\w+)$/
      547. 
+
    547.          DEFAULT_SCHEMA_COLUMN:"filename",
      548. 
+
    548.          DEFAULT_SCHEMA_TABLE:"schema_migrations"
      549. 
 
    549.      }
      550. 
-
    550.  }).as(module);
      551. 
+
    551.  }).as(exports, "TimestampMigrator");
      552. 
 
    552.  
      553. 
-
    553.
    +
  • 1exports.run = function () {
    • +
  • 31 return Migrator.run.apply(Migrator, arguments);
    • +
  • };
    • @@ -13876,7 +13892,7 @@
    Coverage92.86 - SLOC1683 + SLOC1684 LOC504 Missed36
    @@ -13884,44 +13900,45 @@ 
    1. 1var comb = require("comb"),
      2. 
-
    2.      define = comb.define,
      3. 
-
    3.      array = comb.array,
      4. 
-
    4.      intersect = array.intersect,
      5. 
-
    5.      compact = array.compact,
      6. 
-
    6.      string = comb.string,
      7. 
-
    7.      format = string.format,
      8. 
-
    8.      argsToArray = comb.argsToArray,
      9. 
-
    9.      isInstanceOf = comb.isInstanceOf,
      10. 
-
    10.      isArray = comb.isArray,
      11. 
-
    11.      isNumber = comb.isNumber,
      12. 
-
    12.      isDate = comb.isDate,
      13. 
-
    13.      isNull = comb.isNull,
      14. 
-
    14.      isBoolean = comb.isBoolean,
      15. 
-
    15.      isFunction = comb.isFunction,
      16. 
-
    16.      isUndefined = comb.isUndefined,
      17. 
-
    17.      isObject = comb.isObject,
      18. 
-
    18.      isHash = comb.isHash,
      19. 
-
    19.      merge = comb.merge,
      20. 
-
    20.      isUndefinedOrNull = comb.isUndefinedOrNull,
      21. 
-
    21.      isString = comb.isString,
      22. 
-
    22.      sql = require("../sql").sql,
      23. 
-
    23.      Expression = sql.Expression,
      24. 
-
    24.      ComplexExpression = sql.ComplexExpression,
      25. 
-
    25.      AliasedExpression = sql.AliasedExpression,
      26. 
-
    26.      Identifier = sql.Identifier,
      27. 
-
    27.      QualifiedIdentifier = sql.QualifiedIdentifier,
      28. 
-
    28.      OrderedExpression = sql.OrderedExpression,
      29. 
-
    29.      CaseExpression = sql.CaseExpression,
      30. 
-
    30.      SubScript = sql.SubScript,
      31. 
-
    31.      NumericExpression = sql.NumericExpression,
      32. 
-
    32.      ColumnAll = sql.ColumnAll,
      33. 
-
    33.      Cast = sql.Cast,
      34. 
-
    34.      StringExpression = sql.StringExpression,
      35. 
-
    35.      BooleanExpression = sql.BooleanExpression,
      36. 
-
    36.      SQLFunction = sql.SQLFunction,
      37. 
-
    37.      LiteralString = sql.LiteralString,
      38. 
-
    38.      PlaceHolderLiteralString = sql.PlaceHolderLiteralString,
      39. 
-
    39.      QueryError = require("../errors").QueryError, patio;
      40. 
+
    40.          define = comb.define,
      41. 
+
    41.          array = comb.array,
      42. 
+
    42.          intersect = array.intersect,
      43. 
+
    43.          compact = array.compact,
      44. 
+
    44.          string = comb.string,
      45. 
+
    45.          format = string.format,
      46. 
+
    46.          argsToArray = comb.argsToArray,
      47. 
+
    47.          isInstanceOf = comb.isInstanceOf,
      48. 
+
    48.          isArray = comb.isArray,
      49. 
+
    49.          isNumber = comb.isNumber,
      50. 
+
    50.          isDate = comb.isDate,
      51. 
+
    51.          isNull = comb.isNull,
      52. 
+
    52.          isBoolean = comb.isBoolean,
      53. 
+
    53.          isFunction = comb.isFunction,
      54. 
+
    54.          isUndefined = comb.isUndefined,
      55. 
+
    55.          isObject = comb.isObject,
      56. 
+
    56.          isHash = comb.isHash,
      57. 
+
    57.          isEmpty = comb.isEmpty,
      58. 
+
    58.          merge = comb.merge,
      59. 
+
    59.          isUndefinedOrNull = comb.isUndefinedOrNull,
      60. 
+
    60.          isString = comb.isString,
      61. 
+
    61.          sql = require("../sql").sql,
      62. 
+
    62.          Expression = sql.Expression,
      63. 
+
    63.          ComplexExpression = sql.ComplexExpression,
      64. 
+
    64.          AliasedExpression = sql.AliasedExpression,
      65. 
+
    65.          Identifier = sql.Identifier,
      66. 
+
    66.          QualifiedIdentifier = sql.QualifiedIdentifier,
      67. 
+
    67.          OrderedExpression = sql.OrderedExpression,
      68. 
+
    68.          CaseExpression = sql.CaseExpression,
      69. 
+
    69.          SubScript = sql.SubScript,
      70. 
+
    70.          NumericExpression = sql.NumericExpression,
      71. 
+
    71.          ColumnAll = sql.ColumnAll,
      72. 
+
    72.          Cast = sql.Cast,
      73. 
+
    73.          StringExpression = sql.StringExpression,
      74. 
+
    74.          BooleanExpression = sql.BooleanExpression,
      75. 
+
    75.          SQLFunction = sql.SQLFunction,
      76. 
+
    76.          LiteralString = sql.LiteralString,
      77. 
+
    77.          PlaceHolderLiteralString = sql.PlaceHolderLiteralString,
      78. 
+
    78.          QueryError = require("../errors").QueryError, patio;
      79. 
 
    79.  
      80. 
 
    80. 1var Dataset;
      81. 
 
    81.  
      82. 
@@ -13985,9 +14002,9 @@
 
    82.          constructor:function () {
      83. 
 
    83.              //We initialize these here because otherwise
      84. 
 
    84.              //the will be blank because of recursive dependencies.
      85. 
-
    85. 29542            !patio && (patio = require("../index"));
      86. 
-
    86. 29542            !Dataset && (Dataset = patio.Dataset);
      87. 
-
    87. 29542            this._super(arguments);
      88. 
+
    88. 29216            !patio && (patio = require("../index"));
      89. 
+
    89. 29216            !Dataset && (Dataset = patio.Dataset);
      90. 
+
    90. 29216            this._super(arguments);
      91. 
 
    91.          },
      92. 
 
    92.  
      93. 
 
    93.          /**
      94. 
@@ -14272,15 +14289,15 @@
 
    94.           * @return {String} a literal representation of the value.
      95. 
 
    95.           */
      96. 
 
    96.          literal:function (v) {
      97. 
-
    97. 44748            if (isInstanceOf(v, LiteralString)) {
      98. 
+
    98. 44422            if (isInstanceOf(v, LiteralString)) {
      99. 
 
    99. 204                return "" + v;
      100. 
-
    100. 44544            } else if (isString(v)) {
      101. 
+
    101. 44218            } else if (isString(v)) {
      102. 
 
    102. 6110                return this._literalString(v);
      103. 
-
    103. 38434            } else if (isNumber(v)) {
      104. 
+
    104. 38108            } else if (isNumber(v)) {
      105. 
 
    105. 6997                return this._literalNumber(v);
      106. 
 
    106.              }
      107. 
-
    107. 31437            else if (isInstanceOf(v, Expression)) {
      108. 
-
    108. 28903                return this._literalExpression(v);
      109. 
+
    109. 31111            else if (isInstanceOf(v, Expression)) {
      110. 
+
    110. 28577                return this._literalExpression(v);
      111. 
 
    111.              }
      112. 
 
    112. 2534            else if (isInstanceOf(v, Dataset)) {
      113. 
 
    113. 104                return this._literalDataset(v);
      114. 
@@ -14332,7 +14349,7 @@
 
    114. 59                return new QualifiedIdentifier(table, e);
      115. 
 
    115. 217            } else if (isInstanceOf(e, OrderedExpression)) {
      116. 
 
    116. 2                return new OrderedExpression(this._qualifiedExpression(e.expression, table), e.descending,
      117. 
-
    117.                      {nulls:e.nulls});
      118. 
+
    118.                          {nulls:e.nulls});
      119. 
 
    119. 215            } else if (isInstanceOf(e, AliasedExpression)) {
      120. 
 
    120. 72                return new AliasedExpression(this._qualifiedExpression(e.expression, table), e.alias);
      121. 
 
    121. 143            } else if (isInstanceOf(e, CaseExpression)) {
      122. 
@@ -14500,9 +14517,9 @@
 
    122. 1440            var columns = this.__opts.columns, ret = "";
      123. 
 
    123. 1440            if (columns && columns.length) {
      124. 
 
    124. 1387                ret = " (" + columns.map(
      125. 
-
    125.                      function (c) {
      126. 
-
    126. 6691                        return c.toString(this);
      127. 
-
    127.                      }, this).join(this._static.COMMA_SEPARATOR) + ")";
      128. 
+
    128.                          function (c) {
      129. 
+
    129. 6691                            return c.toString(this);
      130. 
+
    130.                          }, this).join(this._static.COMMA_SEPARATOR) + ")";
      131. 
 
    131.              }
      132. 
 
    132. 1440            return ret;
      133. 
 
    133.          },
      134. 
@@ -14592,7 +14609,7 @@
 
    134.           * SQL fragment for specifying all columns in a given table
      135. 
 
    135.           **/
      136. 
 
    136.          columnAllSql:function (ca) {
      137. 
-
    137. 345            return  string.format("%s.*", this.quoteSchemaTable(ca.table));
      138. 
+
    138. 19            return  string.format("%s.*", this.quoteSchemaTable(ca.table));
      139. 
 
    139.          },
      140. 
 
    140.  
      141. 
 
    141.          /**
      142. 
@@ -14614,8 +14631,8 @@
 
    142. 0                    return this.complexExpressionSql("EQ", args);
      143. 
 
    143.                  } else {
      144. 
 
    144. 0                    return this.complexExpressionSql("OR",
      145. 
-
    145.                          [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0],
      146. 
-
    146.                              null)]);
      147. 
+
    147.                              [BooleanExpression.fromArgs(["NEQ"].concat(args)), new BooleanExpression("IS", args[0],
      148. 
+
    148.                                      null)]);
      149. 
 
    149.                  }
      150. 
 
    150.  
      151. 
 
    151. 6454            } else if (["IN", "NOTIN"].indexOf(op) != -1) {
      152. 
@@ -14646,8 +14663,8 @@
 
    152.                          //literal so that if values is an array of two element arrays, it
      153. 
 
    153.                          //will be treated as a value list instead of a condition specifier.
      154. 
 
    154. 4                        return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols),
      155. 
-
    155.                              ComplexExpression.IN_OPERATORS[op],
      156. 
-
    156.                              valArray ? this._arraySql(vals) : this.literal(vals));
      157. 
+
    157.                                  ComplexExpression.IN_OPERATORS[op],
      158. 
+
    158.                                  valArray ? this._arraySql(vals) : this.literal(vals));
      159. 
 
    159.                      }
      160. 
 
    160.                  }
      161. 
 
    161.                  else {
      162. 
@@ -14661,13 +14678,13 @@
 
    162.                          }
      163. 
 
    163.                      } else {
      164. 
 
    164. 10                        return format("(%s %s %s)", isString(cols) ? cols : this.literal(cols),
      165. 
-
    165.                              ComplexExpression.IN_OPERATORS[op], this.literal(vals));
      166. 
+
    166.                                  ComplexExpression.IN_OPERATORS[op], this.literal(vals));
      167. 
 
    167.                      }
      168. 
 
    168.                  }
      169. 
 
    169. 6437            } else if ((newOp = this._static.TWO_ARITY_OPERATORS[op]) != null) {
      170. 
 
    170. 5427                var l = args[0];
      171. 
 
    171. 5427                return format("(%s %s %s)", isString(l) ? l : this.literal(l), newOp,
      172. 
-
    172.                      this.literal(args[1]));
      173. 
+
    173.                          this.literal(args[1]));
      174. 
 
    174. 1010            } else if ((newOp = this._static.N_ARITY_OPERATORS[op]) != null) {
      175. 
 
    175. 976                return string.format("(%s)", args.map(this.literal, this).join(" " + newOp + " "));
      176. 
 
    176. 34            } else if (op == "NOT") {
      177. 
@@ -14710,7 +14727,7 @@
 
    177.              }
      178. 
 
    178. 925            var tref = this.__tableRef(table);
      179. 
 
    179. 925            return string.format(" %s %s", this._joinTypeSql(jc.joinType),
      180. 
-
    180.                  tableAlias ? this.__asSql(tref, tableAlias) : tref);
      181. 
+
    181.                      tableAlias ? this.__asSql(tref, tableAlias) : tref);
      182. 
 
    182.          },
      183. 
 
    183.  
      184. 
 
    184.          /**
      185. 
@@ -14783,11 +14800,11 @@
 
    185.           */
      186. 
 
    186.          qualifiedIdentifierSql:function (qcr) {
      187. 
 
    187. 4532            return [qcr.table, qcr.column].map(
      188. 
-
    188.                  function (x) {
      189. 
-
    189. 9064                    return [QualifiedIdentifier, Identifier, String].some(function (c) {
      190. 
-
    190. 25671                        return x instanceof c
      191. 
-
    191.                      }) ? this.literal(x) : this.quoteIdentifier(x)
      192. 
-
    192.                  }, this).join('.');
      193. 
+
    193.                      function (x) {
      194. 
+
    194. 9064                        return [QualifiedIdentifier, Identifier, String].some(function (c) {
      195. 
+
    195. 25671                            return x instanceof c
      196. 
+
    196.                          }) ? this.literal(x) : this.quoteIdentifier(x)
      197. 
+
    197.                      }, this).join('.');
      198. 
 
    198.          },
      199. 
 
    199.  
      200. 
 
    200.          /**
      201. 
@@ -14798,18 +14815,18 @@
 
    201.           * quote the name with {@link patio.dataset._Sql#_quotedIdentifier}.
      202. 
 
    202.           */
      203. 
 
    203.          quoteIdentifier:function (name) {
      204. 
-
    204. 34093            if (isInstanceOf(name, LiteralString)) {
      205. 
+
    205. 33767            if (isInstanceOf(name, LiteralString)) {
      206. 
 
    206. 260                return name;
      207. 
 
    207.              } else {
      208. 
-
    208. 33833                if (isInstanceOf(name, Identifier)) {
      209. 
+
    209. 33507                if (isInstanceOf(name, Identifier)) {
      210. 
 
    210. 22237                    name = name.value;
      211. 
 
    211.                  }
      212. 
-
    212. 33833                name = this.inputIdentifier(name);
      213. 
-
    213. 33833                if (this.quoteIdentifiers) {
      214. 
-
    214. 26623                    name = this._quotedIdentifier(name)
      215. 
+
    215. 33507                name = this.inputIdentifier(name);
      216. 
+
    216. 33507                if (this.quoteIdentifiers) {
      217. 
+
    217. 26311                    name = this._quotedIdentifier(name)
      218. 
 
    218.                  }
      219. 
 
    219.              }
      220. 
-
    220. 33833            return name;
      221. 
+
    221. 33507            return name;
      222. 
 
    222.          },
      223. 
 
    223.  
      224. 
 
    224.          /**
      225. 
@@ -14819,15 +14836,15 @@
 
    225.           * identifierOutputMethod.
      226. 
 
    226.           */
      227. 
 
    227.          inputIdentifier:function (v) {
      228. 
-
    228. 34019            var i = this.__identifierInputMethod;
      229. 
-
    229. 34019            v = v.toString(this);
      230. 
-
    230. 34019            return !isUndefinedOrNull(i) ?
      231. 
-
    231.                  isFunction(v[i]) ?
      232. 
-
    232.                      v[i]() :
      233. 
-
    233.                      isFunction(comb[i]) ?
      234. 
-
    234.                          comb[i](v)
      235. 
-
    235.                          : v
      236. 
-
    236.                  : v;
      237. 
+
    237. 33693            var i = this.__identifierInputMethod;
      238. 
+
    238. 33693            v = v.toString(this);
      239. 
+
    239. 33693            return !isUndefinedOrNull(i) ?
      240. 
+
    240.                      isFunction(v[i]) ?
      241. 
+
    241.                              v[i]() :
      242. 
+
    242.                              isFunction(comb[i]) ?
      243. 
+
    243.                                      comb[i](v)
      244. 
+
    244.                                      : v
      245. 
+
    245.                      : v;
      246. 
 
    246.          },
      247. 
 
    247.  
      248. 
 
    248.          /**
      249. 
@@ -14837,15 +14854,15 @@
 
    249.           * identifierOutputMethod.
      250. 
 
    250.           */
      251. 
 
    251.          outputIdentifier:function (v) {
      252. 
-
    252. 19523            (v == '' && (v = 'untitled'));
      253. 
-
    253. 19523            var i = this.__identifierOutputMethod;
      254. 
-
    254. 19523            return !isUndefinedOrNull(i) ?
      255. 
-
    255.                  isFunction(v[i]) ?
      256. 
-
    256.                      v[i]() :
      257. 
-
    257.                      isFunction(comb[i]) ?
      258. 
-
    258.                          comb[i](v)
      259. 
-
    259.                          : v
      260. 
-
    260.                  : v;
      261. 
+
    261. 19885            (v == '' && (v = 'untitled'));
      262. 
+
    262. 19885            var i = this.__identifierOutputMethod;
      263. 
+
    263. 19885            return !isUndefinedOrNull(i) ?
      264. 
+
    264.                      isFunction(v[i]) ?
      265. 
+
    265.                              v[i]() :
      266. 
+
    266.                              isFunction(comb[i]) ?
      267. 
+
    267.                                      comb[i](v)
      268. 
+
    268.                                      : v
      269. 
+
    269.                      : v;
      270. 
 
    270.          },
      271. 
 
    271.  
      272. 
 
    272.          /**
      273. 
@@ -14855,10 +14872,10 @@
 
    273.           * quoted (if quoting identifiers)
      274. 
 
    274.           */
      275. 
 
    275.          quoteSchemaTable:function (table) {
      276. 
-
    276. 2557            var parts = this.schemaAndTable(table);
      277. 
-
    277. 2557            var schema = parts[0];
      278. 
-
    278. 2557            table = parts[1];
      279. 
-
    279. 2557            return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
      280. 
+
    280. 2231            var parts = this.schemaAndTable(table);
      281. 
+
    281. 2231            var schema = parts[0];
      282. 
+
    282. 2231            table = parts[1];
      283. 
+
    283. 2231            return string.format("%s%s", schema ? this.quoteIdentifier(schema) + "." : "", this.quoteIdentifier(table));
      284. 
 
    284.          },
      285. 
 
    285.  
      286. 
 
    286.  
      287. 
@@ -14867,15 +14884,15 @@
 
    287.           * Split the schema information from the table
      288. 
 
    288.           */
      289. 
 
    289.          schemaAndTable:function (tableName) {
      290. 
-
    290. 2801            var sch = this.db ? this.db.defaultSchema || null : null;
      291. 
-
    291. 2801            if (isString(tableName)) {
      292. 
+
    292. 2475            var sch = this.db ? this.db.defaultSchema || null : null;
      293. 
+
    293. 2475            if (isString(tableName)) {
      294. 
 
    294. 1008                var parts = this._splitString(tableName);
      295. 
 
    295. 1008                var s = parts[0], table = parts[1];
      296. 
 
    296. 1008                return [s || sch, table];
      297. 
-
    297. 1793            } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
      298. 
+
    298. 1467            } else if (isInstanceOf(tableName, QualifiedIdentifier)) {
      299. 
 
    299. 3                return [tableName.table, tableName.column]
      300. 
-
    300. 1790            } else if (isInstanceOf(tableName, Identifier)) {
      301. 
-
    301. 1790                return [null, tableName.value];
      302. 
+
    302. 1464            } else if (isInstanceOf(tableName, Identifier)) {
      303. 
+
    303. 1464                return [null, tableName.value];
      304. 
 
    304.              } else {
      305. 
 
    305. 0                throw new QueryError("table should be a QualifiedIdentifier, Identifier, or String");
      306. 
 
    306.              }
      307. 
@@ -14924,7 +14941,7 @@
 
    307.           * expressions.
      308. 
 
    308.           */
      309. 
 
    309.          __expressionList:function (columns) {
      310. 
-
    310. 4610            return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
      311. 
+
    311. 4284            return columns.map(this.literal, this).join(this._static.COMMA_SEPARATOR);
      312. 
 
    312.          },
      313. 
 
    313.  
      314. 
 
    314.          //Format the timestamp based on the default_timestamp_format, with a couple
      315. 
@@ -14941,9 +14958,9 @@
 
    315.           */
      316. 
 
    316.          _joinTypeSql:function (joinType) {
      317. 
 
    317. 922            return (joinType || "").replace(/([a-z]+)|([A-Z][a-z]+)/g,
      318. 
-
    318.                  function (m) {
      319. 
-
    319. 1127                    return m.toUpperCase() + " ";
      320. 
-
    320.                  }
      321. 
+
    321.                      function (m) {
      322. 
+
    322. 1127                        return m.toUpperCase() + " ";
      323. 
+
    323.                      }
      324. 
 
    324.              ).trimRight() + " JOIN";
      325. 
 
    325.          },
      326. 
 
    326.  
      327. 
@@ -15046,7 +15063,7 @@
 
    327.           * @return SQL fragment for SQL::Expression, result depends on the specific type of expression.
      328. 
 
    328.           * */
      329. 
 
    329.          _literalExpression:function (v) {
      330. 
-
    330. 28913            return v.toString(this);
      331. 
+
    331. 28587            return v.toString(this);
      332. 
 
    332.          },
      333. 
 
    333.  
      334. 
 
    334.          /**
      335. 
@@ -15069,10 +15086,10 @@
 
    335. 6059            var table = parts[0], column = parts[1], alias = parts[2];
      336. 
 
    336. 6059            if (!alias) {
      337. 
 
    337. 6059                return column && table ? this._literalExpression(QualifiedIdentifier.fromArgs([table, column])) : "'"
      338. 
-
    338.                      + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'"
      339. 
+
    339.                          + v.replace(/\\/g, "\\\\").replace(/'/g, "''") + "'"
      340. 
 
    340.              } else {
      341. 
 
    341. 0                return this.literal(new AliasedExpression(column
      342. 
-
    342.                      && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias));
      343. 
+
    343.                          && table ? QualifiedIdentifier.fromArgs([table, column]) : new Identifier(column), alias));
      344. 
 
    344.              }
      345. 
 
    345.          },
      346. 
 
    346.  
      347. 
@@ -15365,9 +15382,9 @@
 
    347. 0                throw new QueryError("No source specified for the query");
      348. 
 
    348.              }
      349. 
 
    349. 6657            return " " + source.map(
      350. 
-
    350.                  function (s) {
      351. 
-
    351. 6971                    return this.__tableRef(s);
      352. 
-
    352.                  }, this).join(this._static.COMMA_SEPARATOR);
      353. 
+
    353.                      function (s) {
      354. 
+
    354. 6971                        return this.__tableRef(s);
      355. 
+
    355.                      }, this).join(this._static.COMMA_SEPARATOR);
      356. 
 
    356.          },
      357. 
 
    357.  
      358. 
 
    358.          /**
      359. 
@@ -15712,7 +15729,7 @@
 
    359.               * @type String
      360. 
 
    360.               */
      361. 
 
    361.              identifierInputMethod:function () {
      362. 
-
    362. 15364                return this.__identifierInputMethod;
      363. 
+
    363. 15038                return this.__identifierInputMethod;
      364. 
 
    364.              },
      365. 
 
    365.  
      366. 
 
    366.              /**
      367. 
@@ -15724,7 +15741,7 @@
 
    367.               * @type String
      368. 
 
    368.               */
      369. 
 
    369.              identifierOutputMethod:function () {
      370. 
-
    370. 15364                return this.__identifierOutputMethod;
      371. 
+
    371. 15038                return this.__identifierOutputMethod;
      372. 
 
    372.              },
      373. 
 
    373.  
      374. 
 
    374.              /**
      375. 
@@ -15737,7 +15754,7 @@
 
    375.               * @default true
      376. 
 
    376.               */
      377. 
 
    377.              quoteIdentifiers:function () {
      378. 
-
    378. 15330                return this.__quoteIdentifiers;
      379. 
+
    379. 15004                return this.__quoteIdentifiers;
      380. 
 
    380.              }
      381. 
 
    381.          },
      382. 
 
    382.  
      383. 
@@ -15880,10 +15897,10 @@
 
    383.  
      384. 
 
    384.          /**@ignore*/
      385. 
 
    385.          constructor:function () {
      386. 
-
    386. 29542            if (!Dataset) {
      387. 
+
    387. 29216            if (!Dataset) {
      388. 
 
    388. 1                Dataset = require("../index").Dataset;
      389. 
 
    389.              }
      390. 
-
    390. 29542            this._super(arguments);
      391. 
+
    391. 29216            this._super(arguments);
      392. 
 
    392.          },
      393. 
 
    393.  
      394. 
 
    394.  
      395. 
@@ -15913,7 +15930,7 @@
 
    395. 2734            var a = [];
      396. 
 
    396. 2734            var ret = new Promise().classic(cb);
      397. 
 
    397. 2734            this.forEach(hitch(this, function (r) {
      398. 
-
    398. 2934                a.push(r);
      399. 
+
    399. 2947                a.push(r);
      400. 
 
    400.              })).then(hitch(this, function () {
      401. 
 
    401. 2731                this.postLoad(a);
      402. 
 
    402. 2731                if (block) {
      403. 
@@ -17159,10 +17176,10 @@
 
    403.           *
      404. 
 
    404.           */
      405. 
 
    405.          constructor:function () {
      406. 
-
    406. 3111            if (comb.isUndefinedOrNull(this.__associations)) {
      407. 
-
    407. 3002                this.__associations = {};
      408. 
+
    408. 3107            if (comb.isUndefinedOrNull(this.__associations)) {
      409. 
+
    409. 3000                this.__associations = {};
      410. 
 
    410.              }
      411. 
-
    411. 3111            this._super(arguments);
      412. 
+
    412. 3107            this._super(arguments);
      413. 
 
    413.          },
      414. 
 
    414.  
      415. 
 
    415.          reload:function () {
      416. 
@@ -18089,240 +18106,29 @@
 
    416.           * });
      417. 
 
    417.           * }
      418. 
 
    418.           *
      419. 
-
    419.           *
      420. 
-
    420.           * @param {String|Function} name the name of the column, or a callback that accepts a function to create validators.
      421. 
-
    421.           *
      422. 
-
    422.           * @throws {patio.ModelError} if name is not a function or string.
      423. 
-
    423.           * @return {patio.Model|Validator} returns a validator if name is a string, other wise returns this for chaining.
      424. 
-
    424.           */
      425. 
-
    425.          validate:function (name) {
      426. 
-
    426. 41            this.__initValidation();
      427. 
-
    427. 41            var ret;
      428. 
-
    428. 41            if (isFunction(name)) {
      429. 
-
    429. 1                name.apply(this, [this.__getValidator.bind(this)]);
      430. 
-
    430. 1                ret = this;
      431. 
-
    431. 40            } else if (isString(name)) {
      432. 
-
    432. 40                ret = this.__getValidator(name);
      433. 
-
    433.              } else {
      434. 
-
    434. 0                throw new ModelError("name is must be a string or function when validating");
      435. 
-
    435.              }
      436. 
-
    436. 41            return ret;
      437. 
-
    437.          }
      438. 
-
    438.      }
      439. 
-
    439.  
      440. 
-
    440.  }).as(module);
      441. 
-
    441.
    -
    - -
    - - - - - -
    -
    database/logging.js
    -     		-
    - Coverage97.96 - SLOC193 - LOC49 - Missed1 -
    -
    - 
    1. 1var comb = require("comb"),
      2. 
-
    2.      define = comb.define,
      3. 
-
    3.      Promise = comb.Promise,
      4. 
-
    4.      isFunction = comb.isFunction,
      5. 
-
    5.      logging = comb.logging,
      6. 
-
    6.      Logger = logging.Logger,
      7. 
-
    7.      hitch = comb.hitch,
      8. 
-
    8.      format = comb.string.format,
      9. 
-
    9.      QueryError = require("../errors").QueryError;
      10. 
-
    10.  
      11. 
-
    11.  
      12. 
-
    12. 1var LOGGER = Logger.getLogger("patio.Database");
      13. 
-
    13.  
      14. 
-
    14. 1define(null, {
      15. 
-
    15.      instance:{
      16. 
-
    16.          /**@lends patio.Database.prototype*/
      17. 
-
    17.  
      18. 
-
    18.          /**
      19. 
-
    19.           * Logs an INFO level message to the "patio.Database" logger.
      20. 
-
    20.           */
      21. 
-
    21.          logInfo:function () {
      22. 
-
    22. 8337            if (LOGGER.isInfo) {
      23. 
-
    23. 8337                LOGGER.info.apply(LOGGER, arguments);
      24. 
-
    24.              }
      25. 
-
    25.          },
      26. 
-
    26.  
      27. 
-
    27.          /**
      28. 
-
    28.           * Logs a DEBUG level message to the "patio.Database" logger.
      29. 
-
    29.           */
      30. 
-
    30.          logDebug:function () {
      31. 
-
    31. 8027            if (LOGGER.isDebug) {
      32. 
-
    32. 8027                LOGGER.debug.apply(LOGGER, arguments);
      33. 
-
    33.              }
      34. 
-
    34.          },
      35. 
-
    35.  
      36. 
-
    36.          /**
      37. 
-
    37.           * Logs an ERROR level message to the "patio.Database" logger.
      38. 
-
    38.           */
      39. 
-
    39.          logError:function (error) {
      40. 
-
    40. 75            if (LOGGER.isError) {
      41. 
-
    41. 75                LOGGER.error.apply(LOGGER, arguments);
      42. 
-
    42.              }
      43. 
-
    43.          },
      44. 
-
    44.  
      45. 
-
    45.          /**
      46. 
-
    46.           * Logs a WARN level message to the "patio.Database" logger.
      47. 
-
    47.           */
      48. 
-
    48.          logWarn:function () {
      49. 
-
    49. 1            if (LOGGER.isWarn) {
      50. 
-
    50. 1                LOGGER.warn.apply(LOGGER, arguments);
      51. 
-
    51.              }
      52. 
-
    52.          },
      53. 
-
    53.  
      54. 
-
    54.          /**
      55. 
-
    55.           * Logs a TRACE level message to the "patio.Database" logger.
      56. 
-
    56.           */
      57. 
-
    57.          logTrace:function () {
      58. 
-
    58. 1            if (LOGGER.isTrace) {
      59. 
-
    59. 1                LOGGER.trace.apply(LOGGER, arguments);
      60. 
-
    60.              }
      61. 
-
    61.          },
      62. 
-
    62.  
      63. 
-
    63.          /**
      64. 
-
    64.           * Logs a FATAL level message to the "patio.Database" logger.
      65. 
-
    65.           */
      66. 
-
    66.          logFatal:function () {
      67. 
-
    67. 1            if (LOGGER.isFatal) {
      68. 
-
    68. 1                LOGGER.fatal.apply(LOGGER, arguments);
      69. 
-
    69.              }
      70. 
-
    70.          },
      71. 
-
    71.  
      72. 
-
    72.          /* Yield to the block, logging any errors at error level to all loggers,
      73. 
-
    73.           * and all other queries with the duration at warn or info level.
      74. 
-
    74.           * */
      75. 
-
    75.          __logAndExecute:function (sql, args, cb) {
      76. 
-
    76. 8101            if (isFunction(args)) {
      77. 
-
    77. 8100                cb = args;
      78. 
-
    78. 8100                args = null;
      79. 
-
    79.              }
      80. 
-
    80.  
      81. 
-
    81. 8101            if (args) {
      82. 
-
    82. 0                sql = format("%s; %j", sql, args);
      83. 
-
    83.              }
      84. 
-
    84. 8101            sql = sql.trim();
      85. 
-
    85. 8101            var start = new Date();
      86. 
-
    86. 8101            var ret = new Promise();
      87. 
-
    87. 8101            if (isFunction(cb)) {
      88. 
-
    88. 8100                this.logInfo("Executing; %s", sql);
      89. 
-
    89. 8100                cb().then(hitch(this, function () {
      90. 
-
    90. 8026                    this.logDebug("Duration: % 6dms; %s", new Date() - start, sql);
      91. 
-
    91. 8026                    ret.callback.apply(ret, arguments);
      92. 
-
    92.                  }), hitch(this, function (err) {
      93. 
-
    93. 74                    err = new QueryError(format("%s: %s", err.message, sql));
      94. 
-
    94. 74                    this.logError(err);
      95. 
-
    95. 74                    ret.errback.apply(ret, [err]);
      96. 
-
    96.                  }));
      97. 
-
    97.              } else {
      98. 
-
    98. 1                throw new QueryError("CB is required");
      99. 
-
    99.              }
      100. 
-
    100. 8100            return ret.promise();
      101. 
-
    101.          },
      102. 
-
    102.  
      103. 
-
    103.          /*Log the given SQL and then execute it on the connection, used by
      104. 
-
    104.           *the transaction code.
      105. 
-
    105.           * */
      106. 
-
    106.          __logConnectionExecute:function (conn, sql) {
      107. 
-
    107. 2079            return this.__logAndExecute(sql, hitch(this, function () {
      108. 
-
    108. 2079                return conn[this.connectionExecuteMethod](sql);
      109. 
-
    109.              }));
      110. 
-
    110.          },
      111. 
-
    111.  
      112. 
-
    112.  
      113. 
-
    113.          getters:{
      114. 
-
    114.              /**@lends patio.Database.prototype*/
      115. 
-
    115.              /**
      116. 
-
    116.               * The "patio.Database" logger.
      117. 
-
    117.               * @field
      118. 
-
    118.               */
      119. 
-
    119.              logger:function () {
      120. 
-
    120. 2                return LOGGER;
      121. 
-
    121.              }
      122. 
-
    122.          }
      123. 
-
    123.      },
      124. 
-
    124.  
      125. 
-
    125.      "static":{
      126. 
-
    126.          /**@lends patio.Database*/
      127. 
-
    127.          /**
      128. 
-
    128.           * Logs an INFO level message to the "patio.Database" logger.
      129. 
-
    129.           */
      130. 
-
    130.          logInfo:function () {
      131. 
-
    131. 1            if (LOGGER.isInfo) {
      132. 
-
    132. 1                LOGGER.info.apply(LOGGER, arguments);
      133. 
-
    133.              }
      134. 
-
    134.          },
      135. 
-
    135.  
      136. 
-
    136.          /**
      137. 
-
    137.           * Logs a DEBUG level message to the "patio.Database" logger.
      138. 
-
    138.           */
      139. 
-
    139.          logDebug:function () {
      140. 
-
    140. 1            if (LOGGER.isDebug) {
      141. 
-
    141. 1                LOGGER.debug.apply(LOGGER, arguments);
      142. 
-
    142.              }
      143. 
-
    143.          },
      144. 
-
    144.  
      145. 
-
    145.          /**
      146. 
-
    146.           * Logs a ERROR level message to the "patio.Database" logger.
      147. 
-
    147.           */
      148. 
-
    148.          logError:function () {
      149. 
-
    149. 1            if (LOGGER.isError) {
      150. 
-
    150. 1                LOGGER.error.apply(LOGGER, arguments);
      151. 
-
    151.              }
      152. 
-
    152.          },
      153. 
-
    153.  
      154. 
-
    154.          /**
      155. 
-
    155.           * Logs a WARN level message to the "patio.Database" logger.
      156. 
-
    156.           */
      157. 
-
    157.          logWarn:function () {
      158. 
-
    158. 1            if (LOGGER.isWarn) {
      159. 
-
    159. 1                LOGGER.warn.apply(LOGGER, arguments);
      160. 
-
    160.              }
      161. 
-
    161.          },
      162. 
-
    162.  
      163. 
-
    163.          /**
      164. 
-
    164.           * Logs a TRACE level message to the "patio.Database" logger.
      165. 
-
    165.           */
      166. 
-
    166.          logTrace:function () {
      167. 
-
    167. 1            if (LOGGER.isTrace) {
      168. 
-
    168. 1                LOGGER.trace.apply(LOGGER, arguments);
      169. 
-
    169.              }
      170. 
-
    170.          },
      171. 
-
    171.  
      172. 
-
    172.          /**
      173. 
-
    173.           * Logs a FATAL level message to the "patio.Database" logger.
      174. 
+
    174.           *
      175. 
+
    175.           * @param {String|Function} name the name of the column, or a callback that accepts a function to create validators.
      176. 
+
    176.           *
      177. 
+
    177.           * @throws {patio.ModelError} if name is not a function or string.
      178. 
+
    178.           * @return {patio.Model|Validator} returns a validator if name is a string, other wise returns this for chaining.
      179. 
 
    179.           */
      180. 
-
    180.          logFatal:function () {
      181. 
-
    181. 1            if (LOGGER.isFatal) {
      182. 
-
    182. 1                LOGGER.fatal.apply(LOGGER, arguments);
      183. 
-
    183.              }
      184. 
-
    184.          },
      185. 
-
    185.  
      186. 
-
    186.          getters:{
      187. 
-
    187.              /**@lends patio.Database*/
      188. 
-
    188.              /**
      189. 
-
    189.               * The "patio.Database" logger.
      190. 
-
    190.               * @field
      191. 
-
    191.               */
      192. 
-
    192.              logger:function () {
      193. 
-
    193. 1                return LOGGER;
      194. 
+
    194.          validate:function (name) {
      195. 
+
    195. 41            this.__initValidation();
      196. 
+
    196. 41            var ret;
      197. 
+
    197. 41            if (isFunction(name)) {
      198. 
+
    198. 1                name.apply(this, [this.__getValidator.bind(this)]);
      199. 
+
    199. 1                ret = this;
      200. 
+
    200. 40            } else if (isString(name)) {
      201. 
+
    201. 40                ret = this.__getValidator(name);
      202. 
+
    202.              } else {
      203. 
+
    203. 0                throw new ModelError("name is must be a string or function when validating");
      204. 
 
    204.              }
      205. 
+
    205. 41            return ret;
      206. 
 
    206.          }
      207. 
 
    207.      }
      208. 
 
    208.  
      209. 
-
    209.  }).as(module);
    +
  • }).as(module);
    • +
    • @@ -18333,10 +18139,10 @@
    - Coverage98.84 - SLOC2136 - LOC431 - Missed5 + Coverage97.71 + SLOC2160 + LOC436 + Missed10
    @@ -18401,17 +18207,17 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29542 this._super(arguments);
    • -
  • 29542 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 206794 if (!this[type + "Join"]) {
    • -
  • 206794 this[type + "Join"] = conditionedJoin.bind(this, type);
    • +
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29216 this._super(arguments);
    • +
  • 29216 this._static.CONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 204512 if (!this[type + "Join"]) {
    • +
  • 204512 this[type + "Join"] = conditionedJoin.bind(this, type);
  • }
  • }, this);
    • -
  • 29542 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • -
  • 147710 if (!this[type + "Join"]) {
    • -
  • 147710 this[type + "Join"] = unConditionJoin.bind(this, type);
    • +
  • 29216 this._static.UNCONDITIONED_JOIN_TYPES.forEach(function (type) {
    • +
  • 146080 if (!this[type + "Join"]) {
    • +
  • 146080 this[type + "Join"] = unConditionJoin.bind(this, type);
  • }
  • }, this);
    • @@ -19823,29 +19629,29 @@
  • * @return {patio.Dataset} a cloned dataset with the columns selected changed.
  • */
  • select:function (args) {
    • -
  • 861 args = flatten(argsToArray(arguments));
    • -
  • 861 var columns = [];
    • -
  • 861 args.forEach(function (c) {
    • -
  • 1281 if (isFunction(c)) {
    • +
  • 535 args = flatten(argsToArray(arguments));
    • +
  • 535 var columns = [];
    • +
  • 535 args.forEach(function (c) {
    • +
  • 955 if (isFunction(c)) {
  • 23 var res = c.apply(sql, [sql]);
  • 23 columns = columns.concat(isArray(res) ? res : [res]);
  • } else {
    • -
  • 1258 columns.push(c);
    • +
  • 932 columns.push(c);
  • }
  • });
    • -
  • 861 var select = [];
    • -
  • 861 columns.forEach(function (c) {
    • -
  • 1284 if (isHash(c)) {
    • +
  • 535 var select = [];
    • +
  • 535 columns.forEach(function (c) {
    • +
  • 958 if (isHash(c)) {
  • 3 for (var i in c) {
  • 4 select.push(new AliasedExpression(new Identifier(i), c[i]));
  • }
    • -
  • 1281 } else if (isString(c)) {
    • +
  • 955 } else if (isString(c)) {
  • 406 select.push(this.stringToIdentifier(c));
  • } else {
    • -
  • 875 select.push(c);
    • +
  • 549 select.push(c);
  • }
  • }, this);
    • -
  • 861 return this.mergeOptions({select:select});
    • +
  • 535 return this.mergeOptions({select:select});
  • },
    • @@ -19859,6 +19665,30 @@
  • },
  • /**
    • +
  • * Selects the columns if only if there is not already select sources.
    • +
  • *
    • +
  • * @example
    • +
  • *
    • +
  • * var ds = DB.from("items"); //SELECT * FROM items
    • +
  • *
    • +
  • * ds.select("a"); //SELECT a FROM items;
    • +
  • * ds.select("a").selectIfNoSource("a", "b"). //SELECT a FROM items;
    • +
  • * ds.selectIfNoSource("a", "b"). //SELECT a, b FROM items;
    • +
  • *
    • +
  • * @param cols columns to select if there is not already select sources.
    • +
  • * @return {patio.Dataset} a cloned dataset with the appropriate select sources.
    • +
  • */
    • +
  • selectIfNoSource:function (cols) {
    • +
  • 0 var ret;
    • +
  • 0 if (!this.hasSelectSource) {
    • +
  • 0 ret = this.select.apply(this, arguments);
    • +
  • } else {
    • +
  • 0 ret = this.mergeOptions();
    • +
  • }
    • +
  • 0 return ret;
    • +
  • },
    • +
    • +
  • /**
  • * Returns a copy of the dataset with the given columns added
  • * to the existing selected columns. If no columns are currently selected,
  • * it will select the columns given in addition to *.
    • @@ -20479,6 +20309,217 @@
  • as(module);
    • +
    + + + + + +
    +
    database/logging.js
    +     		+
    + Coverage97.96 + SLOC193 + LOC49 + Missed1 +
    +
    + 
    1. 1var comb = require("comb"),
      2. 
+
    2.      define = comb.define,
      3. 
+
    3.      Promise = comb.Promise,
      4. 
+
    4.      isFunction = comb.isFunction,
      5. 
+
    5.      logging = comb.logging,
      6. 
+
    6.      Logger = logging.Logger,
      7. 
+
    7.      hitch = comb.hitch,
      8. 
+
    8.      format = comb.string.format,
      9. 
+
    9.      QueryError = require("../errors").QueryError;
      10. 
+
    10.  
      11. 
+
    11.  
      12. 
+
    12. 1var LOGGER = Logger.getLogger("patio.Database");
      13. 
+
    13.  
      14. 
+
    14. 1define(null, {
      15. 
+
    15.      instance:{
      16. 
+
    16.          /**@lends patio.Database.prototype*/
      17. 
+
    17.  
      18. 
+
    18.          /**
      19. 
+
    19.           * Logs an INFO level message to the "patio.Database" logger.
      20. 
+
    20.           */
      21. 
+
    21.          logInfo:function () {
      22. 
+
    22. 8337            if (LOGGER.isInfo) {
      23. 
+
    23. 8337                LOGGER.info.apply(LOGGER, arguments);
      24. 
+
    24.              }
      25. 
+
    25.          },
      26. 
+
    26.  
      27. 
+
    27.          /**
      28. 
+
    28.           * Logs a DEBUG level message to the "patio.Database" logger.
      29. 
+
    29.           */
      30. 
+
    30.          logDebug:function () {
      31. 
+
    31. 8027            if (LOGGER.isDebug) {
      32. 
+
    32. 8027                LOGGER.debug.apply(LOGGER, arguments);
      33. 
+
    33.              }
      34. 
+
    34.          },
      35. 
+
    35.  
      36. 
+
    36.          /**
      37. 
+
    37.           * Logs an ERROR level message to the "patio.Database" logger.
      38. 
+
    38.           */
      39. 
+
    39.          logError:function (error) {
      40. 
+
    40. 75            if (LOGGER.isError) {
      41. 
+
    41. 75                LOGGER.error.apply(LOGGER, arguments);
      42. 
+
    42.              }
      43. 
+
    43.          },
      44. 
+
    44.  
      45. 
+
    45.          /**
      46. 
+
    46.           * Logs a WARN level message to the "patio.Database" logger.
      47. 
+
    47.           */
      48. 
+
    48.          logWarn:function () {
      49. 
+
    49. 1            if (LOGGER.isWarn) {
      50. 
+
    50. 1                LOGGER.warn.apply(LOGGER, arguments);
      51. 
+
    51.              }
      52. 
+
    52.          },
      53. 
+
    53.  
      54. 
+
    54.          /**
      55. 
+
    55.           * Logs a TRACE level message to the "patio.Database" logger.
      56. 
+
    56.           */
      57. 
+
    57.          logTrace:function () {
      58. 
+
    58. 1            if (LOGGER.isTrace) {
      59. 
+
    59. 1                LOGGER.trace.apply(LOGGER, arguments);
      60. 
+
    60.              }
      61. 
+
    61.          },
      62. 
+
    62.  
      63. 
+
    63.          /**
      64. 
+
    64.           * Logs a FATAL level message to the "patio.Database" logger.
      65. 
+
    65.           */
      66. 
+
    66.          logFatal:function () {
      67. 
+
    67. 1            if (LOGGER.isFatal) {
      68. 
+
    68. 1                LOGGER.fatal.apply(LOGGER, arguments);
      69. 
+
    69.              }
      70. 
+
    70.          },
      71. 
+
    71.  
      72. 
+
    72.          /* Yield to the block, logging any errors at error level to all loggers,
      73. 
+
    73.           * and all other queries with the duration at warn or info level.
      74. 
+
    74.           * */
      75. 
+
    75.          __logAndExecute:function (sql, args, cb) {
      76. 
+
    76. 8101            if (isFunction(args)) {
      77. 
+
    77. 8100                cb = args;
      78. 
+
    78. 8100                args = null;
      79. 
+
    79.              }
      80. 
+
    80.  
      81. 
+
    81. 8101            if (args) {
      82. 
+
    82. 0                sql = format("%s; %j", sql, args);
      83. 
+
    83.              }
      84. 
+
    84. 8101            sql = sql.trim();
      85. 
+
    85. 8101            var start = new Date();
      86. 
+
    86. 8101            var ret = new Promise();
      87. 
+
    87. 8101            if (isFunction(cb)) {
      88. 
+
    88. 8100                this.logInfo("Executing; %s", sql);
      89. 
+
    89. 8100                cb().then(hitch(this, function () {
      90. 
+
    90. 8026                    this.logDebug("Duration: % 6dms; %s", new Date() - start, sql);
      91. 
+
    91. 8026                    ret.callback.apply(ret, arguments);
      92. 
+
    92.                  }), hitch(this, function (err) {
      93. 
+
    93. 74                    err = new QueryError(format("%s: %s", err.message, sql));
      94. 
+
    94. 74                    this.logError(err);
      95. 
+
    95. 74                    ret.errback.apply(ret, [err]);
      96. 
+
    96.                  }));
      97. 
+
    97.              } else {
      98. 
+
    98. 1                throw new QueryError("CB is required");
      99. 
+
    99.              }
      100. 
+
    100. 8100            return ret.promise();
      101. 
+
    101.          },
      102. 
+
    102.  
      103. 
+
    103.          /*Log the given SQL and then execute it on the connection, used by
      104. 
+
    104.           *the transaction code.
      105. 
+
    105.           * */
      106. 
+
    106.          __logConnectionExecute:function (conn, sql) {
      107. 
+
    107. 2079            return this.__logAndExecute(sql, hitch(this, function () {
      108. 
+
    108. 2079                return conn[this.connectionExecuteMethod](sql);
      109. 
+
    109.              }));
      110. 
+
    110.          },
      111. 
+
    111.  
      112. 
+
    112.  
      113. 
+
    113.          getters:{
      114. 
+
    114.              /**@lends patio.Database.prototype*/
      115. 
+
    115.              /**
      116. 
+
    116.               * The "patio.Database" logger.
      117. 
+
    117.               * @field
      118. 
+
    118.               */
      119. 
+
    119.              logger:function () {
      120. 
+
    120. 2                return LOGGER;
      121. 
+
    121.              }
      122. 
+
    122.          }
      123. 
+
    123.      },
      124. 
+
    124.  
      125. 
+
    125.      "static":{
      126. 
+
    126.          /**@lends patio.Database*/
      127. 
+
    127.          /**
      128. 
+
    128.           * Logs an INFO level message to the "patio.Database" logger.
      129. 
+
    129.           */
      130. 
+
    130.          logInfo:function () {
      131. 
+
    131. 1            if (LOGGER.isInfo) {
      132. 
+
    132. 1                LOGGER.info.apply(LOGGER, arguments);
      133. 
+
    133.              }
      134. 
+
    134.          },
      135. 
+
    135.  
      136. 
+
    136.          /**
      137. 
+
    137.           * Logs a DEBUG level message to the "patio.Database" logger.
      138. 
+
    138.           */
      139. 
+
    139.          logDebug:function () {
      140. 
+
    140. 1            if (LOGGER.isDebug) {
      141. 
+
    141. 1                LOGGER.debug.apply(LOGGER, arguments);
      142. 
+
    142.              }
      143. 
+
    143.          },
      144. 
+
    144.  
      145. 
+
    145.          /**
      146. 
+
    146.           * Logs a ERROR level message to the "patio.Database" logger.
      147. 
+
    147.           */
      148. 
+
    148.          logError:function () {
      149. 
+
    149. 1            if (LOGGER.isError) {
      150. 
+
    150. 1                LOGGER.error.apply(LOGGER, arguments);
      151. 
+
    151.              }
      152. 
+
    152.          },
      153. 
+
    153.  
      154. 
+
    154.          /**
      155. 
+
    155.           * Logs a WARN level message to the "patio.Database" logger.
      156. 
+
    156.           */
      157. 
+
    157.          logWarn:function () {
      158. 
+
    158. 1            if (LOGGER.isWarn) {
      159. 
+
    159. 1                LOGGER.warn.apply(LOGGER, arguments);
      160. 
+
    160.              }
      161. 
+
    161.          },
      162. 
+
    162.  
      163. 
+
    163.          /**
      164. 
+
    164.           * Logs a TRACE level message to the "patio.Database" logger.
      165. 
+
    165.           */
      166. 
+
    166.          logTrace:function () {
      167. 
+
    167. 1            if (LOGGER.isTrace) {
      168. 
+
    168. 1                LOGGER.trace.apply(LOGGER, arguments);
      169. 
+
    169.              }
      170. 
+
    170.          },
      171. 
+
    171.  
      172. 
+
    172.          /**
      173. 
+
    173.           * Logs a FATAL level message to the "patio.Database" logger.
      174. 
+
    174.           */
      175. 
+
    175.          logFatal:function () {
      176. 
+
    176. 1            if (LOGGER.isFatal) {
      177. 
+
    177. 1                LOGGER.fatal.apply(LOGGER, arguments);
      178. 
+
    178.              }
      179. 
+
    179.          },
      180. 
+
    180.  
      181. 
+
    181.          getters:{
      182. 
+
    182.              /**@lends patio.Database*/
      183. 
+
    183.              /**
      184. 
+
    184.               * The "patio.Database" logger.
      185. 
+
    185.               * @field
      186. 
+
    186.               */
      187. 
+
    187.              logger:function () {
      188. 
+
    188. 1                return LOGGER;
      189. 
+
    189.              }
      190. 
+
    190.          }
      191. 
+
    191.      }
      192. 
+
    192.  
      193. 
+
    193.  }).as(module);
    +
    +
    @@ -21126,7 +21167,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(){
    • -
  • 49107 return this.__quoteIdentifiers;
    • +
  • 48455 return this.__quoteIdentifiers;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21134,20 +21175,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(){
    • -
  • 15274 return this.__providesAccurateRowsMatched;
    • +
  • 14948 return this.__providesAccurateRowsMatched;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(){
    • -
  • 15281 return this.__requiresSqlStandardDateTimes;
    • +
  • 14955 return this.__requiresSqlStandardDateTimes;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(){
    • -
  • 15287 return this.__supportsCte;
    • +
  • 14961 return this.__supportsCte;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21159,25 +21200,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(){
    • -
  • 15310 return this.__supportsIntersectExcept;
    • +
  • 14984 return this.__supportsIntersectExcept;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(){
    • -
  • 15286 return this.__supportsIntersectExceptAll;
    • +
  • 14960 return this.__supportsIntersectExceptAll;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(){
    • -
  • 15543 return this.__supportsIsTrue;
    • +
  • 15217 return this.__supportsIsTrue;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(){
    • -
  • 15285 return this.__supportsJoinUsing;
    • +
  • 14959 return this.__supportsJoinUsing;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21189,7 +21230,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(){
    • -
  • 15278 return this.__supportsMultipleColumnIn;
    • +
  • 14952 return this.__supportsMultipleColumnIn;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21201,13 +21242,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(){
    • -
  • 15274 return this.__supportsTimestampUsecs;
    • +
  • 14948 return this.__supportsTimestampUsecs;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(){
    • -
  • 15274 return this.__supportsWindowFunctions;
    • +
  • 14948 return this.__supportsWindowFunctions;
  • }
  • },
    • @@ -21218,7 +21259,7 @@
  • // Whether this dataset quotes identifiers.
  • /**@ignore*/
  • quoteIdentifiers:function(val){
    • -
  • 15286 this.__quoteIdentifiers = val;
    • +
  • 14960 this.__quoteIdentifiers = val;
  • },
  • // Whether this dataset will provide accurate number of rows matched for
    • @@ -21226,20 +21267,20 @@
  • // rows matched by the dataset's filter.
  • /**@ignore*/
  • providesAccurateRowsMatched:function(val){
    • -
  • 15274 this.__providesAccurateRowsMatched = val;
    • +
  • 14948 this.__providesAccurateRowsMatched = val;
  • },
  • //Whether the dataset requires SQL standard datetimes (false by default,
  • // as most allow strings with ISO 8601 format).
  • /**@ignore*/
  • requiresSqlStandardDateTimes:function(val){
    • -
  • 15274 this.__requiresSqlStandardDateTimes = val;
    • +
  • 14948 this.__requiresSqlStandardDateTimes = val;
  • },
  • // Whether the dataset supports common table expressions (the WITH clause).
  • /**@ignore*/
  • supportsCte:function(val){
    • -
  • 15275 this.__supportsCte = val;
    • +
  • 14949 this.__supportsCte = val;
  • },
  • // Whether the dataset supports the DISTINCT ON clause, false by default.
    • @@ -21251,25 +21292,25 @@
  • //Whether the dataset supports the INTERSECT and EXCEPT compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExcept:function(val){
    • -
  • 15276 this.__supportsIntersectExcept = val;
    • +
  • 14950 this.__supportsIntersectExcept = val;
  • },
  • //Whether the dataset supports the INTERSECT ALL and EXCEPT ALL compound operations, true by default.
  • /**@ignore*/
  • supportsIntersectExceptAll:function(val){
    • -
  • 15276 this.__supportsIntersectExceptAll = val;
    • +
  • 14950 this.__supportsIntersectExceptAll = val;
  • },
  • //Whether the dataset supports the IS TRUE syntax.
  • /**@ignore*/
  • supportsIsTrue:function(val){
    • -
  • 15274 this.__supportsIsTrue = val;
    • +
  • 14948 this.__supportsIsTrue = val;
  • },
  • //Whether the dataset supports the JOIN table USING (column1, ...) syntax.
  • /**@ignore*/
  • supportsJoinUsing:function(val){
    • -
  • 15276 this.__supportsJoinUsing = val;
    • +
  • 14950 this.__supportsJoinUsing = val;
  • },
  • //Whether modifying joined datasets is supported.
    • @@ -21281,7 +21322,7 @@
  • //Whether the IN/NOT IN operators support multiple columns when an
  • /**@ignore*/
  • supportsMultipleColumnIn:function(val){
    • -
  • 15274 this.__supportsMultipleColumnIn = val;
    • +
  • 14948 this.__supportsMultipleColumnIn = val;
  • },
  • //Whether the dataset supports timezones in literal timestamps
    • @@ -21293,13 +21334,13 @@
  • //Whether the dataset supports fractional seconds in literal timestamps
  • /**@ignore*/
  • supportsTimestampUsecs:function(val){
    • -
  • 15274 this.__supportsTimestampUsecs = val;
    • +
  • 14948 this.__supportsTimestampUsecs = val;
  • },
  • //Whether the dataset supports window functions.
  • /**@ignore*/
  • supportsWindowFunctions:function(val){
    • -
  • 15274 this.__supportsWindowFunctions = val;
    • +
  • 14948 this.__supportsWindowFunctions = val;
  • }
  • }
    • @@ -21393,8 +21434,8 @@
  • * @ignore
  • */
  • constructor:function () {
    • -
  • 29542 !Dataset && (Dataset = require("../index").Dataset);
    • -
  • 29542 this._super(arguments);
    • +
  • 29216 !Dataset && (Dataset = require("../index").Dataset);
    • +
  • 29216 this._super(arguments);
  • },
  • /**
    • From 84004ce9f9ee9bf7e750fd26b4f97185a37335a2 Mon Sep 17 00:00:00 2001 From: Doug Martin Date: Wed, 29 Aug 2012 11:49:12 -0500 Subject: [PATCH 3/3] v 0.1.1 * new patio.Dataset features * #sourceList - get all sources as identifiers * #joinSourceList - get all join sources * #hasSelectSource - returns true if there are not any select sources (i.e select *) * #seleIfNoSource - add the selects if there is not currently a select * Fixed issue with patio.Model#_setFromDb where values not in the models table columns would be in accesible, (i.e a join with a model would not show the join columns) * updated docs --- History.md | 8 ++++++++ package.json | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/History.md b/History.md index ba6c1571..65b9bcec 100644 --- a/History.md +++ b/History.md @@ -1,3 +1,11 @@ +#0.1.1 / 2012-08-29 +* new patio.Dataset features + * #sourceList - get all sources as identifiers + * #joinSourceList - get all join sources + * #hasSelectSource - returns true if there are not any select sources (i.e select *) + * #seleIfNoSource - add the selects if there is not currently a select +* Fixed issue with patio.Model#_setFromDb where values not in the models table columns would be in accesible, (i.e a join with a model would not show the join columns) +* updated docs #0.1.0 / 2012-08-25 * Added custom getters (mbenedettini) * Added Validator plugin for models diff --git a/package.json b/package.json index 71233b46..e7f6f0b9 100755 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "patio", "description": "Patio query engine and ORM", - "version": "0.1.0", + "version": "0.1.1", "keywords": [ "ORM", "object relation mapper",