本文介绍在项目中如何配置 Util 依赖服务.
文章分为多个小节,如果对设计原理不感兴趣,只需要阅读基础用法部分即可.
基础用法
Asp.Net Core 项目服务配置
调用 WebApplicationBuilder 实例的 AsBuild 方法, 并以链式调用Util服务扩展.
范例
var builder = WebApplication.CreateBuilder( args );
builder.AsBuild()
.AddAop()
.AddUtc()
.AddSerilog()
.AddSqlServerUnitOfWork( builder.Configuration.GetConnectionString( "DefaultConnection" ) )
.AddUtil();
控制台项目服务配置
调用 IHostBuilder 实例的 AsBuild 方法, 并以链式调用Util服务扩展.
范例
Host.CreateDefaultBuilder( args )
.AsBuild()
.AddSerilog()
.AddUtil()
.Build()
.Run();
设计动机
.Net 默认的服务配置方式是在 IServiceCollection 实例调用服务扩展方法.
下面的代码用于添加Asp.Net Core Web Api控制器服务.
var builder = WebApplication.CreateBuilder( args );
builder.Services.AddControllers();
.Net 在 IServiceCollection 上扩展了大量的服务配置方法.
不仅如此,第三方类库也会添加自己的服务扩展到 IServiceCollection .
最少记忆原则是应用框架设计原则之一.
应用框架的封装,应尽量减少开发人员需要记忆的内容.
代码提示能够帮助开发人员记忆.
大量的扩展方法降低了代码提示的作用,在不看文档的情况下,你很难知道哪些服务扩展是 Util应用框架相关的.
Util应用框架定义了用来专门聚集服务配置的接口 IAppBuilder,从而将Util应用框架提供的服务配置方法从 IServiceCollection 分离出来.
AsBuild 方法返回 IAppBuilder 实例,现在你只需有个模糊的印象就能调用Util应用框架提供的服务配置方法.
源码解析
AppBuilder
AppBuilder 是 IHostBuilder 的简单包装.
///
/// 应用生成器
///
public interface IAppBuilder {
///
/// 主机生成器
///
public IHostBuilder Host { get; }
///
/// 构建
///
public IHost Build();
}
///
/// 应用生成器
///
public class AppBuilder : IAppBuilder {
///
/// 初始化应用生成器
///
/// 主机生成器
public AppBuilder( IHostBuilder host ) {
Host = host ?? throw new ArgumentNullException( nameof( host ) );
}
///
public IHostBuilder Host { get; }
///
/// 构建
///
public IHost Build() {
return Host.Build();
}
}
AsBuild扩展方法
已为 IHostBuilder 和 WebApplicationBuilder 添加 AsBuild扩展方法.
///
/// 主机生成器服务扩展
///
public static class IHostBuilderExtensions {
///
/// 转换为Util应用生成器
///
/// 主机生成器
public static IAppBuilder AsBuild( this IHostBuilder hostBuilder ) {
hostBuilder.CheckNull( nameof( hostBuilder ) );
return new AppBuilder( hostBuilder );
}
}
///
/// Web应用生成器扩展
///
public static class WebApplicationBuilderExtensions {
///
/// 转换为Util应用生成器
///
/// Web应用生成器
public static IAppBuilder AsBuild( this WebApplicationBuilder builder ) {
builder.CheckNull( nameof( builder ) );
return new AppBuilder( builder.Host );
}
}
服务配置扩展
当 Util 应用框架内置功能无法满足你的需求时,可以自行扩展.
如果扩展功能需要进行配置,可以扩展到 IAppBuilder,以方便调用.
创建 AppBuilderExtensions 静态类, 为 IAppBuilder 添加服务器托管网服务扩展方法.
约定,服务配置名称应以 Add 开头.
IAppBuilder 可以获取 IHostBuilder 实例,调用它的 ConfigureServices 方法进行配置.
服务配置扩展范例
///
/// 业务锁操作扩展
///
public static class AppBuilderExtensions {
///
/// 配置业务锁
///
/// 应用生成器
public static IAppBuilder AddLock( this IAppBuilder builder ) {
builder.CheckNull( nameof( builder ) );
buil服务器托管网der.Host.ConfigureServices( ( context, services ) => {
services.TryAddTransient();
} );
return builder;
}
}
服务器托管，北京服务器托管，服务器租用 http://www.fwqtg.net
机房租用，北京机房租用，IDC机房托管， http://www.fwqtg.net
