ColdFusion | onRequestStart, onRequest, onRequestEnd
  1. Introduction
  2. Utiliser la méthode « onRequestStart »
  3. Utiliser la méthode « onRequest »
  4. Utiliser la méthode « onRequestEnd »
  1. Introduction
    À la réception d'une requête http, ColdFusion procède comme suit lors du traitement de cette requête :

    • Appel de la fonction onRequestStart si existante ;
    • Appel de la fonction onRequest si existante ;
    • Exécution de la page de la requête http si la fonction onRequest est inexistante ;
    • Appel de la fonction OnRequestEnd si existante.
  2. Utiliser la méthode « onRequestStart »
    Exemple : Application.cfc

    Si le tag cfreturn est mentionné, alors il faut que la valeur retournée soit une valeur booléenne.
    Si ColdFusion échoue à convertir la valeur retournée en une valeur booléenne (exemple : <cfreturn "UNDEFINED" />) ou si le tag cfreturn est omit, vous obtiendrez une erreur « The value returned from the onRequestStart function is not of type boolean ».

    Si la fonction retourne false (ou si une erreur est survenue à l'exécution de cette fonction), l'exécution de la requête sera interrompue et la sortie déjà générée sera envoyée au client.

    Si la fonction retourne true, alors la page de la requête sera traitée par ColdFusion.

    Remarques :
    ColdFusion appel cette fonction lors de la réception d'une requête http.
    Typiquement, cette fonction est utilisée pour faire un pré-traitement avant l'exécution de la page de la requête http, par exemple un contrôle de sécurité.
    Comme cette fonction appartient au CFC Application.cfc, alors toutes les variables du scope VARIABLES ne seront pas visibles à l'extérieur de ce CFC, et donc ne seront pas visibles dans le code de la page de la requête http.
  3. Utiliser la méthode « onRequest »
    Exemple : Application.cfc

    Remarques :
    Dans les cas d'utilisations normales d'une application web, on n'aura pas besoin de déclarer cette fonction.
    Mais, si cette fonction est déclarée, alors il faut inclure explicitement la page du code pour répondre à la requête du client.
    Aussi, il faut prendre note que toutes les variables du scope VARIABLES seront visibles dans le code des pages incluses par le code de cette fonction.
  4. Utiliser la méthode « onRequestEnd »
    Exemple : Application.cfc

    Remarques :
    ColdFusion appel cette fonction après avoir terminé l'exécution de la page de la requête http.
    Typiquement, cette fonction est utilisée pour faire un post-traitement, par exemple la compression de la réponse qui sera envoyée au client.
© 2025  mtitek