【NetCore】10-路由定义

文章目录

  • [路由与终结点:如何规划好Web Api](#路由与终结点:如何规划好Web Api)
    • [1. 路由](#1. 路由)
      • [1.1 路由映射](#1.1 路由映射)
      • [1.2 路由注册方式](#1.2 路由注册方式)
      • [1.3 路由约束](#1.3 路由约束)
      • [总结: Web Api定义](#总结: Web Api定义)

路由与终结点:如何规划好Web Api

1. 路由

1.1 路由映射

路由系统核心作用是指URL和应用程序Controller的对应关系的一种映射
这种映射的作用:

1.把URL映射到对应的Controller的action上

2.根据Controller和action的名字生成URL

1.2 路由注册方式

  • 路由模板的方式 ⇒ 传统方式,可作为MVC页面的Web配置
  • RouteAttribute方式 ⇒ 更适合Web Api

1.3 路由约束

路由约束指的是路由如何匹配

  • 类型约束
  • 范围约束
  • 正则约束
  • 是否必选
  • 自定义IRouteConstraint

根据路由信息URL生成地址的类

  • LinkGenerator

  • IUrlHelper

    复制代码
      	/// <summary>
          /// 类型约束
          /// </summary>
          /// <param name="id">必须可以转long</param>
          /// <returns></returns>
          [HttpGet("{id:MyRouteConstraint}")]
          public bool OrderExist(object id)
          {
              return true;
          }
    
          /// <summary>
          /// 范围约束
          /// </summary>
          /// <param name="id"></param>
          /// <returns></returns>
          [HttpGet("{id:max(20)}")]
          public bool Max(long id)
          {
              return true;
          }
    
          /// <summary>
          /// 是否必选
          /// </summary>
          /// <param name="name"></param>
          /// <returns></returns>
          [HttpGet("{name:required}")]
          public bool Reque(string name)
          {
              return true;
          }
    
          /// <summary>
          /// 正则约束
          /// </summary>
          /// <param name="number"></param>
          /// <returns></returns>
          [HttpGet("{number:regex(^\\d{{3}}$)}")]
          public bool Bumber(string number)
          {
    
              return true;
          }

    // 自定义IRouteConstraint
    // 自定义路由约束类
    public class MyRouteConstraint : IRouteConstraint
    {
    public bool Match(HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
    {
    if (RouteDirection.IncomingRequest == routeDirection)
    {
    var v= values[routeKey];
    if (long.TryParse(v.ToString(),out var value))
    {
    return true;
    }
    }
    return false;
    }
    }

    // startup中ConfigureServices
    services.AddRouting(options =>
    {
    options.ConstraintMap.Add("MyRouteConstraint", typeof(MyRouteConstraint));
    });

    [HttpGet("{id:MyRouteConstraint}")]
    public bool OrderExist([FromRoute]string id)
    {
    return true;
    }

LinkGenerator生成Url

复制代码
[HttpGet("{id:max(20)}")]
public bool Max([FromRoute] long id, [FromServices] LinkGenerator linkGenerator)
{
      var a = linkGenerator.GetPathByAction(HttpContext,
          action: "Reque",
          controller: "Order",
          values: new { name = "abc" });

      var uri = linkGenerator.GetUriByAction(HttpContext,
          action: "Reque",
          controller: "Order",
          values: new { name = "abc" });
      return true;

  }

总结: Web Api定义

  • Restful不是必须的
  • 约定好API的表达契约
  • 将API约束在特定目录下,如/api/
  • 使用ObsoleteAttribute标记即将废弃的API
相关推荐
@Kerry~11 分钟前
phpstudy .htaccess 文件内容
java·开发语言·前端
CRMEB系统商城11 分钟前
CRMEB多商户系统(PHP)v3.3正式发布,同城配送上线[特殊字符]
java·开发语言·小程序·php
sali-tec39 分钟前
C# 基于halcon的视觉工作流-章45-网格面划痕
开发语言·算法·计算机视觉·c#
一壶浊酒..42 分钟前
python 爬取百度图片
开发语言·python·百度
机器视觉知识推荐、就业指导43 分钟前
C语言中的预编译是什么?何时需要预编译?
c语言·开发语言
该用户已不存在1 小时前
工具用得好,Python写得妙,9个效率工具你值得拥有
后端·python·编程语言
·心猿意码·1 小时前
C++智能指针解析
开发语言·c++
广龙宇1 小时前
【一起学Rust · 项目实战】使用getargs库来获取命令行参数
开发语言·python
沐知全栈开发1 小时前
HTML 颜色名
开发语言
property-2 小时前
C++中#define和const的区别
开发语言·c++