标签: #设计模式

本文从 SwitchData 项目源码出发，手把手拆解一个生产可用的 C# Telnet 客户端。核心亮点：Telnet 协议状态机解析器（逐字节处理 IAC/DO/WILL/SB/SE 协商）、SemaphoreSlim 双锁全双工设计、复用 Encoder 解决 UTF-8 多字节截断、IAsyncDisposable 异步资源管理。附带实战踩坑：登录残留清除、VT100 控制序列过滤、ORDP 网关并发限流。

在 C# 里调用 Python、Shell、Java 脚本看似简单，落地却总踩同一个坑：大输出死锁、脚本卡死没有超时、子进程变孤儿。本文从真实的 ScriptHelper 实现出发，讲清 BeginOutputReadLine 防死锁的原理、CancellationTokenSource 控制超时的写法、Kill(true) 终止进程树的必要性，以及中文输出乱码与退出码读取时机的处理细节。

多可选参数查询接口还在用字符串拼接 SQL？本文拆解一套组合模式动态查询条件构建器：FilterCondition 叶子节点 + FilterGroup 逻辑组把 WHERE 子句建模成对象树，17 种运算符全部注册到一张声明式注册表，递归遍历时参数编号贯穿全树递增，值走 DbParameter、列名走元数据白名单校验，从根上堵死注入路径，并逐一讲清 LIKE 通配符转义、NULL 三值逻辑、空条件跳过等容易踩的坑。

枚举转中文描述是业务系统刚需，但每次 ToString 加反射读 DescriptionAttribute 会拖慢高频接口。本文基于 SwitchData 项目的 EnumExtensions 实现，拆解泛型静态类 EnumCache<T> 的独立静态字段缓存原理、.NET 8 FrozenDictionary 的读优化特性，以及 (MyEnum)999 未定义枚举值的防御式处理，让枚举反射只跑一次。

System.Text.Json 默认行为无法满足统一日期格式、字符串自动 Trim、DataTable 序列化等业务需求。本文基于真实项目实现，完整讲解 JsonConverter 基础写法、可空类型转换陷阱、DataTable 与 Newtonsoft 桥接、JsonConverterFactory 工厂模式，并总结六大常见踩坑点。

IPAddress 没有实现 IComparable，直接字符串排序会掉进字典序陷阱：10.0.0.10 反而排在 10.0.0.9 前面。本文以局数据系统中的 IPInterval / PortInterval 为例，完整实现字节序比较、CIDR 掩码求广播地址，以及 IComparable / IComparer / IEquatable 三个泛型接口的职责分工与 GetHashCode 一致性，让区间对象无缝接入 Sort、Distinct 与 O(n) 重合检测。

在电信行业网络运维中，Telnet 协议直连网元是一个非常实用但容易被忽视的技术方案。本文从 SwitchData 项目出发，完整拆解一套生产级 ORDP 直连架构：SemaphoreSlim 并发限流保护网关单点、VT100+NUL+命令回显三重协议清洗、IAsyncDisposable 异步资源管理、Try-Catch 整体回退第三方平台。附带 TelnetClient.ClearPendingText、ExpectedCommandPromptCount 多阶段提示符等多个实战踩坑经验。

DataTable 用得多了就会发现，所有项目都在重复这些操作：去空行、Trim 字符串、列名/索引互查、Schema 克隆、DataRow 转 Dictionary、ToSortedTable、FirtRowToColumnName。本文基于 SwitchData 项目中真实在用的 DataTableExtensions（1700+ 行），把高频数据后处理操作整理成统一的扩展方法工具集，涵盖倒序遍历、Span 零分配清洗、CloneSchema/CopyData 投影、SplitColumn/MergeColumns/FillDownColumns 复杂业务转换等完整实现。

EF Core 是怎么把 LINQ 翻译成 SQL 的？答案是表达式树。本文从 SwitchData 项目中 462 行的 ExpressionParser 真实代码出发，展示手写 ORM 如何把 Where/OrderBy Lambda 翻译成结构化 QueryCondition 列表：排序解析沿方法调用链向内剥离，条件解析基于 ExpressionVisitor 深度优先遍历并还原括号语义，还包含闭包变量提取、string.Contains 转 LIKE、PredicateBuilder 动态组合等核心难点的完整实现。

Telnet 协议解析器是状态机设计模式的经典应用场景。本文从协议原理出发，用逐字节扫描 + 8 状态 FSM 的方式，完整实现 Telnet 四向握手协商（DO/DONT/WILL/WONT）、TerminalType/WindowSize 子协商、业务数据 IAC 转义还原，并与上层 Socket TelnetClient 配合实现零依赖、高性能的生产级 Telnet 协议栈。