Day 21:业务逻辑定制与 Plugin 的四个时点

昨天结尾停在一个情况:一家公司要的差异大到语言与布局都接不住。那类需求的形状跟前两篇不一样:保存前多一道信用额度检查、保存后把单据同步到另一套系统、删除时通知仓储。它们要的不是一份长得不一样的定义,是一段会运行的行为。

框架原本就有一条路能接:继承整张表单的 BO,在注册表里换掉绑定。但这条路对上面那几件事过重。为了保存后发一封通知,得接管整张单据的 BO;三个互不相干的定制需求叠起来,只能写进同一个子类;套装日后在那个步骤添加的逻辑还跑不跑得到,取决于子类记不记得调用 base。缺的不是扩展点,是一种比继承轻、而且能逐份定制声明的挂法。

本篇说明:

  1. plugin 挂在哪四个时点,各自适合放什么
  2. 配置文件为什么连时点一起写,一个类一个时点又换到什么
  3. 两层相加之后,失败与对外的副作用该怎么放
  4. 什么时候该用 plugin,以及它跨不过的那条线

一、Plugin 的四个时点

能挂的位置开几个、开在哪里,是这种机制要答的第一个问题。

框架开了四个:BeforeSave、AfterSave、BeforeDelete、AfterDelete。把它们放回 Day 14 那条写入管道,位置是这样:

text 复制代码
DoBeforeSave
    BeforeSave        ← plugin
[截取变更集]
DoSave                ← transaction 只涵盖这一句
[变更审计]
DoAfterSave
    AfterSave         ← plugin

方括号是框架自己做的事,不是扩展点。删除那一侧是同一个形状:DoBeforeDelete → BeforeDelete → DoDelete → 删除审计 → DoAfterDelete → AfterDelete,其中 BeforeDelete 与 AfterDelete 是 plugin 的时点。

时点 紧接在哪一步之后 适合放什么
BeforeSave DoBeforeSave 四个里唯一能安全改数据的
AfterSave DoAfterSave 通知、对外同步
BeforeDelete DoBeforeDelete 对着整笔快照做的检查
AfterDelete DoAfterDelete 把删除传播出去

四个时点都在 transaction 之外,所以 Day 14 那条边界照样适用:在这里读到的值,写进数据库的当下不保证还成立。真的要挡住另一个同时在保存的人,只能让数据库在写入的当下自己判定:一句带着前提的 UPDATE、一个唯一索引,或一条 check constraint。

每个时点都接在对应的 Do 步骤之后,而那一步最后跑的可能是套装的 base,也可能是定制 BO 重写过的版本。继承与 plugin 在 Day 14 那条轴线上是相邻的两层,差的只是粒度与控制权,两者因此可以一起用。

BeforeSave 特别的地方在于它排在截取变更集与写入之前,所以在那里改的值会存进数据库,也会留在审计轨迹里。再往后一格就不行了:数据已经写完,AfterSave 改 DataSet 没有效果,要改的是调用端会拿到的 RefreshedDataSet。这条分界 Day 14 在 SaveContext 上画过,plugin 拿到的是同一个对象。

删除那一侧的快照也是 Day 14 讲过的,这里只补一句:框架在决定要不要加载它的时候,把有没有 plugin 也算了进去。因为数据删掉之后,只剩 AfterDelete 还看得到被删掉的是什么。


二、时点写在配置文件上,类必须对得上

哪一段定制跑在哪一个时点,这件事要在配置文件上看得见。PluginSettings 因此一行写两件事,类型与时点:

xml 复制代码
<PluginSettings>
  <Items>
    <ProgramPluginItem ProgId="Order">
      <Plugins>
        <PluginItem Type="Acme.Plugins.CreditLimitCheck, Acme.Plugins" Stage="BeforeSave" />
        <PluginItem Type="Acme.Plugins.OrderSync, Acme.Plugins" Stage="AfterSave" />
      </Plugins>
    </ProgramPluginItem>
  </Items>
</PluginSettings>

