严格限定简单表达式的数据为字符串,而不使用Object,避免引起误解
Stone authored at 2015-03-12 09:43:31
12.95 KiB
X
/*
 * XCoder v4.5.2011.1108
 * 作者:nnhy/X
 * 时间:2011-11-13 22:43:14
 * 版权:版权所有 (C) 新生命开发团队 2011
*/
using System;
using System.ComponentModel;
using System.Xml.Serialization;
using XCode;

namespace NewLife.CommonEntity
{
    /// <summary>模版项</summary>
    [ModelCheckMode(ModelCheckModes.CheckTableWhenFirstUse)]
    public class TemplateItem : TemplateItem<TemplateItem> { }

    /// <summary>模版项</summary>
    public partial class TemplateItem<TEntity> : Entity<TEntity> where TEntity : TemplateItem<TEntity>, new()
    {
        #region 扩展属性
        [NonSerialized]
        private EntityList<TemplateContent> _TemplateContents;
        /// <summary>该模版项所拥有的模版内容集合</summary>
        [XmlIgnore]
        public EntityList<TemplateContent> TemplateContents
        {
            get
            {
                if (_TemplateContents == null && ID > 0 && !Dirtys.ContainsKey("TemplateContents"))
                {
                    _TemplateContents = TemplateContent.FindAllByTemplateItemID(ID);
                    Dirtys["TemplateContents"] = true;
                }
                return _TemplateContents;
            }
            set { _TemplateContents = value; }
        }

        [NonSerialized]
        private Template _Template;
        /// <summary>该模版项所对应的模版</summary>
        [XmlIgnore]
        public Template Template
        {
            get
            {
                if (_Template == null && TemplateID > 0 && !Dirtys.ContainsKey("Template"))
                {
                    _Template = Template.FindByID(TemplateID);
                    Dirtys["Template"] = true;
                }
                return _Template;
            }
            set { _Template = value; }
        }

        /// <summary>该模版项所对应的模版名称</summary>
        [XmlIgnore]
        public String TemplateName { get { return Template != null ? Template.FullPath : null; } }

        [NonSerialized]
        private TemplateContent _LastTemplateContent;
        /// <summary>该模版项所对应的最后一个模版内容</summary>
        [XmlIgnore]
        public TemplateContent LastTemplateContent
        {
            get
            {
                if (_LastTemplateContent == null && TemplateID > 0 && !Dirtys.ContainsKey("LastTemplateContent"))
                {
                    _LastTemplateContent = TemplateContent.FindLastByTemplateItemID(ID);
                    Dirtys["LastTemplateContent"] = true;
                }
                return _LastTemplateContent;
            }
            set { _LastTemplateContent = value; }
        }

        /// <summary>该模版项所对应的模版内容</summary>
        [XmlIgnore]
        public String Content
        {
            get { return LastTemplateContent != null ? LastTemplateContent.Content : null; }
            set
            {
                Extends["Content"] = value;
                Dirtys["Content"] = true;
            }
        }

        /// <summary>该模版项所对应的模版版本</summary>
        [XmlIgnore]
        public Int32 Version { get { return LastTemplateContent != null ? LastTemplateContent.Version : 0; } }
        #endregion

        #region 扩展查询
        /// <summary>根据模版、名称查找</summary>
        /// <param name="templateid">模版</param>
        /// <param name="name">名称</param>
        /// <returns></returns>
        [DataObjectMethod(DataObjectMethodType.Select, false)]
        public static TEntity FindByTemplateIDAndName(Int32 templateid, String name)
        {
            if (Meta.Count >= 1000)
                return Find(new String[] { _.TemplateID, _.Name }, new Object[] { templateid, name });
            else // 实体缓存
                return Meta.Cache.Entities.Find(e => e.TemplateID == templateid && e.Name == name);
        }

