Node Atlas NodeAtlas

Le Framework JavaScript Serveur Évolutif

  • Mise en place Simple

    Au point avec HTML & CSS ?
    Débutant en JavaScript ?

    Réalisez rapidement des sites vitrines multilingues sans effort avec l'utilisation de routes, vues ou variations.

  • Site vivant et Évolutif

    Expert en JavaScript client ?
    Prêt à embrasser Node.js ?

    Améliorer progressivement votre base à mesure de vos besoins en utilisant des contrôleurs, modèles ou modules.

  • Partie Cliente Agnostique

    Déjà vos habitudes Front-end ?
    Habitué(e) du Data Binding ?

    Du léger Vanilla au simple jQuery en passant par Vue, Angular ou React : utiliser vos bibliothèques clientes favorites !

Introduction

Une instance de site NodeAtlas est pilotée par le fichier webconfig.json. Tout site NodeAtlas en possède un, c'est ce qui force le moteur à passer de « Simple serveur web » à « Serveur web NodeAtlas ».

NodeAtlas n'est pas une architecture MVC standard. L'une des particularités de NodeAtlas est que le contrôleur s'occupe lui-même de rendre la page sans développement de votre part. Aussi le minimum vital pour créer une page est de référencer un fichier de vue.

Nous allons voir pour commencer comment mettre en place l'ensemble de fichiers minimals afin de réaliser un « Hello World ! ».

Ensemble de fichiers

Après avoir installé NodeAtlas, créez-vous un ensemble de fichiers représentant un site dans le dossier de votre choix. Nous allons dans cet exemple le faire dans un dossier hello-world :

hello-world/
├─ views/
│  └─ index.htm
└─ webconfig.json

Nous allons donc délivrer derrière une adresse HTTP le contenu de la vue views/index.htm :

<!DOCTYPE html>
<html lang="fr-fr">
    <head>
        <meta charset="utf-8" />
        <title>Hello world</title>
    </head>
    <body>
        <div>Ceci est un Hello World !</div>
    </body>
</html>

Voyons ci-après le contenu du fichier webconfig.json.

Configuration minimale

Vous pouvez faire tourner une page simple avec la configuration minimale du webconfig.json ci-dessous :

webconfig.json

{
    "routes": {
        "/": {
            "view": "index.htm"
        }
    }
}

équivalente à

webconfig.json

{ "routes": { "/": "index.htm" } }

Lancer le site

Avec la commande node-atlas

Si vous avez installé NodeAtlas avec npm install -g node-atlas vous pouvez utiliser la commande node-atlas. node-atlas est un raccourci de la commande node </path/to/globals/>node_modules/node-atlas/.

Note : vous pouvez également utiliser la commande atlas qui est un alias de node-atlas mais plus rapide à écrire.

Placez-vous avec votre invité de commande dans le dossier hello-world/ et exécutez la commande suivante.

$ node-atlas

Note : Si votre port 80 est utilisé ou que vous n'avez pas accès à celui-ci, vous pouvez utiliser l'option --httpPort.

$ node-atlas --httpPort 8080

ou utiliser la propriété du webconfig httpPort

{
   "httpPort": 8080,
   "routes": { "/": "index.htm" }
}

Vous aurez accès à votre « Hello World » à la page http://localhost/ dans un navigateur (ou http://localhost:8080/).

Via un fichier JavaScript

Vous pouvez également utiliser NodeAtlas comme un module npm.

Créer alors un fichier server.js au même niveau que le webconfig.json.

server.js

require("node-atlas")().start();

Lancez ensuite le fichier avec Node.js.

$ node server.js

Squelette de Hello World

Il est également possible d'obtenir une application déjà prête avec plusieurs des fonctionnalités qui seront étudiées un peu plus loin avec la commande --create. Pour ce faire il faut créer un dossier de test et y copier un squelette d'application exemple :

$ node-atlas --create hello-world

et démarrer !

$ node-atlas --browse