使用.NET6实现动态API

 更新时间:2021年12月21日 11:15:36   作者:known  
本文详细讲解了使用.NET6实现动态API,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

ApiLite是基于.NET6直接将Service层生成动态api路由,可以不用添加Controller,支持模块插件化,在项目开发中能够提高工作效率,降低代码量。

开发环境

  • .NET SDK 6.0.100-rc.2.21505.57
  • VS2022 Preview 7.0

项目地址

GitHub: https://github.com/known/ApiLite

项目目标

  • 根据Service动态生成api
  • 支持自定义路由模板(通过Route特性定义)
  • 支持模块插件化
  • 支持不同模块,相同Service名称的路由(命名空间需要有3级以上,例如:Com.Mod.XXX)
  • 自动根据方法名称判断请求方式,Get开头的方法名为GET请求,其他为POST请求

编码约定

  • 模块类库必须包含继承IModule接口的类
  • 需要生成api的Service必须继承IService接口
  • GET请求的方法必须以Get开头

核心代码

主要是ApiFeatureProvider和ApiConvention这两个自定义类来动态生成api,ApiFeatureProvider继承ControllerFeatureProvider,覆写IsController方法,判断服务类型是否符合Controller。ApiConvention实现了IApplicationModelConvention接口,实现动态添加Action。下面是主要代码,完整代码请在GitHub上下载。

static class ServiceExtension
{
    internal static WebApplicationBuilder AddKApp(this WebApplicationBuilder builder, Action<AppOption>? action = null)
    {
        var option = new AppOption();
        action?.Invoke(option);
        ...
        AddDynamicApi(mvcBuilder, option);//添加动态api
        return builder;
    }
 
    private static void AddDynamicApi(IMvcBuilder builder, AppOption option)
    {
        builder.ConfigureApplicationPartManager(m =>
        {
            m.ApplicationParts.Add(new AssemblyPart(typeof(IService).Assembly));
            foreach (var item in option.Modules)
            {
                item.Initialize();//初始化模块
                //将模块添加到ApplicationParts,这样才能发现服务类
                var assembly = item.GetType().Assembly;
                m.ApplicationParts.Add(new AssemblyPart(assembly));
            }
            m.FeatureProviders.Add(new ApiFeatureProvider());
        });
 
        builder.Services.Configure<MvcOptions>(o =>
        {
            o.Conventions.Add(new ApiConvention());
        });
    }
}
 
//判断服务类型是否为Controller
class ApiFeatureProvider : ControllerFeatureProvider
{
    protected override bool IsController(TypeInfo typeInfo)
    {
        if (!typeof(IService).IsAssignableFrom(typeInfo) ||
            !typeInfo.IsPublic ||
            typeInfo.IsAbstract ||
            typeInfo.IsGenericType)
            return false;
 
        return true;
    }
}
 
class ApiConvention : IApplicationModelConvention
{
    public void Apply(ApplicationModel application)
    {
        foreach (var controller in application.Controllers)
        {
            var type = controller.ControllerType;
            if (typeof(IService).IsAssignableFrom(type))
            {
                ConfigureApiExplorer(controller);
                ConfigureSelector(controller);
            }
        }
    }
 
    ...
 
    //构造路由模板
    private string GetRouteTemplate(ActionModel action)
    {
        if (action.Attributes != null && action.Attributes.Count > 0)
        {
            foreach (var item in action.Attributes)
            {
                if (item is RouteAttribute attribute)
                {
                    return attribute.Path;//返回自定义路由
                }
            }
        }
 
        var routeTemplate = new StringBuilder();
        //routeTemplate.Append("api");
        var names = action.Controller.ControllerType.Namespace.Split('.');
        if (names.Length > 2)
        {
            //支持不同模块相同类名,添加命名空间模块名作前缀
            routeTemplate.Append(names[^2]);
        }
 
        // Controller
        var controllerName = action.Controller.ControllerName;
        if (controllerName.EndsWith("Service"))
            controllerName = controllerName[0..^7];
 
        routeTemplate.Append($"/{controllerName}");
 
        // Action
        var actionName = action.ActionName;
        if (actionName.EndsWith("Async"))
            actionName = actionName[..^"Async".Length];
 
        if (!string.IsNullOrEmpty(actionName))
            routeTemplate.Append($"/{actionName}");
 
        return routeTemplate.ToString();
    }
}

