SpringCloud微服务实战——搭建企业级开发框架(三十二):代码生成器使用配置说明

一、新建数据源配置

  因考虑到多数据源问题,代码生成器作为一个通用的模块,后续可能会为其他工程生成代码,所以,这里不直接读取系统工程配置的数据源,而是让用户自己维护。

新建数据源

参数说明

  • 数据源名称:用于查找区分数据源的名称
  • 连接地址 : 连接方式:数据库类型:数据库地址等参数,例:jdbc:mysql://127.0.0.1/gitegg_cloud?zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=utf8&all owMultiQueries=true&serverTimezone=Asia/Shanghai
  • 用户名:登录数据库的用户名
  • 密码:登录数据库的密码
  • 数据库驱动:数据库驱动类型,例:com.mysql.jdbc.Driver(MySQL5 )或 com.mysql.cj.jdbc.Driver(MySQL8 )
  • 数据库类型:选择对应的数据库类型,如果有新增可以新增数据字典
  • 备注:备注信息

二、新建业务数据字典

  界面的增删改查界面会有一些数据字典的下拉框或者单选、多选等基础数据,这些根据具体需要生成代码的表设计提前做好规划,在业务字典中提前建好数据字典。在自定类型表,点击一条记录所在的行即是选中,右侧字典值列表会出现对应的字典值列表。

业务字典

三、代码生成的基础配置

  代码生成的基础配置实际也是一类数据字典,但这是只针对代码生成功能模块使用的数据字典,比如在界面上选择的数据库类型、表单展现类型、树类型等、都是获取这里的配置数据。在实际应用开发过程中,可以根据自己的需求进行新增、修改。

基础配置

四、校验规则配置

  在我们业务开发过程中,无论是界面还是接口,都会对数据字段的长度、大小、类型等进行校验,这里的配置主要是配置数据字段校验的正则表达式,在代码生成时,会在前端代码和后台代码添加校验方法进行数据校验。

正则表达式校验规则

五、代码配置(重点)

  代码配置是实际代码生成的重点,以上几项配置都是为代码生成做前期准备工作,代码配置模块是实际的针对业务表进行配置,最终生成代码。

1、 新建代码配置
新增代码配置
配置参数说明
  • 数据源 :选择我们上面配置的需要生成代码的数据库。
  • 模块名称:需要生成代码的模块名称,这个名称将用作菜单名称、系统提示等。
  • 模块代码:系统在生成代码时会根据模块代码新建对应名称的目录,进行存放该模块的代码。
  • 服务名称:微服务注册到Nacos上的名称,框架中这个取得的是微服务pom.xml里的artifactId配置,在生成代码时,微服务名称将加在请求url的前面,请一定确认这个字段的正确性,否则访问不到后台服务。
  • 表名 : 需要生成代码的表。
  • 表别名 :在生成多表联合代码时,这个作为表的别名在查询语句的mapper文件中使用。
  • 表前缀 :在我们定义表时,t_代码是表(table的首字母),下划线后面代码子系统的名称,再后面是模块名称,那么在我们生成代码时,前面的前缀需要去掉,只保留模块名称,即生成代码时的实体类名称。
  • 父级包名:定义生成模块代码的包路径,代码将存放在这个包名下。
  • 表单类型:在进行增删查改时的展现方式,有弹出框、新打开一个页面、右侧伸缩抽屉等形式
  • 表单列数:定义表单字段在表里每行展示几列
  • 数据展示:配置数据查询列表的展示形式,有表格、树等形式
  • 左树类型: 当数据展示形式包含左侧树时,这里可以选择左侧树的数据类型
  • Controller请求路径:配置在Controller代码中的 @RequestMapping 参数,即模块的请求路径
  • 后端代码保存路径:后端代码的存放路径,到具体微服务的根目录即可,即src目录的上一级目录,不需要具体到src目录和src下面的目录。
  • 前端代码保存路径:前端代码的存放路径,到具体前端代码的根目录即可。
  • 页面文件目录自定义: 前端代码默认放到views目录下,不设置的话会使用服务请求和模块代码两级字段开始生成目录,如果需要大的区分,这里可以再设置一级目录。
  • 生成类型:有些代码生成可能只有接口,或者只想重新生成页面代码,那么这里可以选择是全部生成,还是只生成后端代码或前端代码。
  • 状态处理:具体业务模块中,状态是一个常用的字段,如果要生成的代码有状态字段,那么这里可以选择是否生成对状态相关操作代码。
  • 支持导出:配置该模块是否有导出功能。
  • 支持导入:配置该模块是否有导入功能。
  • 联表类型:配置该模块在操作时,是进行多表操作还是单表操作。
  • 查询复用:代码中列表查询(分页或不分页)和单条记录查询可以使用同一条sql,基于性能方面考虑,这里可以选择是生成单独的查询方法,还是复用同一个查询方法。
