昨天结尾停在一个情况:一家公司要的差异大到语言与布局都接不住。那类需求的形状跟前两篇不一样:保存前多一道信用额度检查、保存后把单据同步到另一套系统、删除时通知仓储。它们要的不是一份长得不一样的定义,是一段会运行的行为。
框架原本就有一条路能接:继承整张表单的 BO,在注册表里换掉绑定。但这条路对上面那几件事过重。为了保存后发一封通知,得接管整张单据的 BO;三个互不相干的定制需求叠起来,只能写进同一个子类;套装日后在那个步骤添加的逻辑还跑不跑得到,取决于子类记不记得调用 base。缺的不是扩展点,是一种比继承轻、而且能逐份定制声明的挂法。
本篇说明:
- plugin 挂在哪四个时点,各自适合放什么
- 配置文件为什么连时点一起写,一个类一个时点又换到什么
- 两层相加之后,失败与对外的副作用该怎么放
- 什么时候该用 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 铁人赛参赛文章,原文为繁体中文。
系列完整目录:ERP 架构师笔记:定义驱动的框架设计