创建路由
路由提供了Route类作为IRouter的标准实现。当调用RouteAsync方法时，Route使用路由模板语法定义匹配URL路径的模式，当调用GetVirtualPath方法时，Route会使用相同的路由模板生成URL。
大多数应用会通过调用MapRoute方法或定义在IRouteBuilder接口上的一个类似扩展方法来创建路由
下面是两个典型的ASP.NET。MVC路由例子
routes.MapRoute(
name: "default_route",
template: "{controller}/{action}/{id?}",
defaults: new { controller = "Home", action = "Index" });
routes.MapRoute(
name: "default_route",
template: "{controller=Home}/{action=Index}/{id?}");
使用路由中间件
在使用路由前，需要添加依赖项 microsoft.aspnetcore.routing
在Staup中添加路由到服务容器
public void ConfigureServices(IServiceCollection services)
{
//添加路由服务
services.AddRouting();
}
路由必须在Startup类Configure方法中配置
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
var trackPackageRouteHandler = new RouteHandler(context =>
{
var routeVal = context.GetRouteData().Values;
return context.Response.WriteAsync($"Hello! Route values: {string.Join(", ", routeVal)}");
});
var routeBuilder = new RouteBuilder(app, trackPackageRouteHandler);
routeBuilder.MapRoute(
"Track Package Route", "package/{operation:regex(^track|create|detonate$)}/{id:int}" );
//只允许Get请求 routeBuilder.MapGet("hello/{name}.{ext?}", context => { var name = context.GetRouteValue("name"); var ext = context.GetRouteValue("ext"); return context.Response.WriteAsync($"Hi,{name}.{ext}!"); }); var routes = routeBuilder.Build(); app.UseRouter(routes); }
响应列表
| URI | Response |
|---|---|
| /package/create/3 | Hello! Route values: [operation, create], [id, 3] |
| /package/track/-3 | Hello! Route values: [operation, track], [id, -3] |
| /package/track/-3/ | Hello! Route values: [operation, track], [id, -3] |
| /package/track/ | <未通过,没有匹配> |
| GET /hello/Joe | Hi, Joe! |
| POST /hello/Joe | <未通过, 只匹配GET请求> |
| GET /hello/Joe/Smith | <未通过,没有匹配> |
框架提供了一系列的创建路由扩展方法
- MapRoute
- MapGet
- MapPost
- MapPut
- MapDelete
- MapVerb
路由约束
| 约束 | 示例 | 匹配示例 | 注释 |
|---|---|---|---|
int |
{id:int} | 123 | 匹配所有整型 |
| bool | {active:bool} | true | 匹配 true 或 false |
| datetime | {dob:datetime} | 2016-01-01 | 匹配一个合法的 DateTime 值 (固定区域性 - 请看 options) |
| decimal | {price:decimal} | 49.99 | 匹配一个合法的 decimal 值 |
| double | {weight:double} | 4.234 | 匹配一个合法的 double 值 |
| float | {weight:float} | 3.14 | 匹配一个合法的 float 值 |
| guid | {id:guid} | 7342570B- | 匹配一个合法的 Guid 值 |
| long | {ticks:long} | 123456789 | 匹配一个合法的 long 值 |
| minlength(value) | {username:minlength(5)} | steve | 至少5个字符串长。 |
| maxlength(value) | {filename:maxlength(8)} | somefile | 字符串不能超过8个字符长。 |
| length(min,max) | {filename:length(4,16)} | Somefile.txt | 字符串至少8个长度且不超过16个字符长度。 |
| min(value) | {age:min(18)} | 19 | 值至少是18。 |
| max(value) | {age:max(120)} | 91 | 值不能超过120。 |
| range(min,max) | {age:range(18,120)} | 91 | 值必须介于18和120之间。 |
| alpha | {name:alpha} | Steve | 字符串必须是由字母字符组成。 |
| regex(expression) | {ssn:regex(^d{3}-d{2}-d{4}$)} | 123-45-6789 | 字符串必须匹配提供的正则表达式。 |
| required | {name:required} | Steve | 用于在URL生成时强制必须存在值。 |
验证URL可转为CLR类型（例如Int或DateTime）的路由约束总是使用固定区域性；它们认为URL是不可本地化的，框架提供的路由约束不会修改路由值，从URL解析过来的所有路由值都会存为字符串。例如，浮点路由约束会试图将路由值转换为一个浮点性，但转换后的值只用于验证它是否能够转换为浮点型
