当前位置:

首页 > 编程开发 > ASP.NET Core路由系统是用于将HTTP请求映射到对应处理程序的机制。它通过定义路由模板来匹配URL,并将请求传递给相应的控制器和动作方法。路由系统的定

ASP.NET Core路由系统是用于将HTTP请求映射到对应处理程序的机制。它通过定义路由模板来匹配URL,并将请求传递给相应的控制器和动作方法。路由系统的定

ASP.NETCore中的路由系统,说白了,就是你的应用如何理解和响应用户在浏览器地址栏里输入的网址(URL)的机制。它像一个智能的交通指挥官,负责把每一个进来的HTTP请求,准确无误地导向你代码里对应的处理逻辑,比如一个控制器里的某个动作方法,或者一个MinimalAPI的终结点。没有它,你的应用就不知道该怎么处理各种请求,简直寸步难行。解决方案在ASP.NETCore里定义路由,通常会在应用的启动配置(Program.cs或Startup.cs)里完成。核心是引入app.UseRouting()

ASP.NET Core中的路由系统是什么?如何定义?

ASP.NET Core中的路由系统,说白了,就是你的应用如何理解和响应用户在浏览器地址栏里输入的网址(URL)的机制。它像一个智能的交通指挥官,负责把每一个进来的HTTP请求,准确无误地导向你代码里对应的处理逻辑,比如一个控制器里的某个动作方法,或者一个Minimal API的终结点。没有它,你的应用就不知道该怎么处理各种请求,简直寸步难行。

解决方案

在ASP.NET Core里定义路由,通常会在应用的启动配置(Program.csStartup.cs)里完成。核心是引入app.UseRouting()app.UseEndpoints()这两个中间件。UseRouting()负责路由匹配,而UseEndpoints()则执行匹配到的终结点。

1. 控制器(Controller)路由: 这是传统MVC应用中最常见的定义方式,分为两种:

  • 约定式路由(Conventional Routing): 通过预设的模式来匹配URL。你可以在Program.cs(或Startup.csConfigure方法)中定义:

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    
        // 你可以定义更多特定的约定式路由
        // endpoints.MapControllerRoute(
        //     name: "blog",
        //     pattern: "blog/{articleId}",
        //     defaults: new { controller = "Blog", action = "Article" });
    });

    这个default路由模式意味着URL通常是/控制器名/动作方法名/可选的ID。比如/Home/Index

  • 特性路由(Attribute Routing): 将路由规则直接写在控制器类或动作方法上,这在我看来,是定义RESTful API时最清晰、最直观的方式。

    [ApiController]
    [Route("api/[controller]")] // 类级别路由前缀
    public class ProductsController : ControllerBase
    {
        [HttpGet] // 匹配GET请求到 api/Products
        public IActionResult GetProducts()
        {
            return Ok(new[] { "Product A", "Product B" });
        }
    
        [HttpGet("{id}")] // 匹配GET请求到 api/Products/{id}
        public IActionResult GetProduct(int id)
        {
            // ...
            return Ok($"Product {id}");
        }
    
        [HttpPost("add")] // 匹配POST请求到 api/Products/add
        public IActionResult AddProduct([FromBody] string productName)
        {
            // ...
            return CreatedAtAction(nameof(GetProduct), new { id = 1 }, productName);
        }
    }

    特性路由的优先级通常高于约定式路由,也更灵活,特别适合构建清晰的API接口。

2. Minimal API 路由: 这是.NET 6引入的新范式,特别适合构建轻量级、高性能的微服务或小型API。路由直接定义在Program.cs里,与处理逻辑紧密结合。

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseRouting(); // 仍然需要路由中间件
app.UseEndpoints(endpoints =>
{
    endpoints.MapGet("/", () => "Hello World!"); // 匹配GET /
    endpoints.MapGet("/users/{id}", (int id) => $"User ID: {id}"); // 匹配GET /users/{id}
    endpoints.MapPost("/items", (string item) => Results.Ok($"Created item: {item}")); // 匹配POST /items
});

app.Run();

Minimal API的路由定义非常简洁,没有控制器和动作方法的概念,直接将URL映射到Lambda表达式或本地函数。

无论哪种方式,路由的定义顺序在某些情况下很重要,尤其是当有重叠的路由模式时,更具体的路由应该放在更通用的路由之前。

ASP.NET Core路由与传统Web Forms或MVC有何不同?

