一、集成
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中
我登录时就是在请求头中,HeaderTenantResolveContributor中可以解析到
二是将解析出的租户信息与系统中配置的租户信息匹配: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类