        /// <summary>根据模版查找</summary>
        /// <param name="templateid">模版</param>
        /// <returns></returns>
        [DataObjectMethod(DataObjectMethodType.Select, false)]
        public static EntityList<TEntity> FindAllByTemplateID(Int32 templateid)
        {
            if (Meta.Count >= 1000)
                return FindAll(new String[] { _.TemplateID }, new Object[] { templateid });
            else // 实体缓存
                return Meta.Cache.Entities.FindAll(_.TemplateID, templateid);
        }

        /// <summary>根据编号查找</summary>
        /// <param name="id">编号</param>
        /// <returns></returns>
        [DataObjectMethod(DataObjectMethodType.Select, false)]
        public static TEntity FindByID(Int32 id)
        {
            if (Meta.Count >= 1000)
                return Find(new String[] { _.ID }, new Object[] { id });
            else // 实体缓存
                return Meta.Cache.Entities.Find(_.ID, id);
            // 单对象缓存
            //return Meta.SingleCache[id];
        }
        #endregion

        #region 对象操作
        ///// <summary>已重载。</summary>
        ///// <param name="forEdit"></param>
        ///// <returns></returns>
        //protected override TEntity CreateInstance(bool forEdit = false)
        //{
        //    TEntity entity = base.CreateInstance(forEdit);
        //    if (forEdit) entity.Kind = "XTemplate";
        //    return entity;
        //}

        ///// <summary>
        ///// 已重载。基类先调用Valid(true)验证数据,然后在事务保护内调用OnInsert
        ///// </summary>
        ///// <returns></returns>
        //public override Int32 Insert()
        //{
        //    return base.Insert();
        //}

        /// <summary>已重载。在事务保护范围内处理业务,位于Valid之后</summary>
        /// <returns></returns>
        protected override Int32 OnInsert()
        {
            Int32 rs = base.OnInsert();

            TemplateContent tc = new TemplateContent();
            tc.TemplateItemID = ID;
            // 数据放在扩展里面
            tc.Content = (String)Extends["Content"];
            tc.Insert();

            return rs;
        }

        /// <summary>已重载</summary>
        /// <returns></returns>
        protected override int OnUpdate()
        {
            // 数据放在扩展里面
            String content = (String)Extends["Content"];

            // 如果扩展里面的内容跟最后内容不一致,则更新
            if (Dirtys["Content"] && (LastTemplateContent == null || "" + content != "" + LastTemplateContent.Content))
            {
                TemplateContent tc = new TemplateContent();
                tc.TemplateItemID = ID;
                tc.Content = content;
                tc.Insert();
            }

            return base.OnUpdate();
        }

        /// <summary>验证数据,通过抛出异常的方式提示验证失败。</summary>
        /// <param name="isNew"></param>
        public override void Valid(Boolean isNew)
        {
            // 这里验证参数范围,建议抛出参数异常,指定参数名,前端用户界面可以捕获参数异常并聚焦到对应的参数输入框
            if (String.IsNullOrEmpty(_.Name)) throw new ArgumentNullException(_.Name, _.Name.Description + "无效!");
            if (!isNew && ID < 1) throw new ArgumentOutOfRangeException(_.ID, _.ID.Description + "必须大于0!");

            // 建议先调用基类方法,基类方法会对唯一索引的数据进行验证
            base.Valid(isNew);

            if (isNew && !Dirtys[_.Kind]) Kind = "XTemplate";
        }

        /// <summary>已重载。删除关联数据</summary>
        /// <returns></returns>
        protected override int OnDelete()
        {
            if (TemplateContents != null) TemplateContents.Delete();

            return base.OnDelete();
        }

        ///// <summary>
        ///// 首次连接数据库时初始化数据,仅用于实体类重载,用户不应该调用该方法
        ///// </summary>
        //[EditorBrowsable(EditorBrowsableState.Never)]
        //protected override void InitData()
        //{
        //    base.InitData();

        //    // InitData一般用于当数据表没有数据时添加一些默认数据,该实体类的任何第一次数据库操作都会触发该方法,默认异步调用
        //    // Meta.Count是快速取得表记录数
        //    if (Meta.Count > 0) return;