这真是一个好问题,尤其对于那些从旧框架迁移过来的开发者来说。在我看来,ASP.NET Core的路由系统,相较于传统的ASP.NET Web Forms或早期的ASP.NET MVC,最大的不同在于其灵活性、模块化和对“终结点路由”(Endpoint Routing)的彻底拥抱

首先,Web Forms基本上没有我们现在意义上的路由,它更多是基于物理文件路径来处理请求,通过URL重写(URL Rewriting)才能模拟出“干净”的URL,这在当时显得有些笨重。而ASP.NET MVC虽然引入了路由概念,比如在RouteConfig.cs里定义路由表,但它本质上还是紧密绑定到控制器和动作方法。

ASP.NET Core则更进一步,引入了终结点路由。这意味着路由系统不再仅仅是为了找到一个控制器动作,它可以找到任何可以作为“终结点”的东西——一个控制器动作、一个Razor Page、一个SignalR Hub,甚至是一个Minimal API的Lambda表达式。这种设计让整个框架的耦合度大大降低,你可以根据需要选择不同的处理方式,而路由系统依然能统一调度。

我个人觉得,最直观的感受是,在ASP.NET Core里,路由的配置变得更加声明式。无论是特性路由直接写在代码旁边,还是Minimal API直接将路由和处理逻辑写在一起,都比以前那种集中式的路由表配置更贴近代码本身。这种变化,让路由的意图更明确,维护起来也更方便,尤其是在大型项目中,不同模块的路由可以独立定义,减少了冲突的可能性。此外,ASP.NET Core的路由是作为中间件集成进请求管道的,这意味着它可以与其他中间件(如认证、授权)无缝协作,提供了更强大的扩展性。

在ASP.NET Core中,如何选择适合的路由定义方式?

选择合适的路由定义方式,其实是根据你的项目类型、团队习惯和对代码组织的需求来决定的。这没有绝对的对错,更多是一种权衡。

如果你的项目是一个传统的MVC应用,需要渲染HTML视图,并且控制器和动作方法比较多,那么约定式路由仍然是一个非常实用的选择。它能让你用最少的配置覆盖大量的URL模式,比如/Products/List/Users/Details/5等,非常适合那些遵循标准MVC模式的应用。它的缺点是,当URL模式变得复杂或需要特别定制时,约定式路由可能会显得不够灵活,需要你手动添加更多的MapControllerRoute

对于构建RESTful API,或者需要细粒度控制每个终结点URL的场景,我强烈推荐特性路由。在我看来,它就是为API而生的。你可以在控制器或动作方法上直接用[Route][HttpGet]等特性来定义URL,这让API的URL结构与代码结构紧密结合,可读性极高。当一个开发者看到一个API方法时,几乎立刻就能知道它的URL路径和HTTP动词。这对于维护和理解大型API项目至关重要。我个人在使用特性路由时,会尽量让URL路径反映资源的层级关系,这能让API设计更加清晰。

Minimal API,则是为轻量级、高性能的微服务或小型工具API量身定制的。如果你只是需要快速搭建几个简单的HTTP终结点,或者构建一个无视图的后端服务,Minimal API无疑是最佳选择。它省去了控制器、动作方法、甚至Startup.cs的繁琐配置,直接在Program.cs里完成所有事情。这使得开发效率极高,代码量也大大减少。但如果你的应用逻辑非常复杂,或者需要大量的依赖注入、过滤器等高级功能,那么Minimal API可能会让Program.cs变得臃肿,这时候控制器或更传统的MVC模式可能更合适。

简单来说,如果追求约定大于配置,且是MVC应用,选约定式路由;如果追求明确的URL结构和API设计,特别是RESTful服务,选特性路由;如果追求极致的简洁和开发效率,且是小型API,选Minimal API。很多时候,在一个项目中,你甚至会混合使用这些方式,比如MVC应用用约定式路由,但其中一些API部分则使用特性路由。

处理复杂的路由场景,如路由参数、约束与回退路由,有哪些技巧?

处理复杂的路由场景,是真正考验你对ASP.NET Core路由系统理解深度的地方。这不仅仅是定义一个简单的URL,更是要让路由系统能够智能地解析各种输入,并做出正确的响应。

