CYQ.Data 轻量数据层之路 优雅V1.4 现世 附API帮助文档(九)

    xiaoxiao2022-07-09  63

    继上一版本V1.3版本发布到现在,时隔N天了:[V1.3版本开源见:CYQ.Data 轻量数据层之路 华丽V1.3版本 框架开源]

     

    N天的时间,根据各路网友的反映及自身的想法,继续修改优化着本框架,力求让大伙相对满意:

    对于:bug反馈、优化建议、及最新框架版本下载见:CYQ.Data 轻量数据层之路 bug反馈/优化建议/框架下载

    升级说明:

    本次升级只是针对易用性增加功能或优化代码及方法,并未发现V1.3版本存在任何bug, 因此,对于V1.3版本,大伙可放心使用,同时也已开放源码。 若对于本V1.4版本改进功能感兴趣,也可尽情使用本版本dll。 欢迎来客继续使用并留言参与讨论。

     

    补充说明:

    V1.4版本辅助工具已经发布,详见:CYQ.Data 轻量数据层之路 优雅V1.4 辅助工具(十)

     

    本次V1.4版本升级修改记录如下:

    1:SQLHelper/DataType/Log 修改类访问修饰符,不对外开放 CYQ.Data 名称空间 1:MProc:ExeScalar方法修改为泛型方法 public T ExeScalar <T> () 2:MProc:由SQLHelper修改访问修饰不对外开放引起,继承变更为内置类。 3:MProc:改返回DataTable为MDataTable,隐藏掉返回的SqlDataReader 4:MProc:修改几个方法名称,参数实现自动增加"@"前缀 5:MAction:默认所有操作开启事务支持,直到调用Close()或EndTransation()或发生异常时,事务才结束。 6:MAction:增加智能检测,构造函数不需要传入数据库配置项。多数据库应用时,约定枚举生成为:[[U/V/P]_+数据库名+Enum],配置文件数据库链接配置项为[数据库名+Conn] CYQ.Data.SQL名称空间 1:SQLHelper:增加事务支持 2:SQLHelper:优化代码,删除没用到的方法 3:SQLString:where条件过滤掉“--”注释号与";"分号 4:OutPutData:增加对存储过程参数的导出 5:OutPutData:增加对于多数据库项目的导出,对于表和视图的枚举导出修改成[[U/V/P]_数据库名+Enum]格式 6:OutPutData:增加生成日志表功能 7:Log:修改WriteLog返回类型为void,在写数据库记录异常日志失败后时抛出异常 8:DataType:合并数据类型转化方法为两个:GetDbType和GetSqlType,同时注释掉其它附加方法 CYQ.Data.Table 名称空间 1:MDataTable:增加ToDataTable功能   CYQ.Data.Cache 名称空间 1:CacheHelper:优化代码,减少代码行数 2:CacheHelper:修改了几个函数名称 其它 同时制作与发布V1.4 API 使用帮助文档

     

     以下针对更新进说明

     

    1:SQLHelper/DataType/Log 修改类访问修饰符,不对外开放

    这个不用多解释了吧,就是通过CYQ.Data.SQL名称空间下,看不到这三个类了。

     

     

    CYQ.Data 名称空间

    一:MProc 存储过程操作类

    1:因SQLHelper修改访问修饰不对外开放,继承方式变更为内置类

    2:ExeScalar由返回object对象改成泛型方法,示例

    MProc proc  =   new  MProc(ProcNames.GetFirstUserID); int  userID = proc.ExeScalar < int > (); proc.Close();

     

    3:删除方法:ExeDataReader与ExeDataTable;增加方法:ExeMDataTable

    示例

    MProc proc  =   new  MProc(ProcNames.GetMessageList); MDataTable mtable =  proc.ExeMDataTable(); proc.Close(); gvProcMessage.DataSource  =  mtable; gvProcMessage.DataBind();

     

    4:方法名称修改:AddParas改成Set方法[并自动增加@前缀];ClearParas改成Clear

    示例

    MProc proc  =   new  MProc(ProcNames.GetMessageList); proc.Set(GetMessageList.UserID,  1 ); // 说明:OutPutData增加了对存储过程参数的枚举导出。 MDataTable mtable  =  proc.ExeMDataTable(); proc.Close(); gvProcMessage.DataSource  =  mtable; gvProcMessage.DataBind();

     

    二:MAction 主操作类

    1:增加事务,并默认所有操作均开启事务,默认直到调用Close方法时提交事务。同时增加提前事务结束方法:EndTransation(),

    示例1:

            MAction action  =   new  MAction(TableNames.Users);          if  (action.Fill( 7 ))         {             action.Set(Users.UserName,  " 用户名被修改了 " );              if  (action.Update()) // 第一步更新成功             {                 action.Set(Users.UserName,  " aaaaaaaaaaa " );                  if  (action.Update( " td>3 " )) // 并不存在td字段,更新失败。自动调用Close(),事务被回滚                 {                     action.Close();                 }             }         }

     

    示例2:

            MAction action  =   new  MAction(TableNames.Users);          if  (action.Fill( 7 ))         {             action.Set(Users.UserName,  " 用户名被修改了 " );              if  (action.Update())             {                 action.EndTransation(); // 提交结束事务,此时用户名称已修改成功。                 action.Set(Users.UserName,  " aaaaaaaaaaa " );                  if  (action.Update( " td>3 " )) // 更新失败,不再引发事务。                 {                     action.Close();                 }             }         }

     

     

    2:多数据库应用加强,增加表枚举约定数据库链接配置

    对于多数据库应用,你仍可以使用以下的方法实例一个MAction

    MAction action  =   new  MAction(TableNames.Users, " CYQ " );

    通过构造函数的重载实现新的数据库链接。

    web.config对CYQ配置如下

    < connectionStrings >      < add name = " Conn "  connectionString = " server=.;database=Chat;uid=sa;pwd=123456 " />      < add name = " CYQ "  connectionString = " server=192.168.1.48;database=CYQ;uid=sa;pwd=3dfe323ft " /> </ connectionStrings >

    当然,为了全局统一管理,你可能把"CYQ"设置成一个类的成员变量能传递,如下:

    // 数据库链接管理类 public   class  DataBaseLink {          public   const   string  CYQ  =   " CYQ " ;          public   const   string  Other =   " Other " ; }  // 调用 MAction action  =   new  MAction(TableNames.Users, DataBaseLink.CYQ);

    以上方式虽然可以做到,不过本次增加的约定方法,可以让你省略对数据库链接的管理,示例

    MAction action  =   new  MAction(U_MessageEnum.Users);

    对应的数据库链接配置为

    < add  name ="MessageConn"  connectionString ="server=.;database=Message;uid=sa;pwd=123456" />

    其约定为:

            表约定:U_数据库名+Enum ->对应配置链接为 数据库名+Conn      视图约定:V_数据库名+Enum ->对应配置链接为 数据库名+Conn 存储过程约定:P_数据库名+Enum ->对应配置链接为 数据库名+Conn

     

    当然了,简单的说其实不用管那么多,因为OutPutData已增加对其约定枚举的导出,详见下面的OutPutData相关介绍。

     

    CYQ.Data.SQL 名称空间

    一:SQLHelper 底层数据库操作类,已封剑归隐,假装不涉人世

    1:增加底层对事务的支持

    2:删除没用到的方法与属性如

    方法:ExeDataTable:ExeXmlScalar 属性:Parameters

     

    二:SQLString 内部SQL字符串组合类

    对where条件增加对符号“ -- ”及“;”的过滤

     

     

    三:OutPutData 主要输出类,包括存储过程输出与执行/表视图存储过程枚举输出

    1:增加对存储过程参数的导出

    导出方法示例

    CYQ.Data.SQL.OutPutData data = new CYQ.Data.SQL.OutPutData("MessageConn"); Response.Write(data.OutPutAllTableEnum(TableType.P,FiledDescriptionType.NoDescription,false));

    导出结果示例

    namespace MessageEnum {     public enum ProcNames{GetUserList,GetMessageList,GetFirstUserID}     #region 存储过程参数枚举     public enum GetUserList{ }     public enum GetMessageList{UserID }     public enum GetFirstUserID{}     #endregion }

     

    2:多数据库方式,增加对约定方式的导出

    导出方法示例,区别仅在最后一个参数设置为“true”

    CYQ.Data.SQL.OutPutData data  =   new  CYQ.Data.SQL.OutPutData( " MessageConn " ); Response.Write(data.OutPutAllTableEnum(TableType.P,FiledDescriptionType.NoDescription, true ));

    导出结果示例,区别仅在存储过程枚举名称

    namespace  MessageEnum { public   enum  P_MessageEnum {GetUserList,GetMessageList,GetFirstUserID} #region  存储过程参数枚举  public   enum  GetUserList { UserID} public   enum  GetMessageList { UserID} public   enum  GetFirstUserID { } #endregion

     

    3:增加生成日志记录表方法

    用法示例[如果该表已存在,则抛出异常提示]

    CYQ.Data.SQL.OutPutData data  =   new  CYQ.Data.SQL.OutPutData( " MessageConn " ); Response.Write(data.ExeCreateLogTable().ToString());

     

     

    四:Log 数据库异常日志记录类

    web.config配置示例

    < appSettings >      < add key = " IsWriteLog "  value = " true " /> </ appSettings > < connectionStrings >      < add name = " Conn "  connectionString = " server=.;database=Chat;uid=sa;pwd=123456 " />      < add name = " LogConn "  connectionString = " Conn " /> </ connectionStrings >

    说明

    1 :如果记录日志,需要创建异常日志表用于记录[详见OutPutData关于创建日志记录表的用法] 2 :在写数据库记录异常日志失败后或不启用日志记录时有异常则抛出 3 :以上示例在链接库链接配置的链接字符串,设置为Conn表示取Conn配置文件的链接字符串。

     

     

    五:DataType 数据库类型与C#类型转换类

    合并方法并优化了代码,同时修改了内部方法名称。内部内不对外开放,不做过多解释了。

     

    CYQ.Data.Table 名称空间

    一:MDataTable 自定义的Table类,支持控件绑定

    增加ToDataTable方法,对于需要用到Select/Fiter/或其它复杂操作时,可切换过去操作。

     

     

    CYQ.Data.Cache 名称空间

    一:CacheHelper 全局缓存类

    1 :优化了代码,减少代码行数 2 :修改几个方法名称 使用示例:  实例化: CacheManage cache = CacheManage.Instance;  添加:   cache.Add( " 路过秋天 " , new  MDataTable);  判断:    if (cache.Contains( " 路过秋天 " ))           {  获取:       MDataTable table = cache.Get( " 路过秋天 " as  MDataTable;           }

     

    V1.4版本CYQ.Data.dll:点击下载

    V1.4版本 API 帮助文档:点击下载

    版权声明:本文原创发表于博客园,作者为路过秋天,原文链接:

    http://www.cnblogs.com/cyq1162/archive/2010/08/31/1812621.html

    相关资源:敏捷开发V1.0.pptx
    最新回复(0)