使用示例

KHost.Run(args, o =>
{
    o.Modules.Add(new TestModule());//添加模块
});
 
class TestModule : IModule
{
    public void Initialize()
    {
    }
}
 
public class TestService : IService
{
    public string GetName(string name)
    {
        return $"Hello {name}";
    }
 
    public string SaveData(string data)
    {
        return $"{DateTime.Now:yyyy-MM-dd HH:mm:ss} {data}";
    }
 
    [Route("api/test")]
    public string GetCustMethod(string id)
    {
        return id;
    }
}

以上所述是小编给大家介绍的使用.NET6实现动态API,希望对大家有所帮助。在此也非常感谢大家对脚本之家网站的支持!

相关文章

  • .Net性能调优-ArrayPool详情

    .Net性能调优-ArrayPool详情

    ArrayPool具有高性能 托管 数组缓冲池,可重复使用,用 租用 空间的方式代替 重新分配 数组空间的行为的特点及可以在频繁创建和销毁数组的情况下 提高性能 ,减少垃圾回收器的压力的优点,下面文章内容将详细对其做介绍,需要的朋友可以参考一下
    2021-09-09
  • .Net 6中的PeriodTimer介绍

    .Net 6中的PeriodTimer介绍

    这篇文章主要介绍了.Net 6中的PeriodTimer,.net 6中新增了一个异步计时器PeroidTimer,相对普通Timer的回调, 它的模型更简单,下面一起来看看具体详情吧
    2022-01-01
  • ASP.NET Core MVC 过滤器(Filter)

    ASP.NET Core MVC 过滤器(Filter)

    本文小编要给大家介绍的是ASP.NET Core MVC 过滤器,ASP.NET MVC 中的过滤器允许在执行管道中的特定阶段之前或之后运行代码。可以对全局,也可以对每个控制器或每个操作配置过滤器,需要的朋友可以参考下面文章的具体内容
    2021-09-09
  • ASP.NET Core 6最小API中使用日志和DI示例详解

    ASP.NET Core 6最小API中使用日志和DI示例详解

    这篇文章主要为大家介绍了ASP.NET Core 6最小API中使用日志和DI示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • .NET6新特新 struct优化

    .NET6新特新 struct优化

    这篇文章主要给大家分享的是 NET6新特新 struct优化,在.NET6中针对Struct做了一些优化,下面我们就通过一些案例来看一下.NET6中针对Struct的优化,需要的朋友可以参考一下,希望对大家有所帮助
    2021-11-11
  • .Net Core HttpClient处理响应压缩详细

    .Net Core HttpClient处理响应压缩详细

    .Net Core作为后起之秀直接将HttpClient扶正,并且在此基础上改良了HttpClientFactory,接下来我们就来探究一下在.Net Core中使用HttpClient处理响应压缩的机制。,需要的朋友可以参考下面文章的具体内容
    2021-09-09
  • asp.net core使用DevExtreme20将int列转为checkbox方法示例

    asp.net core使用DevExtreme20将int列转为checkbox方法示例

    这篇文章主要为大家介绍了asp.net core使用DevExtreme20将int列转为checkbox方法示例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-08-08
  • 在 ASP.NET Core 中自动启用 CAP 事务详情

    在 ASP.NET Core 中自动启用 CAP 事务详情

    本篇文章旨在描述如何在 ASP.NET Core项目中并以一种简便的方式启用CAP事务,因为在我们的示例中都是直接演示比较直观的方式,没有进行封装,有些初学者同学不太会,找到问我如何封装,本篇文章主要基于 Entity Framework 来进行演示
    2021-10-10
  • ASP.NET Web API教程 创建域模型的方法详细介绍

    ASP.NET Web API教程 创建域模型的方法详细介绍

    本文将介绍几种常见的创建域模型的方法,有需要的朋友可以适当的参考
    2012-11-11
  • ASP.NET MVC Web API HttpClient简介

    ASP.NET MVC Web API HttpClient简介

    依稀还记得那个时候用WebClient,HttpWebRequest来发送一个请求,现在ASP.NET MVC4中自带了一个类HttpClient;需要的朋友可以参考下
    2012-11-11

最新评论