ASP.NET Core 中的端点数据源如何动态注册路由?

畫卷琴夢
发布: 2025-09-27 09:52:01
原创
693人浏览过
答案:ASP.NET Core通过DynamicRouteValueTransformer、IEndpointRouteBuilder或自定义EndpointDataSource实现动态路由。1. 使用DynamicRouteValueTransformer可在请求时动态解析路由,适合根据上下文匹配控制器/动作;2. 通过DynamicEndpointService在运行时收集并应用新路由,适用于插件式或配置驱动场景;3. 自定义EndpointDataSource可从数据库等外部源加载端点,并结合ChangeToken实现热更新。应根据需求选择机制,注意性能与线程安全。

asp.net core 中的端点数据源如何动态注册路由?

在 ASP.NET Core 中,可以通过 EndpointDataSource 结合自定义路由扩展机制实现动态注册路由。虽然 EndpointDataSource 本身是用于描述已注册的端点的只读数据源,但要实现“动态注册”,关键在于使用 DynamicRouteValueTransformer 或直接操作 IRouteBuilder / IEndpointRouteBuilder 在运行时添加或修改路由。

1. 使用 MapDynamicControllerRoute 实现动态路由匹配

适合需要根据请求上下文动态决定控制器/动作的场景。通过继承 DynamicRouteValueTransformer,可以在运行时解析路由参数。

示例:

定义一个动态转换器:

public class CustomRouteTransformer : DynamicRouteValueTransformer
{
    public override ValueTask<RouteValueDictionary?> TransformAsync(HttpContext httpContext, RouteValueDictionary values)
    {
        var path = httpContext.Request.Path.Value?.TrimStart('/');

        if (string.IsNullOrEmpty(path))
            return ValueTask.FromResult<RouteValueDictionary?>(null);

        var parts = path.Split('/');
        if (parts.Length == 2 && parts[0] == "dynamic")
        {
            return ValueTask.FromResult<RouteValueDictionary?>(new RouteValueDictionary
            {
                ["controller"] = "Home",
                ["action"] = "Index",
                ["id"] = parts[1]
            });
        }

        return ValueTask.FromResult<RouteValueDictionary?>(null);
    }
}
登录后复制

Program.cs 中注册:

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapDynamicControllerRoute<CustomRouteTransformer>("{**slug}");
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});
登录后复制

2. 运行时动态添加端点(通过 IEndpointRouteBuilder)

若需在应用启动后按需注册新路由(如插件系统或配置驱动),可在服务中持有 Action<IEndpointRouteBuilder> 集合,并在中间件中重新应用。

步骤如下:

  • 定义一个可变的路由配置列表
  • 创建中间件,在每次请求前检查是否需要更新路由表
  • 使用 ApplicationBuilder 重新构建路由(注意性能影响)
简化示例:

定义动态注册器:

public class DynamicEndpointService
{
    private readonly List<Action<IEndpointRouteBuilder>> _routes = new();

    public void AddRoute(string pattern, RequestDelegate handler)
    {
        _routes.Add(endpoints =>
        {
            endpoints.Map(pattern, handler);
        });
    }

    public void ApplyRoutes(IEndpointRouteBuilder builder)
    {
        foreach (var route in _routes)
        {
            route(builder);
        }
    }
}
登录后复制

注册服务:

黑点工具
黑点工具

在线工具导航网站,免费使用无需注册,快速使用无门槛。

黑点工具 18
查看详情 黑点工具
builder.Services.AddSingleton<DynamicEndpointService>();
登录后复制

Program.cs 中使用:

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    var dynamicService = endpoints.ServiceProvider.GetRequiredService<DynamicEndpointService>();
    dynamicService.ApplyRoutes(endpoints);

    endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}");
});
登录后复制

之后可在任意位置注入 DynamicEndpointService 并添加新路由。

3. 自定义 EndpointDataSource(高级用法)

若需完全控制端点发现,可实现 EndpointDataSource,并结合 ChangeToken 实现热更新。

此类适用于需要从数据库、配置中心等外部源加载路由的场景。

  • 实现 EndpointDataSource 接口
  • 重写 EndPoints 属性返回当前有效端点列表
  • 使用 ChangeToken.OnChange 监听数据变更并触发刷新

然后通过 UseEndpoints 添加该数据源:

endpoints.DataSources.Add(new CustomEndpointDataSource());
登录后复制

基本上就这些。根据需求选择方式:简单动态匹配用 DynamicRouteValueTransformer,运行时增删用服务协调,复杂场景可自定义 EndpointDataSource。核心是利用 ASP.NET Core 的路由中间件扩展能力,不建议频繁重建路由表,注意线程安全和性能。

以上就是ASP.NET Core 中的端点数据源如何动态注册路由?的详细内容,更多请关注php中文网其它相关文章!

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号