posts - 19,  comments - 128,  trackbacks - 0

前一章讲解了如何配置DbSession,本章重点讲解利用MySoft.Data进行数据的插入操作

这里先引用一下上一章的DbSession的配置代码

    /// <summary>
    /// 数据库访问类
    /// </summary>
    public static class DataAccess
    {
        /// <summary>
        /// 通过配置节来实例化DbSession
        /// </summary>
        public static readonly DbSession DefaultSession = new DbSession("DataExample");

        /// <summary>
        /// 通过自定义类来实例化DbSession
        /// </summary>
        public static readonly DataExample ExampleSession = new DataExample();

    }

    /// <summary>
    /// DataExample会话类
    /// </summary>
    public class DataExample : DbSession
    {
        public DataExample()
            : base("DataExample")
        {
#if DEBUG
            this.RegisterSqlLogger(log =>
                {
                    System.IO.File.WriteAllText("c:\\log.txt", log);
                });
#endif
        }

        /// <summary>
        /// 插入实体
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="item"></param>
        /// <returns></returns>
        public int Insert<T>(T item) where T : Entity
        {
            item.Detach();
            return base.Save(item);
        }

        /// <summary>
        /// 更新实体
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="item"></param>
        /// <returns></returns>
        public int Update<T>(T item) where T : Entity
        {
            item.Attach();
            return base.Save(item);
        }
    }

    针对上一节DbSession的配置,可以看到,这里对DataExample类扩展了两个方法,而在我的组件内部并没有Insert<T>(T item)与Update<T>(T item)方法,而是将其合并到了一个方法Save<T>(T item),外部通过item.Attach()与item.Detach()来改变实体的状态。

    注:item.Attach()与item.Detach()方法还有更多强大的用法,下面会重点讲到!

    也许有人会觉得合并在一起很难区分插入与修改,应该直接用方法名来区分比较好,当然OK,直接在这里加上两个方法即可,还可以扩展出更多的方法来适应你项目开发的需求,比如你完全可以扩展出一个保存多个对象的方法,如下:

        /// <summary>
        /// 一次插入多条数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="items"></param>
        /// <returns></returns>
        public int Insert<T>(IList<T> items) where T : Entity
        {
            int ret = 0;
            foreach (T item in items)
            {
                ret += Insert(item);
            }
            return ret;
        }

    用方法名来区分固然也是好的,但如果需要保存一个实体列表,而这个列表中的实体有些是需要插入的,有些是需要更新的,你该如何处理,只有一种办法,把列表拆分为两个,分别来进行插入与更新。

而使用一个方法Save<T>(T item)可以很方便解决这个问题,在外部将需要插入的方法调用item.Detach(),需要更新的实体调用item.Attach()即可,然后一次传入内部进行操作,还可以为每个实体设置插入的字段或更新的字段!这样是否使用上更优雅一些呢,如下:

            Products product = new Products()
            {
                ProductName = "测试产品1"
            };
            DataAccess.ExampleSession.Save(product);
            product.Detach(Products._.UnitPrice);
            DataAccess.ExampleSession.Save(product);
 

    如果数据库中的某些字段有默认值,比如日期字段需要保存为getdate(),就可以通过Detach()方法将其字段移除而不进行插入!

    好了,DbSession的方法扩展和简单应用就讲到这里,下面开始讲解如何使用DbSession来插入数据,领略MySoft.Data带给你强大的功能体验与快速开发的便捷吧!

以下操作都以数据库Northwind为例。

 

一、强类型数据插入

 

准备工作:

新建一个MySoftExample.DataEntity的项目,使用工具将Northwind中的所有表生成实体,生成的结果如图,生成时将命名空间也设置为MySoftExample.DataEntity。

tmp306

    生成以上实体项目后,再新建一个MySoftExample.Web项目,将MySoftExample.DataEntity项目添加到当前项目的引用中,下面就可以通过生成的实体进行数据的操作了。

    下面的操作以Products实体为例进行操作:

1、单个实体数据插入

            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            //插入单个对象
            DataAccess.ExampleSession.Save(product);

2、批量实体数据插入

            //实例化一组Products对象
            List<Products> list = new List<Products>();
            for (int index = 0; index < 10; index++)
            {
                list.Add(new Products()
                {
                    ProductName = "测试产品" + index
                });
            }

            //批量保存数据
            DbBatch batch = DataAccess.ExampleSession.BeginBatch(10);
            list.ForEach(item =>
            {
                batch.Save(item);
            });

            batch.Process();

