ForgeTotal.js 5
pl

Total.js 5

Operacje QueryBuilder, filtry i kontrakt kierowcy

Total.js 5 · total5@0.0.19 total5reference Uruchomiono z Total.js 5

Ta strona obejmuje natywny QueryBuilder z total5@0.0.19 (querybuilder.js). DB() zwraca kontroler kolejki. Każda operacja planuje wywołanie sterownika; dodawaj filtry i callbacki synchronicznie przed jej wykonaniem. NEWDB(name, driver) rejestruje połączenie. NEWDB(name) wyrejestrowuje je. W tej kolejce nie ma niejawnego silnika bazy danych ani transakcji.

Przykładowy sterownik zwraca otrzymane opcje. aby wykonać operację bazy danych, wdrożyć tę operację w sterowniku. Książka - Sqlite.

OperacjeSterownik otrzymuje
find/all(table), read/one(table), list(table)exec, table; read ustawia first:true, take:1; list domyślnie używa take:100, skip:0
check(table), count(table)check ustawia first:1, take:1; wartość wyniku definiuje sterownik
insert/ins(table, data)payload
update/modify/mod/upd(table, data, upsert)payload, upsert; zerowy wynik wyzwala drugi insert, gdy upsert jest włączony
remove/rem(table), truncate/clear(table), drop(table)Odpowiedni exec; operacje destrukcyjne wymagają wsparcia sterownika
scalar(table, type, key, key2)scalar:{type,key,key2}; pominięty key staje się *
command(table, name)command:name
query(sql, params) lub query(connection, sql, params)Surowy tekst w query, wartości w params, tabela jest pusta; wiązanie parametrów SQL to odpowiedzialność sterownika
Metody zapytaniaOpcje / zachowanie
where(name, [comparer], value), equal(object), id(value), userid(value)Skrót równości; == staje się =, != staje się ; ID w tablicy używają in
in/notin(name, values, [idField]), between(name,a,b), or(fn)Filtrują rekordy; or grupuje rekordy dodane wewnątrz fn(builder)
array(name,[comparer],value)Domyślny komparator &&; interpretacja należy do sterownika
month/day/year/hour/minute(name,[comparer],value)Filtry według części daty; domyślny komparator =
search(name,value,[where]), contains(name), empty(name)Filtrują rekordy; semantyka dopasowania należy do sterownika
query(fragment), join(name,table,type,a,b), permit(name,type,values,userid,required)Filtry specyficzne dla sterownika; surowe fragmenty muszą pochodzić z zaufanego kodu aplikacji
fields(csv), returning(csv)Tablice przyciętych nazw pól, nie escapowanie SQL ani autoryzacja
sort(name, descending), gridsort(csv,[localized])Ciągi sortowania; true lub desc wybierają malejąco
take/limit(n), skip(n), page(page,limit), paginate(page,limit,max)Przesunięcia/limity; paginate ogranicza limit, page nie
first(), primarykey(name), schema(name), language(value,prefix,skip), debug()Metadane dla sterownika; first rozpakowuje też wynik w tablicy
gridfilter(name,query,type,[key]), autoquery(query,schema,sort,max)Zamieniają parametry zapytania siatki na opcje. autoquery ogranicza żądane pola i klucze sortowania do zadeklarowanego schematu
gridfields(fields,allowed)Użyj fields() z własną listą dopuszczalną: jest to sprawdzony sposób wyboru kolumn
callback/pipe(fn), promise(), done($,fn,param)Zakończenie; obietnice są odrzucane przy błędzie sterownika
data(fn), fail(fn), error/err(message,reverse)Hooki sukcesu/porażki; error() odrzuca puste wyniki, reverse:true odrzuca wyniki prawdziwe (w tym pustą tablicę)
set(name), nobind()Nazywają wynik w kolejce lub nie zastępują wyjścia kolejki
insert(fn,param) na builderze updateModyfikuje payload przed zapasowym insertem upsertu
audit($,message,type)Po udanej odpowiedzi sterownika wywołuje variables() i audit() dostarczonego kontekstu

