二开案例.单据插件.缓存清理

【应用场景】

直接后台修改了数据，前端缓存不会自动刷新，此时，需要在后台手动调用一下缓存清理服务。

【注意】

本案例仅适用于22年9月，以及之后的补丁版本。

【案例演示】

采购订单，修改订单明细引用的某个物料的规格型号数据，然后通过手动刷新物料的缓存，使得修改后的物料数据在单据界面上立即生效。

【实现步骤】

<1>编写单据插件，代码如下。

using Kingdee.BOS;

using Kingdee.BOS.App.Core;

using Kingdee.BOS.App.Data;

using Kingdee.BOS.Core.Bill.PlugIn;

using Kingdee.BOS.Core.Const;

using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using Kingdee.BOS.ServiceHelper;

using Kingdee.BOS.Util;

using System;

using System.Collections.Generic;

using System.ComponentModel;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【单据插件】缓存清理

    /// </summary>

    [Description("【单据插件】缓存清理"), HotUpdate]

    public class ClearCacheBillPlugIn : AbstractBillPlugIn

    {

        public override void BarItemClick(BarItemClickEventArgs e)

        {

            base.BarItemClick(e);

            if (e.BarItemKey.Equals("tbUpdateData", StringComparison.OrdinalIgnoreCase))

            {

                // 修改物料【普通物料A】的规格型号数据

                var sql = "UPDATE T_BD_MATERIAL_L SET FSPECIFICATION=N'国产' WHERE FMATERIALID IN (187780,187802,187812,187822,421843)";

                DBUtils.Execute(Context, sql);

                this.View.ShowMessage("物料【普通物料A】的规格型号已更新为国产！");

                return;

            }

            if (e.BarItemKey.Equals("tbClearCacheByFormIds", StringComparison.OrdinalIgnoreCase))

            {

                // 清除物料的所有缓存(传入参数为物料的业务对象标识)

                ClearCacheByFormIds(Context, new List<string>(new[] { "BD_MATERIAL" }));

                this.View.ShowMessage("物料的缓存已被清空！");

                return;

            }

            if (e.BarItemKey.Equals("tbClearCacheByPrimaryKeys", StringComparison.OrdinalIgnoreCase))

            {

                // 清除指定内码的物料的所有缓存(传入参数为物料的业务对象标识)

                ClearCacheByPrimaryKeys(Context, "BD_MATERIAL", new List<string>(new[] { "187780", "187802", "187812", "187822", "421843" }));

                this.View.ShowMessage("物料【普通物料A】的缓存已被清空！");

                return;

            }

        }

        /// <summary>

        /// 清理缓存（整个基础资料的缓存全清）

        /// </summary>

        /// <param name="ctx">上下文</param>

        /// <param name="formIds">业务对象标识</param>

        /// <returns></returns>

        public static bool ClearCacheByFormIds(Context ctx, List<string> formIds)

        {

            if (formIds == null || formIds.Count == 0)

            {

                return false;

            }

            var area = ctx.GetDBCacheKey();

            foreach (var formId in formIds)

            {

                var metadata = FormMetaDataCache.GetCachedFormMetaData(