Revert "清理"
猿人易 authored at 2024-06-17 16:53:31
4.34 KiB
Stardust
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web.Script.Serialization;
using System.Xml.Serialization;
using NewLife;
using NewLife.Data;
using NewLife.Log;
using XCode;
using XCode.Cache;
using XCode.Membership;

namespace Stardust.Data.Configs;

/// <summary>配置历史。记录配置变更历史</summary>
public partial class ConfigHistory : Entity<ConfigHistory>
{
    #region 对象操作
    static ConfigHistory()
    {
        // 累加字段,生成 Update xx Set Count=Count+1234 Where xxx
        //var df = Meta.Factory.AdditionalFields;
        //df.Add(nameof(ConfigId));

        // 过滤器 UserModule、TimeModule、IPModule
        Meta.Modules.Add<UserModule>();
        Meta.Modules.Add<TimeModule>();
        Meta.Modules.Add<IPModule>();
    }

    /// <summary>验证并修补数据,通过抛出异常的方式提示验证失败。</summary>
    /// <param name="isNew">是否插入</param>
    public override void Valid(Boolean isNew)
    {
        // 如果没有脏数据,则不需要进行任何处理
        if (!HasDirty) return;

        // 这里验证参数范围,建议抛出参数异常,指定参数名,前端用户界面可以捕获参数异常并聚焦到对应的参数输入框
        if (Action.IsNullOrEmpty()) throw new ArgumentNullException(nameof(Action), "操作不能为空!");

        // 建议先调用基类方法,基类方法会做一些统一处理
        base.Valid(isNew);

        if (TraceId.IsNullOrEmpty()) TraceId = DefaultSpan.Current?.TraceId;
    }
    #endregion

    #region 扩展属性
    #endregion

    #region 扩展查询
    /// <summary>根据编号查找</summary>
    /// <param name="id">编号</param>
    /// <returns>实体对象</returns>
    public static ConfigHistory FindById(Int32 id)
    {
        if (id <= 0) return null;

        // 实体缓存
        if (Meta.Session.Count < 1000) return Meta.Cache.Find(e => e.Id == id);

        // 单对象缓存
        return Meta.SingleCache[id];

        //return Find(_.Id == id);
    }
    #endregion

    #region 高级查询
    /// <summary>高级查询</summary>
    /// <param name="configId">应用</param>
    /// <param name="action">操作</param>
    /// <param name="success">成功</param>
    /// <param name="start">创建时间开始</param>
    /// <param name="end">创建时间结束</param>
    /// <param name="key">关键字</param>
    /// <param name="page">分页参数信息。可携带统计和数据权限扩展查询等信息</param>
    /// <returns>实体列表</returns>
    public static IList<ConfigHistory> Search(Int32 configId, String action, Boolean? success, DateTime start, DateTime end, String key, PageParameter page)
    {
        var exp = new WhereExpression();

        if (configId >= 0) exp &= _.ConfigId == configId;
        if (!action.IsNullOrEmpty()) exp &= _.Action == action;
        if (success != null) exp &= _.Success == success;
        exp &= _.CreateTime.Between(start, end);
        if (!key.IsNullOrEmpty()) exp &= _.Remark.Contains(key) | _.CreateIP.Contains(key);

        return FindAll(exp, page);
    }

    /// <summary>类别名实体缓存,异步,缓存10分钟</summary>
    static Lazy<FieldCache<ConfigHistory>> ActionCache = new Lazy<FieldCache<ConfigHistory>>(() => new FieldCache<ConfigHistory>(__.Action)
    {
        MaxRows = 50
    });

    /// <summary>获取所有类别名称</summary>
    /// <returns></returns>
    public static IDictionary<String, String> FindAllActions() => ActionCache.Value.FindAllName().OrderByDescending(e => e.Key).ToDictionary(e => e.Key, e => e.Value);
    #endregion

    #region 业务操作
    /// <summary>新增历史</summary>
    /// <param name="configId"></param>
    /// <param name="action"></param>
    /// <param name="success"></param>
    /// <param name="remark"></param>
    /// <returns></returns>
    public static ConfigHistory Add(Int32 configId, String action, Boolean success, String remark)
    {
        if (configId == 0) throw new ArgumentNullException(nameof(configId));
        if (action.IsNullOrEmpty()) throw new ArgumentNullException(nameof(action));

        var hi = new ConfigHistory
        {
            ConfigId = configId,
            Action = action,
            Success = success,
            Remark = remark,
        };
        hi.Insert();

        return hi;
    }
    #endregion
}