只为成功找方向,不为失败找借口

每天都不能停止前进的脚步
  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

Asp.Net MVC :路由器

Posted on 2017-12-04 14:39  冰碟  阅读(246)  评论(0编辑  收藏  举报

特性路由

特性路由是对现有路由系统的扩展,提供了一种针对某个具体Controller类型或Action方法的路由注册方式。从而可以对路由规则进行细粒度的设计。

特性路由(Attribute Route)就是利用标注在Controller类型或Action方法上的特性来提供路由规则的路由注册方式。

1、 注册

默认情况下特性路由功能是关闭的,需要调用RouteCollection的扩展方法MapMvcAttributeRoutes来开启。

这个方法的调用要放在路由注册之前。

public static void RegisterRoutes(RouteCollection routes)

{
    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
 
    RouteTable.Routes.MapMvcAttributeRoutes();
 
    routes.MapRoute(
    name: "Default",
    url: "{controller}/{action}/{id}",
    defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
    );
}
 
public class MoviesController : Controller
{
    // GET: Movies
    public ActionResult Index()
    {
        return View();
    }
    [HttpGet]
    [Route("movies/{id}")]
    public ActionResult GetMoviesById(string id)
    {
        ViewBag.id = id;
        return View();
    }
    [HttpGet]
    [Route("movies/starring/{starring}")]
    [Route("movies/starring/{starring}/{genre}")]
    [Route("movies/director/{director}/{genre}")]
    public ActionResult FindMovies(string starring, string director, string genre)
    {
        ViewBag.starring = starring;
        ViewBag.director = director;
        ViewBag.genre = genre;
        return View();
    }
}

默认情况下使用特性类型RouteAttribute,它实现了接口IRouteInfoProvider。

当使用RouteAttribute时,需要提供一个路由模版来对Template这个只读属性进行初始化。而如果需要用这个路由特性注册的路由对象来生成URL,还需要为它提供一个Name,以便可以从路由表中把它提取出来。

2、 为特性路由的变量添加约束

路由变量基本都会直接绑定到目标Action方法相应的参数上,由于这些变量值在请求URL中以字符串的形式体现,所以被绑定参数必需支持源自字符串的类型转换。

为了确保参数绑定的正常进行,需要对路由变量在数据类型上进行约束。这些约束可以直接以内联的形式定义在路由模版里。

[HttpGet]

[Route("movies/{id:range(20,50)}")]
public ActionResult GetMoviesById(int id)

对于路由系统来说,约束通过RouteContraint对象来表示,所有RouteContraint类型均实现了IRouteContraint接口。

特性路由的这些以内联形式定义在路由模版中的约束,它们的约束类型也是实现了IRouteContraint接口。

 

系统提供的约束
约束 描述 用法 类型
bool 类型匹配 (布尔类型) {x:bool} BoolRouteContraint
datetime 类型匹配 (DateTime类型) {x:datetime} DateTimeRouteContraint
decimal 类型匹配 (Decimal类型) {x:decimal} DecimalRouteContraint
double 类型匹配 (Double类型) {x:double} DoubleRouteContraint
float 类型匹配 (Float类型) {x:float} FloatRouteContraint
guid 类型匹配 (Guid类型) {x:guid} GuidRouteContraint
int 类型匹配 (32位整数) {x:int} IntRouteContraint
long 类型匹配 (64位整数) {x:long} LongRouteContraint
alpha 字符组成(必须有拉丁字母组成) {x:alpha} AlphaRouteContraint
regex 字符组成(必须与指定的正则匹配) {x:regex(^\d{3}-\d{3}-\d{4}$)} RegexRouteContraint
max 值范围(小于或等于指定的最大值) {x:max(20)} MaxRouteContraint
min 值范围(大于或等于指定的最小值) {x:max(20)} MinRouteContraint
range 值范围(在指定的最大值和最小值之间) {x:range(20,50)} RangeRouteContraint
maxlength 字符串长度(小于或等于指定的最大长度) {x:maxlength(20)} MaxLengthRouteContraint
minlength 字符串长度(大于或等于指定的最小长度) {x:minlength(20)} MinlengthRouteContraint
length 字符串长度(等于指定的长度或者在指定的范围内) {x:length(6)} LengthRouteContraint

3、 为路由变量设置缺省值

1.将对应的参数定义为可缺省参数,路由模版里使用“?”

[HttpGet]

[Route("movies/language/{language?}")]
public ActionResult GetMoviesByLanguage(string language = "en")
{
    return View();
}

2.将默认值定义在路由模版中

[HttpGet]

[Route("movies/language/{language=en}")]
public ActionResult GetMoviesByLanguage(string language)
{
    return View();
}

4、 设置模版前缀

使用RoutePrefixAttribute类型的特性,它只有一个只读属性Prefix,表示目标Controller所有Action方法共享的URL前缀。这个属性只能应用在Controller类型上,且只能有一个。

 

[RoutePrefix("movies")]

public class MoviesController : Controller
{
    [HttpGet]
    [Route("{id:range(20,50)}")]
    public ActionResult GetMoviesById(int id)
    {
        ViewBag.id = id;
        return View();
    }
    [HttpGet]
    [Route("starring/{starring}")]
    [Route("starring/{starring}/{genre}")]
    [Route("director/{director}/{genre}")]
    public ActionResult FindMovies(string starring, string director, string genre)
    {
        ViewBag.starring = starring;
        ViewBag.director = director;
        ViewBag.genre = genre;
        return View();
    }
 
    [HttpGet]
    [Route("~/actors/{criteria}")] //使用“~”为前缀,屏蔽掉Controller类型上的前缀“movies”
    public ActionResult FindActors(string criteria)
    {
        return View();
    }
}

5、 设置Area名

使用RouteAreaAttribute类型的特性,它由两个属性AreaName和AreaPrefix,默认情况下使用AreaName做模版前缀,如果希望具有一个不同于Area名称的前缀,则要通过设置AreaPrefix属性来实现。

如果没有使用字符“~”前缀,特性路由的完整格式为{AreaPrefix}/{RoutePrefix}/{Template} 或者{AreaName}/{RoutePrefix}/{Template} 。

[RouteArea("MoviesArea")]//[RouteArea()]

[RoutePrefix("movies")]
public class MoviesController : Controller
{
    [HttpGet]
    [Route("{id:range(20,50)}")]
    public ActionResult GetMoviesById(int id)
    {
        ViewBag.id = id;
        return View();
    }
    [HttpGet]
    [Route("starring/{starring}")]
    [Route("starring/{starring}/{genre}")]
    [Route("director/{director}/{genre}")]
    public ActionResult FindMovies(string starring, string director, string genre)
    {
        ViewBag.starring = starring;
        ViewBag.director = director;
        ViewBag.genre = genre;
        return View();
    }
 
    [HttpGet]
    [Route("~/admin/actors/{criteria}")] //使用“~”为前缀,屏蔽掉Controller类型上的前缀“movies”
    public ActionResult FindActors(string criteria)
    {
        return View();
    }
}

 

6、 直接应用到Controller上的RouteAttribute

[RouteArea("vedio")]

[RoutePrefix("movies")]
[Route("{action}/{id}", Name = "FindMovies")]
public class MoviesController : Controller
{
    public ActionResult Index(string id)
    {
        throw new NotImplementedException();
    }
}