ABP框架的设计是模块化的, 微服务兼容 和 多租户. 同时设计了连接字符串管理来支持这些场景;

• 允许为每个模块设置单独的连接字符串,这样每个模块都可以有自己的物理数据库. 甚至可以将模块配置为使用不同的DBMS.
• 允许为每个租户设置单独的连接字符串使用单独的数据库(在SaaS应用程序中).

它还支持混合场景;

• 允许将模块分组到数据库 (所有的模块分组到一个共享数据库, 两个模块使用数据库A, 3个模块使用数据库B, 一个数据库使用数据库C，其余的数据库使用数据库D...等.)
• 允许将租户分组到数据库中,像模块一样.
• 允许为每个租户每个模块分离数据库 (数据库过多会增加维护成本,但ABP框架支持这种需求).

配置连接字符串

"ConnectionStrings": {
  "Default": "Server=localhost;Database=MyMainDb;Trusted_Connection=True;",
  "AbpIdentityServer": "Server=localhost;Database=MyIdsDb;Trusted_Connection=True;",
  "AbpPermissionManagement": "Server=localhost;Database=MyPermissionDb;Trusted_Connection=True;"
}

ABP使用 IConfiguration 服务获取应用程序配置. 虽然在 appsettings.json 文件中写入配置是最简单的方法, 但它不仅限于此文件. 你可以使用环境变量, user secrets, Azure Key Vault... 等.

以上配置定义了三个不同的连接字符串:

• MyMainDb (Default 连接字符串)是应用程序的主连接字符串. 如果没有为模块指定连接字符串,则回退到 Default 连接字符串. 应用程序启动模板 配置为使用单个字符串, 所以所有的模块都使用单个数据库.
• MyIdsDb 由 IdentityServer 模块使用.
• MyPermissionDb 由 权限管理 模块使用.

预构建的应用程序模块 为连接字符串名称定义常量. 例如IdentityServer模块在 AbpIdentityServerDbProperties 类(位于 Volo.Abp.IdentityServer 命名空间)定义了 ConnectionStringName 常量 . 其他的模块类似的定义常量,你可以查看连接字符串的名称.

设置连接字符串名称

模块通常使用 ConnectionStringName attribute 为 DbContext 类关联一个唯一的连接字符串名称. 示例:

[ConnectionStringName("AbpIdentityServer")]
public class IdentityServerDbContext
    : AbpDbContext<IdentityServerDbContext>, IIdentityServerDbContext
{
}

对于 Entity Framework Core 和 MongoDB, 写入到 DbContext 类 (和接口,如果有的话).

替换连接字符串解析器

ABP定义了 IConnectionStringResolver,并在需要连接字符串时使用它. 有两个预构建的实现:

• DefaultConnectionStringResolver 根据上面"配置连接字符串"一节中定义的规则,使用 AbpDbConnectionOptions 选择连接字符串.
• MultiTenantConnectionStringResolver 用于多租户应用程序,并尝试获取当前租户的已配置连接字符串(如果有). 它使用 ITenantStore 查找连接字符串. 它继承了 DefaultConnectionStringResolver, 如果没有为当前租户指定连接字符串则回退到基本逻辑.

如果需要自定义逻辑来确定连接字符串,可以实现 IConnectionStringResolver 接口(也可以从现有类派生)并使用依赖注入系统替换现有实现.