数据库设计规范参考手册
概要
本书设计的数据表结构必须与代码生成工具配合使用才能发挥其作用。
因为工具定义了用于生成特定功能的特殊语法。
数据表配置示例
规范
一.命名规则
1、数据库的名称通常为项目名称,只有小写
2、数据表、字段命名使用下划线命名方式,全为小写; 由于不同的数据库可能对表名、字段的大小写敏感,因此为了避免这些故障,将数据库统一为小写
3、数据类型也全部为小写
4、字段长度、bigint、int等类型有默认长度,可以不填写的varchar等需要指定长度,但不需要括号; 定制小数点前后的位数(如decimal )需要括号
5、不含姓名、字段的中文名称、标点符号;
6、允许空值。 可以填写的值不是null、y、n,而是不填写默认的null值;
7、主/外/约:主键/外键/约束。 代码生成工具根据这里的值生成制作表时对应的主键、外键或约束;
8、备注:备注可以包含很多内容,也有特殊的用法。 请参考以下特殊语法说明;
二.特殊语法
1、主键字段需要自增功能,备注中需要填写“自增”;
2、注释字段的不同功能由分号分隔(字段的中文名称和注释实际存储在数据表注释中,因此用分号分隔);
3、一些特殊功能的定义目前使用的是类HTML标记的格式; 例如; 不需要用分号隔开;
4、标签的作用、使用方法
角色:使用此选项卡可以指定是否在后台管理页面的左侧显示树
用法:此选项卡被添加到数据表注释中
不指定表名,表示左侧的树型显示本表的数据
指定表名,在左侧的树中显示指定表的数据
注意:参数的值是实体类名,第一个字符为小写。 不是数据表的名称格式。
5、标签的作用、使用方法
作用:使用此选项卡可以指定是否需要将监听器、移动器、管理器等层添加到监听器接口、方法
用法:此选项卡被添加到数据表注释中
listAllTree=树节点文本字段=树节点代码字段,如果不指定参数,则使用缺省表名Name、表名Code;
例如,如果表名为: group,则treeTextName=groupName,treeCodeName=groupCode
指定参数。 第一个参数是treeTextName,如果只指定一个,则认为是treeTextName,第二个参数是treeCodeName。
注意:参数值采用实体类的属性名称格式,而不是数据表的字段名格式。
6、parent_id和level字段合作,字段名固定,不要做其他名字。 level字段的类型固定为tinyint