.NET7后端框架:一句话启动

  • .NET7后端框架:一句话启动已关闭评论
  • 91 次浏览
  • A+
所属分类:.NET技术
摘要

.NET6 开始,.NET Croe API 项目取消了 Startup.cs 文件,在 Program.cs 文件的 Main 函数中完成服务的注册和中间件管道的管理。但当我们项目引入更多包的时候,Program.cs 文件也会看起来很臃肿。
而且,我们不只会有一个后端项目,为了方便快速创建后端框架,我们可以将基础服务移植到单独项目中进行管理。


前言

.NET6 开始,.NET Croe API 项目取消了 Startup.cs 文件,在 Program.cs 文件的 Main 函数中完成服务的注册和中间件管道的管理。但当我们项目引入更多包的时候,Program.cs 文件也会看起来很臃肿。
而且,我们不只会有一个后端项目,为了方便快速创建后端框架,我们可以将基础服务移植到单独项目中进行管理。

那么,就从 Program.cs 开始。

创建项目

先创建三个项目,一个 ASP.NET Core Web API 项目,两个 C#类库 项目。结构如下:
.NET7后端框架:一句话启动

  • AMO.API 项目作为启动项目
  • AMO.Core 作为基础服务项目
  • AMO.Entities 作为实体项目

迁移

编辑 AMO.Core 项目文件,添加 Microsoft.AspNetCore.App 框架引用,否则无法引用WebApplicationBuilder类;将 AMO.API 项目中默认添加的 Swagger 包引用复制过来。同时修改输出路径为 ..AMO.APIbin

<Project Sdk="Microsoft.NET.Sdk">   <PropertyGroup>     <TargetFramework>net7.0</TargetFramework>     <ImplicitUsings>enable</ImplicitUsings>     <Nullable>enable</Nullable>     <BaseOutputPath>..AMO.APIbin</BaseOutputPath>   </PropertyGroup>   <ItemGroup>     <FrameworkReference Include="Microsoft.AspNetCore.App" />     <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="7.0.0" />     <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />   </ItemGroup> </Project> 

AMO.Core 项目新增文件夹 StartupExtensions 以后依赖项的管理都在该文件夹下。
创建一个静态类 AppStart.cs ,定义 Run 静态方法,将 Program.cs 中服务注册和管道配置的代码迁移该方法中。

using Microsoft.AspNetCore.Builder; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting;  namespace AMO.Core.StartupExtensions {     /// <summary>     /// 启动程序     /// </summary>     public static class AppStart     {         /// <summary>         /// 运行程序         /// </summary>         /// <param name="builder">WebApplicationBuilder</param>         public static void Run(this WebApplicationBuilder builder)         {             // Add services to the container.              builder.Services.AddControllers();             // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle             builder.Services.AddEndpointsApiExplorer();             builder.Services.AddSwaggerGen();              var app = builder.Build();              // Configure the HTTP request pipeline.             if (app.Environment.IsDevelopment())             {                 app.UseSwagger();                 app.UseSwaggerUI();             }              app.UseHttpsRedirection();              app.UseAuthorization();               app.MapControllers();              app.Run();         }     } }  

修改 AMO.API 项目文件,引入 AMO.Core 的项目引用,删除 Swagger 包。

<Project Sdk="Microsoft.NET.Sdk.Web">   <PropertyGroup>     <TargetFramework>net7.0</TargetFramework>     <Nullable>enable</Nullable>     <ImplicitUsings>enable</ImplicitUsings>   </PropertyGroup>   <ItemGroup>     <ProjectReference Include="..AMO.CoreAMO.Core.csproj" />   </ItemGroup> </Project> 

在 Program.cs 使用扩展方法。

using AMO.Core.StartupExtensions;  namespace AMO.API {     public class Program     {         public static void Main(string[] args)         {              WebApplication.CreateBuilder(args).Run();         }     } } 

最后

生成解决方案,启动项目。熟悉的 Swagger 页面出来了。
.NET7后端框架:一句话启动

之所以这么改造,主要目的是将后端框架的基础服务抽离到 AMO.Core 项目中,以便以后有新项目,能够快速复用。
当然,你可以发现 Program.cs 清爽了,但 AppStart.cs 后续引入新的包后,还不是一样会臃肿?
那么,后续我们将继续对 AppStart.cs 进一步优化。

题外

近期我司开源了一套简洁又功能完整的WMS系统: ModernWMS,采用 Vue3 + TS + Vuetify + .Net7 + EF Core 框架。欢迎来踩。
在线体验地址: https://wmsonline.ikeyly.com/
Github: https://github.com/fjykTec/ModernWMS
Gitee:https://gitee.com/modernwms/ModernWMS