Raccourcis : Contenu - rubriques - sous rubriques
EN FR

URL : identification d'une action

Une fois que l'on a fait un contrôleur on veut bien sûr pouvoir appeler l'une de ces méthodes, donc indiquer les informations nécessaires dans les URLs.

Avec la configuration par défaut de Jelix (donc avec le moteur d'URL basic_significant), il faut indiquer dans l'URL :

  • le nom du module
  • le nom du contrôleur
  • le nom de la méthode

   index.php/monmodule/moncontroleur/mamethode

Avec le moteur d'url "simple", on aurait une url comme :


   index.php?module=monmodule&action=moncontroleur:mamethode

Notez que le nom du contrôleur et celui de la méthode doivent être séparés par le caractère ":".

  • Si le nom d'action n'est pas présent, Jelix essaiera d'exécuter la méthode index() du contrôleur default dans le module indiqué.
  • Si le nom du module est absent, Jelix essaiera d'exécuter l'action indiquée du module indiqué dans le paramètre startModule dans la configuration de l'application.
  • Si les deux noms sont absents, Jelix exécutera l'action indiquée dans le paramètre startAction, à partir du module indiqué dans le paramètre startModule dans la configuration de l'application.
  • Avec le moteur d'url "simple", pour l'action, si on indique juste le nom de la méthode, Jelix exécutera la méthode indiquée dans le contrôleur default.

Sélecteurs d'action

Dans vos templates et dans votre code en général, vous n'indiquerez jamais d'URL "en dur". Jelix comporte des mécanismes (la classe jUrl notament) pour générer les URLs correspondantes à des actions. Ceci permet de choisir son moteur d'URL préféré (simple ou significant) et de modifier le "mapping" entre des URLs significatives et des actions. Tout ceci sans toucher ni aux templates, ni aux contrôleurs.

Aussi vous allez devoir la plupart du temps indiquer à divers objets ou méthodes de l'API de Jelix des sélecteurs d'action accompagnés d'éventuels paramètres. Voir la page sur les sélecteurs pour en savoir plus sur les sélecteurs en général.

Les sélecteurs d'action ont cette syntaxe :


   module~controleur:methode

Vous pouvez omettre l'une de ces parties comme spécifié précédemment :


   controleur:methode
   methode
   module~
   controleur:

Vous pouvez aussi indiquer le caractère "#" pour spécifier le module courant ou l'action courante. Dans ces exemples, imaginons que c'est l'action "bar:man" du module "foo" qui a été appelée dans Jelix :

  • "#~controleur:methode" représente l'action "controleur:methode" du module qui a été appelé. Équivaut donc à "foo~controleur:methode"
  • "module~#" représente l'action qui a été appelée mais du module indiqué. Équivaut donc à "module~bar:man"
  • "#~#" représente le module/l'action qui ont été appelés. Équivaut donc à "foo~bar:man".

Indiquer le point d'entrée

Par défaut quand on indique un sélecteur d'action, il génère l'URL avec le point d'entrée courant : si on a appelé Jelix avec index.php, ce sera index.php, si c'est xmlrpc.php, ce sera xmlrpc.php.

Cependant on peut vouloir indiquer des URLs pour d'autres points d'entrées. Par exemple, on est dans une action qui affiche une page html et on veut indiquer dans la page l'URL du point d'entrée pour les services web jsonrpc.

Dans ce cas on ajoute à la fin du sélecteur d'action, un "@" suivi du nom du type du point d'entrée :


  foo~bar:man@css

Ici on demande l'URL de l'action "bar:man" du module "foo", pour les requêtes de type "css".

Pour la plupart des URLs on indiquera certainement "@classic".

Si dans un sélecteur d'action on indique juste le type de requête, seront utilisés le module et l'action indiqués respectivement dans startModule et startAction de la configuration de l'application. Ainsi par exemple le sélecteur "@classic" correspondra à l'URL "index.php".

Pour en savoir plus : configuration et la manipulation des URLs dans Jelix.