阿Y博客

本文带你拆解一个生产环境真实在用的轻量级 ADO.NET ORM 框架。它基于特性驱动实体映射，用 Expression Tree 动态编译 Getter/Setter 委托实现零反射开销，并通过 MetadataCache、SchemaCache、CachingMechanism 三级 ConcurrentDictionary 缓存体系保证性能与线程安全。整个框架零外部依赖，代码量不过千行，却完整实现了 Dapper 的核心能力。

生产项目里接入 RabbitMQ 最烦的是每次发消息前都要写一长串 ExchangeDeclare + QueueDeclare + QueueBind 模板代码。本文从 SwitchData 项目源码中拆解一套声明式封装：用 [RabbitMqQueue] 特性标注消息模型类，用 ConcurrentDictionary 做拓扑缓存和反射缓存，用 SemaphoreSlim 做异步锁延迟创建单例连接，用泛型 SendMessageAsync<T> 让调用方只需要传消息对象本身。附带死信队列自动声明、延迟消息插件支持、手动 ACK/NACK 异常兜底、AutomaticRecoveryEnabled 自动重连等生产级能力，整个客户端不到 400 行却把 RabbitMQ.Client 裸 API 包装成了'一行代码发消息'的干净调用。

本文从真实项目代码出发，带你从零实现一个完整的 C# Telnet 协议客户端。我们会拆开 Telnet 协议的每一个字节——IAC 转义、DO/DONT/WILL/WONT 协商、SB/SE 子协商、终端类型（VT100）握手、窗口大小声明——然后用一个有限状态机把它们串起来，最后用 SemaphoreSlim 保证异步读写的线程安全。完整代码来自生产环境，已稳定跑了一年多。

手写 ORM 或数据库抽象层时，缓存是性能关键。本文从 SwitchData 项目提取一套生产级缓存方案：用 record struct 做零 GC 组合键，ConcurrentDictionary 做线程安全容器，CacheKey 包含 ConnectionString 防止串库，命中缓存时必须 Clone 可变对象（DbParameter、DataTable、List）避免被业务代码污染。四句话总结一套可直接抄过去的 ORM 缓存基础设施。

Web API 有基类+多子类的继承体系（如 ReviewBase 派生 Excel/TXT/Database 三种导入请求），Swagger 默认只展示基类导致前端看不到子类字段。本文介绍用 System.Text.Json 的 JsonPolymorphic + JsonDerivedType 特性让运行时支持多态，再配合 Swashbuckle 的 UseOneOfForPolymorphism 自动生成 OpenAPI oneOf Schema，以及手动 DocumentFilter 和自定义 OperationFilter 两种备用方案，让 Swagger UI 直接展示子类下拉选择。