展开菜单
首页 精品内容 本月促销 装机必备 Windows macOS软件 IOS软件 Android AI PDF教程 专题
全部分类

当前位置:

首页 > 编程开发 > 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结构和请求模式。关键在于理解它们各自的用途和优先级,并根据实际需求进行组合。

本文内容来源于互联网,如有侵权请联系删除。
作者最新文章
编程开发
相关文章 更多
精品专题 更多
本月促销

正软商城本月促销专区,汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动,提供限时折扣、特价授权和优惠购买信息,活动库存及价格以页面实时展示为准。

装机必备

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

Windows

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

macOS软件

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

IOS软件

正软商城iOS软件专区,精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用,提供功能介绍、适用设备、系统要求和正版获取方式等信息。

AI

正软商城AI软件专区,汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具,提供功能介绍、适用平台、收费方式及正版购买信息。

PDF教程

正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

Mac软件 更多
灵活计算器
灵活计算器

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

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

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

极度公式
极度公式

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

图几
图几

图几是一款适用于 macOS 的截图、标注与美化工具,支持离线操作保障隐私。界面整理和高频系统操作被放到一起考虑,桌面或窗口内容一多时,管理起来会更省心。

密码键盘
密码键盘

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

思源笔记
思源笔记

思源笔记是一款本地笔记软件,提供所见即所得的编辑方式,为长文写作带来顺滑的体验。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

Office 365 简体中文
Office 365 简体中文

一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。

WALTR PRO
WALTR PRO

WALTR是一款电脑至iOS文件传输转换工具,操作简单,快速实现文件识别与传送。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

CodeExpander
CodeExpander

CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。

Mountain Duck
Mountain Duck

Mountain Duck 是一款能将多个网盘挂载到本地的工具,像本地磁盘一样使用网盘。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。

Menuist
Menuist

Menuist 是一款面向 macOS 的 Finder 右键菜单增强工具,主要用来补充新建文件、快捷导航等常用操作,让日常文件管理和访问路径时更高效、更顺手。

Mole
Mole

Mole 是一款专为 Mac 设计的深度清理优化工具,涵盖缓存清理、应用管理及实时状态监控等功能。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。

WINDOWS 更多
Windows 10
Windows 10

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

极度公式
极度公式

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

密码键盘
密码键盘

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

思源笔记
思源笔记

思源笔记是一款本地笔记软件,提供所见即所得的编辑方式,为长文写作带来顺滑的体验。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

傲梅轻松备份
傲梅轻松备份

傲梅轻松备份是一款专业易用的数据备份软件,为重要数据提供安全保障。日常使用里的持续防护和信息管理会更突出,适合把安全控制放进长期使用流程中的场景。

Office 365 简体中文
Office 365 简体中文

一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。

Wise Folder Hider Pro
Wise Folder Hider Pro

Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件,为私密数据添加多重保护。高频操作更强调就近处理,浏览、整理和跨目录移动文件时,来回切换和重复点击都会少很多。

WALTR PRO
WALTR PRO

WALTR是一款电脑至iOS文件传输转换工具,操作简单,快速实现文件识别与传送。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

CodeExpander
CodeExpander

CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。

PinStack
PinStack

PinStack是一款轻量级的Windows平台剪贴板管理工具,优化您的剪贴板使用体验。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。

Mountain Duck
Mountain Duck

Mountain Duck 是一款能将多个网盘挂载到本地的工具,像本地磁盘一样使用网盘。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。

Seer
Seer

Seer是一款在Win平台下的空格键功能增强效率工具,只需轻敲空格键,就能预览几乎任何格式的文件。它更适合把零散的小功能集中起来使用,处理高频琐碎任务时会更省事。