docs: clarify mount checkpoints and snapshot ownership contracts
This commit is contained in:
@@ -4,6 +4,7 @@
|
||||
//! 调用路径:桥接 bootstrap 注册 Constructor;Mount/视觉协议/绘图入口调用 collection 生成返回列表。
|
||||
//! source-layout/graphics/三维等消费者用 items 借用成员;源代码通过 at/append/remove/extend/added 操作。
|
||||
//! 列表只允许对象成员;子类普通字段另按名义类型检查,不能把标量字段值混进成员前缀。
|
||||
//! items/at 读取真实 payload;count/first 是构造或原地编辑时同步写入的普通属性,不是反向驱动成员序列的存储。
|
||||
//!
|
||||
//! Managed indexed host results; values and the at method are traced edges.
|
||||
use endor_core::{
|
||||
@@ -32,7 +33,8 @@ impl ObjectPayload for ObjectList {
|
||||
}
|
||||
/// 枚举本对象真正拥有的托管强引用,供 Aster 引用追踪和循环回收使用。
|
||||
fn trace(&self, visit: &mut dyn FnMut(ObjectRef)) {
|
||||
// Aster 引用追踪逐条遍历成员拥有边;变量名 mount 沿用最初用途,但列表也可持有其他对象。
|
||||
// Aster 引用追踪逐条遍历成员拥有边;重复成员也逐条 visit,不能按对象身份去重而改变引用计数图。
|
||||
// 变量名 mount 沿用最初用途,但列表也可持有 PaintCommand、场景元素等其他对象。
|
||||
for mount in &self.0 {
|
||||
visit(*mount);
|
||||
}
|
||||
@@ -144,6 +146,7 @@ impl NativeCallable for Edit {
|
||||
members.push(*item);
|
||||
}
|
||||
// added 的持久式结果使用默认 ObjectList 类型,原列表(含其子类字段)保持不变。
|
||||
// 复制的是成员句柄序列;新旧列表会同时拥有相同业务对象,不深拷贝成员,也不继承原列表的子类普通字段。
|
||||
if self.persistent {
|
||||
return Ok(NativeResult::Return(Value::Object(collection(
|
||||
cx,
|
||||
@@ -168,6 +171,8 @@ impl NativeCallable for Edit {
|
||||
}
|
||||
|
||||
/// 将已有对象引用包装为新的 ObjectList,并安装默认名义类型及下标查询方法。
|
||||
/// Mount 查询、布局/绘制协议记录、graphics.flow 和 Window.pages 等宿主入口调用;这里只检查列表预算,不验证成员业务种类。
|
||||
/// 消费 Arrangement、DisplayList 或场景集合的入口仍需逐项验证相应 payload/名义类型,不能把 ObjectList 当作元素类型保证。
|
||||
pub fn collection(
|
||||
cx: &mut NativeContext<'_>,
|
||||
mounts: Vec<ObjectRef>,
|
||||
@@ -239,6 +244,7 @@ fn build(
|
||||
}
|
||||
|
||||
/// 借用受检查列表的条目;返回值的有效期仍依赖原托管对象存活。
|
||||
/// source_layout/source_paint/graphics 等原生消费者直接调用,不执行源 at 方法或自定义迭代器;需要修改 VM 时先复制句柄结束借用。
|
||||
pub fn items(store: &endor_core::ObjectStore, list: ObjectRef) -> Result<&[ObjectRef], VmError> {
|
||||
Ok(&store.payload::<ObjectList>(list, "ObjectList")?.0)
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user