        //    // 需要注意的是,如果该方法调用了其它实体类的首次数据库操作,目标实体类的数据初始化将会在同一个线程完成
        //    if (XTrace.Debug) XTrace.WriteLine("开始初始化{0}模版项数据……", typeof(TEntity).Name);

        //    TEntity user = new TEntity();
        //    user.Name = "admin";
        //    user.Password = DataHelper.Hash("admin");
        //    user.DisplayName = "管理员";
        //    user.RoleID = 1;
        //    user.IsEnable = true;
        //    user.Insert();

        //    if (XTrace.Debug) XTrace.WriteLine("完成初始化{0}模版项数据!", typeof(TEntity).Name);
        //}
        #endregion

        #region 高级查询
        /// <summary>查询满足条件的记录集,分页、排序</summary>
        /// <param name="templateid">模版编号</param>
        /// <param name="key">关键字</param>
        /// <param name="orderClause">排序,不带Order By</param>
        /// <param name="startRowIndex">开始行,0表示第一行</param>
        /// <param name="maximumRows">最大返回行数,0表示所有行</param>
        /// <returns>实体集</returns>
        [DataObjectMethod(DataObjectMethodType.Select, true)]
        public static EntityList<TEntity> Search(Int32 templateid, String key, String orderClause, Int32 startRowIndex, Int32 maximumRows)
        {
            return FindAll(SearchWhere(templateid, key), orderClause, null, startRowIndex, maximumRows);
        }

        /// <summary>查询满足条件的记录总数,分页和排序无效,带参数是因为ObjectDataSource要求它跟Search统一</summary>
        /// <param name="templateid">模版编号</param>
        /// <param name="key">关键字</param>
        /// <param name="orderClause">排序,不带Order By</param>
        /// <param name="startRowIndex">开始行,0表示第一行</param>
        /// <param name="maximumRows">最大返回行数,0表示所有行</param>
        /// <returns>记录数</returns>
        public static Int32 SearchCount(Int32 templateid, String key, String orderClause, Int32 startRowIndex, Int32 maximumRows)
        {
            return FindCount(SearchWhere(templateid, key), null, null, 0, 0);
        }

        /// <summary>构造搜索条件</summary>
        /// <param name="templateid">模版编号</param>
        /// <param name="key">关键字</param>
        /// <returns></returns>
        private static String SearchWhere(Int32 templateid, String key)
        {
            // WhereExpression重载&和|运算符,作为And和Or的替代
            var exp = SearchWhereByKeys(key);

            // 以下仅为演示,2、3行是同一个意思的不同写法,FieldItem重载了等于以外的运算符(第4行)
            //exp &= _.Name.Equal("testName")
            //    & !String.IsNullOrEmpty(key) & _.Name.Equal(key)
            //    .AndIf(!String.IsNullOrEmpty(key), _.Name.Equal(key))
            //    | _.ID > 0;

            exp &= _.TemplateID == templateid;

            return exp.SetStrict();
        }
        #endregion

        #region 扩展操作
        #endregion

        #region 业务
        /// <summary>根据路径创建,自动识别或创建父级</summary>
        /// <param name="path"></param>
        /// <returns></returns>
        public static TEntity CreateItem(String path)
        {
            if (String.IsNullOrEmpty(path)) return null;

            String[] ss = path.Split(@"\");
            // 必须至少包含两级,目录和模版项
            if (ss.Length < 2) return null;

            // 先解决父级
            Template parent = Template.Create(String.Join(@"\", ss, 0, ss.Length - 1));

            // 如果找不到父级,就有问题了
            if (parent == null) return null;

            String name = ss[ss.Length - 1];
            TEntity entity = FindByTemplateIDAndName(parent.ID, name);
            if (entity != null) return entity;

            entity = new TEntity();
            entity.TemplateID = parent.ID;
            entity.Name = name;
            entity.Save();

            return entity;
        }

        /// <summary>复制子项</summary>
        /// <param name="src"></param>
        public void CopyContent(TEntity src)
        {
            this.Content = src.Content;
        }
        #endregion
    }
}