·您现在的位置: 云翼网络 >> 文章中心 >> 网站建设 >> 网站建设开发 >> ASP.NET网站开发 >> 从零开始编写自己的C#框架(6)——SubSonic3.0插件介绍(附源码)

从零开始编写自己的C#框架(6)——SubSonic3.0插件介绍(附源码)

作者:佚名      ASP.NET网站开发编辑:admin      更新时间:2022-07-23

从零开始编写自己的C#框架(6)——SubSonic3.0插件介绍(附源码)

  前面几章主要是概念性的东西为主,向初学者们介绍项目开始前的一些知识与内容,从本章开始将会进入实操阶段,希望跟着本系统学习的朋友认真按说明做好每一步操作(对于代码最好是直接照着文档内容在你的IDE中打一次出来,而不是使用复制粘贴),这样对你理解后面的章节会有较好的帮助,如果你对我这种书写方式有什么建议或支持,也希望在评论中留言,谢谢你的支持。

  SubSonic3.0简介

  SubSonic是Rob Conery用c#语言写的一 个ORM开源框架,使用BSD软件授权许可(The BSD 3-Clause License)。它是一个实用的快速开发框架,通过非常简单的配置,以及附带的T4模板,就可以帮我们生成功能强大的数据访问层工具,让开发人员远离SQL语句的拼接,专注于业务逻辑的开发。

  SubSonic3.0适合短、平、快的中小型项目开发,支持MsSql、MySQL与SQLite三种数据库,支持Linq和支持事务。对数据库操作灵活,对生成的SQL语句会自动进行优化,虽然是ORM框架,但在性能上并没有太大的损失。它上手容易,是一个非常棒的ORM开发框架。

  3.0版本最大的缺点是框架未开发完善,对多表关联查询支持的不是很好,只支持一个多表关联条件(复杂的多表关联只能使用存储过程或SQL语句拼接方式来实现);条件语句对In与Not In不支持(需要在数据层重新封装处理才行);如果使用Redis缓存的话,存储数据时对subsonic3.0生成的实体有兼容问题,需要做一次转换封装后才能使用。

  不过总的来说,这些缺点都是可以克服的,在开发效率、二次开发、软件维护上来说,优点也是非常明显的,请大家耐心学完本系列,你就能很容易的掌握SubSonic3.0这个开发利器。

  SubSonic3.0安装说明

  SubSonic3.0安装练习相关附件下载

  在MsSql中新建一个数据库SubSonicTest,并设置好登陆帐号与密码为SubSonicTest。

  运行下载包里的“SQL语句.txt”文件里的语句,生成数据表、记录与测试用的存储过程。

  

  创建一个空白解决方案

  

  在解决方案中创建一个空Web应用程序项目

  

  将SubSonic文件夹复制进项目文件夹中

  

  刷新项目就可以看到隐藏的SubSonic文件夹

  

  打开Web.config,添加数据库链接字串

  

  

<connectionStrings>    <!-- 连接数据库的字符串 -->    <add name="PRocom" connectionString="server=.;Initial Catalog=SubSonicTest;uid=SubSonicTest;pwd=SubSonicTest"/>  </connectionStrings>
View Code

  将Dll和SubSonic.Core复制到解决方案中

  

  添加SubSonic3.0项目(直接使用源码项目,方便在使用时调试及修改)

  

  

  

  添加SubSonic.Core项目和Castle.Core.dll引用(大神TerryLee的博客里有Castle 开发系列文章 有兴趣的朋友可以进去学习一下)

  

  

  

  将SubSonic包含进项目中

  

  如果你的数据库名称、帐号和密码设置同面前要求一样的话,T4模板将会直接运行生成相关实体类,如果设置不一样的,请按下面要求来进行设置

  打开Settings.ttinclude配置文件

  

  

  设置好以后,选择全部T4模板文件,运行生成代码

  

  

  SubSonic3.0模板介绍说明

  本文只介绍附件中SubSonic文件夹模板(MsSql),不适用官方发布的模板

