Skip to content

Latest commit

 

History

History
97 lines (83 loc) · 3.51 KB

README.zh-CN.md

File metadata and controls

97 lines (83 loc) · 3.51 KB

中 | EN

Masa.Contrib.Isolation.MultiEnvironment

用例：

Install-Package Masa.Contrib.Isolation.UoW.EF
Install-Package Masa.Contrib.Isolation.MultiEnvironment
Install-Package Masa.Utils.Data.EntityFrameworkCore.SqlServer
  1. 配置appsettings.json
{
  "ConnectionStrings": {
    "DefaultConnection": "server=localhost;uid=sa;pwd=P@ssw0rd;database=identity;"
  },
  "IsolationConnectionStrings": [
    {
      "Environment": "development",
      "ConnectionString": "server=localhost,1674;uid=sa;pwd=P@ssw0rd;database=identity;"
    },
    {
      "Environment": "staging",
      "ConnectionString": "server=localhost,1672;uid=sa;pwd=P@ssw0rd;database=identity;"
    }
  ]
}
  • 1.1 当前环境是development时：数据库地址：server=localhost,1674;uid=sa;pwd=P@ssw0rd;database=identity;
  • 1.2 当前环境是staging时：数据库地址：server=localhost,1672;uid=sa;pwd=P@ssw0rd;database=identity;
  • 1.3 当前环境是其他环境时：数据库地址：server=localhost;uid=sa;pwd=P@ssw0rd;database=identity;
  1. 使用Isolation.UoW.EF
builder.Services.AddEventBus(eventBusBuilder =>
{
    eventBusBuilder.UseIsolationUoW<CustomDbContext>(
        isolationBuilder => isolationBuilder.UseMultiEnvironment(),
        dbOptions => dbOptions.UseSqlServer());
});
  1. DbContext需要继承IsolationDbContext
public class CustomDbContext : IsolationDbContext
{
    public CustomDbContext(MasaDbContextOptions<CustomDbContext> options) : base(options)
    {
    }
}
  1. 隔离的表对应的类需要实现IMultiEnvironment

采用物理隔离时也可以选择不实现IMultiEnvironment

总结
  • 控制器或MinimalAPI中环境如何解析？
    • 环境默认提供了7个解析器，执行顺序为：HttpContextItemParserProvider、QueryStringParserProvider、FormParserProvider、RouteParserProvider、HeaderParserProvider、CookieParserProvider、EnvironmentVariablesParserProvider (获取系统环境变量中的参数，默认环境隔离的参数：ASPNETCORE_ENVIRONMENT)
      • HttpContextItemParserProvider: 通过请求的HttpContext的Items属性获取环境信息
      • QueryStringParserProvider: 通过请求的QueryString获取环境信息
      • FormParserProvider: 通过Form表单获取环境信息
      • RouteParserProvider: 通过路由获取环境信息
      • HeaderParserProvider: 通过请求头获取环境信息
      • CookieParserProvider: 通过Cookie获取环境信息
      • EnvironmentVariablesParserProvider: 通过系统环境变量获取环境信息
  • 如果解析器解析环境失败，那最后使用的数据库是?
    • 若解析环境失败，则直接返回DefaultConnection
  • 如何更改默认环境参数名
builder.Services.AddEventBus(eventBusBuilder =>
{
    eventBusBuilder.UseIsolationUoW<CustomDbContext>(
        isolationBuilder => isolationBuilder.UseMultiEnvironment("env"),// 使用环境隔离
        dbOptions => dbOptions.UseSqlServer());
});
  • 如何更改解析器
builder.Services.AddEventBus(eventBusBuilder =>
{
    eventBusBuilder.UseIsolationUoW<CustomDbContext>(
        isolationBuilder => isolationBuilder.UseMultiEnvironment("env", new List<IEnvironmentParserProvider>()
        {
            new EnvironmentVariablesParserProvider() // 默认从系统环境变量中获取环境隔离中的环境信息
        }),
        dbOptions => dbOptions.UseSqlServer());// 使用环境隔离
});