1. 路由参数与可选参数: 路由参数是URL中的占位符,用来捕获URL中的动态值。比如/products/{id}中的{id}

  • 基本参数: endpoints.MapControllerRoute(..., pattern: "{controller}/{action}/{id}")
  • 可选参数: 通过在参数名后加?来表示,例如{id?}。这意味着URL中可以有这个参数,也可以没有。这在很多场景下非常有用,比如一个分页列表,page参数可能存在也可能不存在。

2. 路由约束(Route Constraints): 路由约束是用来限制路由参数必须符合特定格式的规则。这能有效避免歧义路由,并提供更好的URL解析。

  • 内置约束: ASP.NET Core提供了许多内置约束,比如:

    • {id:int}id必须是整数。
    • {name:alpha}name必须只包含字母。
    • {slug:minlength(5)}slug最小长度为5。
    • {date:datetime}date必须是日期时间格式。
    • {zipcode:regex(^[0-9]{5}$)}:使用正则表达式匹配美国邮政编码。 这些约束可以直接加在路由参数后面,例如:
      [HttpGet("products/{id:int}")] // id必须是整数
      public IActionResult GetProductById(int id) { /* ... */ }

    [HttpGet("blog/{year:int}/{month:int}/{slug:minlength(10)}")] // 多个约束 public IActionResult GetBlogPost(int year, int month, string slug) { / ... / }

    使用约束能让路由匹配更精确,避免一个URL意外匹配到错误的动作。

3. 默认值: 你可以为路由参数设置默认值,当URL中缺少该参数时,就会使用默认值。

endpoints.MapControllerRoute(
    name: "products",
    pattern: "products/{action=List}/{id?}", // action默认为List
    defaults: new { controller = "Products" });

这样,访问/products就会等同于/products/List

4. 回退路由(Fallback Routes): 回退路由是一个非常实用的机制,它定义了一个“万能”的路由,当所有其他路由都无法匹配时,就会使用它。这在单页应用(SPA)中尤其常见,因为SPA的路由通常由前端JavaScript处理。

  • MapFallbackToController / MapFallbackToPage

    app.UseEndpoints(endpoints =>
    {
        // 其他正常的路由定义
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    
        // 回退路由,将所有未匹配的请求导向Home控制器的Index动作
        endpoints.MapFallbackToController("Index", "Home");
    });

    当用户直接访问/some/nonexistent/path时,如果前端路由没有处理,服务器就会将请求导向Home/Index,让SPA的根页面加载,再由前端路由接管。

  • MapFallbackToFile

    app.UseStaticFiles(); // 确保静态文件中间件在回退路由之前
    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        // ... 其他API或MVC路由
        endpoints.MapFallbackToFile("index.html"); // 将所有未匹配的请求导向wwwroot/index.html
    });

    这在部署SPA时非常常见,它确保无论用户访问什么路径,都能加载SPA的index.html文件,然后由前端框架(如React, Angular, Vue)来处理客户端路由。

这些技巧的灵活运用,能让你构建出既强大又健壮的路由系统,应对各种复杂的URL结构和请求模式。关键在于理解它们各自的用途和优先级,并根据实际需求进行组合。

本文内容来源于互联网,如有侵权请联系删除。
作者最新文章
编程开发
相关文章 更多
C++动态数组初始化怎么写?常用语句与代码示例
C++动态数组初始化怎么写?常用语句与代码示例

深入解析C++中动态数组的初始化机制,涵盖new操作符的不同用法、基本类型与类对象的初始化差异,以及为何在现代C++开发中应优先使用std::vector。

using namespace 使用中遇到的问题怎么解决
using namespace 使用中遇到的问题怎么解决

命名空间的基本概念与常见引入问题在C++等编程语言中,命名空间(namespace)是一种将代码标识符(如变量、函数、类名)封装在特定名称下的机制,其主要目的是避免命名冲突,尤其是在大型项目或使用多个第三方库时。使用“using namespace”指令可以将指定命名空间中的所有名称引入当前作用域,

c语言函数递归 实操经验总结:这些技巧很实用
c语言函数递归 实操经验总结:这些技巧很实用

理解递归的基本原理在C语言中,递归是一种函数调用自身的编程技术。要掌握它,首先需要理解其核心思想:将一个复杂的大问题,分解为一个或几个与原问题相似但规模更小的子问题,直到子问题足够简单,可以直接求解。这个过程通常包含两个关键部分:递归出口和递归体。递归出口定义了问题何时不再继续分解,即最简单、可直接

c语言函数递归 怎么选?常见方案对比分析
c语言函数递归 怎么选?常见方案对比分析

