# De la Express la Total.js 5

> Ce scrieți în Express și ce scrieți la Total.js 5 pentru aceeași muncă: rute, parametri, corpuri, răspunsuri, mijloace de software, fișiere statice, cookie-uri, validare, vizualizări și multe altele.

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

Total.js nu este Express cu alt nume. Cele mai mari diferențe: un handler primește **un singur obiect, `$`**, în loc de `(req, res)`; corpul este analizat de framework după tipul de conținut; nu instalezi pachete pentru cookie-uri, încărcări, validare, sesiuni, CORS, cron sau e-mail, pentru că fac parte din framework; iar fișierele proiectului tău sunt **încărcate din foldere** în loc să fie importate (vezi pagina despre structura proiectului).

Tabelul cuprinde modele comune Express cu echivalentele lor de Total.js 5.

| Sarcină | Express | Total.js 5 |
|---|---|---|
| Pornirea serverului | `app.listen(3000)` | `Total.run({ port: 3000 })` |
| O rută | `app.get('/users', fn)` | `ROUTE('GET /users/', fn)` (scrie bara finală) |
| Parametru de cale | `app.get('/users/:id', fn)` și `req.params.id` | `ROUTE('GET /users/{id}/', fn)` și `$.params.id` |
| Șir de interogare | `req.query.page` | `$.query.page` |
| Corp JSON | `app.use(express.json())` și `req.body` | `$.body`, analizat după tipul de conținut |
| Antetele cererii | `req.headers['x-token']` | `$.headers['x-token']` |
| Trimiterea JSON | `res.json(object)` | `$.json(object)` |
| Trimiterea de text sau HTML | `res.send('text')` | `$.plain('text')` sau `$.html('<p>..</p>')` |
| Cod de stare | `res.status(404).json(...)` | `$.invalid(404)` pentru o eroare, sau `$.response.status = 201` înainte de a răspunde |
| Antetul răspunsului | `res.set('x-a', 'b')` | `$.response.headers['x-a'] = 'b'` |
| Redirecționare | `res.redirect('/x')` | `$.redirect('/x')` |
| Cookie-uri | `cookie-parser`, `res.cookie(...)` | `$.cookie('name')` pentru citire, `$.cookie('name', value, '1 day')` pentru scriere |
| Middleware pe o rută | `app.get('/a', mw, fn)` | `MIDDLEWARE('mw', ($, next) => ...)` și `ROUTE('GET /a/ #mw', fn)` |
| Fișiere statice | `app.use(express.static('public'))` | Pune fișierele în `public/`: fără cod |
| Descărcarea unui fișier | `res.download(path, name)` | `$.file(path, name)` |
| Șablon | `res.render('page', model)` | `$.view('page', model)` |
| Validarea intrării | `express-validator` sau `zod` | `input: '*email:Email, age:Number'` pe o acțiune |
| Pagină de eroare | un middleware de gestionare a erorilor | `ROUTE('#404', fn)` și `ROUTE('#401', fn)` |
| Autentificare | `passport` sau `express-session` | `AUTH(fn)` și `ROUTE('+GET /private/', fn)` |
| Încărcări de fișiere | `multer` | flagul `@upload` și `$.files` |
| CORS | `cors` | `CORS('https://example.com')` |
| Apelarea altui API | `axios` sau `fetch` | `REQUEST()` și `RESTBuilder` |
| Sarcini programate | `node-cron` | `CRON('0 9 * * 1-5', fn)` |
| Trimiterea de e-mail | `nodemailer` | `MAIL()` și `HTMLMAIL()` cu `mail_smtp` în `config` |
| WebSocket | `ws` sau `socket.io` | `ROUTE('SOCKET /chat/', fn)` |

Fiecare parte are o rețetă cu mai multe detalii; aceasta este toată corespondența într-un singur loc. Exemplul de mai jos este partea Total.js a rândurilor care au nevoie de cod.

```js definitions/compare.js
MIDDLEWARE('mw', function($, next) {
	$.response.headers['x-a'] = 'b';
	next();
});

NEWACTION('Users/create', {
	name: 'Create a user',
	input: '*email:Email, age:Number',
	action: function($, model) {
		$.callback({ email: model.email, age: model.age });
	}
});
```

```js controllers/compare.js
exports.install = function() {
	ROUTE('GET /users/{id}/', user);
	ROUTE('POST /users/ --> *Users/create');
	ROUTE('GET /mw/ #mw', ok);
	ROUTE('GET /created/', created);
	ROUTE('GET /moved/', moved);
	ROUTE('GET /cookie/', cookie);
	ROUTE('GET /html/', html);
};

function user($) {
	$.json({ id: $.params.id, page: $.query.page, token: $.headers['x-token'] });
}

function ok($) {
	$.json({ ok: true });
}

function created($) {
	$.response.status = 201;
	$.json({ created: true });
}

function moved($) {
	$.redirect('/users/1/');
}

function cookie($) {
	$.cookie('visited', 'yes', '1 day');
	$.json({ before: $.cookie('visited') || null });
}

function html($) {
	$.html('<p>Hello</p>');
}
```