3、带事务单个实体插入(MySoft.Data内置实现DbTrans)

            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            //使用事务进行数据插入
            using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
            {
                try
                {
                    trans.Save(product);
                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

4、带事务批量实体插入(MySoft.Data内置实现DbTrans)

            //实例化一组Products对象
            List<Products> list = new List<Products>();
            for (int index = 0; index < 10; index++)
            {
                list.Add(new Products()
                {
                    ProductName = "测试产品" + index
                });
            }

            //使用事务进行批量数据插入
            using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
            {
                try
                {
                    DbBatch batch = trans.BeginBatch(10);
                    list.ForEach(item =>
                    {
                        batch.Save(item);
                    });
                    batch.Process();

                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

5、创建外部数据库链接方式插入

            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            using (System.Data.Common.DbConnection conn = DataAccess.ExampleSession.CreateConnection())
            {
                //插入单个对象
                DataAccess.ExampleSession.SetConnection(conn).Save(product);
            }
注:批量插入可以采用同样的方法处理!

6、创建外部数据库事务方式插入

            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            using (System.Data.Common.DbTransaction trans = DataAccess.ExampleSession.BeginTransaction())
            {
                try
                {
                    //插入单个对象
                    DataAccess.ExampleSession.SetTransaction(trans).Save(product);
                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

注:批量插入可以采用同样的方法处理!

 

item.Detach()方法的高级用法

 

1、指定某些字段使用数据默认值(不改变原有对象传入的状态)

//插入时排除某些字段
Detach(params Field[] removeFields);

//字段CategoryID不进行插入操作
product.Detach(Products._.CategoryID);

//ExcludeField插入时包括的字段
//调用Field.All或Products._.All的Remove方法排除插入的字段可以返回ExcludeField
//也就是说Detach会排除除Remove以外的所有字段
Detach(ExcludeField field);

//只插入ProductName字段
product.Detach(Field.All.Remove(Products._.ProductName));

 

说明一下:

不改变原有对象的传状态是指,假如product对象已经在外面调用过如:

在之前调用了product.Detach(Product._.SupplierID);

此处再次调用会在原有的基础上再排除CategoryID,相当于SupplierID与CategoryID都不进行插入操作,而以下DetachAll()方法则是清除之前所有的状态,再进行当前的处理。


2、指定某些字段使用数据默认值(改变原有对象传入的状态)
//插入时排除某些字段
DetachAll(params Field[] removeFields);

//字段CategoryID不进行插入操作
product.DetachAll(Products._.CategoryID);

//ExcludeField插入时包括的字段
//调用Field.All或Products._.All的Remove方法排除插入的字段可以返回ExcludeField
//也就是说DetachAll会排除除Remove以外的所有字段
DetachAll(ExcludeField field); 

//只插入ProductName字段
product.DetachAll(Field.All.Remove(Products._.ProductName));

InsertOrUpdate方法的使用

 

当用户不知道当前实体是否在数据库中存在时,可以使用此方法。

内部将会根据主键去判断此实体在数据库中是否存在,然后再自动调用相应的方法来进行处理。

            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品"
            };

            DataAccess.ExampleSession.InsertOrUpdate(product);

当然数据插入操作还有其它的方式(自己可以慢慢研究):

            DataAccess.ExampleSession.Insert<Products>(
                new Field[] { Products._.ProductName },
                new object[] { "测试产品" });

            int productID;
            DataAccess.ExampleSession.Insert<Products, int>(
                new Field[] { Products._.ProductName },
                new object[] { "测试产品" }, out productID);


 

二、InsertCreator数据插入

 

通过插入创建器同样也可以达到上面的效果,也可以进行泛型方式进行数据插入,一般情况下创建器用于没有建立对象实体时直接对表和字段的操作。

1、通过实体插入实体

           InsertCreator ic = InsertCreator.NewCreator()
            .From<Products>()
            .SetEntity<Products>(product);

            DataAccess.ExampleSession.Excute(ic);

2、通过字符串表与字段插入数据

            InsertCreator ic = InsertCreator.NewCreator()
            .From("Products")
            .AddInsert("ProductName", "测试产品");

            DataAccess.ExampleSession.Excute(ic);

3、通过字符串表与字段插入数据并返回标识列值

            InsertCreator ic = InsertCreator.NewCreator()
                .From("Products")
                .AddInsert("ProductName", "测试产品")
                .SetIdentityField("ProductID");

            int productID;
            DataAccess.ExampleSession.Excute(ic, out productID);

以上通过创建器的方式同样可以用事务来操作 trans.Excute(ic);

这里只是简单的介绍了一下,还有更多的功能需要用户使用时才能体会到。

 

数据的插入操作就讲解到这里,下一章将讲解数据的修改(Update)操作

有什么问题可以到此处:MySoft组件问题反馈与疑难解答

posted on 2010-03-12 17:32  MySoft  阅读(3710)  评论(4编辑  收藏