package jnpf.base.model;
|
|
/**
|
* 表单数据删除的结果载体。
|
*
|
* <p>AUDIT 补丁（2026-08-05，登记 tasks/jnpf-platform-patches.md #7）新增。
|
*
|
* <p><b>为什么需要它</b>：{@code FlowFormDataUtil.deleteTable} 原先返回 {@code boolean}
|
* 且**无条件返回 true**——记录本来就不存在，与真的删掉了一条，调用方分不出来。
|
* 它内部其实已经算出了两个事实（被删记录的真实主键、实际影响行数），只是全丢掉了。
|
*
|
* <p><b>为什么要真实主键</b>：流程侧删除传进来的 id 可能是 {@code flowTaskId} 而不是业务主键
|
* （{@code deleteTable} 按「主键 = id OR flowTaskId = id」定位），而审计事件的 dataId
|
* 必须是业务主键，否则查询侧对不上记录。
|
*
|
* <p><b>为什么不含子表影响行数</b>：三个消费方（成功/失败判定、dataIdList 入列、审计 dataId）
|
* 没有一个需要它。要用时再加，不预留。
|
*/
|
public class FormDeleteResult {
|
|
/** 真实主键；{@code null} 表示记录不存在。 */
|
private final Object mainId;
|
|
/** 主表实际影响行数：逻辑删取 update 的返回值，物理删取 delete 的返回值。 */
|
private final int affectedRows;
|
|
private FormDeleteResult(Object mainId, int affectedRows) {
|
this.mainId = mainId;
|
this.affectedRows = affectedRows;
|
}
|
|
/** 记录不存在：没定位到主表行，什么都没删。 */
|
public static FormDeleteResult notFound() {
|
return new FormDeleteResult(null, 0);
|
}
|
|
public static FormDeleteResult of(Object mainId, int affectedRows) {
|
return new FormDeleteResult(mainId, affectedRows);
|
}
|
|
public Object getMainId() {
|
return mainId;
|
}
|
|
public int getAffectedRows() {
|
return affectedRows;
|
}
|
|
/** 主表行是否存在（与"是否删成功"分开：定位到了但影响 0 行也算 found）。 */
|
public boolean isFound() {
|
return mainId != null;
|
}
|
|
/** 是否真的删掉了（逻辑删也算——它是一次 update）。 */
|
public boolean isDeleted() {
|
return affectedRows > 0;
|
}
|
|
@Override
|
public String toString() {
|
return "FormDeleteResult{mainId=" + mainId + ", affectedRows=" + affectedRows + "}";
|
}
|
}
|
