一、集成
1、引用安装包
Volo.Abp.AspNetCore.MultiTenancy
2、配置租户key
Configure<AbpAspNetCoreMultiTenancyOptions>(options =>
{
options.TenantKey = "BridgeTenantKey";
});
3、在代码中写入所有租户,当在也可以在配置文件或数据库中定义你的所有租户
Configure<AbpDefaultTenantStoreOptions>(options =>
{
options.Tenants = new[]
{
new TenantConfiguration(
Guid.Parse("446a5211-3d72-4339-9adc-845151f8ada0"), //Id
"tenant1" //Name
),
new TenantConfiguration(
Guid.Parse("25388015-ef1c-4355-9c18-f6b6ddbaf89d"), //Id
"tenant2" //Name
)
};
});
4、开启租户
Configure<AbpMultiTenancyOptions>(options =>
{
options.IsEnabled = true;
});
5、配置租户中间件
app.UseMultiTenancy();
6、最后访问服务会报错:
<body>
<h3>找不到租户!</h3>
无法找到ID或名称为446a5211-3d72-4339-9adc-845151f8ada0的租户<br>
</body>
二、租户源原码解析
1、那就从中间件UseMultiTenancy()开始切入
在该方法中注入了一个中间件:MultiTenancyMiddleware,在该方法中有一个方法InvokeAsync
进入_tenantConfigurationProvider的实现TenantConfigurationProvider中,查看GetAsync()方法
在该方法中只做了两件事
一是从请求头中解析租户信息:TenantResolver.ResolveTenantIdOrNameAsync();
解析租户信息是从我们注入的几个类中依次解析直到拿表租户信息,有从请求头,有从cookie中
public class AbpAspNetCoreMultiTenancyModule : AbpModule
{
public override void ConfigureServices(ServiceConfigurationContext context)
{
Configure<AbpTenantResolveOptions>(options =>
{
options.TenantResolvers.Add(new QueryStringTenantResolveContributor());
options.TenantResolvers.Add(new RouteTenantResolveContributor());
options.TenantResolvers.Add(new HeaderTenantResolveContributor());
options.TenantResolvers.Add(new CookieTenantResolveContributor());
});
}
}
二是将解析出的租户信息与系统中配置的租户信息匹配:await FindTenantAsync(resolveResult.TenantIdOrName);
protected virtual async Task<TenantConfiguration?> FindTenantAsync(string tenantIdOrName)
{
if (Guid.TryParse(tenantIdOrName, out var parsedTenantId))
{
return await TenantStore.FindAsync(parsedTenantId);
}
else
{
return await TenantStore.FindAsync(tenantIdOrName);
}
}
其中,TenantStore就来源我们系统开始配置的AbpDefaultTenantStoreOptions类