XPages OpenNTF Domino中设置Authors类型Item抛key cannot be 0异常排查
报错根因定位
从异常调用链逐层拆解,错误发生的完整流程为:
- 代码执行
authorFieldCommittee.setAuthors(true)时,OpenNTF Domino封装层会先校验当前Item的字段属性标记,依次触发isReadersNamesAuthors()、hasFlag()、isNames()系列内部方法 - 上述校验方法需要获取Item底层绑定的原生NotesItem委托对象,因此调用
getDelegate()方法触发Item实例的resurrect()复活逻辑,尝试重新关联底层原生对象 - 复活逻辑会将重新获取的原生对象写入Domino参考缓存,写入时检测到传入的缓存键值为0,直接抛出
java.lang.IllegalArgumentException: key cannot be 0异常
OpenNTF Domino参考缓存的底层规则:对原生Notes对象的缓存统一使用原生对象的内存句柄值作为唯一key,正常存活的原生对象句柄值永远不会为0;只有对象被释放、句柄被回收时,句柄值才会被重置为0,这时候触发缓存写入就会直接命中该校验错误。
业务代码的直接触发诱因
原有业务代码里存在两次连续调用同参数doc.replaceItemValue(fieldName, matter.getCommAuthors())的冗余操作:
- 第一次调用方法时,会在文档上下文创建/替换对应Item,返回第一个有效Item实例,但该实例的返回值没有被代码接收,没有被后续逻辑使用
- 紧接着第二次调用完全相同参数的
replaceItemValue时,OpenNTF封装层会直接销毁第一次生成的Item实例的底层原生委托,将文档上下文中的同名字段对象标记为悬空失效状态 - 第二次调用返回的Item实例,因为连续替换的时序冲突,内部持有的原生对象句柄已经被前置操作重置为0,后续调用
setAuthors(true)触发缓存写入逻辑时,就会直接触发key为0的校验报错。
修复方案
去掉冗余的重复replaceItemValue调用,仅保留一次方法调用拿到有效Item实例后直接设置Authors属性即可:
matter.setCommAuthors(getAuthorsCommittee(matter)); if (null != matter.getCommAuthors()) { String fieldName = "CommAuthors"; // 单次调用获取有效Item实例,避免重复替换导致的对象句柄失效 Item authorFieldCommittee = doc.replaceItemValue(fieldName, matter.getCommAuthors()); authorFieldCommittee.setAuthors(true); }
内容的提问来源于stack exchange,提问作者Patrick Kwinten
相关产品推荐
相关产品推荐

