244 lines
8.4 KiB
Rust
244 lines
8.4 KiB
Rust
//! 无 UI 的任务宿主回归:同键替换、资格变化和退出门闩必须由真实 VM/API 路径体现。
|
||
//! 测试不启动 GUI、文件读取或网络请求,宿主资格由普通对象属性提供。
|
||
use endor_core::{
|
||
CallArity, ContextNativeFunction, NativeCallable, NativeContext, NativeResult, ObjectRef,
|
||
ObjectStore, TypeConstructor, Value, Vm, VmError,
|
||
};
|
||
use endorphin_nexus_runtime::{
|
||
VmSession,
|
||
tasks::{self, Scheduler, TaskHost},
|
||
};
|
||
use std::sync::{
|
||
Arc,
|
||
atomic::{AtomicUsize, Ordering},
|
||
};
|
||
|
||
#[derive(Debug)]
|
||
/// 普通对象宿主只用属性保存作用域和资格,不知道 Block、Mount、Window 或 desktop。
|
||
struct PlainHost;
|
||
impl TaskHost for PlainHost {
|
||
/// 未提交过任务时返回 None;已有作用域必须是字典。
|
||
fn scope(&self, store: &ObjectStore, owner: ObjectRef) -> Result<Option<ObjectRef>, VmError> {
|
||
match store.get_attr(owner, "taskScope") {
|
||
Ok(Value::Object(scope)) => {
|
||
store.dict_items(scope)?;
|
||
Ok(Some(scope))
|
||
}
|
||
Err(VmError::AttributeNotFound(_)) => Ok(None),
|
||
Ok(_) => Err(VmError::InvalidArgument("invalid test scope")),
|
||
Err(error) => Err(error),
|
||
}
|
||
}
|
||
/// 由写屏障建立真实拥有边,测试结束时可交给 VM 正常回收。
|
||
fn install_scope(
|
||
&self,
|
||
cx: &mut NativeContext<'_>,
|
||
owner: ObjectRef,
|
||
scope: ObjectRef,
|
||
) -> Result<(), VmError> {
|
||
cx.set_attr(owner, "taskScope", Value::Object(scope))
|
||
}
|
||
/// 外部修改普通布尔字段即可撤销交付资格,不借用 Tessera 的任何模型。
|
||
fn eligible(
|
||
&self,
|
||
store: &ObjectStore,
|
||
owner: ObjectRef,
|
||
_context: ObjectRef,
|
||
) -> Result<bool, VmError> {
|
||
Ok(store.get_attr(owner, "eligible")? == Value::Bool(true))
|
||
}
|
||
/// 所有任务共享宿主注册的精确类型身份。
|
||
fn task_type(&self, store: &ObjectStore, context: ObjectRef) -> Result<ObjectRef, VmError> {
|
||
object(store.get_attr(context, "Task")?)
|
||
}
|
||
}
|
||
|
||
#[derive(Debug)]
|
||
/// VM 外的计数器观察真正回调次数,零参/Unit 契约与 after 要求一致。
|
||
struct Count(Arc<AtomicUsize>);
|
||
impl NativeCallable for Count {
|
||
/// 明确接受零个参数,不能依赖旧原生函数缺少元数据的兼容路径。
|
||
fn arity(&self) -> Option<CallArity> {
|
||
Some(CallArity::exact(0))
|
||
}
|
||
/// 每次真正执行递增一次,取消和状态查询不得触发它。
|
||
fn invoke(
|
||
&self,
|
||
_cx: &mut NativeContext<'_>,
|
||
_args: &[Value],
|
||
) -> Result<NativeResult, VmError> {
|
||
self.0.fetch_add(1, Ordering::SeqCst);
|
||
Ok(NativeResult::Return(Value::Nil))
|
||
}
|
||
}
|
||
|
||
/// 解码借用或拥有的对象值;此函数不改变根计数,调用方按来源管理拥有权。
|
||
fn object(value: Value) -> Result<ObjectRef, VmError> {
|
||
match value {
|
||
Value::Object(value) => Ok(value),
|
||
_ => Err(VmError::InvalidArgument("expected test object")),
|
||
}
|
||
}
|
||
|
||
/// 所有创建根交给 VmSession;api/context/owner 是会话根的借用身份。
|
||
fn setup() -> (
|
||
VmSession,
|
||
Scheduler,
|
||
ObjectRef,
|
||
ObjectRef,
|
||
ObjectRef,
|
||
Arc<AtomicUsize>,
|
||
) {
|
||
let mut runtime = VmSession::new().unwrap();
|
||
let types = runtime.vm_mut().bootstrap_types().unwrap();
|
||
runtime.keep_root(types.object);
|
||
runtime.keep_root(types.type_type);
|
||
let definition = runtime
|
||
.vm_mut()
|
||
.new_type("Task", types.object, TypeConstructor::Abstract)
|
||
.unwrap();
|
||
runtime.keep_root(definition);
|
||
let context = runtime.vm_mut().new_object().unwrap();
|
||
runtime.keep_root(context);
|
||
runtime
|
||
.vm_mut()
|
||
.set_attr(context, "Task", Value::Object(definition))
|
||
.unwrap();
|
||
let api = runtime.vm_mut().new_object().unwrap();
|
||
runtime.keep_root(api);
|
||
let owner = runtime.vm_mut().new_object().unwrap();
|
||
runtime.keep_root(owner);
|
||
runtime
|
||
.vm_mut()
|
||
.set_attr(owner, "eligible", Value::Bool(true))
|
||
.unwrap();
|
||
let calls = Arc::new(AtomicUsize::new(0));
|
||
let callback = runtime
|
||
.vm_mut()
|
||
.allocate(ContextNativeFunction::new(
|
||
"count",
|
||
Count(calls.clone()),
|
||
vec![],
|
||
))
|
||
.unwrap();
|
||
runtime.keep_root(callback);
|
||
let scheduler = runtime
|
||
.with_host(|vm, roots| tasks::install(vm, roots, api, context, Arc::new(PlainHost)))
|
||
.unwrap();
|
||
(runtime, scheduler, api, owner, callback, calls)
|
||
}
|
||
|
||
/// 通过安装的公开 API 创建零延时任务;返回根交给会话,避免旧 token 因替换而提前回收。
|
||
fn after(
|
||
runtime: &mut VmSession,
|
||
api: ObjectRef,
|
||
owner: ObjectRef,
|
||
callback: ObjectRef,
|
||
key: &str,
|
||
) -> ObjectRef {
|
||
let function = object(runtime.vm().get_attr(api, "after").unwrap()).unwrap();
|
||
let task = object(
|
||
runtime
|
||
.vm_mut()
|
||
.call(
|
||
function,
|
||
&[
|
||
Value::Object(owner),
|
||
Value::Text(key.into()),
|
||
Value::Number(0_i64.into()),
|
||
Value::Object(callback),
|
||
],
|
||
)
|
||
.unwrap(),
|
||
)
|
||
.unwrap();
|
||
runtime.keep_root(task);
|
||
task
|
||
}
|
||
|
||
/// 经真实类型方法绑定读取状态,不直接检查 Nexus 的私有 Task 载荷。
|
||
fn query(vm: &mut Vm, task: ObjectRef, name: &str) -> Value {
|
||
let bound = object(vm.bind_attr(task, name).unwrap()).unwrap();
|
||
let result = vm.call(bound, &[]);
|
||
vm.release(bound).unwrap();
|
||
result.unwrap()
|
||
}
|
||
|
||
#[test]
|
||
/// 替换旧 token 后只有新任务执行一次;终态 token 可继续查询,拥有字典已经清空。
|
||
fn same_key_replacement_only_delivers_the_new_identity() {
|
||
let (mut runtime, scheduler, api, owner, callback, calls) = setup();
|
||
let old = after(&mut runtime, api, owner, callback, "same");
|
||
let new = after(&mut runtime, api, owner, callback, "same");
|
||
assert_eq!(
|
||
query(runtime.vm_mut(), old, "status"),
|
||
Value::Text("cancelled".into())
|
||
);
|
||
// 取消被替换的旧 token 不得删除新任务的 owner/key 身份。
|
||
assert_eq!(query(runtime.vm_mut(), old, "cancel"), Value::Bool(false));
|
||
assert_eq!(query(runtime.vm_mut(), new, "active"), Value::Bool(true));
|
||
assert_eq!(scheduler.poll(runtime.vm_mut(), 64).unwrap(), 1);
|
||
assert_eq!(calls.load(Ordering::SeqCst), 1);
|
||
assert_eq!(
|
||
query(runtime.vm_mut(), new, "status"),
|
||
Value::Text("completed".into())
|
||
);
|
||
assert_eq!(query(runtime.vm_mut(), new, "result"), Value::Nil);
|
||
assert_eq!(scheduler.poll(runtime.vm_mut(), 64).unwrap(), 0);
|
||
let scope = PlainHost
|
||
.scope(runtime.vm().object_store(), owner)
|
||
.unwrap()
|
||
.unwrap();
|
||
assert!(
|
||
runtime
|
||
.vm()
|
||
.object_store()
|
||
.dict_items(scope)
|
||
.unwrap()
|
||
.is_empty()
|
||
);
|
||
scheduler.quiesce(runtime.vm_mut()).unwrap();
|
||
runtime.close().unwrap();
|
||
assert_eq!(runtime.vm().object_count(), 0);
|
||
}
|
||
|
||
#[test]
|
||
/// 交付前撤销资格阻止回调,轮询执行取消;退出门闩在重新取得资格后仍拒绝提交。
|
||
fn host_lifecycle_and_shutdown_prevent_late_delivery() {
|
||
let (mut runtime, scheduler, api, owner, callback, calls) = setup();
|
||
let task = after(&mut runtime, api, owner, callback, "late");
|
||
runtime
|
||
.vm_mut()
|
||
.set_attr(owner, "eligible", Value::Bool(false))
|
||
.unwrap();
|
||
assert_eq!(query(runtime.vm_mut(), task, "active"), Value::Bool(false));
|
||
assert_eq!(scheduler.poll(runtime.vm_mut(), 64).unwrap(), 1);
|
||
assert_eq!(
|
||
query(runtime.vm_mut(), task, "status"),
|
||
Value::Text("cancelled".into())
|
||
);
|
||
assert_eq!(calls.load(Ordering::SeqCst), 0);
|
||
scheduler.quiesce(runtime.vm_mut()).unwrap();
|
||
runtime
|
||
.vm_mut()
|
||
.set_attr(owner, "eligible", Value::Bool(true))
|
||
.unwrap();
|
||
let function = object(runtime.vm().get_attr(api, "after").unwrap()).unwrap();
|
||
assert!(
|
||
runtime
|
||
.vm_mut()
|
||
.call(
|
||
function,
|
||
&[
|
||
Value::Object(owner),
|
||
Value::Text("forbidden".into()),
|
||
Value::Number(0_i64.into()),
|
||
Value::Object(callback),
|
||
]
|
||
)
|
||
.is_err()
|
||
);
|
||
runtime.close().unwrap();
|
||
assert_eq!(runtime.vm().object_count(), 0);
|
||
}
|