2、配置代码生成规则

  在已建好的代码配置列表中点击"配置规则"按钮,进入到代码生成规则配置页面。如果在上一步中选择的是多表查询,那么这里会进入多表配置界面,如果选择的是单表,那么这里直接进入字段配置界面。

  1. 配置联表
  • 多表配置列表
多表配置列表
  • 多表配置表单
多表配置表单
配置参数说明
  • 表名 : 选择相同数据源下的表。
  • 别名 : 联表查询时,mapper.xml里面SQL语句的表别名。
  • 表前缀 : 去除系统和模块标识,只保留实体名称。
  • 排序 : 显示排序及在SQL查询时的排序。
  • 联表方式 : 表连接方式,LEFT JOIN、RIGHT JOIN、INNER JOIN、UNION、UNION ALL等
  • 查询字段 : 此表需要查询的字段
  • 自定义on条件: 需要和主表关联的字段及自定义的条件
  1. 配置字段
字段配置
配置参数说明
  • 字段描述 : 获取数据表的描述信息,用于字段名称和展示在页面字段的label。
  • 字段类型 : 自动转换数据库定义的字段类型为JAVA对应的字段类型。
  • 字段名称 : 实体类里面字段的定义。
  1. 配置表单
表单配置
配置参数说明
  • 表单新增 : 字段是否展示在界面的新增表单。
  • 表单编辑 : 字段是否展示在界面的编辑表单。
  • 组件类型 : 字段展示在界面的类型,INPUT、SELECT、CHECKBOX等。
  • 字典编码 : 当字段的组件类型为选择类型时,提供选择的填充数据。此数据来自业务字典。
  1. 配置表单校验
表单校验
配置参数说明
  • 最小长度 : 字段的最小长度,初始值来自数据库字段定义。
  • 最大长度 : 字段的最大长度,初始值来自数据库字段定义。
  • 是否必填 : 字段是否必填。
  • 是否唯一 : 字段是否唯一,如果配置为唯一,那么在表单新增或编辑时会自动生成校验方法。
  • 校验类型 : 选择已配置的通用正则表达式。
  • 正则表达式 : 对于非通用的特殊字段,可以自定义正则表达式。
  • 最大值 : 当字段为数值类型时,字段的最大值,初始值来自数据库字段定义。
  • 最小值 : 当字段为数值类型时, 字段的最小值,初始值来自数据库字段定义。
  1. 配置数据展示列表
列表配置
配置参数说明
  • 查询条件 : 是否是查询条件,展示在界面的查询条件区域。
  • 查询类型 : 字段的查询类型,等于、不等于、大于、小于等。
  • 列表展示 : 是否展示在查询结果的数据表格中。
  • 支持导入 : 字段是否支持导入,在代码配置中支持导入时,此字段生效。
  • 支持导出 : 字段是否支持导出,在代码配置中支持导出时,此字段生效。
  1. 完成保存配置,在列表中点击生成代码按钮,生成代码。
执行生成代码操作

六、配置资源权限

  执行完代码生成操作之后,会在后台代码的mapper.xml同级目录生成一个同名的.sql文件,这里面是访问新生成代码模块的资源菜单权限脚本。

GitEgg-Cloud是一款基于SpringCloud整合搭建的企业级微服务应用开发框架,开源项目地址:

Gitee: https://gitee.com/wmz1930/GitEgg
GitHub: https://github.com/wmz1930/GitEgg

欢迎感兴趣的小伙伴Star支持一下。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,636评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,890评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,680评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,766评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,665评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,045评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,515评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,182评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,334评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,274评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,319评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,002评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,599评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,675评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,917评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,309评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,885评论 2 341

推荐阅读更多精彩内容