Cordis的Accessor机制：如何拦截属性读写，掌控依赖注入的终极指南

Cordis的Accessor机制：如何拦截属性读写，掌控依赖注入的终极指南

【免费下载链接】cordisMeta-Framework of Spatiotemporal Composability项目地址: https://gitcode.com/GitHub_Trending/co/cordis

Cordis 是一个强调"时空可组合性"的元框架，而Accessor机制正是它最核心的魔法之一：通过 Proxy 在属性读写的瞬间进行拦截，让依赖注入、服务获取与混入都变得自然流畅。本文面向新手，用最直白的方式拆解 Cordis 如何拦截属性读写，并手把手教你用ctx.accessor()注册自己的访问器。

为什么 Cordis 要拦截属性读写？

在传统框架中，拿一个服务通常要写ctx.get('foo')，注册要写ctx.provide('foo')，调用全靠字符串，写多了既繁琐又容易拼错。

Cordis 的思路完全不同：它把Context对象本身变成一个"智能代理"。当你写下ctx.foo时，框架会在背后自动完成服务查找；当你写下ctx.foo = value时，框架会自动完成服务注册。这种把属性读写变成框架钩子的设计，就是Accessor机制。

它的好处显而易见：

• 🚀书写更自然：ctx.foo代替ctx.get('foo')，代码即文档
• 🛡️类型更安全：TypeScript 能直接推断属性类型，告别魔法字符串
• 🧩组合更灵活：属性读写可以挂载自定义逻辑，实现响应式更新

Accessor机制的核心原理：Proxy 三大拦截器

Cordis 的拦截逻辑全部集中在 reflect.ts 的ReflectService.handler中。这个 handler 定义了三个关键陷阱（trap），分别拦截属性的读取、写入和存在性检查。

读取拦截（get）：一次读属性，三层找值

当你访问ctx.foo时，get 拦截器按以下顺序寻找值：

1. 特殊属性直接放行：symbol、prototype、then、数字、下划线开头的属性直接走原生逻辑（见 isSpecialProperty），避免破坏框架内部机制
2. 已有属性直接返回：如果 Context 上真实存在该属性，直接返回并做可追踪包装
3. 访问器优先：如果该属性注册了 accessor，调用其自定义的get函数
4. 服务查找：沿着 fiber 链逐层向上查找服务实现，找不到就抛出cannot get property "foo" without inject错误

const def = target.reflect.props[prop] if (def?.type === 'accessor') { return def.get.call(ctx, ctx[symbols.receiver], error) }

写入拦截（set）：没有 provide 就别想赋值

写入时同样严格：如果属性既不是访问器也不是服务，直接抛出cannot set property "foo" without provide。这意味着所有属性写入都必须经过框架登记，杜绝了随手乱挂属性的坏习惯。

存在性拦截（has）：in运算符也能感知

'foo' in ctx会检查访问器和服务的注册表，让in判断与运行时状态保持同步。

如何用 ctx.accessor() 注册自定义访问器

ctx.accessor()是 ReflectService 提供的注册入口。它接收属性名和一个包含get/set的对象，让你完全掌控该属性的读写行为：

ctx.accessor('counter', { get(receiver, error) { return this.secret + 1 // 读取时自动 +1 }, set(value, receiver, error) { this.secret = value - 1 // 写入时自动 -1 return true // 返回 true 表示写入成功 }, })

注册之后，任何对ctx.counter的读写都会经过你的自定义逻辑，实现"拦截属性读写"的完美闭环。测试代码见 reflect.spec.ts。

快速上手：Accessor 与 Service 的三步组合拳

理解 Accessor机制最快的方式，是看它如何与 Service、mixin 协同工作：

1. 提供服务：ctx.provide('foo')或继承Service类，把服务挂到 Context 上
2. 注入依赖：在插件中直接ctx.foo读取，或root.inject(['foo'], cb)等待服务就绪
3. 混入能力：ctx.mixin()把某个对象的方法/属性挂到 Context 上，访问时自动绑定this

class Foo extends Service { constructor(ctx: Context) { super(ctx, 'foo') // 自动 provide('foo') } hello() { return 'world' } } const root = new Context() await root.plugin(Foo) console.log(root.foo.hello()) // 'world'

进阶玩法：关联访问器（Associate）实现动态注入

Cordis 还支持"关联类型"注入：给对象打上Service.tracker标记，它的属性读写就会自动映射到 Context 上（见 associate.spec.ts）。例如session.bar会被重定向到ctx['session.bar']，实现跨服务动态组合，这正是"时空可组合性"的体现。

常见错误与排查技巧

• ❌cannot get property "bar" without inject：属性未注册，检查是否忘记provide或accessor
• ❌cannot set property "foo" without provide：写入未登记属性，先用provide声明
• ❌service "foo" has been registered at <root>：服务重复注册，同一上下文只能注册一次

调试时还可以利用root.reflect服务直接调用get/set，绕过 Proxy 单独验证注册状态。

总结：Accessor机制值得掌握的 3 个理由

1. 心智负担低：属性即服务，读写即注入，新手 5 分钟就能上手
2. 拦截能力强大：get/set/has 三层拦截 + 关联注入，覆盖绝大多数组合需求
3. 生态扩展性好：基于ctx.accessor()可以轻松开发自定义属性语义，构建自己的 DSL

如果你想亲自运行文中示例，可以克隆仓库到本地体验完整效果。掌握了 Cordis 的 Accessor机制，你就拿到了理解这个"时空可组合性"框架的第一把钥匙，快去试试拦截你的第一个属性吧！🎯

【免费下载链接】cordisMeta-Framework of Spatiotemporal Composability项目地址: https://gitcode.com/GitHub_Trending/co/cordis