Query Builder: DB() a NEWDB() s vlastnou databázou
DB() zostaví dotaz bez toho, aby vedel, ktorá databáza ho vykoná, a NEWDB() zaregistruje driver, ktorý ho vykoná. total5 samo nemá SQL driver: query builder zhromaždí, o čo žiadate, do objektu options a zavolá s ním váš driver a driver (váš alebo taký, ktorý prichádza v module) preloží options do SQL, volania NoSQL alebo čohokoľvek iného.
NEWDB(driver)zaregistruje predvolený driver aNEWDB('name', driver)pomenovaný. Driver jefunction(options, callback): odpovedzte cezcallback(error, response). Tabuľka zapísaná akoname/table(DB().find('audit/log')) používa drivernamea tabuľkulog; bez predpony je driverdefault.- Operácie začínajú dotaz:
find(table)(v prípade akýchkoľvek problémov)read(table)jeden objekt, alebonullkeď nie je žiadny,list(table)(Poznámka z jednej stránky:response.page,limitapagesje pridaný k tomu, čo vodič vráti, takže vodič by mal nastaviťcounta) ainsert(table, data)Staviteľ má tiežcount,update,removeaquery- pracujú rovnakým spôsobom (vozač dostaneoptions.execs týmto menom) - Vyplňte dotaz s:
where(name, [comparer], value)(=keď nie je porovnateľný,fields('a,b'),sort(name, [true])(truea potom zostupuje,take(n)apage(page, limit)Ďalšie modifikácie zahŕňajúid,in,skip,betweenasearch. - Ukončite cez
.callback($): výsledok ide do odpovede akcie$, alebo do funkcie(err, response), ktorú odovzdáte namiesto toho.
Pre kompletný domáci prevádzkový katalóg, správanie sa / chyby a tvary filtra, pozri Prehľad stavebnej zmluvyPre SQL CRUD, commit a rollback, pozri Vyhľadávač-sqlitePríklad vodiča ukladá záznamy v pamäti a vystavuje posledný objekt options prijatý.
const users = [
{ id: 1, name: 'Ann', age: 31 },
{ id: 2, name: 'Bob', age: 17 },
{ id: 3, name: 'Cy', age: 45 }
];
F.seen = [];
// The default driver: it understands only "age >= value" and "id = value", which is all this example asks
NEWDB(function(options, callback) {
F.seen.push(JSON.parse(JSON.stringify(options)));
let rows = users.slice();
for (let f of options.filter) {
if (f.type === 'where' && f.name === 'age' && f.comparer === '>=')
rows = rows.filter(n => n.age >= f.value);
else if (f.type === 'where' && f.name === 'id')
rows = rows.filter(n => n.id === f.value);
}
switch (options.exec) {
case 'find':
case 'read':
if (options.sort && options.sort[0] === 'name_desc')
rows.sort((a, b) => a.name < b.name ? 1 : -1);
if (options.take)
rows = rows.slice(0, options.take);
return callback(null, rows);
case 'list':
rows.count = rows.length;
return callback(null, rows);
case 'insert':
users.push(Object.assign({ id: users.length + 1 }, options.payload));
return callback(null, users[users.length - 1]);
default:
return callback('The driver does not know ' + options.exec);
}
});
// A second driver, used by the tables that start with "audit/"
NEWDB('audit', function(options, callback) {
F.seen.push({ driver: 'audit', table: options.table });
callback(null, [{ event: 'login' }]);
});exports.install = function() {
ROUTE('GET /adults/', adults);
ROUTE('GET /user/{id}/', user);
ROUTE('POST /users/', create);
ROUTE('GET /page/', page);
ROUTE('GET /audit/', audit);
ROUTE('GET /seen/', seen);
};
function adults($) {
DB().find('users').where('age', '>=', 18).fields('id,name').sort('name', true).take(5).callback($);
}
function user($) {
DB().read('users').where('id', +$.params.id).callback($);
}
function create($) {
DB().insert('users', { name: $.body.name, age: $.body.age }).callback($);
}
function page($) {
DB().list('users').page(1, 2).callback(function(err, response) {
$.json({ err: err, count: response.count, page: response.page, limit: response.limit, pages: response.pages });
});
}
function audit($) {
DB().find('audit/log').callback($);
}
function seen($) {
$.json(F.seen);
}