同步操作将从 AIR Software/airboot-saas-datasource 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
Airboot-SaaS-DataSource是轻量级通用多租户管理系统 Airboot-SaaS 的动态数据源版本。在主要功能上将与 Airboot-SaaS 和 Airboot 保持一致。
Airboot-SaaS-DataSource支持【共享数据源,独立Schema】和【独立数据源】的SaaS模式,完美支持混合云。租户之间物理隔离,理论上租户数量可无限扩展,不会遭遇【共享Schema,共享数据表】模式的性能瓶颈,即使某个租户的数据量巨大也不会影响其他租户的体验,客户可随时将自己的Schema私有化。
本系统支持数据源 --> Schema
一对多的灵活配置,你可以根据部署成本、租户数据量或客户要求等因素,来决定某租户是跟其他租户共享数据源(租户自己的Schema都是专属独立的互不影响),还是完全独享一个数据源,以此来达到混合云的效果。如果某个租户数据量巨大,你可以对其单独进行分库分表等优化,最后映射出一个统一的VIP或域名配置到本系统内即可。如果数据源配置有变更,本系统支持不停机动态切换。
关于Schema的定义可参考 数据库中的Schema是什么? ,如果你使用的是MySQL,则Schema = Database。
本系统初期基于 若依(RuoYi-Vue) 二次开发,启动开发时对应的若依版本在2.2至2.3之间,之后的功能路线与若依不同,基本没有再合并若依的更新。
若依本身是一个优秀的开源项目,我根据个人开发习惯做了一些架构和细节上的改动,其中后端改动较大,前端改动较小,UI风格没有变化(若依也是直接采用了vue-admin-element),欢迎有类似开发习惯的小伙伴们尝试使用。
主要改动如下:
Mybatis
替换为 Mybatis-Plus ,简化了Mapper代码;字典管理
功能,全部改为枚举实现。这东西见仁见智,只是我个人更习惯用枚举,没有绝对的好坏。非要说原因的话,请看:为什么去掉字典管理?
Spring-Security
,改为自定义拦截器实现,原因请看:为什么去掉Spring-Security?
以MySQL为例(字符集utf8mb4):
airboot-server/sql/common.sql
,将数据源表中的初始化数据改成你自己的数据源配置,租户表中的初始化数据务必确保有一个id为1的租户(只需保证id为1即可,租户名称等都可以改动),其他租户可以之后在系统中创建;common.sql
导入数据库中建表,随后在application-dev.yml
配置文件中,将spring.datasource.dynamic.datasource.common
里的配置改为你建好的公共库配置;schema_name
,并以此为名称新建一个数据库作为管理平台租户,随后将airboot-server/sql/tenant.sql
导入此库中建表;application.yml
及application-dev.yml
中各项配置,比如Redis的链接地址;Airboot Server启动成功!
的提示。在airboot-web
目录下打开命令行:
# 使用淘宝源来加快下载速度
npm config set registry http://registry.npm.taobao.org/
# 解决node-sass可能下载出错的问题
npm config set sass_binary_site https://npm.taobao.org/mirrors/node-sass/
# 安装依赖
npm install
# 启动服务
npm run dev
启动成功后浏览器访问 http://localhost/
管理员账号 admin,密码 admin123
如果你选择了管理平台租户登录,则管理员账号具有超级租户管理员
权限,是系统内的最高权限。
如果登录其他租户,则管理员只是租户内部的管理员权限。
本系统已经在拦截器中自动处理了租户切换逻辑,如果你想自己手动切换租户,或想了解租户切换原理,请前往 saas-datasource-spring-boot-starter 仔细阅读说明文档。
谨记一点:不要在事务内部做任何切换数据源的操作!无论是SaaSDataSource.switchTo(dsKey)
方法、@SaaS
注解还是@DS
注解,都必须保证他们在事务开启前生效,否则在事务内部无法正常切换数据源。
具体事务相关注意事项请仔细阅读 saas-datasource-spring-boot-starter 的说明文档。
从大的方向上来讲,SaaS的登录一般有两类方案:
综上所述,具体采用什么登录方案,是要根据用户体验及技术难度等多方面因素来取舍的。本系统为简便起见,采用了上述第一种登录方案,开发者可自行更改。
系统运行过程中可在数据源管理
页面随时添加新的数据源,在新增租户时可以选择已经建好的数据源。
注意:本系统为演示方便,默认在页面上明文展示数据源的用户名和密码,开发者正式使用时务必根据自身安全策略自行修改展示方式。
新增租户会直接动态新建Schema并执行初始化脚本,默认的初始化脚本为airboot-server/sql/tenant.sql
,你也可以修改tenant.sql-script-name
配置来指定其他脚本(目录仍然是airboot-server/sql/
)。或者修改SqlUtil.executeScript
方法来指定其他目录。
假设你在某次迭代后产生了数据库变更,而此时已经有很多租户正在使用了,手动去给每个Schema执行变更是很繁琐且存在风险的。
此时可以使用租户管理页面
中的执行SQL
功能来进行自动批量刷库,可以选择全部租户(不含公共库)、只刷公共库或指定租户。密钥默认airboot,你可以修改密钥或自定义其他安全策略。
id为1的租户中的管理员是超级租户管理员,拥有系统中的最高权限。
超级租户管理员可以在右上角随意切换至其他租户。
其他租户的管理员的权限实质上由超级租户管理员来分配,你也可以在租户初始化脚本中预设管理员的权限。假设你新增了某个功能,想给所有现有租户的管理员都分配此功能的权限,可以使用批量刷库。
注意代码生成
功能默认只识别公共库中的数据表,使用时需要先在公共库中建新的表,或者修改代码以指向其他数据源(如专门用于代码生成的库),由开发者自行决定。
请按以下步骤排查问题:
SaaSDataSource.switchTo(dsKey)
手动切换租户;数据源管理
和租户管理
的后端更新逻辑,移除相应的缓存即可;字典看起来灵活,能够随时新增和修改,但如果没有业务关联就是没有意义的数据。而如果想要做业务关联,大部分情况下还是要去修改代码的,字典并没有减轻你的工作。比如在 RuoYi-Vue 的源代码中,虽然字典定义了0
是正常状态,1
是停用状态,但依然要在代码里用常量类 UserConstants.java 来为0
和1
赋予具体的业务含义,然后再拿来比对用户或部门的状态等,其实是比添加和使用枚举更繁琐了一点。
我认为最适合使用字典的是像新闻类别
这样的数据,只要我预先写好代码,就可以动态增改新闻类别,因为处理逻辑都是一样的。但要注意,像这样的字典,恰恰不应该放进像字典管理
这样统一的功能中。原因如下:
字典管理
里,这个权限就很难控制,RuoYi-Vue 并没有在字典管理上实现这种权限细分,而如果你想自己实现也是很繁琐的。新闻类别
不一定是只要有字典名称
和字典值
这两个字段就能满足了,我可能还需要其他属性,但我总不能去给字典表随便添加字段吧?所以正确的做法是:单独建一张新闻类别表
,单独加一个新闻类别管理
功能,这样不但业务清晰,也便于管理。
如果我们在系统中大量使用字典,就意味着我们在所有用到字典数据的地方都需要去后端获取,否则用户会无法使用查询条件,列表数据里的字典值也无法转义。这在请求量少的时候没多大问题,但如果请求非常多,对数据库的压力是显而易见的。可如果把字典数据拉到缓存里,又会面临缓存和数据库双写的问题。或者我们可以设置一个按钮来手动刷新缓存,但也会存在忘记刷新的风险。
而如果我们使用枚举,这些问题都是不会存在的。
字典管理
如果想要做的完善,还需要考虑很多细节。比如是否需要对修改和删除进行控制,如果不控制,那字典值修改或删除后,使用到此字典值的旧数据怎么办?如果要控制,那就需要遍历可能用到字典值的数据表,并作出相应处理。在 RuoYi-Vue 的源代码中是直接就可以修改和删除的,并没有做控制处理,而如果我们自己实现的话也需要花很多时间和精力。相比之下枚举就不存在这样的问题。
综上所述,我并非反对使用字典,而是认为使用字典一定要有合适的情况和明确的目的(比如单独的新闻类别管理
是合适且明确的),像统一的字典管理
其实是没有必要的。
Spring-Security
的确是功能强大的权限框架,但一方面是较重,不符合Airboot-SaaS轻量级的理念。另一方面,如果想要用好Spring-Security
的强大功能,需要对其有一定的熟练度,这无疑会给想使用Airboot-SaaS进行二次开发的人设置了门槛,所以我将其替换成了更易于理解和改造的自定义拦截器。
个人认为,权限这个东西,说通用也通用,说不通用也不通用,很多公司在权限上其实都会有自己的特殊需求。除非你的目的是做一个庞大且复杂的管理系统,否则没有必要考虑用Spring-Security
。
综上所述,我一直推荐使用中文来命名业务相关的枚举、常量或局部变量,但对于类似实体类的属性等不推荐使用中文,因为会导致getter和setter的方法名看起来很怪。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。