递归函数的基本概念与适用场景在C语言编程中,递归是一种函数调用自身的编程技巧。它并非适用于所有问题,但在处理某些具有自相似结构的问题时,能提供极其清晰和优雅的解决方案。递归的核心思想是将一个大规模问题分解为一个或多个同类型但规模更小的子问题,直到子问题简单到可以直接求解。典型的适用场景包括树形结构的

Objective-C 内存管理入门:从 alloc 到 dealloc 的生命周期详解
Objective-C 内存管理入门:从 alloc 到 dealloc 的生命周期详解

理解内存管理的基石在Objective-C的编程世界中,内存管理是开发者必须掌握的核心技能之一。它直接关系到应用的性能、稳定性与资源利用效率。与一些采用自动垃圾回收机制的语言不同,Objective-C在很长一段时间里,依赖一套基于引用计数的、需要开发者部分介入的管理规则。这套规则的核心思想是明确的

如何正确使用 dealloc 以避免 iOS 应用中的内存泄漏
如何正确使用 dealloc 以避免 iOS 应用中的内存泄漏

理解 dealloc 的角色与时机在 iOS 应用开发中,内存管理是保障应用性能与稳定性的基石。dealloc 方法是 Objective-C 中对象生命周期结束时的关键回调,它标志着对象即将被系统回收内存。正确理解其触发时机至关重要:当一个对象的引用计数降为零时,运行时系统会自动调用该对象的 de

深入理解 Objective-C 中的 dealloc 方法:内存管理核心机制
深入理解 Objective-C 中的 dealloc 方法:内存管理核心机制

内存管理的基石在Objective-C的世界里,内存管理是开发者必须掌握的核心技能之一。作为一门在手动引用计数(MRC)时代诞生的语言,Objective-C要求程序员对对象的生命周期有清晰的认识。dealloc方法正是这一生命周期中至关重要的终点站。它是一个实例方法,当对象的引用计数降为零时,系统

理解 native2ascii:Java 国际化开发中的字符编码工具
理解 native2ascii:Java 国际化开发中的字符编码工具

native2ascii 工具的基本定位在Ja va应用程序的国际化与本地化开发过程中,处理非拉丁字符集是一个常见且关键的环节。Ja va内部使用Unicode字符集来统一表示全球各种语言的文字,但其属性文件(.properties)在历史上要求使用ASCII编码,或者更准确地说,要求非ASCII字

如何使用 native2ascii 转换中文字符为 Unicode 转义序列
如何使用 native2ascii 转换中文字符为 Unicode 转义序列

理解 native2ascii 工具的基本用途在软件开发,特别是涉及国际化处理的场景中,开发者常常需要处理不同编码的文本资源。native2ascii 是 Ja va 开发工具包(JDK)中提供的一个命令行实用程序,其主要功能是将包含本地字符编码(非ASCII字符)的文件,转换为包含 Unicode

Java native2ascii 命令详解:解决属性文件乱码问题
Java native2ascii 命令详解:解决属性文件乱码问题

native2ascii 命令的由来与作用在Ja va开发中,处理国际化资源文件是一个常见需求。资源文件通常以.properties格式存储,用于支持多语言界面。然而,Ja va属性文件默认采用ISO-8859-1字符集编码,这导致了一个直接的问题:当文件中包含非拉丁字符(如中文、日文、韩文等)时,

查看更多
精品专题 更多
装机必备
装机必备

正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

Windows
Windows

正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

macOS软件
macOS软件

正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

Mac软件 更多
灵活计算器
灵活计算器
macOS/iOS/Android

灵活计算器是一款笔记式算数应用,支持实时计算、动态关联和云端同步功能。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

赤友清理大师
赤友清理大师
macOS

赤友清理大师是一款为 Mac 设计的智能清理优化工具,可精准扫描垃圾、大文件、重复文件等,释放磁盘空间。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

极度公式
极度公式
Windows/macOS/Linux

极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

WINDOWS 更多
Windows 10
Windows 10
Windows

Windows 10 是一款微软推出的经典操作系统,拥有硬件兼容性与多任务处理能力。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。

极度公式
极度公式
Windows/macOS/Linux

极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

密码键盘
密码键盘
Windows/macOS/iOS/Android

密码键盘是一款兼具安全性与便捷性的高效密码管理器。日常使用里的持续防护和信息管理会更突出,适合把安全控制放进长期使用流程中的场景。