路由

2018-08-31 12:07:56 浏览数 (1)

创建路由

    路由提供了Route类作为IRouter的标准实现。当调用RouteAsync方法时,Route使用路由模板语法定义匹配URL路径的模式,当调用GetVirtualPath方法时,Route会使用相同的路由模板生成URL。

    大多数应用会通过调用MapRoute方法或定义在IRouteBuilder接口上的一个类似扩展方法来创建路由

    下面是两个典型的ASP.NET。MVC路由例子

代码语言:javascript复制
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中添加路由到服务容器

代码语言:javascript复制
public void ConfigureServices(IServiceCollection services)
{
       //添加路由服务
       services.AddRouting();
}

   路由必须在Startup类Configure方法中配置

代码语言:javascript复制
 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解析过来的所有路由值都会存为字符串。例如,浮点路由约束会试图将路由值转换为一个浮点性,但转换后的值只用于验证它是否能够转换为浮点型

0 人点赞