NStarfaiNet 框架的使用示例（一）

以下示例仅仅是我测试框架所用的一部分示范代码，仅供大家参考：
DAO: 依赖于NStarfaiNet的架构将不再需要DAO这一层，因为NStarfaiNet.Access就是你的DAO。为了不将NStarfaiNet过多方法和接口暴露给开发人员使用，应用架够有必要做一下适当的包装。

如下所示：
IBaseDao.cs：

 1/**//*
 2  版权所有:版权所有(C) 2007 NStarfaiNet框架设计者
 3  模块名称:NStarfaiNet.Test
 4  完成日期:2006-08-20
 5  设计作者:刘斌[liubin]
 6  内容摘要:IBaseDao 的摘要说明。
 7*/
 8using System;
 9using System.Data;
10using System.Collections.Specialized;
11using NStarfaiNet.Access.Interface;
12
13namespace NStarfaiNet.Test.Dao
14{
15    /**//// <summary>
16    /// 应用框架DAO接口
17    /// </summary>
18    public interface IBaseDao : IDao
19    {
20        自动生成代码#region 自动生成代码
21        /**//// <summary>
22        /// 新增记录。
23        /// </summary>
24        /// <param name="entity">实体对象。</param>
25        /// <returns>新增成功返回true，否则返回false。</returns>
26        int Insert(IEntity entity);
27
28        /**//// <summary>
29        /// 删除记录。
30        /// </summary>
31        /// <param name="entity">实体对象。</param>
32        /// <returns>删除成功返回true，否则返回false。</returns>
33        int Delete(Key key);
34
35        /**//// <summary>
36        /// 更新记录。
37        /// </summary>
38        /// <param name="entity">实体对象。</param>
39        /// <returns>更新成功返回true，否则返回false。</returns>
40        int Update(IEntity entity);
41
42        /**//// <summary>
43        /// 获得表下一个主键值
44        /// </summary>
45        /// <param name="tableName">表名称</param>
46        /// <returns></returns>
47        int GetPrimaryKeyValue(string tableName);
48
49        /**//// <summary>
50        /// 根据主键获得IEntity对象
51        /// </summary>
52        /// <param name="key"></param>
53        /// <returns></returns>
54        IEntity Get(Key key);
55
56        /**//// <summary>
57        /// 查询表
58        /// </summary>
59        /// <param name="tag">语句ID</param>
60        /// <param name="ht">条件集合</param>
61        /// <returns></returns>
62        DataTable ExcuteDataTable(string tag, HybridDictionary ht);
63
64        /**//// <summary>
65        /// 获得SQL
66        /// </summary>
67        /// <param name="tag">语句ID</param>
68        /// <param name="ht">条件集合</param>
69        /// <returns></returns>
70        string GetSQL(string tag, HybridDictionary ht);
71        #endregion
72        
73    }
74}
75

 BaseDao.cs：

  1/**//*
  2  版权所有:版权所有(C) 2007 NStarfaiNet框架设计者
  3  模块名称:NStarfaiNet.Test
  4  完成日期:2006-08-20
  5  设计作者:刘斌[liubin]
  6  内容摘要:BaseDao 的摘要说明。
  7*/
  8using System;
  9using NStarfaiNet.Access.Interface;
 10using NStarfaiNet.Access;
 11
 12namespace NStarfaiNet.Test.Dao
 13{
 14    /**//// <summary>
 15    /// 应用框架DAO
 16    /// </summary>
 17    public class BaseDao : IBaseDao
 18    {
 19        自动生成代码#region 自动生成代码
 20        /**//// <summary>
 21        /// 数据库访问接口。
 22        /// </summary>
 23        private IDataAccess m_DataAccess = null;
 24        /**//// <summary>
 25        /// 数据库访问接口。
 26        /// </summary>
 27        public IDataAccess DataAccess
 28        {
 29            set
 30            {
 31                m_DataAccess = value;
 32            }
 33            
 34            get
 35            {
 36                return m_DataAccess;
 37            }
 38        }
 39
 40        /**//// <summary>
 41        /// 数据库ID
 42        /// </summary>
 43        /// <remarks>
 44        ///         dao_maps_config.config文件中database的ID
 45        /// </remarks>
 46        private string m_AccessID = string.Empty;
 47        /**//// <summary>
 48        /// 构造函数
 49        /// </summary>
 50        public BaseDao()
 51        {
 52            // 默认数据库
 53            this.m_DataAccess = AccessManager.GetInstance();
 54        }
 55
 56        public BaseDao(string accessID)
 57        {
 58            // 多数据库支持
 59            this.m_AccessID = accessID;
 60            if (accessID == null || accessID.Length == 0)
 61            {
 62                this.m_DataAccess = AccessManager.GetInstance();
 63            }
 64            else
 65            {
 66                this.m_DataAccess = AccessManager.GetInstance(m_AccessID);
 67            }
 68        }
 69
 70
 71        public int Insert(IEntity entity)
 72        {
 73            // TODO:  添加 BaseDao.Insert 实现
 74            return m_DataAccess.Insert(entity);
 75        }
 76
 77        public int Delete(Key key)
 78        {
 79            // TODO:  添加 BaseDao.Delete 实现
 80            return m_DataAccess.Delete(key);
 81        }
 82
 83        public int Update(IEntity entity)
 84        {
 85            // TODO:  添加 BaseDao.Update 实现
 86            return m_DataAccess.Update(entity);
 87        }
 88
 89        public int GetPrimaryKeyValue(string tableName)
 90        {
 91            // TODO:  添加 BaseDao.GetPrimaryKeyValue 实现
 92            return m_DataAccess.GetPrimaryKeyValue(tableName);
 93        }
 94    
 95        public System.Data.DataTable ExcuteDataTable(string tag, System.Collections.Specialized.HybridDictionary ht)
 96        {
 97            // TODO:  添加 BaseDao.GetDataTable 实现            
 98            return m_DataAccess.ExcuteDataTable(tag, ht);;
 99        }
100        public IEntity Get(Key key)
101        {
102            // TODO:  添加 BaseDao.Get 实现
103            return m_DataAccess.Get(key);
104        }
105        public string GetSQL(string tag, System.Collections.Specialized.HybridDictionary ht)
106        {
107            // TODO:  添加 BaseDao.GetSQL 实现
108            return m_DataAccess.GetSQL(tag, ht);
109        }
110        #endregion
111
112    }
113}
114

