knex/lib/query/compiler.js

var _       = require('lodash');
var Helpers = require('../helpers');
var push    = Array.prototype.push;
var concat  = Array.prototype.concat;

module.exports = function() {

  var components = [
    'wrapped', 'columns', 'join', 'where', 'union', 'group',
    'having', 'order', 'limit', 'offset', 'lock'
  ];

  // The "QueryCompiler" takes all of the query statements which have been
  // assembed in the
  var QueryCompiler = function(builder) {
    this.tableName = builder._table();
    this.singles   = builder.singles;
    this.grouped   = _.groupBy(builder.statements, 'type');
  };

  _.extend(QueryCompiler.prototype, {

    get: function(elem) {
      var item = this.grouped[elem];
      return item ? item[0] : {value: '', columns: ''};
    },

    compiled: function(target) {
      return this[target]();
    },

    // Compiles the `select` statement, or nested sub-selects
    // by calling each of the component compilers, trimming out
    // the empties, and returning a generated query string.
    select: function() {
      var statements = [];
      for (var i = 0, l = components.length; i < l; i++) {
        var component = components[i];
        if (this.grouped[component] || component === 'columns') {
          statements.push(this[component](this));
        }
      }
      var bindings = concat.apply([], _.compact(_.pluck(statements, 'bindings')));
      return {
        sql: _.compact(_.pluck(statements, 'sql')).join(' '),
        bindings: bindings
      };
    },

    // Alias to `select` with some post-processing on the output.
    pluck: function() {
      return this.select();
    },

    // Compiles an `insert` query, allowing for multiple
    // inserts using a single query statement.
    insert: function() {
      var insertData = this.get('insert');
      return {
        sql: 'insert into ' + this.tableName + ' ' +
          insertData.columns + ' values ' + insertData.value,
        bindings: insertData.bindings
      };
    },

    // Compiles the columns in the query, specifying if an item was distinct.
    columns: function() {
      var distinct = false;
      var bindings = [];
      if (this.onlyUnions()) return {};
      var sql = _.compact(_.map(this.grouped.columns, function(block) {
        if (block.distinct) distinct = true;
        push.apply(bindings, block.bindings);
        return block.value;
      }, this));
      return {
        sql: 'select ' + (distinct ? 'distinct ' : '') +
          (sql.join(', ') || '*') + (this.tableName ? ' from ' + this.tableName : ''),
        bindings: bindings // _.flatten(bindings, true)
      };
    },

    // Compiles all each of the `join` clauses on the query,
    // including any nested join queries.
    join: function() {
      return {
        sql: _.map(this.grouped.join, function(item, i) {
          var sql = '';
          if (i > 0) sql += item.bool || '';
          return sql + item.value;
        }).join(' ')
      };
    },

    // Compiles all `where` statements on the query.
    where: function() {
      return this._havingWhere('where');
    },

    group: function() {
      return this._groupsOrders('group');
    },

    order: function() {
      return this._groupsOrders('order');
    },

    // Compiles the `having` statements.
    having: function() {
      return this._havingWhere('having');
    },

    // Compile the "union" queries attached to the main query.
    union: function() {
      var onlyUnions = this.onlyUnions();
      var sql = '', unions = this.grouped.union;
      for (var i = 0, l = unions.length; i < l; i++) {
        var union = unions[i];
        if (i > 0) sql += ' ';
        if (i > 0 || !onlyUnions) sql += union.clause + ' ';
        sql += union.value;
      }
      return {
        type: 'union',
        sql: sql,
        bindings: _.flatten(_.pluck(this.grouped.union, 'bindings'))
      };
    },

    // If we haven't specified any columns or a `tableName`, we're assuming this
    // is only being used for unions.
    onlyUnions: function() {
      return (!this.grouped.columns && this.grouped.union && !this.tableName);
    },

    limit: function() {
      var limit = this.get('limit');
      return {
        sql: limit.value,
        bindings: limit.bindings
      };
    },

    offset: function() {
      var offset = this.get('offset');
      return {
        sql: offset.value,
        bindings: offset.bindings
      };
    },

    // Compiles a `delete` query.
    delete: function() {
      var wheres = this.where();
      return {
        sql: 'delete from ' + this.tableName + ' ' + wheres.sql,
        bindings: wheres.bindings
      };
    },

    // Compiles a `truncate` query.
    truncate: function() {
      return {
        sql: 'truncate ' + this.tableName
      };
    },

    lock: function() {
      return {
        sql: _.pluck(this.grouped.lock, 'value').join(' ')
      };
    },

    // Compiles the `order by` statements.
    _groupsOrders: function(type) {
      var items = _.pluck(this.grouped[type], 'value');
      if (items.length > 0) {
        return {
          sql: type + ' by ' + items.join(', ')
        };
      }
      return {};
    },

    // The same logic is used for compiling "where" statements as it is
    // for "having" statements.
    _havingWhere: function(type) {
      var bindings = [];
      return {
        sql: _.map(this.grouped[type], function(item, i) {
          push.apply(bindings, item.bindings);
          return (i === 0 ? type + ' ' : '') + item.bool + ' ' + item.value;
        }).join(' ').replace(/and |or /, ''),
        bindings: _.flatten(bindings)
      };
    }

  });

  QueryCompiler.extend = require('simple-extend');

  return QueryCompiler;
};