Raccourcis : Contenu - rubriques - sous rubriques
EN FR
La page correspondant à la dernière version stable est consultable dans le Manuel Jelix 1.8

Voici quelques explications sur le fonctionnement du framework et sur les principaux objets que vous allez avoir à utiliser.

Le framework se base sur un principe : à chaque URL correspond une action.

Étapes d'exécution

  1. Le serveur web reçoit une requête HTTP.
    • Le point d'entrée est exécuté par le serveur lorsqu'une URL l'indique. Par défaut il s'agit de index.php.
    • Ce script initialise l'environnement Jelix avec jApp
    • Il instancie ensuite un objet de type jRequest et un coordinateur de type jCoordinator. Voyez le coordinateur comme un routeur.
    • jRequest détermine le nom de l'action à exécuter et le nom du module concerné, à partir de l'URL
    • L'objet jRequest analyse alors le contenu de la requête HTTP pour en extraire les données. Celles-ci peuvent être dans l'URL et/ou dans le corps de la requête (méthode POST par exemple).
  2. Le contrôleur correspondant au couple module/action est instancié et la méthode exécutée par le coordinateur (ou routeur)
  3. La méthode, que vous développez :
    • récupère les paramètres de requête pour déterminer les traitements à suivre.
    • exécute les traitements métiers et récupère éventuellement des résultats qui seront utilisés pour l'affichage.
    • instancie un objet de type jResponse auquel elle assignera les données à afficher, initialisera les templates, etc...
  4. Jelix récupère cet objet jResponse, invoque la génération du document en sortie et envoie ce dernier au navigateur.

Ce que vous avez à manipuler

En général, vous n'aurez pas à utiliser un objet jRequest ou jCoordinator directement.

Vous aurez par contre à créer un objet de type jController pour y inclure le code d'une action. Cet objet propose des méthodes pour récupérer les paramètres extraits par jRequest, mais aussi pour récupérer un objet jResponse. Vous aurez donc dans le code de l'action, en plus de manipuler vos objets "métier", à manipuler cet objet jResponse pour indiquer les données à renvoyer au navigateur.

Objets en détails

Voyons maintenant un descriptif de chaque objet présenté ici ainsi que d'autres, à commencer par les sélecteurs.