一个 ProgId 对一串 plugin,每一个 Stage 都有它自己的类,一个类也只挂一个时点。例子里因此是两个类:保存前那道检查与保存后那次同步本来就是两件事。分开之后顺带换到各自可以被挑走,另一家客户也在用同一套外部系统,把 OrderSync 声明上去就好,不必连信用额度检查一起搬。

类那一边要对得上:继承 FormBusinessPlugin,把基底要的调用参数往上传,重写配置文件上声明的那一个时点。

csharp 复制代码
public sealed class CreditLimitCheck(IBeeContext ctx, Guid accessToken, string progId)
    : FormBusinessPlugin(ctx, accessToken, progId)
{
    public override void BeforeSave(SaveContext context) { /* 额度不足就丢异常 */ }
}

三、相加之后,失败往哪里跑

两层相加的规则与代价前天已经写完:套装链先跑、定制链接在后面,定制层没有办法禁用套装声明的 plugin。相加之后还有一件事要决定:这条链上任何一段失败了怎么办。

两种失败都往上抛,不略过、不降级:

失败的种类 处置
声明的类型载不到 直接抛,整个操作失败
运行时丢出异常 往上抛,中止操作

这与 BO 那一轴是同一个答案,理由却不一样。那一边不留退路,是因为退回框架默认的类型照样构造得起来,那个程序于是安静地表现得很通用;plugin 这一边是因为它本来就是有人刻意加上去的,略过它等于定制整段没有生效,而静默漏掉一段信用额度检查,比拒绝保存难处理得多。Day 15 谈注册表的失败策略时,判准是「故障的面貌」,这里是同一条判准的另一个实例。

对外的副作用要落在哪一边

框架只管运行顺序:照配置文件声明的先后把链上的 plugin 叫过一遍,中间不接异常、也不判断该不该继续。所以一段 plugin 出错之后怎么办,是写它的人决定的,而选择只有两个:直接抛出,整个操作中止;或是自己接住、记一笔错误,流程照常走完。

一般的分法照时点走,Before 抛、After 记。Before 那两个时点多半在做验证,挡不下来就不该让它存进去;After 那两个时点数据已经提交了,这时丢异常等于对着已经存好的数据回报失败,而且进程要是在 plugin 跑完之前挂掉,结果是数据在、同步没发生、也不留痕迹。

After 最常见的用途是把变更同步到另一套系统,那也是最容易写错的地方:在那里抛异常,等于对方系统维护中的时候用户连单都存不了。框架没有为这件事加机制,加了也会被一个包住整段的 try-catch 绕过去;它只把责任讲明白:别让外部系统的可用性决定一笔数据能不能保存。

可靠性要求因此把位置分成两种:

可靠性要求 该落在哪里
不能漏(财务、库存、对外承诺) 在 transaction 内登记一笔待送记录,另外由后台任务送出
尽力而为,或另有对账作业补得回来 AfterSave / AfterDelete 的 plugin 直接送

第二行现在就做得到。第一行还不行:框架里没有这样的实现,而 Day 14 写过的那六个写入步骤,也没有一个能在既有的 transaction 上追加语句。框架说得出这件事该落在哪一边,但还没有把那个位置开出来。


四、什么时候该用 plugin

一家客户提出需求的时候,第一个要问的是这件事能不能靠改定义解决。字段标题换个说法、界面上少三个字段、菜单照他们的组织排,这几种前两篇谈过,改的是一份定义,不必动程序。

把常见的需求排在一起,界线就清楚了:

想改的东西 套装层 定制层
字段标题、下拉选项的文字 改语言文件 改定制语言文件
界面上少三个字段、明细换一种排法 改布局文件 改定制布局文件
菜单长得不一样 改菜单文件 改定制菜单文件
多一个字段 改 FormSchema 与 TableSchema 没有这条路
改一条计算规则或验证规则 改 FormSchema 里的算式 挂 plugin,或换掉整个 BO

前三行在两层都成立,就是 Day 1 那句话:定义是数据,改定义不必重编、不必换程序集。第四行只在套装层成立,理由前天写过:FormSchema 同时决定数据表长什么样,逐份定制分歧的话,物理结构会跟着裂开。

