ForgeTotal.js 5
pt

Total.js 5

Restringir uma rota com flags

Total.js 5 · total5@0.0.19 routingflags Executada com o Total.js 5

Os flags começam com @ e vão depois do URL. Uma rota só corresponde quando o pedido satisfaz todos os seus flags; caso contrário o Total.js tenta a rota seguinte para o mesmo URL e responde 404 se nenhuma corresponder. Flags úteis:

  • @json e @xml: o body tem de ser JSON ou XML
  • @xhr: o pedido tem de ser AJAX (cabeçalho x-requested-with)
  • @upload: o body tem de ser multipart/form-data
  • @debug e @release: a rota só existe nesse modo
  • @mobile e @robot: o cliente é um navegador móvel ou um rastreador
controllers/data.js
exports.install = function() {
	ROUTE('POST /data/ @json', json_only);
	ROUTE('POST /data/ @xml', xml_only);

	// Careful: a route with flags has a lower priority than the same URL without flags
	ROUTE('POST /mixed/ @json', json_only);
	ROUTE('POST /mixed/', anything);
};

function json_only($) {
	$.json({ handler: 'json' });
}

function xml_only($) {
	$.json({ handler: 'xml' });
}

function anything($) {
	$.json({ handler: 'anything' });
}

Nunca misture uma rota com flags e uma rota sem flags no mesmo URL: a que não tem flags é verificada primeiro e fica com todos os pedidos, pelo que a rota com flags nunca é alcançada.