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 ）
• 数据库类型：选择相应的数据库类型，如果有新的数据字典
• 备注：备注信息

  界面将有一些基本数据，如数据字典的下拉框或单选、多选等。根据具体需要生成代码的表设计将提前规划，并在业务字典中提前构建数据字典。在自定类型表中，单击记录行即选择，相应的字典值列表将出现在右侧字典值列表中。

  代码生成的基本配置实际上是一种数据字典，但它是一种只用于代码生成功能模块的数据字典，如界面上选择的数据库类型、表单显示类型、树类型等。在实际的应用程序开发过程中，可以根据自己的需要进行添加和修改。

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

  代码配置是实际代码生成的重点。以上配置是为代码生成做准备。代码配置模块实际上是为业务表配置，最终生成代码。

• 数据源 ：选择需要生成代码的数据库进行上述配置。
• 模块名称：需要生成代码的模块名称，用作菜单名称、系统提示等。
• 模块代码：系统在生成代码时，会根据模块代码新建相应名称的目录，存储该模块的代码。
• 服务名称：在Nacos上注册的微服务名称，框架中获得的是微服务pom.xml中的artifactid配置，在生成代码时，微服务名称将添加到请求url之前，请确认该字段的正确性，否则无法访问后台服务。
• 表名 : 需要生成代码的表。
• 表别名 ：在生成多表联合代码时，在查询语句的mapper文件中使用此作为表的别名。
• 表前缀 ：当我们定义表时，t_代码是表(table的首字母)，代码系统的名称在下划线后面，然后模块名称在后面，所以当我们生成代码时，需要删除前缀，只保留模块名称，即生成代码时的物理名称。
• 父级包名：定义生成模块代码的包路径，代码将存储在此包名下。
• 表单类型:增删查改时的显示模式，包括弹出框、新开页、右侧伸缩抽屉等。
• 表单列数：定义表单字段，每行在表中显示几列
• 数据显示：配置数据查询列表的显示形式，包括表格、树木等
• 左树类型： 当数据显示形式包含左树时，这里可以选择左树的数据类型
• Controller请求路径：配置在Controller代码中 @RequestMapping 参数，即模块的请求路径
• 后端代码保存路径：后端代码的存储路径可以到特定微服务的根目录，即SRC目录的最后一级目录，无需到SRC目录和SRC以下目录。
• 前端代码保存路径：前端代码的存储路径，到具体前端代码的根目录。
• 页面文件目录自定义： 默认情况下，将前端代码放在views目录下。如果不设置，将使用服务请求和模块代码两级字段生成目录。如果需要大的区别，可以在这里设置一级目录。
• 生成类型：有些代码可能只生成接口，或者只是想重生页面代码，所以您可以选择是全部生成，还是只生成后端代码或前端代码。
• 状态处理：在特定的业务模块中，状态是一个常用的字段。如果要生成的代码有状态字段，您可以选择是否生成与状态相关的操作代码。
• 支持导出：配置该模块是否具有导出功能。
• 支持导入：配置该模块是否具有导入功能。
• 联表类型：配置该模块在操作过程中是多表操作还是单表操作。
• 查询重用:列表查询(分页或不分页)和代码中的单个记录查询可以使用相同的sql。考虑到性能，您可以选择是生成单独的查询方法还是重用相同的查询方法。

  点击已建立的代码配置列表"配置规则"按钮，进入代码生成规则配置页面。如果您在上一步选择多表查询，您将进入多表配置界面。如果您选择单表，您将直接进入字段配置界面。

1. 配置联表

• 多表配置列表

• 多表配置表单

• 表名 ： 在相同的数据源下选择表。
• 别名 ： 联表查询时，mapper.SQL语句在xml中的表别名。
• 表前缀 ： 去除系统和模块标识，只保留实体名称。
• 排序 : SQL查询时显示排序和排序。
• 联表方式 : 表连接方式，LEFT JOIN、RIGHT JOIN、INNER JOIN、UNION、UNION ALL等
• 查询字段 ： 本表中需要查询的字段
• 自定义on条件： 与主表相关的字段和自定义的条件

2. 配置字段

• 字段描述 ： 用于字段名称和页面字段中显示的label，获取数据表的描述信息。
• 字段类型 ： 定义为JAVA对应的字段类型的自动转换数据库。
• 字段名称 ： 物理类中字段的定义。

3. 配置表单

• 表单新增 ： 界面上的新表单是否显示了字段。
• 表单编辑 ： 编辑表单是否显示在界面上。
• 组件类型 ： 界面中显示字段的类型，INPUT、SELECT、CHECKBOX等。
• 字典编码 ： 当字段组件类型为选择类型时，提供选择的填充数据。这些数据来自商业字典。

4. 配置表验证

• 最小长度 ： 最小字段长度的初始值来自数据库字段的定义。
• 最大长度 ： 最大字段长度的初始值来自数据库字段的定义。
• 是否必填 ： 是否必须填写字段。
• 是否唯一 ： 如果字段是唯一的，如果配置是唯一的，验证方法将在表单添加或编辑时自动生成。
• 校验类型 ： 选择已配置的一般正则表达式。
• 正则表达式 ： 对于非通用的特殊字段，可以自定义正则表达式。
• 最大值 ： 当字段为数值类型时，字段的最大值来自数据库字段的定义。
• 最小值 ： 当字段为数值类型时， 从数据库字段定义来看，字段的最小值。

5. 配置数据显示列表

• 查询条件 ： 在界面的查询条件区域显示是否为查询条件。
• 查询类型 ： 查询字段的类型等于、不等于、大于、小于等。
• 列表展示 ： 是否显示在查询结果的数据表中。
• 支持导入 : 当代码配置支持导入时，该字段是否支持导入有效。
• 支持导出 : 当代码配置支持导出时，该字段是否支持导出有效。

6. 在列表中点击生成代码按钮，完成保存配置，生成代码。

  代码生成操作完成后，将在后台代码mapper中执行.xml同级目录生成同名.sql文件是访问新生成代码模块的资源菜单权限脚本。

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