Blog.Core开源将Program升级为.NET6.0版本

Posted 2022-04-12 dotNET跨平台

大家假期好，好久不见，之前忙于其他事情，公众号暂时搁置了一个月了，新的一年开始了，很多小伙伴开始催更了，粉丝的要求必须满足。

2022年打算重点推广BCVP社区，所以还是希望有愿意投稿的小伙伴，积极投稿哟。同时我也有以下几个打算，欢迎广而告之：

1、还是有很多小伙伴对Blog.Core的学习内容和技术知识不是很清晰，所以打算每月开一个直播，主要是以直播公开课的形式分享里边的知识架构（B站直播）；

2、同时也把之前欠的技术难点给补充上，比如GitHub上说的最多的就是部门数据的权限功能（开发中）、数据迁移优化和项目完全升级为.NET6.0（本文所讲）；

3、继续讲讲微服务相关的内容（B站视频录播）；

以上三个知识点会慢慢铺开来进行，也欢迎更多的小伙伴公司使用Blog.Core，如果公司有使用，可得老张技术指导。

老张

https://github.com/anjoy8/Blog.Core/issues/75

废话不多说，直接开始今天的内容分享。

需求说明

ASP.NET6.0正式版已经出来了半年多了，作为一个LTS版本，也是受到官方的强烈推荐和升级建议，自然，作为有3.7k个Star的Blog.Core已经在第一时间更新了6.0，并且一直健壮的运行了很久了，只不过遗留了一个功能点：6.0版本优化了Program.cs的写法，并把Startup.cs给优化掉了，看上去是一个Mini精简版本——采用新的宿主模型。

最小宿主模型：
1）、大大减少了创建应用程序所需的文件和代码行数。只有一个文件需要四行代码。同时也新增特性最小API模型。
2）、Startup.cs将和 Program.cs 合并到单个 Program.cs 文件中。
3）、使用顶级语句减少应用程序所需的代码。
4）、使用全局 using 指令消除或最大程度地减少所需的 using 语句行数。

不过很多小伙伴表示看着别扭和不太习惯，同时我也考虑到我的博客中，都是老的版本，就一直没升级，不过昨天也是尝试了一波，表示改写起来也是比较简单的。

相关的代码已经提交到了GitHub上的mini-program分支，如果大家一周内没问题，我会merge到master分支，欢迎大家clone代码尝试，如果有错误欢迎提issue，如果有其他疑问和建议也欢迎提issue，我会帮助解答。

过程很简单，这里列举下有哪些问题点。

1、使用隐式命名空间引用

如果我们创建一个空的.net6.0webapi项目，可以看到program.cs内容是这样的：

var builder = WebApplication.CreateBuilder(args);


// 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.UseAuthorization();


app.MapControllers();


app.Run();

这里是没有using命名空间的，但是如果我们在类和方法上点击F12，也能看到具体的程序集。同时也没有定义具体的类名和方法名，所以才导致很多小伙伴表示看着比较别扭。

如何实现的呢，就是在.csproj文件里，启动隐式命名空间引用即可：

<ImplicitUsings>enable</ImplicitUsings>

打开obj目录（用于存放编译过程中生成的中间临时文件），在cs文件的对应目录发现了WebApplication1.GlobalUsings.g.cs文件:

虽然看着别扭，但是整体其实也能看的明白，还是定义host、注册服务和配置中间件这三个步骤，两个核心关键点就是.build()完后，容器里才会注册具体的服务实例，.run()完后，项目就正式的启动起来了。

咱们把官方给的写法拷贝到Blog.Core中，就可以改造了。

同时要注意另一个null的配置，如果配置了在controller的action中，会校验空值的，必须传参，所以我的建议还是不开启：

<Nullable>enable</Nullable>

2、配置自定义注入容器

首先说下以官方容器为默认容器，是如何做依赖注入服务注册的，和之前很像：

builder.Services.AddScoped<UseServiceDIAttribute>();
builder.Services.AddSingleton(new Appsettings(builder.Configuration));

用的是builder.Services来处理，将之前的service前边，统一加上builder即可。

当然咱们也用到Autofac，所以需要配置自定义的注入容器：

builder.Host
.UseServiceProviderFactory(new AutofacServiceProviderFactory())
.ConfigureContainer<ContainerBuilder>(builder =>

    builder.RegisterModule(new AutofacModuleRegister());
    builder.RegisterModule<AutofacPropertityModuleReg>();
)

其他的日志配置和app参数配置和之前一样，具体参考Blog.Core代码即可。

3、如何使用配置和环境参数

在第一步中，已经生成了builder，官方已经给我们做好了处理，所以直接作为属性拿来用即可：

4、中间件什么时候开始？

上边的过程是准备阶段，我们把builder.build()后，构建完成，开始配置中间件管道了。

// 3、配置中间件
var app = builder.Build();


if (app.Environment.IsDevelopment())

    app.UseDeveloperExceptionPage();

else

    app.UseExceptionHandler("/Error");
    //app.UseHsts();



app.UseIpLimitMiddle();
app.UseRequestResponseLogMiddle();
app.UseRecordAccessLogsMiddle();
app.UseSignalRSendMiddle();
app.UseIpLogMiddle();
app.UseAllServicesMiddle(builder.Services);
// and so on...

其他的也直接copy过来就行。

5、中间件使用依赖注入服务

在之前的写法中，我们中间件可以作为一个类似构造函数那样，将接口注册，但是现在没有这些东西了，从哪里获取服务呢，比如我们开启QuarzNet任务，可以用原生的写法，从容器ServiceProvider中获取：

var tasksQzServices = scope.ServiceProvider.GetRequiredService<ITasksQzServices>();
var schedulerCenter = scope.ServiceProvider.GetRequiredService<ISchedulerCenter>();
app.UseSeedDataMiddle(myContext, builder.Environment.WebRootPath);
app.UseQuartzJobMiddleware(tasksQzServices, schedulerCenter);

改到这里就没有什么了，直接执行.run()方法就行了。

6、其他需要注意的点

1、Swagger自定义html的Stream

因为Program类的原因，不能直接用this.GetType()了，可以换这种写法：

Assembly.GetExecutingAssembly()
.GetManifestResourceStream("Blog.Core.Api.index.html")

2、其他调用Program.cs

Program使用最小宿主模式后，在其他类库里会访问受限，所以要换成其他的

其他的还没有遇到有需要更新的，Blog.Core也是比较全的项目了，基本涵盖了平时大家开发的功能，当然，如果有自己把握不住的，欢迎GitHub上提issue。

《新程序员》：云原生和全面数字化实践 50位技术专家共同创作，文字、视频、音频交互阅读