• Asp.Net MVC :路由器


    特性路由

    特性路由是对现有路由系统的扩展,提供了一种针对某个具体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();
        }
    }
     
  • 相关阅读:
    H5小游戏的坑点小结
    禁用iOS的UIView长按默认操作
    chrome诡异的Provisional headers are shown
    手机浏览器音频内核的坑
    libuv在cocos2d-x中的使用
    windows下codelite的使用
    windows下clang的安装与使用
    ztree选父不选子选子不选父
    <c:forEach>判断第一条或最后一条记录
    iframe高度自适应的方法
  • 原文地址:https://www.cnblogs.com/icebutterfly/p/7976955.html
Copyright © 2020-2023  润新知