# Контролни обаждания, ръчно разрешаване и условни отговори

> Извършване на jsonstring, отговори, направени, успешни, упълномощени, персонализирани и последно модифицирани обработка.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: bg
Content-SHA256: 0828ce44cafaa4b48e855b1eb864404183a8cadf8d8876cc1466145a2ad3215b
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

Това са обикновени методи на контролер на маршрут, различни от контекста на действие. `$.jsonstring()` приема вече сериализиран JSON. `$.respond()` избира метода, назован от `$.response.output`, по подразбиране JSON. `$.done(true)` препраща резултата на callback във плика за успех; друг аргумент избира фиксирана стойност. `$.successful(fn)` извиква вашата функция само когато няма грешка.

`await $.authorize()` се изпълнява с резултата от оторизацията; анонимен резултат трябва пак да се обработи от вашия код. За условни отговори подайте **низ на UTC заглавие** на `$.notmodified()`: в 0.0.19 сравнението е точно равенство на низове. `$.httpcache()` задава заглавия, но `$.json()` презаписва политиката на кеша, така че примерът изпраща суров буфер, след като ги зададе. Използвайте публичен кеш само за публични представяния. `$.custom()` прехвърля собствеността върху отговора на вашия обработчик; завършете сами отговора на Node.

```js definitions/auth.js
AUTH(function($) {
	if ($.headers['x-demo-user'] === 'alice')
		$.success({ id: 'alice' });
	else
		$.invalid();
});
```

```js controllers/completion.js
exports.install = function() {
	ROUTE('GET /serialized/', $ => $.jsonstring('{"ok":true}'));
	ROUTE('GET /respond/', function($) { $.response.output = 'plain'; $.respond('hello'); });
	ROUTE('GET /done/', $ => $.done(true)(null, { id: 7 }));
	ROUTE('GET /successful/', $ => $.successful(value => $.json({ value: value }))(null, 9));
	ROUTE('GET /callback-error/', $ => $.successful(() => $.json({ wrong: true }))('failure'));
	ROUTE('GET /manual-auth/', async function($) {
		var user = await $.authorize();
		if (user)
			$.json({ id: $.user.id });
		else
			$.invalid(401);
	});
	ROUTE('GET /conditional/', function($) {
		var modified = 'Mon, 05 Jan 2026 00:00:00 GMT';
		if ($.notmodified(modified))
			return;
		$.httpcache(modified);
		$.binary(Buffer.from('public version 1'), 'text/plain');
	});
	ROUTE('GET /custom/', function($) {
		$.custom();
		$.res.writeHead(202, { 'content-type': 'text/plain' });
		$.res.end('accepted');
	});
};
```