知识卡片

结构图卡 · 471.b.2.a.4.a.1.d.1.b.13.f.3.d.2.a

取消节点记录后代并级联传播

理解等级:中级

书中cancelCtx保存父Context、取消错误、Done通道及受锁保护的children集合。取消时先记录状态并关闭通知,再遍历可取消后代传播;重复取消由已记录的错误挡住。并非所有上下文节点都直接互持引用,value节点沿父链查找,取消注册会寻找合适的祖先取消节点。私有字段是实现讲解,不作公开使用接口。

其中Done的完整Go签名为Done() <-chan struct{},图中为避免把空结构体括号误读成类边界,只列方法名。

结构图:

classDiagram
 class Context {
 <<interface>>
 Done()
 Err() error
 Value(key any) any
 Deadline() (time.Time, bool)
 }
 class cancelCtx {
 error err
 atomic.Value done
 sync.Mutex mu
 Done()
 }
 Context <|.. cancelCtx : 指针隐式实现
 cancelCtx --> Context : 保存父上下文
 cancelCtx --> cancelCtx : 注册可取消后代

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 上下文 · 查看原书依据

      children维护了当前上下文节点对子节点的引用。Go语言并没有专门去重的数据结构,此处的map用于去重;canceler则是另外一个接口,保证只有cancelCtx和timerCtx等实现类的实例对象可以加入map中(如此便可以拒绝emptyCtx、valueCtx实例)。

    参考来源

    - 位置:《深入浅出Go语言核心编程 (张朝明李奕锋甘海彬)》第10章《上下文》(来源项目:a19c7933-4eda-4176-aebd-30fe7e1ad292;源文件:extracted/深入浅出Go语言核心编程 (张朝明李奕锋甘海彬)/_epub-src/EPUB/xhtml/isbn9787302649106_10;代码图像及OCR记录见_evidence/images.json、ocr.jsonl、ocr-zh.jsonl,关键歧义回看原图) - 结论依据:原文所述机制、条件及相邻代码示例支撑正文;对示例与通用规则的区分已在正文标明,不把图片OCR当作无误源码。 - 原始内容:children维护了当前上下文节点对子节点的引用。Go语言并没有专门去重的数据结构,此处的map用于去重;canceler则是另外一个接口,保证只有cancelCtx和timerCtx等实现类的实例对象可以加入map中(如此便可以拒绝emptyCtx、valueCtx实例)。