node-query/docs/driver.js.html

322 lines
6.4 KiB
HTML
Raw Normal View History

2014-10-20 16:56:45 -04:00
<!DOCTYPE html>
2014-10-23 10:53:16 -04:00
2014-10-20 16:56:45 -04:00
<html lang="en">
<head>
2014-10-23 10:53:16 -04:00
<meta charset="utf-8">
<title>DocStrap Source: driver.js</title>
2014-10-20 16:56:45 -04:00
2014-10-23 10:53:16 -04:00
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<link type="text/css" rel="stylesheet" href="styles/sunlight.default.css">
2014-10-20 16:56:45 -04:00
2014-10-23 10:53:16 -04:00
<link type="text/css" rel="stylesheet" href="styles/site.cosmo.css">
2014-10-20 16:56:45 -04:00
2014-10-23 10:53:16 -04:00
</head>
2014-10-20 16:56:45 -04:00
2014-10-23 10:53:16 -04:00
<body>
<div class="container-fluid">
<div class="navbar navbar-fixed-top navbar-inverse">
<div class="navbar-inner">
<a class="brand" href="index.html">DocStrap</a>
<ul class="nav">
<li class="dropdown">
<a href="modules.list.html" class="dropdown-toggle" data-toggle="dropdown">Modules<b
class="caret"></b></a>
<ul class="dropdown-menu ">
<li>
<a href="module-adapter.html">adapter</a>
</li>
<li>
<a href="module-driver.html">driver</a>
</li>
<li>
<a href="module-helpers.html">helpers</a>
</li>
<li>
<a href="module-node-query.html">node-query</a>
</li>
<li>
<a href="module-query-builder.html">query-builder</a>
</li>
2014-10-27 10:35:44 -04:00
<li>
<a href="module-query-parser.html">query-parser</a>
</li>
2014-10-23 10:53:16 -04:00
</ul>
</li>
</ul>
</div>
</div>
<div class="row-fluid">
<div class="span12">
<div id="main">
<h1 class="page-title">Source: driver.js</h1>
<section>
<article>
<pre
class="sunlight-highlight-javascript linenums">'use strict';
2014-10-20 16:56:45 -04:00
var helpers = require('./helpers');
/**
* Base Database Driver
*
2014-10-23 10:53:16 -04:00
* @module driver
2014-10-20 16:56:45 -04:00
*/
2014-10-23 10:53:16 -04:00
var d = {
2014-10-20 16:56:45 -04:00
identifierChar: '"',
tablePrefix: null,
/**
* Low level function for naive quoting of strings
* @param {String} str
* @return {String}
* @private
*/
_quote: function(str) {
2014-10-23 10:53:16 -04:00
return (helpers.isString(str) &amp;&amp; ! (str.startsWith(d.identifierChar) || str.endsWith(d.identifierChar)))
? d.identifierChar + str + d.identifierChar
2014-10-20 16:56:45 -04:00
: str;
},
/**
* Sets the table prefix on the passed string
*
* @param {String} str
* @return {String}
* @private
*/
_prefix: function(str) {
2014-10-23 10:53:16 -04:00
if (str.startsWith(d.prefix))
2014-10-20 16:56:45 -04:00
{
return str;
}
2014-10-23 10:53:16 -04:00
return d.prefix + str;
2014-10-20 16:56:45 -04:00
},
/**
* Set the limit clause
* @param {String} sql
* @param {Number} limit
* @param {Number|null} offset
* @return {String}
*/
limit: function(sql, limit, offset) {
sql += " LIMIT " + limit;
if (helpers.isNumber(offset))
{
sql += " OFFSET " + offset;
}
return sql;
},
/**
* Prefixes a table if it is not already prefixed
*
* @param {String} table
* @return {String}
*/
prefixTable: function(table) {
2014-10-23 10:53:16 -04:00
if (d.tablePrefix)
2014-10-20 16:56:45 -04:00
{
// Split identifier by period, will split into:
// database.schema.table OR
// schema.table OR
// database.table OR
// table
var idents = table.split('.', table);
var segments = idents.length;
// Add the database prefix
2014-10-23 10:53:16 -04:00
idents[segments - 1] = d._prefix(idents[segments - 1]);
2014-10-20 16:56:45 -04:00
table = idents.join('.');
}
return table;
},
/**
* Quote database table name, and set prefix
*
* @param {String} table
* @return {String}
*/
quoteTable: function(table) {
2014-10-23 10:53:16 -04:00
table = d.prefixTable(table);
2014-10-20 16:56:45 -04:00
// Quote after prefix
2014-10-23 10:53:16 -04:00
return d.quoteIdentifiers(table);
2014-10-20 16:56:45 -04:00
},
/**
* Use the driver's escape character to quote identifiers
*
* @param {String|Array}
* @return {String|Array}
*/
quoteIdentifiers: function(str) {
var hiers, raw;
var pattern = new RegExp(d.identifierChar + '(' + '([a-zA-Z0-9_]+)' + '(\((.*?)\))' + ')' + d.identifierChar, 'ig');
2014-10-20 16:56:45 -04:00
// Recurse for arrays of identifiiers
if (Array.isArray(str))
{
2014-10-23 10:53:16 -04:00
return str.map(d.quoteIdentifiers);
2014-10-20 16:56:45 -04:00
}
// Handle commas
if (str.contains(','))
{
var parts = str.split(',').map(helpers.stringTrim);
str = parts.map(d.quoteIdentifiers).join(',');
}
2014-10-20 16:56:45 -04:00
// Split identifiers by period
2014-10-23 10:53:16 -04:00
hiers = str.split('.').map(d._quote);
2014-10-20 16:56:45 -04:00
raw = hiers.join('.');
// Fix functions
if (raw.contains('(') &amp;&amp; raw.contains(')'))
{
var funcs = pattern.exec(raw);
// Unquote the function
raw = raw.replace(funcs[0], funcs[1]);
// Quote the identifiers inside of the parens
var inParens = funcs[3].substring(1, funcs[3].length -1);
raw = raw.replace(inParens, d.quoteIdentifiers(inParens));
}
2014-10-20 16:56:45 -04:00
return raw;
}
2014-10-23 10:53:16 -04:00
};
module.exports = d;</pre>
</article>
</section>
</div>
<div class="clearfix"></div>
<footer>
<span class="copyright">
DocStrap Copyright © 2012-2014 The contributors to the JSDoc3 and DocStrap projects.
</span>
<br />
<span class="jsdoc-message">
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.3.0-alpha9</a>
2014-10-27 10:35:44 -04:00
on Mon Oct 27th 2014 using the <a
2014-10-23 10:53:16 -04:00
href="https://github.com/terryweiss/docstrap">DocStrap template</a>.
</span>
</footer>
</div>
<br clear="both">
</div>
</div>
<!--<script src="scripts/sunlight.js"></script>-->
<script src="scripts/docstrap.lib.js"></script>
<script src="scripts/bootstrap-dropdown.js"></script>
<script src="scripts/toc.js"></script>
<script>
$( function () {
$( "[id*='$']" ).each( function () {
var $this = $( this );
$this.attr( "id", $this.attr( "id" ).replace( "$", "__" ) );
} );
$( "#toc" ).toc( {
anchorName : function ( i, heading, prefix ) {
return $( heading ).attr( "id" ) || ( prefix + i );
},
selectors : "h1,h2,h3,h4",
showAndHide : false,
scrollTo : "100px"
} );
$( "#toc>ul" ).addClass( "nav nav-pills nav-stacked" );
$( "#main span[id^='toc']" ).addClass( "toc-shim" );
$( '.dropdown-toggle' ).dropdown();
// $( ".tutorial-section pre, .readme-section pre" ).addClass( "sunlight-highlight-javascript" ).addClass( "linenums" );
$( ".tutorial-section pre, .readme-section pre" ).each( function () {
var $this = $( this );
var example = $this.find( "code" );
exampleText = example.html();
var lang = /{@lang (.*?)}/.exec( exampleText );
if ( lang && lang[1] ) {
exampleText = exampleText.replace( lang[0], "" );
example.html( exampleText );
lang = lang[1];
} else {
lang = "javascript";
}
if ( lang ) {
$this
.addClass( "sunlight-highlight-" + lang )
.addClass( "linenums" )
.html( example.html() );
}
} );
Sunlight.highlightAll( {
lineNumbers : true,
showMenu : true,
enableDoclinks : true
} );
} );
</script>
<!--Navigation and Symbol Display-->
<!--Google Analytics-->
2014-10-20 16:56:45 -04:00
</body>
</html>