ForgeDokumentace
cs

Dokumentace

Proč zvolit Total.js pro aplikace Node.js

Total.js 5 · total5@0.0.19 frameworknodejschoosealternativesarchitecture Spuštěno s Total.js 5

Total.js 5 je kompletní aplikační framework pro Node.js distribuovaný jako total5. Jeden balíček dává týmu HTTP routy, validaci vstupu, views renderované na serveru, autentizaci, uploady, routy WebSocket, plánované úlohy, lokalizaci, e-mail a další, vše navržené tak, aby to fungovalo společně. Stavíte aplikaci místo vybírání, propojování a udržování tuctu samostatných knihoven.

Co váš projekt získá

Co váš projekt potřebujeCo vám dává Total.jsPodívejte se na to ve Forge
Interní obchodní aplikace s formuláři, chráněnými routami a uploadem souborůNativní vstupní schémata, autentizační hooky a zpracování uploadů, připravené k použitíValidace, autentizace, uploady
Dashboard s živými aktualizacemi a periodickými reportyRouty WebSocket, plánované úlohy a e-mail ve stejném frameworkuPříklad WebSocket, úlohy cron, e-mail
Malý tým, který chce dodat a udržovat jednu serverovou aplikaciAutomaticky načítané soubory a společná sada konvencí, díky nimž je každý projekt povědomýStruktura projektu, konvence
Aplikace renderovaná na serveruViews, layouty a lokalizace v rámci stejného frameworkuViews a layouty, lokalizace

Každý řádek odkazuje na příklad, který Forge spouští. Ve frontendu má Total.js jComponent a katalog stovek hotových komponent, takže stejný ekosystém pokrývá i rozhraní; jejich použití je volitelné.

Proč týmy volí Total.js

Jádro bez externích závislostí. Nainstalovaný balíček total5 nedeklaruje žádné závislosti třetích stran za běhu. Neexistuje řetězec modulů od různých autorů, které je třeba udržovat kompatibilní, žádný opuštěný balíček, který zastaví váš build, žádné překvapení z tranzitivní aktualizace. Taková kontinuita má přímý a silný vliv na to, jak dobře se projekt škáluje a jak snadno se udržuje po léta: co se dnes naučíte a nasadíte, funguje dál, s podporou jednoho projektu.

Vestavěné bezpečnostní API. rámec zahrnuje ověření, podepsané sezení, kontroly CSRF, šifrování hesla a validace vstupu akce. Referenční aplikace Taskboard Kombinujte je do jedné aplikace.

Rychlá křivka učení. Total.js je JavaScript s konvencemi, které se rychle osvojí, takže tým, který ho ještě nezná, není v nevýhodě. Repozitáře Total.js obsahují velkou sbírku skriptů, příkladů a kompletních aplikací pod licencí MIT, které můžete číst, znovu použít a učit se z nich, a Forge přidává spuštěné recepty na zbytek.

Rychlé a lehké. Total.js je rychlý a jeden balíček bez stromu závislostí jej udržuje lehkým: méně věcí k načtení, aktualizaci a auditu, což nejvíce záleží na malých serverech a malých zařízeních. Forge jej měří za kontrolovaných podmínek a publikuje latenci, CPU a paměť pro každou zátěž, se surovými daty, v benchmarcích.

Začněte jednoduše: přímá HTTP routa

Tento spustitelný příklad ověří tělo pomocí kompaktního nativního schématu a odpoví přímo z kontroleru: pár řádků a žádné další vrstvy. S růstem aplikace přidají doménové akce opakovaně použitelnou, ověřenou smlouvu, kterou můžete volat z rout, kódu a nástrojů.

controllers/contacts.js
var schema = NEWSCHEMA('ContactsInput', '*name:String');

exports.install = function() {
	ROUTE('GET /health/', health);
	ROUTE('POST /contacts/', create);
};

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

function create($) {
	var result = schema.transform($.body);
	if (result.error) {
		$.response.status = 400;
		$.json({ error: 'invalid' });
		return;
	}
	$.response.status = 201;
	$.json({ name: result.response.name });
}

Zdroje

Forge spojuje svá tvrzení s věcmi, které můžete spustit. pokyny Total.js popisují styl kódování ekosystému, Total.js AI Context poskytuje implementační pokyny a manifest zdrojů zaznamenává zkontrolované revize. Pokud se příručka a nainstalovaný framework někdy liší, referencí je nainstalovaný zdrojový kód.