GUI代码生成器 === **目录索引：** - 建表 - 代码生成 - 配置扫描路径 - 功能测试 - 代码生成器使用规则 - 一对多的代码生成 # GUI代码生成器用法 本章通过一个实际的示例来讲解JEECG代码生成器的使用 ## 1.建表 现在有一张员工表person，其建表SQL为： ``` CREATE TABLE `person` ( `ID` varchar(32) NOT NULL default '' COMMENT '主键', `NAME` varchar(32) default NULL COMMENT '用户名', `AGE` int(11) default NULL COMMENT '年龄', `SALARY` decimal(10,2) default NULL COMMENT '工资', `createDt` datetime default NULL COMMENT '创建时间', PRIMARY KEY (`ID`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; ``` 注意：建表时，必须给每个字段加上注释，代码生成器会根据注释去生成页面字段对应的显示文本。 ## 2.代码生成 运行“src/main/java/test/JeecgOneGUI.java”文件，打开代码生成器并输入相应的参数如图4-1所示。  图4-1员工信息维护的代码生成器 执行【生成】之后，可以在源代码目录src中看到新生成的java代码文件，如图4-2所示。  图4-2生成的java文件 同样地，可以在WebRoot/webpage中看到新生成的jsp页面，如图4-3所示。  图4-3生成的JSP文件 ``` 生成代码结构说明 1.添加和修改页面在一个JSP页面中 2.service层接口和实现都继承父类 ``` ## 3.配置扫描路径 用代码生成器生成代码后，需要进行相关配置配置，扫描注入control、service、entity等; 详细操作步骤如下： a.control扫描配置，在spring-mvc.xml文件里面  b.Service扫描路径配置, spring-mvc-hibernate.xml  c.实体Entity扫描路径配置, spring-mvc-hibernate.xml  ## 4.功能测试 #### ①.添加菜单并授权 重新启动Tomcat，进入系统主界面->系统管理->菜单管理，点击菜单录入，添加员工管理菜单，如图4-4所示。 菜单地址内容为:类映射名.do?方法名，如personController.do?person  图4-4员工管理的菜单添加 菜单添加完成之后，需要将该菜单分配给管理员角色，重新登录系统后，可以在系统管理模块下看到子菜单【员工管理】，如图4-5所示。  图4-5新增的员工管理菜单项 #### ②.功能测试 点击菜单项【员工管理】，打开员工管理的主界面如图4-6所示。  图4-6员工管理主界面 点击【录入】按钮，在弹出的对话框中录入员工基本信息，如图4-7所示。  图4-7员工信息录入 点击确定按钮，对信息进行保存，此时可以在用户列表中看到新录入的信息，同时在数据库中也可以看到数据被保存入库，如图4-8所示。  图4-8信息被正确保存入库 ## 5.代码生成器使用规则 #### ①.建表规范 * 表必须有唯一主键: ID（字符类型 32位） 备注: 主键采用UUID方式生成 主键支持自定义，修改jeecg_config.properties的参数[jeecg_generate_table_id]即可; * 如需使用框架自动生成表创建人，创建时间等，必须字段参见“表4 2建表模板” * 表字段必须有注释 备注: JSP页面字段文本，是根据表字段注释来生成 注：请按照建表模板表4 来创建新表，模板表中原有的字段，生成器会过滤不在页面生成。 表4-9建表模板 | 字段名| 类型| 长度| 备注| 主键| | ---| ---| ---| ---| ---| | ID| varchar| 36| 主键| TURE| | CREATE_BY| varchar| 36| 创建人| | | CREATE_NAME| varchar| 32| 创建人名字| | | CREATE_DATE| datetime| 0| 创建时间| | | UPDATE_BY| varchar| 36| 修改人| | | UPDATE_NAME| varchar| 32| 修改人名字| | | UPDATE_DATE| datetime| 0| 修改时间| | | DELFLAG| int| 2| 删除标记| | | DEL_DATE| datetime| 0| 删除时间| | | #### ②.页面生成规则 说明：JSP页面字段的文本内容，取表字段的注释前6位字符(如果建表字段注释为空，则页面字段文本会为空) * 默认生成的JSP页面前五个字段为必须项，其他字段为非必须输入（需要自己手工加） * 数据库字段类型为：datetime -->对应页面字段，会自动追加[年月日-时分秒]时间控件 * 数据库字段类型为：date -->对应页面会字段，自动追加[年月日]时间控件 * 数据库字段类型为：Int/Number-->对应页面字段，会自动追加数字校验（不允许输入小数） * 数据库字段类型为：float/double/decimal-->对应页面页面字段，会自动追加数字校验（允许输入小数） * 如果表字段为字符类型，并且设置了长度，页面输入框会自动设置maxlength对应表字段长度 ## 6.一对多的代码生成 #### ①.一对多代码生成器使用 单表的代码生成器入口类是test.JeecgOneGUI； 一对多的代码生成器入口类是test.JeecgOneToMainUtil; 一对多的代码生成器使用示例： ``` //第一步：设置主表 CodeParamEntity codeParamEntityIn = new CodeParamEntity(); codeParamEntityIn.setTableName("jeecg_order_main");//主表[表名] codeParamEntityIn.setEntityName("Demo4ManyKey"); //主表[实体名] codeParamEntityIn.setEntityPackage("jeecg"); //主表[包名] codeParamEntityIn.setFtlDescription("订单主数据"); //主表[描述] //第二步：设置子表集合 List<SubTableEntity> subTabParamIn = new ArrayList<SubTableEntity>(); //[1].子表一 SubTableEntity po = new SubTableEntity(); po.setTableName("jeecg_order_custom");//子表[表名] po.setEntityName("DemoMany4CustomKey");//子表[实体名] po.setEntityPackage("jeecg"); //子表[包] po.setFtlDescription("订单客户明细"); //子表[描述] po.setForeignKeys(new String[]{"GORDER_ID","GO_ORDER_CODE"});//子表[外键:与主表关联外键] subTabParamIn.add(po); //[2].子表二 SubTableEntity po2 = new SubTableEntity(); po2.setTableName("jeecg_order_product"); //子表[表名] po2.setEntityName("DemoMany4ProductKey"); //子表[实体名] po2.setEntityPackage("jeecg"); //子表[包] po2.setFtlDescription("订单产品明细"); //子表[描述] po2.setForeignKeys(new String[]{"GORDER_ID","GO_ORDER_CODE"});//子表[外键:与主表关联外键] subTabParamIn.add(po2); codeParamEntityIn.setSubTabParam(subTabParamIn); //第三步：一对多(父子表)数据模型,代码生成 CodeGenerateOneToMany.oneToManyCreate(subTabParamIn, codeParamEntityIn); ``` #### ②.使用规范 1.目前代码生成器默认的主键生成策略为UUID 2.主表和子表的目录最好保持一致 3.子表和主表的外键规则如下： a)主表和子表的外键字段名字，必须相同（除主键ID外） b)子表引用主表主键ID作为外键，外键字段必须以_ID结尾