Routes

Une route est un endpoint HTTP défini dans Luna Park. Elle encapsule de la logique côté serveur (requêtes en base, calculs, transformations) et l'expose à l'interface, qui peut l'appeler comme une fonction.

Création d'une route

Dans l'Explorer, faites un clic droit puis New → Route. Ses réglages sont dans l'Inspector :

• Method : GET, POST, PUT ou DELETE.
• Path : le chemin de l'endpoint. Par défaut, il reprend le nom de la route (une route get-articles est exposée sur /api/get-articles). Ajoutez des paramètres avec :, par exemple /articles/:id.
• Route Input et Route Output : les types des données reçues et renvoyées.
• Guards : des règles d'accès vérifiées avant l'exécution de la route (voir plus bas).

Anatomie d'une route

Le graphe d'une route va d'un node d'input à un node d'output. Entre les deux, vous branchez la logique : nodes BDD, opérations, conditions, etc.

Input

Le node d'input expose les données reçues par la route, sur des ancrages optionnels :

• headers : entêtes HTTP (auth, content-type...).
• body : corps de la requête (typique pour POST et PUT).
• query : paramètres de query string (?id=5&limit=10).
• params : paramètres de chemin (/articles/:id).

Définissez la forme de headers, body et query dans Route Input. params suit le chemin.

Vous récupérez ce dont vous avez besoin pour le passer aux nodes suivants. Par exemple, un id venant de params peut alimenter un DB Find By Id.

Les plugins peuvent ajouter des entrées : le plugin Users ajoute l'utilisateur connecté (user), par exemple.

Output

Le node d'output reçoit ce que la route renvoie au caller. Tout ce que vous branchez sur son ancrage devient le corps de la réponse HTTP. Son type se règle dans Route Output.

Une route peut avoir plusieurs nodes d'output, un par branche (trouvé / introuvable, par exemple).

Erreurs

Pour répondre avec une erreur HTTP, utilisez le node Error : choisissez un code (400 Bad Request, 401 Unauthorized, 404 Not Found...) et un message. L'exécution s'arrête là.

Cookies

Lisez et écrivez des cookies avec les nodes Get Cookie, Set Cookie et Clear Cookie. Les cookies sont signés avec le Cookie salt des Backend Settings.

Guards

Les routes sont publiques par défaut. Un guard vérifie chaque requête avant l'exécution de la route et rejette celles qui ne sont pas autorisées. Ajoutez-en un dans la section Guards de l'Inspector.

Les guards sont fournis par les plugins. Le plugin Users fournit Authenticated (utilisateurs connectés uniquement) et Permission (utilisateurs dont les rôles donnent une permission).

Tester une route

Les routes s'exécutent dans l'éditeur : quand l'interface en appelle une en mode Preview, la route tourne sur la base de données de l'éditeur, et ses logs apparaissent dans la console.

Appeler une route depuis l'interface

À chaque création de route, Luna Park génère automatiquement un node nommé comme la route (get-articles, create-user...). Vous l'utilisez directement dans le graphe d'un composant frontend : sa sortie contient la réponse, prête à brancher sur l'interface (par exemple un Template pour boucler dessus).

Exemple guidé : afficher une liste d'articles

Cet exemple part d'une table articles (voir Base de données pour la créer), crée une route get-articles qui la lit, et affiche les résultats dans l'interface.

1. Créer la route get-articles

1. Créez une route nommée get-articles.
2. Dans ses propriétés, sélectionnez la méthode GET.
3. Dans le graphe de la route, ajoutez un node DB Find sur la table articles.
4. Branchez la sortie du DB Find sur l'output de la route.
5. Définissez la Response de l'output comme étant un Array d'Object.

2. Appeler la route depuis l'interface

1. Dans la page, créez une variable articles de type Array d'Object avec un champ title (string). Cela permettra de n'afficher que les titres dans l'interface, sans id, created_at ni updated_at.

   

2. Dans le graphe, ajoutez un node On Mounted pour déclencher l'appel au chargement de la page, puis ajoutez le node get-articles et branchez sa sortie sur Set articles.

   

3. Ajoutez un composant Template (boucle For) dans l'interface et liez-le à la variable articles.

   

4. À l'intérieur du template, créez un Block dans lequel vous allez mettre une variable que vous allez lier à Template[].value.title pour afficher le titre de chaque article.