BLL:

自动生成的业务类，此处以表bsi_test对应的业务类为示范代码，

 

  1/**//*
  2  版权所有:版权所有(C) 2007 NStarfaiNet框架设计者
  3  模块名称:NStarfaiNet.Test
  4  完成日期:2006-08-20
  5  设计作者:刘斌[liubin]
  6  内容摘要:BsiTestBLL 的摘要说明。
  7*/
  8using System;
  9
 10using NStarfaiNet.Access.Interface;
 11using NStarfaiNet.Test.Dao;
 12using NStarfaiNet.Test.Model.Interface;
 13using NStarfaiNet.Test.BLL;
 14
 15namespace NStarfaiNet.Test.GeneratorCode.BLL
 16{
 17    /**//// <summary>
 18    /// BsiTestBLL 的摘要说明。
 19    /// </summary>
 20    public class BsiTestBLL : BaseBLL
 21    {
 22        自动生成代码#region 自动生成代码
 23        protected BsiTestBLL()
 24        {
 25            
 26        }
 27        protected BsiTestBLL(string accessID)
 28        {
 29            base.m_AccessID = accessID;
 30        }
 31
 32        private static volatile BsiTestBLL m_instance = null;
 33        
 34        /**//// <summary>
 35        /// 方法名称: GetInstance
 36        /// 内容摘要: 取得 BsiTestBLL 对象
 37        /// </summary>
 38        /// <param name="accessID">Database ID</param>
 39        /// <returns>返回一个已经存在的实体</returns>
 40        public static BsiTestBLL GetInstance(string accessID)
 41        {
 42            // 通用的必要代码 iBatisNet双校检机制,如果实例不存在
 43            if (m_instance == null)
 44            {
 45                lock (typeof (BsiTestBLL))
 46                {
 47                    // 如果实例不存在
 48                    if (m_instance == null)
 49                    {
 50                        // 创建一个的实例
 51                        m_instance = new BsiTestBLL(accessID);
 52                    }
 53                }
 54            }
 55            // 返回业务逻辑对象
 56            return m_instance;
 57        }
 58        /**//// <summary>
 59        /// 方法名称: GetInstance
 60        /// 内容摘要: 取得 BsiTestBLL 对象
 61        /// </summary>
 62        /// <returns>返回一个已经存在的实体</returns>
 63        public static BsiTestBLL GetInstance()
 64        {
 65            // 通用的必要代码 iBatisNet双校检机制,如果实例不存在
 66            if (m_instance == null)
 67            {
 68                lock (typeof (BsiTestBLL))
 69                {
 70                    // 如果实例不存在
 71                    if (m_instance == null)
 72                    {
 73                        // 创建一个的实例
 74                        m_instance = new BsiTestBLL();
 75                    }
 76                }
 77            }
 78            // 返回业务逻辑对象
 79            return m_instance;
 80        }
 81        
 82        /**//// <summary>
 83        /// 获得Dao
 84        /// </summary>
 85        private IBaseDao Dao
 86        {
 87            get
 88            {
 89                return base.GetDAO();
 90            }
 91        }
 92        
 93        /**//// <summary>
 94        /// 方法名称: Insert
 95        /// 内容摘要: 插入纪录
 96        /// </summary>
 97        /// <returns>int</returns>
 98        public int Insert(IBsiTestEntity obj)
 99        {
100            obj.TestId = this.Dao.GetPrimaryKeyValue("bsi_test");
101            return this.Dao.Insert(obj);
102        }
103        
104        
105        /**//// <summary>
106        /// 方法名称: Update
107        /// 内容摘要: 更新纪录
108        /// </summary>
109        /// <returns>int</returns>
110        public int Update(IBsiTestEntity obj)
111        {
112            return this.Dao.Update(obj);
113        }
114        
115        
116        /**//// <summary>
117        /// 方法名称: Delete
118        /// 内容摘要: 删除纪录
119        /// </summary>
120        /// <returns>int</returns>
121        public int Delete(Key key)
122        {
123            return this.Dao.Delete(key);
124        }
125        
126        /**//// <summary>
127        /// 方法名称: Get
128        /// 内容摘要: 由键值获取一个实体对象
129        /// </summary>
130        /// <returns>IBsiTestEntity</returns>
131        public IBsiTestEntity Get(Key key)
132        {
133            return (IBsiTestEntity)this.Dao.Get(key);
134        }    
135        #endregion
136    
137    }
138}
139