.NET 6 Minimal API的经验分享

Minimal API 是 .NET 6 提供的最新功能 ，对比传统的 ASP.NET Core Web API 方式更加直接 , 你可以用几行代码编写好 REST API 。没有了祖传的 Startup.cs 和 Controller ，通过简单的代码就可以完成 API 的开发。在第二阶段的 .NET 挑战赛中就以 .NET 6 中 的 Minimal API 作为学习的主线来完成相关的云原生应用。有小伙伴问怎么可以用好 Minimal API ，如何去架构一个 Minimal API 的云原生解决方案 ,今天我和大家分享一下。.

MapGet 是 EndpointRouteBuilderExtensions 类的扩展方法， 你可以看到它设定了路由规则后， 会传递一个委托参数 ， 编译器会将它转换为 RequestDelegate ，通过它来取代 Controller 的工作。然后使用 app.Run() 方法来运行我们的 Minimal API 应用程序。

在传统的 Web API 通过 Controller ，针对不同的功能进行 CRUD 的开发， 但如果我们是 Minimal API 呢 ， 要如何组织呢 ？还有我们是否还能用 Repository Pattern 呢 ？

1. Controller 再见

假设我们要搭建一个关于课程信息的 API， 有课程基本信息(课程类型，课程列表)和选课信息(学生选课，每门课学生选课信息)，如果从传统 Web API 你需要添加 CourseController 和 BookController 两个控制器，通过不同 Action 去对应相关路由 ，但对于 Minimal API 如果我们涉及很多的路由就会让我们的 Program.cs 文件过大，非常不好管理。那我们把功能点切分，或者说重新模拟 Controller 去划分还是非常好的。

如上图 ，是我画的一个图 ，通过把 Course 和 Book 划分为两个 Module ， 在 Module 里都包含了路由的设置 。这个时候我们做一个接口 ，因为每个 Module 都需要包含添加路由的方法，所以把它做成一个接口 IBaseModule ，以后不同的 Module 都可以用 。

如何添加进去 Program.cs ? 我们来用一个 IEndpointRouteBuilder 的扩展方法 ，把路由添加都归类进来

public static class ModuleExtensions
{
    public static void Routers(this IEndpointRouteBuilder builder)
    {
        CourseModule courseModule = new CourseModule();
        BookModule bookModule = new BookModule();
        courseModule.AddModuleRoutes(builder);
        bookModule.AddModuleRoutes(builder);
    }
}

这里有一个技巧就是我们可以通过以下 typeof 找到继承于 IBaseModule 的 Module 并将它实例化后调用添加路由的方法。

public static void Routers(this IEndpointRouteBuilder builder)
    {
        var modules = typeof(IBaseModule).Assembly
            .GetTypes()
            .Where(p => p.IsClass && p.IsAssignableTo(typeof(IBaseModule)))
            .Select(Activator.CreateInstance)
            .Cast<IBaseModule>();
        foreach(var module in modules)
        {
            module.AddModuleRoutes(builder);
        }
    }

2. Repostitory 模式能延续吗 ？

这是毫无疑问可以继续使用。通过 Repository 模式你不需要去关心你所使用的 ORM 是什么 ， 与 ORM 的所有处理过程都在 Repository 层中处理掉 , 通过这样去减少耦合， 提供更好的可测试性。在微软文档中，有以下的比较

在 Minimal API 使用 Repository Pattern 在整体上和传统的 ASP.NET MVC 没有不同 ，这里是我用 Repository 模式架构的 Minimal API 的截图

注意一点有人认为 Repository 模式有点过时 ，和过度架构 ， 但我觉得还是非常有必要的，因为这样可以更好管理你的项目。

3. 依赖注入

依赖注入解决了应用程序如何独立于对象创建方式的问题。当您需要可配置的应用程序单元测试时，这非常有用。随着应用程序的规模和复杂性的增长，依赖注入可帮助您更轻松地更改应用程序。在 ASP.NET Core 中有非常好用的依赖注入方式 ， 这点在 Minimal API 也是。由于我们针对功能模块去管理 ，所以在依赖注入时也可以针对模块功能去进行 。以下是我针对模块依赖注入的设计， 结合 Repository 模式以及上面提到的 ModuleExtension.cs 进行的调整 ， 我也把关于数据连接公用的依赖注入也抽象了出来。

public static class ModuleExtensions
{
    static readonly List<IBaseModule> moduleList = new List<IBaseModule>(); 
    private static IEnumerable<IBaseModule> GetModules()
    {
        var modules = typeof(IBaseModule).Assembly
            .GetTypes()
            .Where(p => p.IsClass && p.IsAssignableTo(typeof(IBaseModule)))
            .Select(Activator.CreateInstance)
            .Cast<IBaseModule>();
        return modules;
    }
    public static void Routers(this IEndpointRouteBuilder builder)
    {
        foreach(var module in moduleList)
        {
            module.AddModuleRoutes(builder);
        }
    }
    public static void AddIoC(this IServiceCollection services)
    {
        foreach(var module in GetModules())
        {
            module.AddModuleIoC(services);
            moduleList.Add(module);
        }
    }
    public static void AddGlobalConfig(this IServiceCollection services)
    {
        services.AddScoped<CourseDataContext>();
        services.AddScoped<IUnitOfWork, UnitOfWork>();
    }
}

注意一些地方，虽然在 Minimal API 上 ，我们的依赖注入虽然把不同的Services 注册了单例给 RequestDelegate 所调用，但在作为参数传送时，要添加 [FromServices] 属性标签才有效 , 如下。

app.MapGet("/Course/GetCourse" ,([FromServices] ICourseService courseService , int typeID)=> {       
        return  courseService.GetCourseList(typeID);
    });

在云原生的年代 ， Minimal API 是 .NET 的又一把利器 。.NET 6 的 Minimal API 要用好 ，实际上还是用到不少旧知识，像 Module 的构建方式，我参考了开源的 Carter( https://github.com/CarterCommunity/Carter ) ， 像 Repository 模式还是没有变 ，当然还是那些熟悉的语法 C# ， 这就是我们常说的 ”万变不离其中“ 。Minimal API 不是要取代 Web API , 更多是给开发人员多一个选择 。作为 .NET 学习挑战赛知识点的补充 ， 希望能给各位小伙伴更深刻了解 Minimal API 在实际应用场景的技巧 。本次的示例代码也放到我的 GitHub 上了 ，如果各位小伙伴感兴趣可以访问该链接获取完整的代码 https://github.com/kinfey/MinimalAPIDemo 。