解决程序配置项重复引用的问题,比如我们有一个GitHubSetting配置项, 我们可以在任意地方注入GitHubSetting,系统会自动将配置项注入到我们的业务代码中,并且可以在系统中动态修改配置项, 修改后会自动持久化到存储中,并通知集群的订阅子节点Setting配置项变更事件,清空缓存并重新加载持久层的最新项 案例项目:BiwenSettingsMutiNodeTest
当前仓储可以是一个抽象的概念,可以任意横向实现.比如使用多个数据库负载,或者多个Redis等.只要能保证数据一致性即可
- 一个简单例子 比如我有一个Web站点,这个Web站点有很多的负载,以及一一些小程序后台服务 ,
- 这些独立的程序(或者裂变或者使用代理转发的微服务), 都使用同一个 WX账号收账,那么这些站点或者后台服务都可以是这个WX账号配置的消费节点,
- 这些节点可以配置一个或者多个作为主节点,当任意一个主节点修改配置项时,主动通知其他子节点更新配置,并且清空配置的缓存服务并重新加载Store!
- dotnet add package Biwen.Settings
- Windows 10
- Rider 2022 / Visual Studio 2022 / Visual Studio Code
- .NET 8.0
[* 示例项目]
- implements IBiwenSettingsDbContext
public class MyDbContext : DbContext, IBiwenSettingsDbContext
{
public MyDbContext(DbContextOptions<MyDbContext> options)
: base(options)
{
}
public DbSet<Setting> Settings { get; set; }
protected override void OnModelCreating(ModelBuilder builder)
{
base.OnModelCreating(builder);
//根据情况自定义表名
builder.Entity<Setting>(b =>
{
b.ToTable("Settings");
});
//可以根据自己的情况约束存储列
//builder.Entity<Setting>().HasKey(x => x.SettingName);
//builder.Entity<Setting>().Property(x => x.SettingName).HasMaxLength(500);
}
}- Add a new Entity Framework Core migration to save your changes
dotnet ef migrations add biwenSettings
dotnet ef database update- 直接跳入step 2.2
- 2.1 如果使用Biwen.Settings提供的EF仓储,必须注入DBContext
builder.Services.AddDbContext<MyDbContext>(options =>
{
//根据您的情况使用任意EFCore支持的数据库
//当前使用内存数据库作为演示.生产环境务必修改!
options.UseInMemoryDatabase("BiwenSettings");
});- 2.2 如果使用自定义仓储,请实现ISettingManager并修改AddBiwenSettings()
options.UseSettingManager<T,V>()- AddBiwenSettings & UseBiwenSettings
builder.Services.AddBiwenSettings(options =>
{
//ProjectId : 项目标识 用于区分不同的项目,比如:日志系统,文件系统;或者环境,比如:开发环境,测试环境,生产环境
#if DEBUG
options.ProjectId = $"Biwen.Settings.TestWebUI-{"Development"}";
#endif
#if !DEBUG
options.ProjectId = $"Biwen.Settings.TestWebUI-{"Production"}";
#endif
//自定义布局
options.Layout = "~/Views/Shared/_Layout.cshtml";
options.Title = "Biwen.Settings";
//路由地址 ,http://..../system/settings
options.Route = "system/settings";
//授权规则
options.PermissionValidator = (ctx) => true;
options.EditorOptions.EditorOnclick = "return confirm('Are You Sure!?');";
options.EditorOptions.EdtiorConfirmButtonText = "Submit";
options.EditorOptions.EditorEditButtonText = "Edit";
options.EditorOptions.ShouldPagenation = true;
//开启AutoFluentValidation
options.AutoFluentValidationOption.Enable = true;
//支持缓存提供者,默认不使用缓存
options.UseCacheOfNull();
//您也可以使用Biwen.Settings提供内存缓存:MemoryCacheProvider
//options.UseCacheOfMemory();
//使用自定义缓存提供者
//options.UseCache<T>();
//配置当前服务为主节点
options.NotifyOptions.IsNotifyEnable = true;
options.NotifyOptions.Secret = "Biwen.Settings.Notify";
//子节点配置
options.NotifyOptions.EndpointHosts = new[]
{
"http://localhost:5150"
};
//默认提供EntityFrameworkCore持久化配置项 dbContextType必须配置
//options.UseStoreOfEFCore(options =>
//{
// options.DbContextType = typeof(MyDbContext);
//});
//使用JsonStore持久化配置项
options.UserStoreOfJsonFile(options =>
{
options.FormatJson = true;
options.JsonPath = "systemsetting.json";
});
//自行实现的ISettingManager注册
//options.UseSettingManager<T,V>()
});
//提供对`IOptions`和`IConfiguration`直接支持:
builder.Configuration.AddBiwenSettingConfiguration(builder.Services, true);
app.UseBiwenSettings(mapNotifyEndpoint: true, builder: builder =>
{
builder.WithTags("BiwenSettingApi").WithOpenApi();
});2024-05-17更新 提供对IOptions,IOptionsSnapshot和IConfiguration直接支持:
帮助参见:releases 2.2.0 +
//模拟的配置项,注意描述信息,以及默认值.初始化将以默认值为准
[Description("微信配置")]
public class WeChatSetting : SettingBase
{
[Description("AppId")]
public string AppId { get; set; } = "wx1234567890";
[Description("AppSecret")]
public string AppSecret { get; set; } = "1234567890";
[Description("Token")]
public string Token { get; set; } = "1234567890";
[Description("EncodingAESKey")]
public string EncodingAESKey { get; set; } = "1234567890";
//排序
public override int Order => 500;
//定义验证器
public class WeChatSettingValidtor : AbstractValidator<WeChatSetting>
{
public WeChatSettingValidtor()
{
//验证规则
RuleFor(x => x.AppId).NotEmpty().Length(12, 32);
RuleFor(x => x.AppSecret).NotNull().NotEmpty().Length(12, 128);
}
}
}
/// <summary>
/// 内置验证器的配置项,推荐使用这种方式 ,同时支持`FluentValidation`和`DataAnnotations`
/// </summary>
[Description("内置验证器的配置项测试")]
public class TestAutoValidSetting : ValidationSettingBase<TestAutoValidSetting>
{
[StringLength(50, MinimumLength = 3)] // DataAnnotations支持
public string Name { get; set; } = "Hello"!;
public TestAutoValidSetting()
{
//构造函数中添加验证规则
RuleFor(x => x.Name).NotEmpty().Length(8, 32);
}
override public int Order => 600;
}
//anywhere you can inject
//View:
//@inject WeChatSetting WeChatSetting;
//@inject TestAutoValidSetting TestAutoValidSetting;
//Service:
//public class MyClass
//{
// private readonly WeChatSetting _weChatSetting;
// private readonly TestAutoValidSetting _testAutoValidSetting;
// public MyClass(WeChatSetting weChatSetting,TestAutoValidSetting testAutoValidSetting)
// {
// _weChatSetting = weChatSetting;
// _testAutoValidSetting = testAutoValidSetting;
// }
//}- INotify订阅配置变更
public class WeChatSettingNotify : INotify<WeChatSetting>
{
private readonly ILogger<WeChatSettingNotify> _logger;
public WeChatSettingNotify(ILogger<WeChatSettingNotify> logger)
{
_logger = logger;
}
public async Task Notify(WeChatSetting setting)
{
_logger.LogInformation("微信配置发生变更!");
await Task.CompletedTask;
}
}- Minimal API
//all settings
//GET ~/{RoutePrefix}/all
//get setting by full type name
//GET ~/{RoutePrefix}/get/{id}
//update setting by full type name
//POST ~/{RoutePrefix}/set/{id}
//body:
//{
// "PropertyName1": "...",
// "PropertyName2": "...",
// "PropertyName3": "..."
//}- MIT
- QQ:552175420
- Email: vipwan#sina.com
- [GitHub](https://github.com/vipwan)