最后一行才是 plugin 的位置。规则与计算式声明在 FormSchema 里,而那份定义不能定制,所以一家客户要改一条算式,只能落回代码。开头那几个需求也一样:定义描述的是数据长什么样,里面没有地方放一段会运行的行为。

落回代码之后,plugin 是最轻的那一种:不必接管整张单据、可以叠加、可以逐份定制声明;但它终究是一个编译后的类型,要编译、要打包、要放进主机的 bin 才会生效。同一件事在套装层是改一行算式,到了定制层就得走这一条交付路径。「不发版」这件事目前完整成立的范围是套装层。

时间拉长还有另一面。一张表单用个几年,上面会累积好几个 plugin,而真正会被重复用到的,多半是跟外部系统对接的那几个:把客户数据同步到 CRM、把单据送进 BPM 审批、把交期写进 Outlook 或 Google 日历。这一种绑的是对方系统,不是某一家客户,所以新客户只要也在用那套系统,把它声明上去就能用,等于在既有的清单里挑几行。

各家自己的业务规则没有这个性质。信用额度怎么算、单号怎么配,多半一家一个样,写了通常也只有那一家在用。但这一类累积起来仍然值得定期盘一次:如果好几家都写了同一种行为,那就不是定制,是还没被收敛的共通需求。


小结

plugin 是继承与定义文件之间的那一格。不接管整条流程,只在四个固定的位置各加一段;两层相加,套装日后补的自动生效;一个类一个时点,配置文件上读得出哪一段跑在哪里。

  • 四个时点全部在 transaction 外,所以 Day 14 那条边界照样适用:这里读到的值在写入当下不保证还成立,而 BeforeSave 是唯一能安全改数据的位置
  • 失败的处置与 BO 那一轴一致,两边都不留退路,但怕的东西不同:那一边怕程序安静地表现得很通用,这一边怕定制整段没生效
  • 不能漏的对外同步该落在 transaction 内,而那个位置目前还没开出来;After 时点承接得了的是尽力而为、或另有对账作业补得回来的那一类

这一章三篇问的是同一件事的三个面向:一家公司要不一样的地方,最后被表达成什么。表达成定义,它就能叠加、能退回、能跟着套装一起演进;表达成类型,它就得编译、打包、进到主机的 bin,然后回到 Day 1 那条「需求的大小,与交付的成本,彻底脱钩」的老路上。

所以判准不是这个扩展机制能做多少事,是它要走哪一条交付路径。plugin 把定制的门槛从「接管一整张单据」降到「加一个类」,这是实质的一级,但它跨不过定义与代码之间那条线。定制化这条线接下来要往前推的,就是把更多「不一样」从代码那一侧搬回定义这一侧。

明天起换一个层面,先从一份对象同时要能存成文件、送给浏览器、又要在行动端读得回来这件事开始。


本文为 2026 iThome 铁人赛参赛文章,原文为繁体中文。

iThome 原文 | HackMD 版

系列完整目录:ERP 架构师笔记:定义驱动的框架设计

相关推荐
IT规划师1 小时前
Redis 核心机制 | 键生命周期与 TTL 管理
redis·.net
Jeff-Tsai1 天前
Day 20:多语言定制与资源结构
.net·架构设计·erp·definition-driven
泓度科技1 天前
多租户数据隔离怎么做 单库单表架构方案
架构设计·多租户·缓存策略·数据隔离·权限管控
Jeff-Tsai2 天前
Day 19:定制层的范围与叠加粒度
.net·架构设计·erp·definition-driven
known3 天前
你的账,是补出来的还是做出来的
blazor·erp·known
Jeff-Tsai3 天前
Day 18:错误契约与用户可见消息
.net·架构设计·erp·definition-driven
IT规划师3 天前
HybridCache-缓存架构决策框架落地
架构·.net
Jeff-Tsai4 天前
Day 17:Connector 与调用端的职责收敛
.net·架构设计·erp·definition-driven
Flynn Liang5 天前
同一需求三套写法:用 Spring AI、LangChain4j、AgentScope Java 各实现一个带工具调用的 RAG 助手(实战对比)
java·人工智能·大模型·架构设计·spring ai·langchain4j·agentscope