Metody kontrolera: callback/pipe, promise, done, debug, language, load(connection, options) i exec(options, callback). load kopiuje zdefiniowany podzbiór zserializowanych opcji; exec rozsyła obsługiwane nazwy operacji. next/free to wewnętrzne elementy cyklu życia. Kolejka zatrzymuje się po błędzie sterownika; nie cofa wcześniejszych zapisów.

definitions/contract.js
NEWDB('contract', function(options, callback) {
	if (options.table === 'failure')
		return callback(new Error('driver failed'));
	if (options.table === 'empty')
		return callback(null, []);
	if (options.table === 'upsert') {
		MAIN.upsert.push(JSON.parse(JSON.stringify(options)));
		return callback(null, options.exec === 'update' ? 0 : options.payload);
	}
	if (options.exec === 'list')
		return callback(null, { items: [], count: 12 });
	callback(null, options.first ? [options] : options);
});
MAIN.upsert = [];
controllers/contract.js
exports.install = function() {
	ROUTE('GET /contract/', contract);
};

async function contract($) {
	try {
		var out = {};
		var methods = ['find', 'all', 'read', 'one', 'list', 'check', 'count', 'insert', 'ins', 'update', 'modify', 'mod', 'upd', 'remove', 'rem', 'truncate', 'clear', 'drop'];
		out.operations = {};
		for (var method of methods)
			out.operations[method] = await DB()[method]('contract/items', { name: 'Ann' }).promise();
		out.scalar = await DB().scalar('contract/items', 'sum', 'amount', 'group').promise();
		out.command = await DB().command('contract/items', 'vacuum').promise();
		out.raw = await DB().query('contract', 'SELECT ?', [7]).promise();
		out.filters = await DB().find('contract/items').id([1, 2]).userid({ id: 'u1' }).equal({ active: true }).where('age', '!=', 0).in('team', [{ id: 'a' }], 'id').notin('team', 'b').between('age', 18, 65).or(function(q) { q.where('role', 'a').where('role', 'b'); }).array('tags', ['x']).month('created', 1).day('created', 2).year('created', '>=', 2020).hour('created', 3).minute('created', 4).search('name', 'ann', 'beg').contains('email').empty('deleted').query('trusted_fragment').join('team', 'teams', 'left', 'a.id', 'b.id').permit('permissions', 'RW', ['team'], 'u1', false).promise();
		out.options = await DB().find('contract/items').fields('id, name').returning('id, name').sort('name', true).gridsort('id_asc').limit(5).skip(2).primarykey('uid').schema('public').language({ language: 'es' }, '_').debug().promise();
		out.page = await DB().list('contract/items').paginate('2', '500', 10).promise();
		out.grid = await DB().find('contract/items').autoquery({ fields: 'id,password', sort: 'password_desc,name_desc', page: '2', limit: '500', age: '>18' }, 'id:String,name:String,age:Number', 'id_asc', 10).promise();
		out.gridfields = await DB().find('contract/items').gridfields('id', 'id,name').promise();
		var queue = DB();
		queue.read('contract/items').set('one');
		queue.count('contract/items').set('count');
		queue.find('contract/items').nobind();
		out.queue = await queue.promise();
		var hooks = [];
		await DB().read('contract/empty').data(function(v) { hooks.push(v === null ? 'null' : 'value'); }).promise();
		try { await DB().read('contract/empty').error('missing').fail(function() { hooks.push('fail'); }).promise(); } catch (e) { out.missing = String(e); }
		try { await DB().find('contract/failure').promise(); } catch (e) { out.failure = String(e); }
		out.hooks = hooks;
		out.upsert = await DB().update('contract/upsert', { name: 'new' }, true).where('id', 7).insert(function(payload, role) { payload.role = role; }, 'member').promise();
		out.upsertCalls = MAIN.upsert;
		out.load = await DB().load('contract', { table: 'items', exec: 'find', take: 2, filter: [] }).promise();
		$.json(out);
	} catch (e) { $.invalid(e); }
}