- Java锁的逻辑(结合对象头和ObjectMonitor)
- 还在用饼状图?来瞧瞧这些炫酷的百分比可视化新图形(附代码实现)⛵
- 自动注册实体类到EntityFrameworkCore上下文,并适配ABP及ABPVNext
- 基于Sklearn机器学习代码实战
在 ASP.NET Core 中,路由是一个非常重要的概念,它决定了如何将传入的请求映射到相应的处理程序。本文将详细介绍 ASP.NET Core 中的路由系统,包括路由的基本原理、路由模板、路由参数、路由约束等内容,并提供相应的代码示例.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/Hello", () => "Hello World!");
app.Run();
前面的示例包含使用 MapGet 方法的单个终结点:
在asp.net core5之前的默认模板项目里面,我们都能看到UseRouting和UseEndpoints这两个中间件。用于配置路由。但是在新版本使用 WebApplicationBuilder配置中间件管道时,该管道使用 UseRouting 和 UseEndpoints 包装在 Program.cs 中添加的中间件,不需要显式调用。但是也可以手动显示调用这个方法来修改中间件的执行顺序.
在 ASP.NET Core 中,路由系统负责将传入的 URL 请求映射到相应的处理程序。它通过匹配传入的 URL 和预定义的路由模板来确定请求应该由哪个处理程序处理。路由系统的工作流程如下:
路由模板是用于定义路由的模式字符串。它可以包含静态文本和占位符,用于匹配传入的 URL。占位符由花括号包围,例如 {controller}、{action} 等。路由模板中的占位符可以用于捕获 URL 中的参数,并将其传递给处理程序。以下是一个示例路由模板:
app.MapControllerRoute(
name: "default",
pattern: "{controller}/{action}/{id?}",
defaults: new { controller = "Home", action = "Index" }
);
如果路由找到匹配项,{} 内的令牌定义绑定的路由参数。 可在路由段中定义多个路由参数,但必须用文本值隔开这些路由参数。 在上面的示例中,{controller}、{action} 和 {id} 是占位符,/是文本值,它们将匹配传入的 URL 中相应的部分。{id?} 中的问号表示参数是可选的。例如,对于 URL /Home/Index/123,controller 的值将是 Home,action 的值将是 Index,id 的值将是 123。 我们新建一个HomeController 。
public class HomeController : Controller
{
[HttpGet]
public IActionResult Index(string? id)
{
return Ok(new { id });
}
}
然后启动服务请求根路径/和/Home/Index/123 可以看到,请求顺利。 需要注意的是,这种对ApiController无效,适合MVC模式。只要有ApiController特性标签,则必须使用[Route]特性标记路由.
路由参数是从 URL 中捕获的值,它们可以用于向处理程序传递数据。在路由模板中,可以使用占位符来定义路由参数。在处理程序中,可以使用属性路由或参数路由的方式来接收路由参数.
属性路由是通过在处理程序的属性上添加路由特性来定义的。属性路由的示例如下:
[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
[HttpGet("{id}")]
public IActionResult GetId(int id)
{
return Ok(new { id });
}
}
在上面的示例中,[Route("api/[controller]")] 表示该控制器的路由模板是 api/[controller],其中 [controller] 是一个占位符,它将被控制器的名称替换。[HttpGet("{id}")] 表示 GetId 方法的路由模板是 {id},它将匹配传入的 URL 中的 id 参数。使用swagger测试响应:
参数路由是通过在处理程序的方法参数上添加路由特性来定义的。参数路由的示例如下:
[HttpGet("GetId/{id}")]
public IActionResult GetIdTow(int id)
{
return Ok(new { id });
}
在上面的示例中,[HttpGet("GetId/{id}")] 表示该方法的路由模板是 GetId/{id},其中 id 是一个占位符,它将匹配传入的 URL 中的 id 参数。使用swagger测试响应:
路由约束用于限制路由模板中参数的值。它可以是预定义的约束,也可以是自定义的约束。预定义的约束包括:
下表是官方给出的约束表格: 要在路由模板中使用约束,可以在参数名称后面使用冒号 :,并指定约束的名称。例如,{id:int} 表示 id 参数必须是整数。 我们在GetIdTowi就上整数和最小值1的约束.
[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
[HttpGet("{id}")]
public IActionResult GetId(int id)
{
return Ok(new { id });
}
[HttpGet("GetId/{id:int:min(1)}")]
public IActionResult GetIdTow(int id)
{
return Ok(new { id });
}
}
然后分别尝试字符串和小于1的数字:
自定义的约束可以通过实现 IRouteConstraint 接口来创建。以下是一个官方示例自定义约束的代码,实现 NoZeroesRouteConstraint 可防止将 0 用于路由参数:
[ApiController]
[Route("api/[controller]")]
public class NoZeroesController : ControllerBase
{
[HttpGet("{id:noZeroes}")]
public IActionResult Get(string id) =>
Content(id);
}
public class NoZeroesRouteConstraint : IRouteConstraint
{
private static readonly Regex _regex = new(
@"^[1-9]*$",
RegexOptions.CultureInvariant | RegexOptions.IgnoreCase,
TimeSpan.FromMilliseconds(100));
public bool Match(
HttpContext? httpContext, IRouter? route, string routeKey,
RouteValueDictionary values, RouteDirection routeDirection)
{
if (!values.TryGetValue(routeKey, out var routeValue))
{
return false;
}
var routeValueString = Convert.ToString(routeValue, CultureInfo.InvariantCulture);
if (routeValueString is null)
{
return false;
}
return _regex.IsMatch(routeValueString);
}
}
若要使用自定义 IRouteConstraint,必须在服务容器中使用应用的 ConstraintMap 注册路由约束类型。 ConstraintMap 是将路由约束键映射到验证这些约束的 IRouteConstraint 实现的目录。 应用的 ConstraintMap 可作为 AddRouting 调用的一部分在 Program.cs 中进行更新,也可以通过使用 builder.Services.Configure 直接配置 RouteOptions 进行更新.
builder.Services.AddRouting(options =>
options.ConstraintMap.Add("noZeroes", typeof(NoZeroesRouteConstraint)));
尝试请求id为0时: 请求不为0时候:
ASP.NET Core 中的路由系统,包括路由的基本原理、路由模板、路由参数、路由约束和路由属性。通过灵活使用路由系统,可以实现灵活的 URL 映射和参数传递,从而构建强大的 Web 应用程序.
欢迎进群催更.
最后此篇关于asp.netcore之路由的文章就讲到这里了,如果你想了解更多关于asp.netcore之路由的内容请搜索CFSDN的文章或继续浏览相关文章,希望大家以后支持我的博客! 。
在一个新的 ASP.NET Core RC2 类库中,我有以下 project.json 文件,我试图在其中遵循 How to trim your package dependencies 上的文档.
我在本地提要上将 nuget 包从 2.2.x 更新到 3.1.0。 然后,在构建机器上尝试构建项目,但是: Project.csproj(0,0): Error NU1102: Unable to
快递100的物流信息查询接口,官方提供了一些demo;还好官方提供的代码是.netcore版本写的,不过写的有点low;根据官方提供的代码,我按照.netcore 的风格重构了代码;核心代码如下:
1、docker介绍 docker是用go语言编写基于linux操作系统的一些特性开发的,其提供了操作系统级别的抽象,是一种容器管理技术,它隔离了应用程序对基础架构(操作系统等)的依赖。相较于虚
demo运行在windows的docker中,系统是win10,所以需要先下载docker for windows,安装完毕后系统会重启,然后桌面上可以找到docker for windows的快捷
NetCore WebSocket 即时通讯示例,供大家参考,具体内容如下 1.新建Netcore Web项目 2.创建简易通讯协议 ?
需求场景: 我需要部署的项目是在Windows上开发的,目标框架为.net core 6.0 因此我们需要先在kylin上部署项目运行所需要的环境。 借助百
我正在 .NET Core 中重写一个调用外部 Web 服务的控制台应用程序。 我目前收到以下错误: One or more errors occurred. (The HTTP request is
关闭。此题需要details or clarity 。目前不接受答案。 想要改进这个问题吗?通过 editing this post 添加详细信息并澄清问题. 已关闭 6 年前。 Improve th
我有一组库,我想将其从 PCL 转移到 netcore。通过此举,我想简化 DI 系统并更新一些内部工作方式。 我想添加的其中一件事是内部对象的配置,就像在 Asp.Net Core 中一样(即 se
注:本文隶属于《理解ASP.NET Core》系列文章,请查看置顶博客或 点击此处查看全文目录 概述 在微服务化的架构设计中,网关扮演着重要的看门人角色,它所提供的功能之一
对于有多个应用系统的企业来说,每一个应用系统都有自己的用户体系,这就造成用户在切换不同应用系统时,就要多次输入账号密码,导致体验非常不好,也造成使用上非常不便。 针对这个问题,我们就可以采用单
就像 Web Api 接口可以对入参进行验证,避免用户传入非法的或者不符合我们预期的参数一样,选项也可以对配置源的内容进行验证,避免配置中的值与选项类中的属性不对应或者不满足预期,毕竟大部分配置
.NET Core 选项系统的主要实现在 Microsoft.Extensions.Options 和 Microsoft.Extensions.Options.ConfigurationExten
漏洞说明: 跨站脚本攻击(Cross Site Scripting),为了不和层叠样式表(Cascading Style Sheets, CSS)的缩写混淆,故将跨站脚本攻击缩写为XSS。恶意攻击
分布式缓存是由多个应用服务器共享的缓存,通常作为访问它的应用服务器的外部服务进行维护。 分布式缓存可以提高 ASP.NET Core 应用的性能和可伸缩性,尤其是当应用由云服务或服务器场托管时。
一个应用要运行起来,往往需要读取很多的预设好的配置信息,根据约定好的信息或方式执行一定的行为。 配置的本质就是软件运行的参数,在一个软件实现中需要的参数非常多,如果我们以 Hard Code(
2. 配置添加 配置系统可以读取到配置文件中的信息,那必然有某个地方可以将配置文件添加到配置系统中。之前的文章中讲到 ASP.NET Core 入口文件中,builder(WebApplica
3. 配置提供程序 上面提到,通过 IConfigurationBuilder 的实现类对象,我们可以自由地往配置系统中添加不同的配置提供程序,从而获取不同来源的配置信息。.NET Core
4. 自定义配置提供程序 在 .NET Core 配置系统中封装一个配置提供程序关键在于提供相应的 IconfigurationSource 实现和 IConfigurationProvide
我是一名优秀的程序员,十分优秀!