文件名称说明
ActiveRecord.tt按数据表生成对应名称的类实体(Model),以及支持lambda表达式的各种常用函数(包括增、改、查、删、Exists等)
Context.tt 生成常用公共模版函数:Select、Insert、Avg、Count、Max、Min、Variance、StandardDeviation、Sum、Delete、GetQuery、Update等
CreateModel.tt新增模板(原SubSonic3.0没有这个模板),主要功能是数据表生成对应名称的类实体(Model),这是普通的类实体,不附任何多余的内容(函数),主要用于存储到Redis缓存或做C/S接口通讯时转Json使用。非必须项
EntityTable.tt新增模板(原SubSonic3.0没有这个模板,里面的功能从Structs.tt模板中分离出来的),主要功能是可直接获取数据表名称与字段名称,减少开发中硬编码的存在
Settings.ttinclude模版参数配置
SQLServer.ttinclude MsSql数据库读取、生成的相关配置
StoredProcedures.tt生成存储过程调用函数(本模板生成的函数调用存储过程非常方便,详情请关注例子)
Structs.tt生成表结构模版,提供给SubSonic插件调用

  SubSonic3.0使用例子

  点击下载本文本例子的解决方案源码

  之前发布过《SubSonic3.0使用例子》,当时刚开始接触写得有点乱,现在重新整理一下,使用上面生成的类来进行操作,可以在项目中直接运行。对于下面的例子,可以直接在解决方案中Debug运行,查看运行结果,以加深理解,当然大部分功能在正式开发中很少使用,所以简单了解一下就可以了,只要会用Lambda,那么后面相关章节介绍时你就会使用。

  下面例子只适用于本文所附带的模板,特此说明

using System;using System.Collections.Generic;using System.Data;using System.Linq;using System.Text;using Solution.Dataaccess.DataModel;using SubSonic.Linq.Structure;using SubSonic.Query;namespace SubSonicTest{    public partial class Test : System.Web.UI.Page    {        protected void Page_Load(object sender, EventArgs e)        {            //-------------------------------------------------------------------------------            // 新增记录            //-------------------------------------------------------------------------------            var branch = new Branch();            branch.DeptCode = SPs.P_Branch_GetMaxBranchCode(2, 1).ExecuteScalar() + "";            branch.Name = "客服部";            branch.Comment = "客户售后服务维护部门";            branch.ParentId = 1;            branch.Sort = 7;            branch.Depth = 2;            //AddDate这个属性不用赋值,ORM框架生成更新语句时会自动过滤该字段,更新时将会使用数据库中设置的默认值            //branch.AddDate = DateTime.Now;            //保存进数据库            branch.Save();            WriteLine("记录添加成功,新增Id为:" + branch.Id);            //-------------------------------------------------------------------------------            // 修改记录            //-------------------------------------------------------------------------------            //从数据库中读出刚添加的记录            var branchModel = Branch.SingleOrDefault(x => x.Id == branch.Id);            //也可以用这个            //var branchModel = new Branch(x => x.Id == branch.Id);            //打印读取出来的数据            WriteLine(branchModel.ToString());            //修改名称为“售后服务部”            branchModel.Name = "售后服务部";            //保存进数据库            branchModel.Save();            //重新从数据库中读取出来并打印到输出窗口            WriteLine((new Branch(x => x.Id == branch.Id)).ToString());            //-------------------------------------------------------------------------------            // 判断刚刚修改的记录是否存在            //-------------------------------------------------------------------------------            if (Branch.Exists(x => x.Id == branch.Id))            {                WriteLine("Id为" + branch.Id + "的记录存在!");            }            else            {                WriteLine("Id为" + branch.Id + "的记录不存在!");            }            //-------------------------------------------------------------------------------            // 删除记录            //-------------------------------------------------------------------------------            //删除当前记录            Branch.Delete(x => x.Id == branch.Id);            //也可以使用这种方法删除            //branchModel.Delete();             Wri