Le routage et les erreurs

La gestion des URL

Le processus de détermination d’une route est simple. En général, une application web ne comporte qu’une seule collection de routes. Afin de déterminer quelle route il faut emprunter selon la requête, le site va parcourir toutes les routes, et via un système de correspondance va déterminer la première route capable de répondre à la requête.

Avec ASP.NET Core, il existe deux composants importants dans la gestion des routes :

De manière synthétique, le middleware appelle la méthode RouteAsync de IRouter sur toutes les routes afin de déterminer laquelle est la plus adaptée. La classe responsable de déterminer si la requête correspond à une route est la classe TemplateMatcher via la méthode TryMatch.

Le middleware et les contraintes

Chaque requête est traitée via un unique middleware de routage intitulé RouterMiddleware. Ce dernier va ainsi rediriger la requête vers un handler qui va traiter la requête. Son code est très simple :

public async Task Invoke(HttpContext httpContext) 
{ 
    var context = new RouteContext(httpContext); 
    context.RouteData.Routers.Add(_router); 
 
    await _router.RouteAsync(context); 
 
    if (context.Handler == null) 
    { 
        _logger.RequestDidNotMatchRoutes(); 
        await _next.Invoke(httpContext); 
    } 
    else 
    { 
        httpContext.Features[typeof(IRoutingFeature)] = new 
RoutingFeature() 
        { 
            RouteData = context.RouteData, 
        }; 
 
        await context.Handler(context.HttpContext); 
    } 
} 

La première partie du middleware permet la création d’un objet de contexte pour la gestion du routage de type RouteContext. C’est cet objet qui va être modifié dans le processus de détermination d’une route, et qui va contenir la suite des opérations (si une route est trouvée) via sa propriété Handler de type RequestDelegate.

var context = new RouteContext(httpContext); 
    context.RouteData.Routers.Add(_router); 

Ensuite, le middleware appelle simplement la méthode RouteAsync() permettant de trouver la bonne route pour la requête entrante. Cette dernière va ainsi, pour chaque route enregistrée, vérifier que le template correspond à la requête demandée via la classe TemplateMatcher.

await _router.RouteAsync(context); 

À ce moment précis, la classe Route, héritant de RouteBase pour...

Les pages d’erreur

Les erreurs et les exceptions sont des éléments courants en programmation informatique, et ASP.NET Core ne déroge pas à la règle. Le système n’est jamais à l’abri, et le développeur doit disposer de tous les outils nécessaires afin de gérer au mieux les cas d’erreurs.

Dans un premier temps, il est possible pour le développeur de configurer une page d’exception qui va s’afficher lorsqu’une erreur survient sur le site. Cette page, conçue spécialement pour le débogage et à utiliser uniquement lors de la phase de développement du site, permet de visualiser plusieurs informations utiles afin de cibler le problème. Le code ci-dessous configure cette page dans la classe Startup.

public void Configure(IApplicationBuilder app,  
    IHostingEnvironment env) 
{ 
    if (env.IsDevelopment()) 
    { 
        app.UseDeveloperExceptionPage(); 
    } 

Deux choses sont importantes ici :

Afin de tester cette page, c’est très simple : il suffit de lever une exception dans n’importe quelle partie du code :

throw new Exception("Exception triggered!"); 

Lorsque le code lève une exception, le serveur redirige automatiquement vers la page d’erreur, fournissant ainsi plusieurs informations de débogage.

Page d’exception pour les développeurs

Les informations contenues dans cette page d’exception sont :