从零开始编写自己的C#框架(9)——数据库设计与创建
对于千万级与百万级数据库设计是有所区别的,由于本项目是基于中小型软件开发框架来设计,记录量相对会比较少,所以数据库设计时考虑的角度是:与开发相结合;空间换性能;空间换开发效率;减少null异常......当然不同的公司与项目要求不同,初学者要学会适应不同的项目开发要求,使用本框架开发时,必须严格按照本章节的要求来设计数据库,不然可能会产生不可控的异常。
从零开始编写自己的C#框架
数据库设计规范
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 |
文件标识: |
C#框架 |
当前版本: |
0.1 |
|
作 者: |
陈焕(AllEmpty) |
|
联系方式: |
1654937@qq.com |
|
更新日期: |
2014-04-26 |
版本/状态 |
作者 |
参与者 |
起止日期 |
备注 |
0.1 |
陈焕(AllEmpty) |
|
2014-04-26 |
创建 |
|
|
|
|
|
|
|
|
|
|
目 录
一、 文档介绍 3
1、文档目的 3
2、文档说明 3
3、读者对象 3
4、系统开发强度等级 3
5、使用工具 3
6、ExcelToSQLString2.91 for July软件介绍 3
二、 创建数据库 4
1、 数据表设计要求 4
2、 数据字典设计要求 4
3、 数据库存储过程创建规范 5
4、 生成SQL代码 5
一、文档介绍
1、文档目的
本文档是《从零开始编写自己的C#框架》项目后台管理系统的开发指引说明。
2、文档说明
本文主要讲述数据库设计的要求与规范,开发者必须严格按照本规范来设计,不然可能在开发中会产生不可控的异常。
本项目是基于中小型软件开发框架来设计,记录量相对会比较少,所以数据库设计时考虑的角度是:与开发相结合;空间换性能;空间换开发效率;减少null异常。
3、读者对象
本项目的开发人员。
4、系统开发强度等级
(强度分为:容易、中等、困难) 当前难度为:容易
5、使用工具
Excel + ExcelToSQLString2.91 for July软件。
6、ExcelToSQLString2.91 for July软件介绍
这个软件是我身边的大神July开发的,将指定格式的数据字典(Excel格式)转为SQL执行语句,减轻开发工作量。
经得July同意,现在无尝共享出来,后面代码中也会使用到大神开发的一些功能非常强大的函数或类,所以在这里也为他宣传一下,以对他无尝奉献的精神表示感谢。
July有十多年的开发经验,在我们的小圈子里的全能型开发人员(除了UI设计不会)。ASP、ASP.NET、PHP都有十年左右的开发经验,经手过的大中小型项目几十个(估计快上百个了),前后端(包括WinFrom开发各种进销存软件与应用、微信开发、WAP站开发)开发都非常擅长,非常精通前端切图、JS、CSS,在他手上没有解决不了的浏览器兼容问题。开发速度效率非常高,承接各种类型的外包开发。想联系他的话请加群327360708找July。
二、 创建数据库
1、 数据表设计要求
1. 数据库表名与字段名应遵守Pascal风格,包含一到多个单词,每一个单词第一个字母大写,其余字母均小写。(具体命名要求请查看第3章节)
2. 如果是关联表,则命名规则为R_表A_表B,如R_ProductInfo_Tag等。
4. 对于视图命名,规则为View_表A,视图由多个表产生,就用下划线连接几个表名,如View_ProductInfo_ProductClass。
5. 存储过程,命名规则为P_表名_存储过程功能名称。如P_ProductInfo_Add;如果该存储过程是很多表共用的,命名为:P_All_存储过程功能名称
6. 数据字段命名,也使用Pascal风格。当字段引用的是其他表字段时,使用表名_其他表字段名称,间用下划线隔开,命名规则:表名_单词。如ProductInfo表与ProductClass表关联的字段:ProductClass_Id,ProductClass_Name等。与外表的主键或相关字段引用时(包括状态值),须加同时添加外表所引用主键(或状态值)对应的名称,以方便查询时减少多表关联语句的编写,提高代码执行效率,详细请看《数据字典》中的设计。
2、 数据字典设计要求
必须使用附件中的Excel表并按里面设计格式来设计数据库(如下图)。
可能有的朋友会说,既然要按软件工程开发规范来做,为什么不用建模工具呢?
呃……其实对于中小型项目来说,我觉得不必要用建模工具来处理,那样很麻烦且更费时间,而使用本文介绍的工具,操作起来方便快捷,直接查看数据字典也很直观明了。
在设计字段名时,除了上面要求外,还有一些特殊的命名规则要求,这将会影响逻辑层生成的函数,当然有些函数如果名称与下面要求一致,而它却不是你想要的功能定义时,你可以忽略该生成函数,不去调用即可。具体如下:
1) 主键Id必须命名为“Id”,将会生成UpdateValue()函数,用来更新指定Id的记录;
2) 字段名包涵Name这个字串的,会生成GetXxxName()函数,可以直接读取该字段值;
3) 字段名包涵_Id这个字串的,会默认为该字段是外键Id,将会生成DeleteByXxx_Id()函数,用来删除当前表值为指定外键的所有记录;还会生成UpdateValue_For_Xxx_Id()函数,用来更新当前表值为指定外键的记录值;
4) 字段类型为tinyint的字段,会被默认为状态字段,会生成UpdateXxx()函数,用来更新该状态值;
5) 字段名包涵Key这个字串且该字段为string类型的,会生成GetModelByXxxKey()函数,主要功能是通过Key这个字段值来获取当前记录实体;
6) 字段名包涵Count这个字串且该字段为int型的,默认为访问计数字段,会生成UpdateXxxCount()函数,用来执行该字段值累加功能;
7) 字段名包涵Img这个字串且该字段为string类型的,默认为图片路径存储字段,会生成DeleteXxx函数,用来执行图片删除功能;
以上规则大家在开发中可以根据需要自己在T4模板中任意添加或修改,使用这种规则生成后,将会大大减轻开发人员的代码量与出错次数(主要减少重复代码的开发),提高开发效率。
另外单独说明一下《数据字典》中“上传管理”与“上传配置明细”这个工作表,它们是July开发的上传组件所要使用的相关配置表,只要配置好相要生成的图片大小与路径,那么就可以通过简单的调用得取想要的效果,在后面代码编辑章节会有详细例子介绍说明。
3、 数据库存储过程创建规范
在创建存储过程时,头部必须写上功能、创建人、创建日期及修改情况。存储过程主体必须写上清晰的注释说明。
例:
---------------------------------------------------------
--功能说明:删除用户使用日志
--操作历史
------操作 操作人 日期
------创建 Empty 2013-11-20
------修改
---------------------------------------------------------
CREATE PROCEDURE [dbo].[P_Userlog_Delete]
AS
BEGIN
--定义临时变量
DECLARE @UseLogReserveTime INT
--获取系统设置的操作日志保留日期
SELECT TOP 1 @UseLogReserveTime = UseLogReserveTime FROM WebConfig
--如果设置为无限制,则不执行删除程序
IF @UseLogReserveTime <= 0
RETURN 0
--执行日志删除程序
DELETE FROM UseLog WHERE DATEDIFF(d, AddDate, DATEADD(d, -@UseLogReserveTime, CONVERT(VARCHAR(10),GETDATE(),110))) >= 0
END
4、 生成SQL代码
在数据字典(Excel表)里设计好数据库架构后,用ExcelToSQLString2.91生成相应的SQL代码,然后打开SQL查询分析器运行后生成相应的数据表。
在Excel表中设计好数据库架构,设置好主键与排序标识,生成的SQL语句就会自动创建对应的主键和绑定排序列。(主意事项:主键Id设计时,名称必须为Key、Id、表名 + Id或 表名 + _Id,不然使用SubSonic3.0插件时会出错)
打开ExcelToSQLString2.91软件
打开软件,选择《数据字典》文件路径,设置好要生成的表格名称,按图中的选项全部打好勾。
然后点击运行,生成对应的SQL语句。
将上面语句复制到SQL查询分析器中直接运行就可以了。
版权声明:
本文由AllEmpty原创并发布于博客园,欢迎转载,未经本人同意必须保留此段声明,且在文章页面明显位置给出原文链接,否则保留追究法律责任的权利。如有问题,可以通过1654937@qq.com 联系我,非常感谢。
发表本编内容,只要主为了和大家共同学习共同进步,有兴趣的朋友可以加加Q群:327360708 ,大家一起探讨。
更多内容,敬请观注博客:http://www.cnblogs.com/EmptyFS/