ASP.NET Web API 路由

时间:2023-03-08 17:00:20
ASP.NET Web API 路由

路由系统是请求消息进入ASP.NET Web API消息处理管道的第一道屏障,其根本目的是利用注册的路由表(RouteTable)对请求的URI进行解析以确定目标HttpController和Action的名称,以及与目标Action方法某个参数进行绑定的路由变量。

ASP.NET Web API框架是一个独立于传输层的抽象消息处理管道,其本身并不具有传输协议的侦听、接收和响应能力。
WebHost和SelfHost这两种典型的寄宿模式采用两种截然不同的机制实现了ASP.NET Web API路由系统的适配。

ASP.NET Web API 包含路由系统在内的核心框架是一个独立于寄宿环境的消息处理管道,这是为什么它能支持多种不同寄宿模式的根源所在。服务寄宿的目的在于提供一个运行环境以监听并接收来自外界的请求,并将请求适当加工后递交给这个抽象的消息处理管道进行处理,最后将管道处理后生成的响应利用网络传输返回给客户端。对于WebHost来说,真正的路由功能是由ASP.NET自身的路由系统来完成的。ASP.NET MVC的路由完全是由ASP.NET路由系统来完成的,但后者并非专门为MVC而设计,其实它最初是为了帮助Web Forms应用实现“请求地址与物理文件的分离”而设计的。

一个简单的例子来注册ASP.NET路由映射

这个Route的注册包括了:映射URI各段(Segment)的默认值,值的约束以及其它一些附加数据。

 using System;
using System.Web;
using System.Web.Routing; namespace WebHost
{
public class Global : HttpApplication
{
protected void Application_Start(object sender, EventArgs e)
{
// 设置路由映射URI各段的默认值
var defaults = new RouteValueDictionary
{
{"areacode", ""}
}; // 设置值的约束
var constrains = new RouteValueDictionary
{
{"areacode", @"0\d{2,3}"},
{"days", @"[1-3]"}
}; // 设置附加数据
var dataTokens = new RouteValueDictionary
{
{"defaultCity", "BeiJing"},
{"defaultDays", ""}
}; // 在路由表中注册路由(Friendly URL与物理文件分离)
RouteTable.Routes.MapPageRoute("default", "{areacode}/{days}", "~/weather.aspx", false, defaults, constrains, dataTokens);
}
}
}

写一个WebForm页面来呈现上述的各种路由数据

 using System;
using System.Web.UI; namespace WebHost
{
public partial class Weather : Page
{
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack)
{
if (RouteData.Route != null)
{
Response.Write(RouteData.Route.GetType().FullName);
Response.Write("<br/>");
}
if (RouteData.RouteHandler != null)
{
Response.Write(RouteData.RouteHandler.GetType().FullName);
Response.Write("<br/>");
}
Response.Write("<b>RouteData Values:</b></br>");
foreach (var variable in RouteData.Values)
{
Response.Write($"<li>{variable.Key}={variable.Value}</li>");
}
Response.Write("<b>RouteData DataTokens:</b>");
foreach (var variable in RouteData.DataTokens)
{
Response.Write($"<li>{variable.Key} = {variable.Value}</li>");
}
}
}
}
}

运行结果

ASP.NET Web API 路由