Expressről Total.js 5-re
A Total.js nem más néven futó Express. A legnagyobb különbségek: a kezelő egyetlen objektumot, $-t kap a (req, res) helyett; a törzset a keretrendszer értelmezi a tartalomtípus alapján; nem telepítesz csomagokat sütikhez, feltöltésekhez, validációhoz, munkamenetekhez, CORS-hoz, cronhoz vagy e-mailhez, mert ezek a keretrendszer részei; a projekted fájljait pedig mappákból tölti be a rendszer importálás helyett (lásd a projektstruktúra oldalt).
Az asztal közös expressz mintákkal párosul Total.js 5 egyenértékű
| Feladat | Express | Total.js 5 |
|---|---|---|
| A szerver indítása | app.listen(3000) | Total.run({ port: 3000 }) |
| Egy útvonal | app.get('/users', fn) | ROUTE('GET /users/', fn) (írd ki a záró perjelet) |
| Útvonalparaméter | app.get('/users/:id', fn) és req.params.id | ROUTE('GET /users/{id}/', fn) és $.params.id |
| Lekérdezési karakterlánc | req.query.page | $.query.page |
| JSON törzs | app.use(express.json()) és req.body | $.body, a tartalomtípus alapján értelmezve |
| Kérésfejlécek | req.headers['x-token'] | $.headers['x-token'] |
| JSON küldése | res.json(object) | $.json(object) |
| Szöveg vagy HTML küldése | res.send('text') | $.plain('text') vagy $.html('<p>..</p>') |
| Állapotkód | res.status(404).json(...) | $.invalid(404) hibához, vagy $.response.status = 201 válasz előtt |
| Válaszfejléc | res.set('x-a', 'b') | $.response.headers['x-a'] = 'b' |
| Átirányítás | res.redirect('/x') | $.redirect('/x') |
| Sütik | cookie-parser, res.cookie(...) | $.cookie('name') olvasáshoz, $.cookie('name', value, '1 day') íráshoz |
| Middleware egy útvonalon | app.get('/a', mw, fn) | MIDDLEWARE('mw', ($, next) => ...) és ROUTE('GET /a/ #mw', fn) |
| Statikus fájlok | app.use(express.static('public')) | Tedd a fájlokat a public/ mappába: kód nélkül |
| Fájl letöltése | res.download(path, name) | $.file(path, name) |
| Sablon | res.render('page', model) | $.view('page', model) |
| Bemenet validálása | express-validator vagy zod | input: '*email:Email, age:Number' egy műveleten |
| Hibaoldal | hibakezelő middleware | ROUTE('#404', fn) és ROUTE('#401', fn) |
| Hitelesítés | passport vagy express-session | AUTH(fn) és ROUTE('+GET /private/', fn) |
| Feltöltések | multer | a jelző @upload és $.files |
| CORS | cors | CORS('https://example.com') |
| Másik API hívása | axios vagy fetch | REQUEST() és RESTBuilder |
| Ütemezett feladatok | node-cron | CRON('0 9 * * 1-5', fn) |
| E-mail küldése | nodemailer | MAIL() és HTMLMAIL() a config-ban lévő mail_smtp-vel |
| WebSocket | ws vagy socket.io | ROUTE('SOCKET /chat/', fn) |
Minden résznek van egy részletesebb receptje; ez a teljes megfeleltetés egy helyen. Az alábbi példa a kódot igénylő sorok Total.js oldala.
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 });
}
});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>');
}