Affärsregler som text med NEWMACRO()

Total.js 5 · total5@0.0.19 macrosrulesscripting Körd med Total.js 5

NEWMACRO(text, [nocompile], [isasync]) gör några rader av ett litet språk till en funktion function(model, helpers). Det är avsett för regler som ändras oftare än koden: en rabatt, ett pris, en behörighetskontroll, en validering som någon som inte skriver JavaScript underhåller i en fil eller en databas.

Språket, som det kontrollerades:

IF condition, ELSE IF condition, ELSE och FI (slutet på villkoret) fungerar som i en textbaserad regel. Villkor använder >, <, >=, <=, = och AND / OR.
RETURN value avslutar makrot med ett värde. YES och NO (även TRUE, FALSE, OK) är booleska värden, text mellan citattecken är text och tal är tal.
Ett ord är en egenskap hos modellen, skriven med små bokstäver: age läser model.age, och total = price * qty skriver model.total.
NAME(arguments) anropar en helper, funktionen med det namnet (med små bokstäver) i objektet helpers som du skickar; inuti den är this modellen. Med isasync satt till true är makrot en async-funktion och väntar på helpers.
#name är en temporär variabel för körningen: #temp = num + 1 och RETURN #temp.
Använd namn med flera bokstäver: en egenskap eller variabel med en bokstav kändes inte igen vid kontrollerna.

NEWMACRO() kompilerar texten med new Function, så ett makro är kod: kompilera bara text som du skrivit eller som en betrodd person underhåller, aldrig text som en besökare skickat. Med nocompile satt till true returnerar det JavaScriptet som det genererar i stället för funktionen, vilket är användbart för att se vad en regel gör.

controllers/rules.js

const helpers = {
	percent: function(value, rate) {
		return value * rate / 100;
	}
};

const age = NEWMACRO("IF age >= 18\n\tRETURN 'adult'\nELSE\n\tRETURN 'minor'\nFI");

const level = NEWMACRO("IF points > 100\n\tRETURN 'gold'\nELSE IF points > 50\n\tRETURN 'silver'\nELSE\n\tRETURN 'bronze'\nFI");

const access = NEWMACRO("IF active AND score >= 5\n\tRETURN yes\nFI\nRETURN no");

const total = NEWMACRO("total = price * qty\nIF qty >= 10\n\ttotal = total - PERCENT(total, 10)\nFI\nRETURN total");

const temporary = NEWMACRO("#next = count + 1\nRETURN #next");

const slow = NEWMACRO("RETURN LOOKUP(code)", false, true);

exports.install = function() {
	ROUTE('POST /rules/', rules);
	ROUTE('GET /source/', source);
};

async function rules($) {
	const model = $.body;
	$.json({
		age: age(model, helpers),
		level: level(model, helpers),
		access: access(model, helpers),
		total: total(model, helpers),
		model_total: model.total,
		temporary: temporary(model, helpers),
		slow: await slow(model, { lookup: async code => 'found ' + code })
	});
}

function source($) {
	$.plain(NEWMACRO("IF points > 100\n\tRETURN 'gold'\nFI", true));
}