c# .netCreateLinkedTokenSource链接令牌,取消信号异步执行

cs 复制代码
// 心跳管理类
    public class WebSocketHeartbeatManager
    {
websocketserver.cs
_cancellationTokenSource = new CancellationTokenSource();
        var token = _cancellationTokenSource.Token;
        _heartbeatManager.StartHeartbeatService(token);
        _acceptTask = AcceptClientsAsync(token); //log5:websocket服务端,检测客户端连接

websocketserver的主类中创建的CancellationTokenSource
public void StartHeartbeatService(CancellationToken externalToken)
{
    _heartbeatCts = CancellationTokenSource.CreateLinkedTokenSource(externalToken);
CreateLinkedTokenSource是什么作用

CancellationTokenSource.CreateLinkedTokenSource 方法用于创建一个与外部令牌关联的新令牌源,它在您的 WebSocket 服务中主要解决以下问题:

一、CreateLinkedTokenSource 的核心作用

  1. 令牌的隔离与组合

    • 将外部传入的 externalToken 与内部令牌源 _heartbeatCts 关联,形成 "链接令牌"
    • externalToken_heartbeatCts 任一被取消时,所有关联的操作都会收到取消信号
  2. 细粒度取消控制

    • 允许在不影响外部令牌的情况下,单独取消心跳服务(.NET 6+ 推荐方式):

      复制代码
      // 仅取消心跳服务,不影响AcceptClientsAsync
      _heartbeatCts.Cancel(); 
  3. 避免令牌源泄漏

    • 通过链接令牌,确保心跳服务能响应外部取消请求,同时保持自身的取消控制能力

二、关键实现原理csharp

复制代码
public void StartHeartbeatService(CancellationToken externalToken)
{
    // 创建与externalToken链接的新令牌源
    _heartbeatCts = CancellationTokenSource.CreateLinkedTokenSource(externalToken);
    
    // 使用_linkedToken控制心跳任务
    await CheckHeartbeatsAsync(_heartbeatCts.Token);
}
catch (OperationCanceledException)
{
    // 无论externalToken还是_heartbeatCts被取消,都会进入此分支
}

三、典型应用场景

  1. 主服务与子服务的取消关联

    • 主服务通过 externalToken 控制整体取消
    • 子服务(心跳检测)可独立取消,不影响其他服务
  2. 多组件协作取消

    • _heartbeatCts 被取消时,所有使用 _heartbeatCts.Token 的操作都会收到取消信号
    • 当外部 externalToken 被取消时,_heartbeatCts 也会自动取消

四、与直接使用 externalToken 的区别

场景 直接使用 externalToken 使用 CreateLinkedTokenSource
取消控制权 心跳服务无法主动取消 可独立取消心跳服务
外部影响 心跳服务取消会影响外部令牌 心跳服务取消不影响外部令牌
异常处理 难以区分取消来源 可通过令牌源区分取消来源

五、完整取消流程示例

  1. 主服务取消

    复制代码
    _cancellationTokenSource.Cancel(); // 外部令牌取消
    // 自动触发_heartbeatCts取消,心跳服务终止
  2. 心跳服务独立取消

    复制代码
    _heartbeatManager.StopHeartbeatService(); // 内部取消
    // _acceptTask仍可继续运行,不受影响
  3. 资源释放顺序

    主服务取消

    externalToken取消

    _heartbeatCts自动取消

    心跳任务终止

    释放心跳相关资源

六、最佳实践建议

  1. 明确取消范围

    • 使用 CreateLinkedTokenSource 时,始终确保:

      复制代码
      _heartbeatCts = CancellationTokenSource.CreateLinkedTokenSource(externalToken);

      避免直接使用 externalToken 注册取消回调,防止意外影响主流程

  2. 异常处理优化

    复制代码
    try
    {
        await CheckHeartbeatsAsync(_heartbeatCts.Token);
    }
    catch (OperationCanceledException)
    {
        if (_heartbeatCts.IsCancellationRequested)
            Console.WriteLine("心跳服务主动取消");
        else
            Console.WriteLine("主服务取消导致心跳终止");
    }

    资源清理

复制代码
   public void Dispose()
   {
       _heartbeatCts?.Cancel();
       _heartbeatCts?.Dispose();
   }

通过 CreateLinkedTokenSource,您的心跳服务能够更灵活地响应取消请求,同时保持与主服务的取消关联,这是现代异步编程中处理复杂取消逻辑的最佳实践。

相关推荐
武子康1 小时前
Java-82 深入浅出 MySQL 内部架构:服务层、存储引擎与文件系统全覆盖
java·开发语言·数据库·学习·mysql·spring·微服务
惜.己2 小时前
pytest中使用skip跳过某个函数
开发语言·python·测试工具·pytest
姜暮儿2 小时前
C++ 性能优化
开发语言·c++
啊呦.超能力3 小时前
QT开发---多线程编程
开发语言·qt
铭哥的编程日记3 小时前
《从C风格到C++风格:内存管理的进化之路》
开发语言·c++
秃了也弱了。3 小时前
reflections:Java非常好用的反射工具包
java·开发语言
慢慢沉4 小时前
C#(基本语法)
c#
Joker—H4 小时前
【Java】Reflection反射(代理模式)
java·开发语言·经验分享·代理模式·idea
阿里巴巴淘系技术团队官网博客5 小时前
面向互联网2C业务的分布式类Manus Java框架
java·开发语言·分布式
笨蛋不要掉眼泪6 小时前
Java测试题(上)
java·开发语言