Enrutamiento y errores

Gestión de las URL

El proceso de determinación de una ruta es sencillo. En general, una aplicación web sólo tiene una colección de rutas. Para determinar qué ruta tomar en función de la petición, el sitio escaneará todas las rutas y, mediante un sistema de correspondencia, determinará la primera ruta capaz de responder a la petición.

Con ASP.NET Core, hay dos componentes importantes de gestión de rutas:

En resumen, el middleware llama al método RouteAsync de IRouter sobre todas las rutas para determinar cuál es la más adecuada. La clase responsable de determinar si la petición coincide con una ruta es la clase TemplateMatcher a través del método TryMatch.

Middleware y restricciones

Cada petición se procesa a través de un único middleware de enrutamiento llamado RouterMiddleware. Este redirige la petición a un handler que la procesa. Su código es muy sencillo:

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 primera parte del middleware permite la creación de un objeto de contexto RouteContext para la gestión de rutas. Es este objeto el que se modificará en el proceso de determinación de una ruta y el que contendrá el resto de operaciones (si se encuentra una ruta) a través de su propiedad RequestDelegate Handler.

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

A continuación, el middleware simplemente llama al método RouteAsync()para encontrar la ruta correcta para la petición entrante. Para cada ruta registrada, el middleware comprobará que la plantilla se corresponde con la petición a través de la clase...

Páginas de error

Los errores y las excepciones son habituales en la programación informática y ASP.NET Core no es una excepción. El sistema nunca es inmune y el desarrollador debe disponer de todas las herramientas necesarias para gestionar las situaciones de error, de la forma más eficaz posible.

En primer lugar, el desarrollador puede configurar una página de excepción que se mostrará cuando se produzca un error en el sitio web. Esta página, diseñada específicamente para la depuración y para ser utilizada sólo durante la fase de desarrollo del sitio, muestra una serie de información útil para ayudar a localizar el problema. El siguiente código configura esta página en la clase Startup.

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

Aquí hay dos cosas importantes:

Probar esta página es muy sencillo: basta con lanzar una excepción en cualquier parte del código:

throw new Exception("Exception triggered!"); 

Cuando el código lanza una excepción, el servidor redirige automáticamente a la página de error, proporcionando una serie de información de depuración.

Página de excepciones para los desarrolladores

La información contenida en esta página de excepción es: