SunSonic 3.0 ORM开源框架的学习

SubSonic 3.0简介

接触到SubSonic3.0 ORM框架是看了AllEmpty大神的从零开始编写自己的C#框架（链接在此）系列的随笔接触到的，本文章学习内容源于AllEmpty大神。

SubSonic就是一个ORM开源框架。作者是Robe Conery，用C#语言写的。其中包含了T4模板可以快速生成数据层实体类，这是一个实用的快速开发框架。让开发人员原理SQL语句的拼接，专注于业务逻辑的实现。SubSonic 3.0支持MsSql、MySql与SQLite三种数据库，对数据库操作灵活，对生成的SQL语句会自动进行优化，虽然是ORM框架，但在性能上并没有太大的损失。它上手容易，是一个非常棒的ORM开发框架。

我使用过程中的切身体会是：一次编写，终身使用。将自己需要的功能写在T4模板，利用T4模板强大的自定义功能可以迅速而准确地生成自己的实体类。可以Select类、实体类查询，支持LINQ，支持聚合函数，支持存储过程，可以使用Distinct关键字。（部分功能AllEmpty添加，我使用的是他的修改版）。

SubSonic 3.0配置

创建项目（整个解决方案下载链接在本文后面）并将SubSonic.Core和Castle.dll引用后，添加SubSonic文件夹。此时，整个项目的文件结构如下所示：

然后需要配置一下数据库连接，这里介绍的是MSSQLSERVER。打开SubSonicTest项目中SubSonic文件夹中的Setting.ttinclude，该文件位置如下图红框所示：

打开该文件在开始找到如下所示的内容：

上图红色箭头指向的数据库连接字符串对应Web.config配置文件中的ConnectionStrings的名称，数据名称对应与ConnectString中的数据库。ConnectionStrings配置方式（以我的为例）如下图红框内容所示：

上图中的数据库连接字符串名称一定要和Web.config配置文件中的保持一致，否则会出现错误。确保没有问题后，按如下所示使用T4模板生成数据库实体类：

生成的实体类如下所示：

SubSonic 3.0简单实用

在SubSonicTest项目中新建一个Aspx窗体文件，这里名称是Test.aspx。对应的cs后台文件代码如下所示：

using System;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Text;
using SubSonic.Linq.Structure;
using SubSonic.Query;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using Solution.DataAccess.DataModel;

namespace SubSonicTest
{
    public partial class Test : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {

            //新增记录
            var branch1 = new Branch
            {
                DeptCode = SPs.P_Branch_GetMaxBranchDeptCode(, ).ExecuteScalar() + "",
                Name = "网络部",
                Comment = "网络问题解决中心",
                ParentId = ,
                Sort = ,
                Depth =
            };

            //保存至数据库
            branch1.Save();
            //打印出来S
            PrintImpInfo("记录添加成功,新增Id="+branch1.Id);

            //查询刚刚添加的记录并修改
            var branchModel = Branch.SingleOrDefault(x => x.Comment == "网络问题解决中心");
            branchModel.Name = "售后服务部";
            branchModel.Save();

            //删除刚才添加的记录
            Branch.Delete(x => x.Comment == "网络问题解决中心");
            if (Branch.Exists(x => x.Comment == "网络问题解决中心"))
            {
                PrintImpInfo("存在");
            }
            else
            {
                PrintImpInfo("不存在");
            }

            //查询Branch下所有的数据
            var list = Branch.All();
            foreach (var branch in list)
            {
                PrintImpInfo(string.Format("名字={0},评论={1},添加日期={2}", branch.Name, branch.Comment, branch.AddDate.ToString("yyyy-MM-dd HH:mm:ss")));
            }

            // //使用类实体附带的函数查询
            PrintImpInfo("使用类实体附带的函数查询");
            );
            foreach (var branch in braanchList)
            {
                PrintImpInfo(branch.Id.ToString());
                PrintImpInfo(branch.Name);
                PrintImpInfo(branch.AddDate.ToString("yyyy-MM-dd HH:mm:ss"));
            }
            PrintImpInfo("------------------------");

            //分页功能，获取第2页记录（每页5条记录）
            PrintImpInfo("获取第2页记录（每页5条记录");
            , );
            foreach (var branch in il)
            {
                PrintImpInfo(branch.Id.ToString());
                PrintImpInfo(branch.Name);
                PrintImpInfo(branch.Sort.ToString());
                PrintImpInfo(branch.Depth.ToString());
                PrintImpInfo(branch.ParentId.ToString());
                PrintImpInfo(branch.AddDate.ToString("yyyy-MM-dd HH:mm:ss"));
            }
            PrintImpInfo("------------------------");

            //使用数据库名+DB可以直接调用聚合函数
            PrintImpInfo("数据库名+DB可以直接调用聚合函数");
            var db = new SubSonicTestDB();
            //平均值
            PrintImpInfo().ExecuteScalar()+" ");
            //计算数量
            PrintImpInfo("计算数量" + db.Count<Position>(x => x.Id).ExecuteScalar() + " ");
            //计算合计量
            PrintImpInfo("计算合计量" + db.Sum<Position>(x => x.Id).ExecuteScalar() + " ");
            //最大值
            PrintImpInfo("最大值" + db.Max<Position>(x => x.Id).ExecuteScalar() + " ");
            //最小值
            PrintImpInfo("最小值" + db.Min<Position>(x => x.Id).ExecuteScalar() + " ");

            //存储过程调用方法
            ,).ExecuteScalar();
            PrintImpInfo("存储过程调用obj="+obj);

            //Linq查询方式
            PrintImpInfo("Linq查询方式");
            var query = new Query<Branch>(db.provider);
            var posts = from p in query
                ")
                select p;
            foreach (var branch in posts)
            {
                PrintImpInfo(branch.ToString());
            }

            query = db.GetQuery<Branch>();
            posts = from p in query
                 && p.Id <
                select p;
            foreach (var branch in posts)
            {
                PrintImpInfo(branch.ToString());
            }

            var newBranchList = query.ToList<Branch>();
            foreach (var branch in newBranchList)
            {
                PrintImpInfo(branch.ToString());
            }

            //Linq多表关联查询方式
            PrintImpInfo("Linq多表关联查询方式");
            var query1 = from b in Position.All()
                join p in Branch.All() on b.Branch_Id equals p.Id
                "
                select p;
            foreach (var branch in query1)
            {
                PrintImpInfo(branch.ToString());
            }

        }
        /// <summary>
        /// 在Debug模式下打印信息到输出窗口中
        /// </summary>
        /// <param name="info"></param>
        private void PrintImpInfo(string info)
        {
            System.Diagnostics.Debug.WriteLine(info);

        }

    }
}

加入断点调试（要求Debug下），即可输出打印出的内容，如下所示（打开输出窗口的快捷键是Ctrl+Alt+O）：

感谢AllEmpty大神让我认识到了SubSonic这个ORM框架，么么哒。

整个解决方案在下面：

点此下载