[
{
"path": ".editorconfig",
"content": "# EditorConfig is awesome:http://EditorConfig.org\n# https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference\n\n# top-most EditorConfig file\nroot = true\n\n# Don't use tabs for indentation.\n[*]\nindent_style = space\n# (Please don't specify an indent_size here; that has too many unintended consequences.)\n\n# Code files\n[*.{cs,csx,vb,vbx}]\nindent_size = 4\ninsert_final_newline = false\ncharset = utf-8-bom\nend_of_line = crlf\n\n# Xml project files\n[*.{csproj,vbproj,vcxproj,vcxproj.filters,proj,projitems,shproj}]\nindent_size = 2\n\n# Xml config files\n[*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct}]\nindent_size = 2\n\n# JSON files\n[*.json]\nindent_size = 2\n\n# Dotnet code style settings:\n[*.{cs,vb}]\n# Sort using and Import directives with System.* appearing first\ndotnet_sort_system_directives_first = true\n\ncsharp_indent_case_contents = true\ncsharp_indent_switch_labels = true\ncsharp_indent_labels = flush_left\n\n#csharp_space_after_cast = true\n#csharp_space_after_keywords_in_control_flow_statements = true\n#csharp_space_between_method_declaration_parameter_list_parentheses = true\n#csharp_space_between_method_call_parameter_list_parentheses = true\n#csharp_space_between_parentheses = control_flow_statements, type_casts\n\n# 单行放置代码\ncsharp_preserve_single_line_statements = true\ncsharp_preserve_single_line_blocks = true\n\n# Avoid \"this.\" and \"Me.\" if not necessary\ndotnet_style_qualification_for_field = false:warning\ndotnet_style_qualification_for_property = false:warning\ndotnet_style_qualification_for_method = false:warning\ndotnet_style_qualification_for_event = false:warning\n\n# Use language keywords instead of framework type names for type references\ndotnet_style_predefined_type_for_locals_parameters_members = false:suggestion\ndotnet_style_predefined_type_for_member_access = false:suggestion\n#dotnet_style_require_accessibility_modifiers = for_non_interface_members:none/always:suggestion\n\n# Suggest more modern language features when available\ndotnet_style_object_initializer = true:suggestion\ndotnet_style_collection_initializer = true:suggestion\ndotnet_style_coalesce_expression = true:suggestion\ndotnet_style_null_propagation = true:suggestion\ndotnet_style_explicit_tuple_names = true:suggestion\ndotnet_style_prefer_inferred_tuple_names = true:suggestion\ndotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion\n\n# CSharp code style settings:\n[*.cs]\n# Prefer \"var\" everywhere\ncsharp_style_var_for_built_in_types = true:warning\ncsharp_style_var_when_type_is_apparent = true:warning\ncsharp_style_var_elsewhere = true:warning\n\n# Prefer method-like constructs to have a block body\ncsharp_style_expression_bodied_methods = when_on_single_line:suggestion\ncsharp_style_expression_bodied_constructors = when_on_single_line:suggestion\ncsharp_style_expression_bodied_operators = when_on_single_line:suggestion\n\n# Prefer property-like constructs to have an expression-body\ncsharp_style_expression_bodied_properties = true:suggestion\ncsharp_style_expression_bodied_indexers = true:suggestion\n#csharp_style_expression_bodied_accessors = true:suggestion\n\n# Suggest more modern language features when available\ncsharp_style_pattern_matching_over_is_with_cast_check = true:suggestion\ncsharp_style_pattern_matching_over_as_with_null_check = true:suggestion\ncsharp_style_inlined_variable_declaration = true:suggestion\n\ncsharp_prefer_simple_default_expression = true:suggestion\ncsharp_style_deconstructed_variable_declaration = true:suggestion\ncsharp_style_pattern_local_over_anonymous_function = true:suggestion\n\ncsharp_style_throw_expression = true:suggestion\ncsharp_style_conditional_delegate_call = true:suggestion\n\n# 单行不需要大括号\ncsharp_prefer_braces = false:suggestion\n\n# Newline settings\ncsharp_new_line_before_open_brace = all\ncsharp_new_line_before_else = true\ncsharp_new_line_before_catch = true\ncsharp_new_line_before_finally = true\ncsharp_new_line_before_members_in_object_initializers = true\ncsharp_new_line_before_members_in_anonymous_types = true\ncsharp_new_line_between_query_expression_clauses = true\n\n[*.md]\ntrim_trailing_whitespace = false"
},
{
"path": ".gitattributes",
"content": "###############################################################################\n# Set default behavior to automatically normalize line endings.\n###############################################################################\n* text=auto\n\n###############################################################################\n# Set default behavior for command prompt diff.\n#\n# This is need for earlier builds of msysgit that does not have it on by\n# default for csharp files.\n# Note: This is only used by command line\n###############################################################################\n#*.cs diff=csharp\n\n###############################################################################\n# Set the merge driver for project and solution files\n#\n# Merging from the command prompt will add diff markers to the files if there\n# are conflicts (Merging from VS is not affected by the settings below, in VS\n# the diff markers are never inserted). Diff markers may cause the following \n# file extensions to fail to load in VS. An alternative would be to treat\n# these files as binary and thus will always conflict and require user\n# intervention with every merge. To do so, just uncomment the entries below\n###############################################################################\n#*.sln merge=binary\n#*.csproj merge=binary\n#*.vbproj merge=binary\n#*.vcxproj merge=binary\n#*.vcproj merge=binary\n#*.dbproj merge=binary\n#*.fsproj merge=binary\n#*.lsproj merge=binary\n#*.wixproj merge=binary\n#*.modelproj merge=binary\n#*.sqlproj merge=binary\n#*.wwaproj merge=binary\n\n###############################################################################\n# behavior for image files\n#\n# image files are treated as binary by default.\n###############################################################################\n#*.jpg binary\n#*.png binary\n#*.gif binary\n\n###############################################################################\n# diff behavior for common document formats\n# \n# Convert binary document formats to text before diffing them. This feature\n# is only available from the command line. Turn it on by uncommenting the \n# entries below.\n###############################################################################\n#*.doc diff=astextplain\n#*.DOC diff=astextplain\n#*.docx diff=astextplain\n#*.DOCX diff=astextplain\n#*.dot diff=astextplain\n#*.DOT diff=astextplain\n#*.pdf diff=astextplain\n#*.PDF diff=astextplain\n#*.rtf diff=astextplain\n#*.RTF diff=astextplain\n"
},
{
"path": ".github/copilot-instructions.md",
"content": "# NewLife Copilot 协作指令\n\n适用于 NewLife 系列全部 C#/.NET 仓库，本文件可随仓库/指令目录一起拷贝到其他项目直接复用。存在本文件则必须遵循。**简体中文回复。**\n通用 C# 最佳实践（设计模式、SOLID、健壮性等）AI 已知，此处不赘述，**仅列出组织专属规则与反常规约定**。\n\n---\n\n## 1. 专用指令（前置检查，必须执行）\n\n**开始任何任务前，必须先将用户请求与下表触发信号逐行匹配。命中则立即用 `get_file` 读取 `.github/instructions/{指令文件}`，读取成功后遵循其中全部规则。未命中任何行才跳过。**\n\n| 触发信号（用户请求含以下任意关键词即命中） | 指令文件 |\n|---------|---------|\n| XCode/实体生成/Model.xml/数据库 CRUD/`NewLife.XCode` 引用/`*.xcode.xml`/项目名含 `.Data`/`XCode.*` 命名空间/用户提及修改任意 `.xml` 文件 | `xcode.instructions.md` |\n| Cube/魔方/Web开发/`NewLife.Cube` 引用/`NewLife.Cube.*` 命名空间 | `cube.instructions.md` |\n| 性能测试/基准测试/压力测试/压测/BenchmarkDotNet/Benchmark/benchmark/吞吐量评估/性能分析/性能对比/性能报告/速度对比/速度测试/内存分配/perf/性能优化测试/做性能/跑分/测试报告 | `benchmark.instructions.md` |\n| NetServer/NetSession/网络服务器/网络客户端/Socket服务/TCP服务/UDP服务/`NewLife.Net` 引用/`NewLife.Net.*` 命名空间/ISocketClient/ISocketRemote/CreateRemote/StandardCodec/LengthFieldCodec/管道编解码/网络编程/Echo服务/网络会话/长连接/粘包拆包 | `net.instructions.md` |\n| 新建系统/新建项目/新增模块/需求整理/需求文档/需求分析/架构设计/技术方案/功能清单/功能拆分/任务分解/迭代开发/迭代计划/验收/PRD/用户故事/做一个系统/做一个平台/开发流程/全部搞完/批量开发/自治模式/一次性做完/继续处理/接着做 | `development.instructions.md` |\n| 缓存/ICache/MemoryCache/Redis缓存/ICacheProvider/缓存设计/`NewLife.Caching` 命名空间 | `caching.instructions.md` |\n| 序列化/JSON/Binary/JsonHelper/序列化设计/SpanSerializer/CSV导出/`NewLife.Serialization` 命名空间 | `serialization.instructions.md` |\n| 加密/安全/Hash/MD5/SHA/AES/SM4/RSA/JWT/SecurityHelper/TokenProvider/`NewLife.Security` 命名空间 | `security.instructions.md` |\n| 远程调用/ApiHttpClient/ApiClient/ApiServer/负载均衡/LoadBalancer/RPC/HTTP客户端/`NewLife.Remoting` 命名空间 | `remoting.instructions.md` |\n| 配置/Config/IConfigProvider/HttpConfigProvider/CommandParser/配置中心/`NewLife.Configuration` 命名空间 | `configuration.instructions.md` |\n\n**自动匹配指令**（无需触发，按 `applyTo` 路径自动生效）：`caching`、`serialization`、`security`、`remoting`、`configuration` 这 5 个指令文件同时配置了 `applyTo` 模式，编辑对应目录下的文件时 VS Code 会自动加载。\n\n---\n\n## 2. 核心原则\n\n检索优先、风格一致、兼容友好、**主动优化**。\n发现明显缺陷（资源泄漏、空引用、逻辑错误）时主动修复；优化请求时深入分析，不做表面工作。\n改动较小直接做并说明；改动较大（涉及公共 API 或大范围重构）先列方案询问确认。\n\n---\n\n## 3. 兼容性约束（极重要）\n\n- **语言版本**：当前为 **C# 14**（`latest`），最大化使用最新语法糖（switch 表达式、集合表达式 `[]`、`?.`/`??`/`??=`、模式匹配、目标类型 `new`、record 等）\n- **框架版本**：新增 API 前，先查看当前项目 `.csproj` 的 `` 配置，**只需满足已声明版本的兼容性**，无需对所有历史版本降级。若包含 `net45`/`netstandard2.0` 等低版本，再提供条件编译降级实现。\n- **禁止高版本专属 BCL API**（低版本项目）：❌ `ArgumentNullException.ThrowIfNull()` → ✅ `if (x == null) throw new ArgumentNullException(nameof(x));`\n- **条件编译符号**：`NETFRAMEWORK`、`NETSTANDARD2_0`、`NETCOREAPP`、`NET5_0_OR_GREATER`、`NET6_0_OR_GREATER`、`NET8_0_OR_GREATER`\n\n---\n\n## 4. 编码规范\n\n### 4.1 类型名（关键差异）\n\n**必须**使用 .NET 正式名：`String`/`Int32`/`Boolean`/`Int64`/`Double`/`Object` 等。\n❌ **禁止**使用 C# 别名：`string`/`int`/`bool`/`long`/`double`/`object`\n\n### 4.2 命名\n\n| 成员类型 | 规则 | 示例 |\n|---------|------|------|\n| 类型/公共成员 | PascalCase | `UserService`、`GetName()` |\n| 参数/局部变量 | camelCase | `userName`、`count` |\n| 私有字段 | `_camelCase` | `_cache`、`_instance` |\n| 扩展方法类 | `xxxHelper` 或 `xxxExtensions` | `StringHelper`、`CollectionExtensions` |\n\n### 4.3 代码风格\n\n- **命名空间**：file-scoped namespace\n- **单文件**：每文件一个主要公共类型；较大平台差异使用 `partial`\n- **集合初始化**：优先使用集合表达式 `[]`，如 `List Tags { get; set; } = [];`\n- **Null 条件运算符**：优先使用 `?.`/`??` 简化空值检查；**C# 14 空条件赋值 `??=`**：变量为 null 时才赋值，可显著提升可读性\n\n```csharp\n// ✅ C#14 空条件赋值（??=）：为 null 时才赋值，替代 if (x == null) x = ...\n_cache ??= new MemoryCache();\nlist ??= [];\n\n// ✅ if 内只有单行代码时可不加花括号（单行 if 同行或换行均可）\nif (value == null) return;\nif (key == null) throw new ArgumentNullException(nameof(key));\n\n// ✅ 语句较长时另起一行，仍不加花括号\nif (value == null)\n throw new ArgumentNullException(nameof(value), \"Value cannot be null\");\n\n// ✅ 多分支单语句：不加花括号\nif (count > 0)\n DoSomething();\nelse\n DoOther();\n\n// ✅ for/foreach/while 循环体必须保留花括号（即使单语句）\nforeach (var item in list)\n{\n Process(item);\n}\n\nfor (var i = 0; i < count; i++)\n{\n Process(i);\n}\n\n// ✅ using 优先无花括号声明；仅需生命周期（如锁）时用弃元\nusing var stream = File.OpenRead(\"file.txt\");\nusing var _ = _lock.AcquireLock();\n```\n\n### 4.4 Region 与日志\n\n较长类使用 `#region` 分段，顺序：`属性` → `静态` → `构造` → `方法` → `辅助` → **`日志`**。\n含 `ILog Log` 和 `WriteLog` 时：**必须放类末尾**，用名为\"日志\"的 region 包裹，不放入\"辅助\"。\n关键过程可使用 `Tracer?.NewSpan()` 埋点。\n\n### 4.5 文档注释\n\n- `` **必须同行闭合**：`/// 获取名称`\n- 每个参数**必须有** `` 标签，无论方法可见性\n- 有返回值**必须有** ``；复杂方法可增加 ``\n- `public`/`protected` 成员必须注释；`[Obsolete]` 必须包含迁移建议\n\n### 4.6 异步与性能\n\n- 异步方法后缀 `Async`，库内部默认 `ConfigureAwait(false)`\n- 热点路径避免反射/复杂 Linq，优先手写循环/`ArrayPool`/`Span`\n- 池化资源明确获取/归还，异常分支不遗失归还\n\n### 4.7 错误处理\n\n- 精准异常类型：`ArgumentNullException`/`InvalidOperationException` 等\n- TryXxx 模式：不用异常作常规分支\n- 类型转换：优先使用 `Utility` 扩展方法，完整列表：`ToInt()`/`ToLong()`/`ToDouble()`/`ToDecimal()`/`ToBoolean()`/`ToDateTime()`/`ToDateTimeOffset()`\n- 对外异常不暴露内部实现/路径\n\n---\n\n## 5. NewLife 内置工具\n\n优先使用项目内置工具而非标准库，**禁止重复造轮子**：\n\n- 字符串构建：`Pool.StringBuilder`（替代 `new StringBuilder()`）\n- 时间戳（毫秒级相对时间）：`Runtime.TickCount64`；**代码计时（精确耗时测量）：`Stopwatch`**\n- 类型转换：`Utility` 扩展方法 — `ToInt()`/`ToLong()`/`ToDouble()`/`ToDecimal()`/`ToBoolean()`/`ToDateTime()`/`ToDateTimeOffset()`\n- 二进制读写：`SpanReader` / `SpanWriter`（替代手动字节偏移操作）\n- 追踪埋点：`Tracer?.NewSpan()`\n\n---\n\n## 6. 防御性注释（禁止删除）\n\n代码中带有说明文字的被注释代码属于**防御性注释**，记录历史踩坑经验。**禁止删除，禁止\"恢复\"执行**。可补充更详细说明。\n\n```csharp\n// 曾经尝试过同步等待，但会导致线程池饥饿和死锁\n// var result = task.Result;\n\n// 不要使用 SendAsync 的无超时重载，否则会造成连接泄漏\n// await client.SendAsync(data);\n```\n\n---\n\n## 7. 工作流\n\n触发检查（第 1 节触发信号表匹配，命中则读取专用指令） → 检索（**优先复用**现有实现） → 评估（公共 API/兼容性/性能） → 方案 → 实施 → 验证 → **AskQuestions 多选确认** → [需调整则循环] → 说明\n\n- **触发检查**：开始工作前必须完成，遗漏专用指令将导致输出不符合要求\n- **实施**：完成主任务；顺带修复明显缺陷；顺带简化重复代码；保留原注释与结构\n- **验证**：代码变更必须编译通过；找到相关测试则运行；仅文档变更可跳过\n- **AskQuestions 多选确认**：使用 `vscode_askQuestions` 工具，多选询问用户是否满意；若需调整则修改后重新编译，循环至满意；确认满意后才进入下一项开发\n\n### 主动优化原则\n\n用户要求**分析/优化代码**时：\n\n| 行动 | 说明 |\n|------|------|\n| **架构梳理** | 重构不清晰的结构，让代码更易懂 |\n| **缺陷修复** | 资源泄漏、空引用、并发问题、逻辑错误 → 直接修复 |\n| **代码简化** | 提取重复代码、合并冗余判断、应用现代语法 |\n| **性能优化** | 缓存重复计算、池化高频对象、避免无用分配 |\n| **注释完善** | 补充缺失的 XML 注释和关键逻辑说明 |\n\n---\n\n## 8. 测试\n\n- 框架 xUnit；类名 `{ClassName}Tests`；方法加 `[DisplayName(\"中文描述意图\")]`\n- 网络端口用 `0`/随机，IO 用临时目录\n- 先搜索 `{ClassName}` 引用定位测试文件，再找 `{ClassName}Tests.cs`；**未找到需说明**，不自动创建测试项目\n\n---\n\n## 9. 文档与发布\n\n### Markdown 文档\n\n**UTF-8 无 BOM**；存放 `Doc/` 目录；文件名优先中文，内容优先简体中文，避免乱码。**已有文件必须先读取再增量修改，禁止覆盖。**\n\n> 代码注释同样要求 UTF-8 无 BOM，优先简体中文。生成或编辑任何文件时须确保编码正确，防止中文乱码。\n\n### NuGet 版本\n\n| 类型 | 格式 | 示例 |\n|------|------|------|\n| 正式版 | `{主}.{子}.{年}.{月日}` | `11.9.2025.0701` |\n| 测试版 | `{主}.{子}.{年}.{月日}-beta{时分}` | `11.9.2025.0701-beta0906` |\n\n---\n\n## 10. 重要禁止项\n\n以下是 AI 容易犯但在本项目影响严重的错误：\n\n- 将 `String`/`Int32` 改为 `string`/`int`（本项目反 C# 惯例，**必须用正式名**）\n- 删除防御性注释（带说明的注释代码）\n- 删除 for/foreach/while 循环体的花括号（**循环体必须有花括号，即使只有一行**）\n- 将 `` 拆成多行\n- 擅自删除 `public`/`protected` 成员\n- 擅自新增外部 NuGet 依赖（需说明理由）\n- 仅删除空白行/注释制造\"格式优化\"提交\n- 虚构不存在的 API/文件/类型\n- 伪造测试结果/性能数据\n- 在热点路径添加未缓存反射/复杂 Linq\n- 输出敏感凭据/内部地址\n- 发现问题却视而不见\n- 用户要求优化时仅做注释/测试等表面工作\n- **跳过第 1 节触发检查**（命中关键词却未加载专用指令文件，是最严重的遗漏错误）\n\n---\n\n## 11. 变更说明模板\n\n```markdown\n## 概述\n做了什么 / 为什么\n\n## 影响\n- 公共 API：是/否\n- 性能影响：无/有（说明）\n\n## 兼容性\n降级策略 / 条件编译点\n\n## 风险与后续\n潜在回归 / 是否补测试\n```\n\n---\n\n## 12. Skills 技能文件\n\n`.github/skills/` 目录下的技能文件提供特定领域的详细使用指南和代码示例，用户可在 Copilot Chat 中通过 `#` 引用。\n\n| 技能文件 | 覆盖领域 |\n|---------|---------|\n| `caching.skill.md` | ICache/MemoryCache/Redis 统一缓存接口 |\n| `logging-tracing.skill.md` | ILog/XTrace 日志与 ITracer/DefaultTracer 链路追踪 |\n| `networking.skill.md` | NetServer/NetSession TCP/UDP/WebSocket 网络编程 |\n| `serialization.skill.md` | JSON/Binary/Span/CSV 序列化 |\n| `configuration.skill.md` | Config<T>/IConfigProvider/HttpConfigProvider 配置管理 |\n| `http-client.skill.md` | ApiHttpClient 多节点 HTTP 客户端与负载均衡 |\n| `dependency-injection.skill.md` | ObjectContainer/Host/Plugin/Actor 依赖注入与宿主 |\n| `timer-scheduling.skill.md` | TimerX/Cron 高级定时调度 |\n| `security.skill.md` | Hash/AES/SM4/RSA/JWT/TokenProvider 安全与加密 |\n| `type-conversion.skill.md` | ToInt/ToBoolean/StringHelper/Pool.StringBuilder 类型转换与工具 |\n\n---\n\n## 13. Agents 智能代理\n\n`.github/agents/` 目录下定义了专用 AI 代理角色，用户可在 Copilot Chat 中通过 `@` 调用。\n\n| 代理文件 | 用途 |\n|---------|------|\n| `newlife-expert.agent.md` | NewLife 组件专家：功能查询、组件推荐、编码指导 |\n| `code-review.agent.md` | 代码审查：按 NewLife 规范 8 维度检查代码 |\n| `project-init.agent.md` | 项目初始化：按模板创建新 NewLife 项目结构 |\n\n---\n\n（完）\n"
},
{
"path": ".github/instructions/benchmark.instructions.md",
"content": "---\napplyTo: \"**/Benchmark/**\"\n---\n\n# 性能测试指令\n\n适用于性能测试、压力测试、基准测试、BenchmarkDotNet 相关任务。\n\n---\n\n## 1. 项目结构\n\n- 基准测试统一放在 `Benchmark/` 项目，按主题分子目录（如 `PacketBenchmarks/`、`CacheBenchmarks/`）\n- 入口 `Program.cs` 使用 `BenchmarkSwitcher` 模式，**不要修改**\n- TFM 使用最新稳定版，`latest`\n\n## 2. 代码规范\n\n遵循主指令全部编码规范（类型名用 `String`/`Int32` 等、file-scoped namespace），另有以下补充：\n\n- **命名空间**：`Benchmark.{主题}Benchmarks`\n- **类名**：`{被测类型}Benchmark` 或 `{被测主题}Benchmark`\n- **必须标注** `[MemoryDiagnoser]` 和 `[SimpleJob]`（需调整迭代次数时用 `[SimpleJob(iterationCount: N)]`）\n- **方法描述**：`[Benchmark(Description = \"中文描述\")]`，方便报告阅读\n- **参数化**：用 `[Params]` 或 `[ParamsSource]` 控制数据规模\n- **初始化 / 清理**：分别放 `[GlobalSetup]` 和 `[GlobalCleanup]`\n- **分组**：同类测试用 `#region` 分组\n- **多线程并发**：动态线程数包含 CPU 核心数，推荐模板：\n\n```csharp\npublic static IEnumerable ThreadCounts\n{\n get\n {\n var cores = Environment.ProcessorCount;\n var set = new SortedSet { 1, 4, 8, 32 };\n set.Add(cores);\n return set;\n }\n}\n\n[ParamsSource(nameof(ThreadCounts))]\npublic Int32 ThreadCount { get; set; }\n```\n\n## 3. 运行要求\n\n- 必须以 **Release 模式**运行，获取有代表性的峰值数据\n- 运行全部：`dotnet run -c Release`\n- 运行指定类：`dotnet run -c Release -- --filter *ClassName*`\n- ❌ 禁止在 Debug 模式下采集数据写入报告\n\n## 4. 测试维度\n\n- **并发维度**：单线程 + 多线程（多线程含与当前 CPU 核心数相同的并发数）\n- **操作维度**：单一操作 + 批量操作\n\n## 5. 常见错误\n\n- ❌ 在 `[Benchmark]` 方法内做初始化（应放 `[GlobalSetup]`）\n- ❌ 忽略返回值导致 JIT 死码消除（确保返回或赋值给字段）\n- ❌ 手动 `Stopwatch` 计时（BDN 自动处理）\n- ❌ `using` 的 `Dispose` 开销混入测量（仅在测试 Dispose 本身时才包含）\n\n## 6. 报告存放\n\n`Doc/Benchmark/{测试主题}性能测试.md`（UTF-8 无 BOM）\n\n## 7. 报告结构（顺序固定）\n\n1. **性能概览**（放最前：一句话点明被测功能用途 + 简单语言总结核心发现）\n2. 测试环境 → 测试方法 → 测试结果（BDN 原始表格，保留 Mean/Error/StdDev/Allocated）\n3. 核心指标（换算 msg/s、QPS 等业务指标）\n4. **对比分析**\n - 纵向：同场景不同并发趋势，找出最优并发点\n - 横向：不同方案同并发差异百分比\n5. 性能瓶颈定位（按重要程度排序）→ 优化建议（含预期收益与内存节省预估）\n\n## 8. 性能瓶颈定位规范\n\n性能瓶颈定位章节是报告的核心价值输出，必须遵循以下规范：\n\n### 8.1 瓶颈点结构（每个瓶颈必须包含）\n\n每个瓶颈点必须包含以下要素，缺一不可：\n\n| 要素 | 说明 | 示例 |\n|------|------|------|\n| **优先级标签** | P0/P1/P2/P3，按影响程度降序 | P0 |\n| **瓶颈名称** | 一句话准确描述瓶颈 | VisitTime 写入触发 MESI 缓存行争用 |\n| **优化收益占比** | 该瓶颈在总体可优化空间中的占比 | ~35% |\n| **现象与数据** | 用 BDN 实测数据量化问题严重程度 | 4T→8T 扩展仅 1.3x，低于预期 2.0x |\n| **根因分析** | 从代码执行路径分析到底层硬件行为 | Get 每次写 VisitTime → 缓存行 Modified → 多核 MESI 失效 |\n| **开销占比估算** | 在单次操作总耗时中的占比 | 占 Get 总耗时 30%~40% |\n| **内存影响** | 每次操作的额外内存分配或 GC 压力 | 48 B/次装箱分配，32 线程累计 3 MB |\n| **优化方向** | 具体可落地的优化方案 | 时间窗口内跳过更新（如 1s 内不重复写） |\n| **预期收益** | 速度提升倍数 + 内存节省比例 | 多线程吞吐 +20-30%，消除缓存行争用 |\n\n### 8.2 瓶颈分级标准\n\n| 级别 | 定义 | 优化收益占比 | 行动 |\n|------|------|------------|------|\n| **P0** | 影响核心吞吐或造成 >30% 性能损失 | ≥25% | 必须优化 |\n| **P1** | 影响多线程扩展性或造成显著内存压力 | 15%~25% | 建议优化 |\n| **P2** | 特定场景下的次要瓶颈 | 5%~15% | 可选优化 |\n| **P3** | 微小开销，仅在极端场景有影响 | <5% | 记录备查 |\n\n### 8.3 瓶颈定位表格模板\n\n性能瓶颈定位章节使用以下统一表格格式：\n\n```markdown\n### 核心瓶颈点总览\n\n| 优先级 | 瓶颈 | 优化收益占比 | 当前开销 | 优化后预估 | 内存节省 |\n|--------|------|------------|---------|-----------|---------|\n| P0 | {瓶颈名称} | ~{X}% | {耗时/分配} | {目标值} | {节省比例} |\n| P1 | {瓶颈名称} | ~{X}% | {耗时/分配} | {目标值} | {节省比例} |\n| ... | ... | ... | ... | ... | ... |\n```\n\n### 8.4 内存优化方向表格模板\n\n紧跟瓶颈总览表之后，补充内存优化方向：\n\n```markdown\n### 关键内存优化方向\n\n| 优先级 | 优化方向 | 当前分配 | 优化后预估 | 节省比例 | 实施方案 |\n|--------|---------|---------|-----------|---------|---------|\n| P0 | {方向} | {X} B/op | {Y} B/op | {Z}% | {方案} |\n| ... | ... | ... | ... | ... | ... |\n```\n\n### 8.5 开销拆解要求\n\n对每个核心操作，必须给出开销来源拆解表：\n\n```markdown\n| 开销来源 | 占比估算 | 耗时估算 | 说明 |\n|---------|---------|---------|------|\n| {来源1} | ~{X}% | ~{N} ns | {原因} |\n| {来源2} | ~{X}% | ~{N} ns | {原因} |\n```\n\n### 8.6 撰写原则\n\n- **数据驱动**：所有结论必须有 BDN 实测数据支撑，禁止无数据臆测\n- **量化优先**：用\"快 X 倍\"、\"省 Y%\"、\"降 Z B/op\"表达，避免\"显著\"、\"明显\"等模糊词\n- **根因到底**：从应用层代码 → 运行时机制 → CPU 微架构逐层分析\n- **可操作**：每个优化建议必须指明具体修改位置和实施方案，而非泛泛建议\n- **排序严格**：P0 在前，P3 在后，同级按收益占比降序\n"
},
{
"path": ".github/instructions/development.instructions.md",
"content": "---\napplyTo: \"Doc/**\"\n---\n\n# AI 辅助开发流程指令\n\n适用于新建应用系统、新增功能模块、需求整理、架构设计等研发全流程任务。\n\n---\n\n## 1. 流程总览\n\n```\n需求整理 → 需求评审与拆分 → 技术方案设计 → 任务分解 → 迭代开发 → 集成验证 → 验收回顾\n```\n\n**核心原则**：大需求必须拆小，每个迭代交付可验证的最小功能单元。禁止\"一次性全做完\"。\n\n---\n\n## 2. 各阶段规范\n\n### 2.1 需求整理\n\n用户提供原始描述（口语化、列表、草稿均可），AI 整理为以下结构（需求 + 功能清单 + 验收 合为一个文件）：\n\n```markdown\n# {项目/模块名}需求\n\n## 1. 背景与目标\n- 为什么做（痛点/动机）\n- 做到什么程度算成功（可衡量目标）\n\n## 2. 用户角色\n| 角色 | 说明 | 核心诉求 |\n|------|------|---------|\n\n## 3. 功能需求\n### 3.1 {功能模块名}\n- **描述**：一句话说明\n- **用户故事**：作为{角色}，我希望{操作}，以便{价值}\n- **验收条件**（AC）：\n - [ ] 条件 1\n - [ ] 条件 2\n- **优先级**：Must / Should / Could / Won't\n\n## 4. 非功能需求\n- 性能 / 安全 / 兼容性（三项必填）\n\n## 5. 边界与约束\n- 不做什么（明确排除项）\n- 已知限制 / 技术债务\n\n## 6. 功能清单与迭代计划\n（需求评审拆分后填写，见 2.2）\n\n## 7. 验收记录\n（开发完成后填写，见 2.7）\n\n## 8. 术语表\n| 术语 | 定义 |\n|------|------|\n```\n\n**规则**：每个功能必须有 AC，无 AC 不可进入开发；优先级用 MoSCoW 四级；非功能需求至少覆盖性能、安全、兼容性。\n\n### 2.2 需求评审与拆分\n\n按**纵向切片**（端到端功能，非技术层）拆分，遵循 INVEST 原则，单个功能单元 ≤ 1-2 天工作量，有依赖须标注。\n\n写入需求文档「6. 功能清单与迭代计划」：\n\n```markdown\n## 6. 功能清单与迭代计划\n\n### 迭代 1：{主题}（Must 级别）\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 预估工作量 |\n|------|--------|---------|---------|----------|\n| F001 | xxx | AC1, AC2 | 无 | 0.5d |\n| F002 | xxx | AC1 | F001 | 1d |\n\n### 迭代 2：{主题}（Should 级别）\n...\n```\n\n### 2.3 技术方案设计\n\n```markdown\n# {项目/模块名}架构\n\n## 1. 架构概览\n## 2. 数据模型\n## 3. 接口设计\n| 接口 | 方法 | 路径/签名 | 入参 | 出参 | 说明 |\n|------|------|----------|------|------|------|\n## 4. 技术选型\n| 领域 | 选型 | 理由 |\n|------|------|------|\n## 5. 关键设计决策\n| 决策点 | 方案 | 备选方案 | 选择理由 |\n|--------|------|---------|---------|\n## 6. 任务分解\n（见 2.4）\n## 7. 风险与缓解\n| 风险 | 影响 | 缓解措施 |\n|------|------|---------|\n```\n\n**规则**：优先使用 NewLife 已有组件（XCode、Remoting、Stardust 等）；数据模型考虑 XCode 实体规范；接口遵循现有 API 风格。\n\n### 2.4 任务分解\n\n单个任务 = 一次 AI 对话可完成的工作量（编码 + 测试 + 自测通过）。写入技术方案「6. 任务分解」：\n\n```markdown\n### 任务 T001：{动词 + 目标}\n- **对应功能**：F001\n- **输入**：前置条件 / 已有代码\n- **产出**：新增/修改哪些文件\n- **验收**：怎样算完成\n```\n\n**批次编排**（用于自治模式，见第 6 节）：按依赖关系编排为批次，每批次 5-8 个任务，同批次内尽量无相互依赖，基础设施任务排在前面，每批次结束设 `[检查点 N]`，标注本批次产出是下批次哪些输入。\n\n### 2.5 迭代开发\n\n流程：`理解任务 → 检索现有实现 → 编码 → 编译通过 → 测试通过 → 提交说明`\n\n- 严格遵守主指令编码规范，每个任务必须编译通过\n- 常规模式：遇歧义暂停确认；自治模式：记录跳过继续（见第 6 节）\n- 有依赖按顺序执行，不跳跃\n\n### 2.6 集成验证\n\n全部编译通过 → 单元测试通过 → 端到端主流程走通 → 异常场景覆盖 → 性能符合预期\n\n### 2.7 验收与回顾\n\n对照需求文档逐条验收，写入「7. 验收记录」：\n\n```markdown\n## 7. 验收记录\n\n### 功能验收\n| 编号 | 功能点 | 验收条件 | 状态 | 备注 |\n|------|--------|---------|------|------|\n\n### 遗留问题\n| 问题 | 影响 | 后续计划 |\n|------|------|---------|\n\n### 经验总结\n- 做得好的 / 待改进的\n```\n\n---\n\n## 3. 文档存放规范\n\n全流程仅产出 **2 个文档**，扁平存放在 `Doc/` 下：\n\n| 文档 | 文件名 | 包含内容 |\n|------|--------|--------|\n| 需求文档 | `Doc/{项目名}需求.md` | 背景目标 + 功能需求 + 功能清单 + 验收记录 + 术语表 |\n| 技术方案 | `Doc/{项目名}架构.md` | 架构 + 数据模型 + 接口 + 技术选型 + 任务分解 + 风险 |\n\nUTF-8 无 BOM；已有文件必须先读取再增量修改，禁止覆盖；各阶段产出追加到对应章节，不新建文件。\n\n---\n\n## 4. AI 协作要点\n\n### 4.1 阶段切换\n\n| 用户说 | 进入阶段 |\n|--------|---------|\n| \"整理需求\"/\"写需求\" | 2.1 需求整理 |\n| \"拆分\"/\"拆解\"/\"排优先级\" | 2.2 需求评审与拆分 |\n| \"技术方案\"/\"架构设计\"/\"怎么实现\" | 2.3 技术方案设计 |\n| \"开始开发\"/\"写代码\"/\"实现 F001\" | 2.5 迭代开发 |\n| \"全部搞完\"/\"批量开发\"/\"自治模式\"/\"一次性做完\"/\"继续处理\"/\"接着做\" | 第 6 节自治批处理 |\n| \"验收\"/\"检查完成情况\" | 2.7 验收与回顾 |\n| 一大段描述未指定阶段 | 默认 2.1 需求整理 |\n\n### 4.2 主动引导\n\n每阶段完成后提示下一步：需求整理完 → 拆分？ → 技术方案？ → 任务分解 → 开发？\n\n### 4.3 大需求防护\n\n功能点 > 5 / 实体 > 3 / 跨 2 层以上 / 描述 > 500 字 → 必须先拆分再开发。\n\n---\n\n## 5. 常见反模式（禁止）\n\n- ❌ 跳过需求直接编码\n- ❌ 一次性输出所有代码（大需求必须拆迭代或使用自治模式）\n- ❌ 需求文档没有验收条件\n- ❌ 功能拆分按技术层而非用户价值\n- ❌ 任务没有完成标准就开始编码\n- ❌ 完成后不做验收对照\n- ❌ 自治模式下遇阻塞问题死等用户（应记录跳过，继续后续）\n- ❌ 自治模式下做需要人工决策的架构变更（应记录待确认，现有方案兜底）\n- ❌ 跨批次不做编译验证\n\n---\n\n## 6. 自治批处理模式\n\n架构师已确认需求和技术方案后，AI 按任务清单自主执行，最小化人工介入。\n\n### 6.1 进入条件（全部满足）\n\n- [ ] 需求文档已完成且架构师已确认\n- [ ] 技术方案已完成且架构师已确认\n- [ ] 任务已分解并编排为批次\n- [ ] 用户明确触发（\"全部搞完\"/\"批量开发\"/\"自治模式\"等）\n\n未满足时提示缺少哪些条件。\n\n### 6.2 计划结构与循环刷新\n\nAI 用 plan 工具创建层次化计划，「前置刷新 + 批次执行」循环：\n\n```\n1. [前置] 读取需求文档与技术方案\n2. [前置] 读取任务清单与进度状态\n3. [前置] 全量编译确认基线\n4. [前置] 识别可并行的批次组\n5. [批次1] 执行 T001-T005（子步骤展开各任务）\n6. [检查点1] 输出批次1报告\n7. [刷新] 重读需求文档与技术方案\n8. [批次2] 执行 T006-T010\n9. [检查点2] 输出批次2报告\n...（循环：刷新 → 批次 → 检查点）\nN-2. [后置] 全量编译与集成验证\nN-1. [后置] 补完被跳过的任务\nN. [后置] 生成验收报告\n```\n\n**要点**：\n- 主步骤 15-25 个（不超过 30），子步骤展开具体任务仅供参考不单独追踪\n- 刷新步骤穿插在每两个批次之间，`get_file` 重读文档对抗上下文漂移\n- 用 `update_plan_progress` 跟踪主步骤，不为每个子任务调用\n- 无依赖的批次可合并为一个主步骤执行，有依赖的必须顺序执行\n\n### 6.3 执行协议\n\n| 情况 | 处理方式 |\n|------|----------|\n| 任务明确无歧义 | 直接执行：编码 → 编译 → 测试 |\n| 小歧义可合理推断 | 执行并在问题日志记录推断依据 |\n| 重大歧义或多种等价方案 | 标记 `⏸️ 待确认`，跳过 |\n| 前置任务被跳过 | 标记 `⏸️ 依赖阻塞：T0xx`，跳过 |\n| 编译失败短时间无法修复 | 回滚改动，记录并跳过 |\n| 涉及公共 API / 架构变更 | 标记 `⏸️ 需架构师决策`，兜底或跳过 |\n\n### 6.4 检查点报告\n\n每批次完毕后输出：\n\n```markdown\n## 检查点 N 报告\n\n### 完成情况\n| 任务 | 状态 | 说明 |\n|------|------|------|\n| T001 | ✅ 完成 | |\n| T003 | ⏸️ 跳过 | 需确认：xxx |\n\n### 编译状态\n- 全量编译：✅ 通过 / ❌ 失败（错误详情）\n\n### 问题日志\n| 编号 | 类型 | 描述 | 影响任务 | 建议方案 |\n|------|------|------|---------|----------|\n\n### 统计\n- 本批次 N 个，完成 X 个，跳过 Y 个\n- 累计进度：已完成 X / 总计 Z（XX%）\n- 上下文预估：{已处理任务数} / {建议上限}\n```\n\n### 6.5 用户回复与继续\n\n架构师回来后：AI 呈现检查点报告 → 架构师批量回复问题（\"Q001 OK，Q002 选 A\"）→ AI 修正推断 + 执行跳过的任务 + 继续下批次 → 循环至完成。\n\n触发词：\"继续\"/\"继续处理\"/\"回复完了\"/\"接着做\"\n\n### 6.6 质量护栏（自动执行）\n\n编译门禁（失败即修复或回滚）/ 命名与技术方案一致 / 编码规范严格遵守 / 新增代码前搜索现有实现避免重复 / 不擅自引入新 NuGet 包\n\n### 6.7 会话边界处理\n\n每个检查点后、连续完成 15+ 任务后、搜索结果不准确时 → 评估是否需要新会话。\n\n**新会话续接模板**：\n\n```\n我们在做 {项目名} 的自治批处理开发。\n- 需求文档：Doc/{项目名}需求.md\n- 技术方案：Doc/{项目名}架构.md\n- 当前进度：批次 N 已完成，从批次 N+1 的 T0xx 开始继续\n- 待解决问题：{问题编号}\n请读取以上文档，从 T0xx 继续执行，自治模式。\n```\n\n上下文即将耗尽时 AI 主动提醒并生成上述模板。新会话前 4 步仍为前置刷新，已完成批次直接标记完成。\n\n### 6.8 批次大小建议\n\n| 复杂度 | 批次大小 |\n|--------|---------|\n| 简单（CRUD） | 8-10 |\n| 中等（业务逻辑） | 5-7 |\n| 复杂（算法、并发） | 3-5 |\n\n单会话上限：3-4 个批次（约 15-25 个任务）。\n\n---\n\n（完）\n"
},
{
"path": ".github/instructions/net.instructions.md",
"content": "---\napplyTo: \"**/Net/**\"\n---\n\n# 网络编程指令\n\n适用于基于 `NewLife.Net` 的网络服务器（`NetServer`）和客户端（`ISocketClient`）开发任务。\n\n---\n\n## 1. 架构概览\n\nNewLife 网络框架分为两层：\n\n| 层级 | 服务端 | 客户端 | 说明 |\n|------|--------|--------|------|\n| **应用层** | `NetServer` / `NetServer` | — | 管理监听、会话生命周期、管道 |\n| **传输层** | `TcpServer` / `UdpServer` | `TcpSession` / `UdpServer`（客户端模式） | 底层 Socket 收发 |\n| **会话** | `NetSession` / `NetSession` | — | 每个连接对应一个会话，业务逻辑入口 |\n| **管道** | `IPipeline` + `IPipelineHandler` | 同左 | 编解码、粘包拆包、消息匹配 |\n\n**关键接口**：\n- `ISocketClient` — 客户端连接接口（Open/Close/Send/Receive）\n- `ISocketRemote` — 远程通信接口（Send/Receive/SendMessageAsync）\n- `INetSession` — 网络会话接口（服务端每个连接的业务处理单元）\n- `INetHandler` — 网络数据处理器接口（Init/Process）\n\n---\n\n## 2. 服务端开发规范\n\n### 2.1 基本模式\n\n推荐使用泛型 `NetServer` + 自定义 `NetSession` 子类：\n\n```csharp\n/// 自定义网络服务器\nclass MyServer : NetServer { }\n\n/// 自定义会话，每个客户端连接对应一个实例\nclass MySession : NetSession\n{\n /// 客户端连接\n protected override void OnConnected()\n {\n base.OnConnected();\n WriteLog(\"客户端已连接 {0}\", Remote);\n }\n\n /// 收到客户端数据\n protected override void OnReceive(ReceivedEventArgs e)\n {\n base.OnReceive(e);\n // 业务处理\n }\n\n /// 客户端断开\n protected override void OnDisconnected(String reason)\n {\n base.OnDisconnected(reason);\n }\n}\n```\n\n### 2.2 服务器启动配置\n\n```csharp\nvar server = new MyServer\n{\n Port = 8080, // 监听端口，0 表示随机\n ProtocolType = NetType.Tcp, // Tcp/Udp/Unknown（同时监听）\n // AddressFamily = AddressFamily.InterNetwork, // 仅IPv4，默认同时IPv4+IPv6\n ServiceProvider = provider, // 依赖注入\n Log = XTrace.Log, // 应用日志\n SessionLog = XTrace.Log, // 会话日志\n Tracer = tracer, // APM 追踪\n#if DEBUG\n SocketLog = XTrace.Log, // Socket 层日志（仅调试）\n LogSend = true,\n LogReceive = true,\n#endif\n};\nserver.Start();\n```\n\n### 2.3 会话生命周期\n\n```\n连接建立 → OnConnected() → OnReceive()... → OnDisconnected(reason) → Dispose()\n```\n\n- **OnConnected**：初始化会话状态、发送欢迎消息\n- **OnReceive**：核心业务处理入口，`e.Packet` 为原始数据，`e.Message` 为管道解码后的消息\n- **OnDisconnected**：清理资源、记录日志，`reason` 包含断开原因\n- 会话内可通过 `ServiceProvider` 获取 Scoped 服务\n\n### 2.4 服务端发送数据\n\n| 方法 | 说明 |\n|------|------|\n| `Send(IPacket)` | 直接发送原始数据，不经过管道 |\n| `Send(String)` | 发送字符串，默认 UTF-8 |\n| `Send(ReadOnlySpan)` | 高性能发送 |\n| `SendMessage(Object)` | 通过管道编码后发送，不等待响应 |\n| `SendReply(Object, ReceivedEventArgs)` | 发送响应消息，与请求关联（用于 StandardCodec 等协议） |\n| `SendMessageAsync(Object)` | 通过管道发送并等待响应 |\n\n### 2.5 群发\n\n```csharp\n// 群发数据给所有在线客户端\nawait server.SendAllAsync(data);\n\n// 带过滤条件群发\nawait server.SendAllAsync(data, session => session.ID > 100);\n\n// 群发管道消息\nserver.SendAllMessage(message, session => session[\"VIP\"] is true);\n```\n\n群发要求 `UseSession = true`（默认开启）。\n\n### 2.6 事件模式（简单场景）\n\n不需要自定义会话时，可直接使用事件：\n\n```csharp\nvar server = new NetServer { Port = 8080 };\nserver.Received += (sender, e) =>\n{\n if (sender is INetSession session)\n session.Send(e.Packet); // Echo\n};\nserver.Start();\n```\n\n---\n\n## 3. 客户端开发规范\n\n### 3.1 创建客户端\n\n通过 `NetUri.CreateRemote()` 扩展方法创建：\n\n```csharp\n// TCP 客户端\nvar client = new NetUri(\"tcp://127.0.0.1:8080\").CreateRemote();\n\n// UDP 客户端\nvar client = new NetUri(\"udp://127.0.0.1:8080\").CreateRemote();\n\n// WebSocket 客户端\nvar client = new NetUri(\"ws://127.0.0.1:8080/path\").CreateRemote();\n```\n\n`CreateRemote` 根据协议自动返回 `TcpSession` / `UdpServer` / `WebSocketClient`。\n\n### 3.2 客户端使用\n\n```csharp\nvar uri = new NetUri(\"tcp://127.0.0.1:8080\");\nvar client = uri.CreateRemote();\nclient.Log = XTrace.Log;\nclient.Open();\n\n// 发送原始数据（不经过管道）\nclient.Send(\"Hello\");\n\n// 事件驱动接收\nclient.Received += (sender, e) =>\n{\n // e.Packet 原始数据，e.Message 管道解码后的消息\n};\n\n// 或同步/异步接收\nusing var pk = client.Receive();\nusing var pk = await client.ReceiveAsync(cancellationToken);\n\nclient.Close(\"完成\"); // 或 client.Dispose()\n```\n\n### 3.3 请求-响应模式（需要管道编解码器）\n\n```csharp\nvar client = new NetUri(\"tcp://127.0.0.1:8080\").CreateRemote();\nclient.Add();\nclient.Open();\n\nvar response = await client.SendMessageAsync(payload, cancellationToken); // 等待响应\nclient.SendMessage(message); // 不等待响应\n```\n\n### 3.4 SSL/TLS\n\n```csharp\n// 服务端 SSL\nvar server = new NetServer\n{\n Port = 443,\n SslProtocol = SslProtocols.Tls12,\n Certificate = new X509Certificate2(\"server.pfx\", \"password\"),\n};\n\n// 客户端 SSL（自动根据端口判断，或手动指定）\nvar client = new NetUri(\"tcp://host:443\").CreateRemote();\nif (client is TcpSession tcp)\n{\n tcp.SslProtocol = SslProtocols.Tls12;\n // tcp.Certificate = cert; // 客户端证书（如果服务端要求）\n}\n```\n\n---\n\n## 4. 管道与编解码器\n\n### 4.1 管道机制\n\n管道（`IPipeline`）是处理器链，Read/Write 返回值作为下一个处理器的输入，返回 `null` 截断管道：\n\n```\n接收：Socket → [Codec1.Read] → [Codec2.Read] → FireRead → OnReceive\n发送：SendMessage → [Codec2.Write] → [Codec1.Write] → FireWrite → Socket\n```\n\nOpen 正序传播，Close 逆序传播。先添加的在底层（靠近 Socket），后添加的在上层（靠近业务）。\n\n### 4.2 内置编解码器\n\n| 编解码器 | 基类 | 说明 | 典型场景 |\n|---------|------|------|---------|\n| `StandardCodec` | `MessageCodec` | 4字节头部（Flag+Seq+Length），支持请求-响应匹配 | 自定义 RPC 协议 |\n| `LengthFieldCodec` | `MessageCodec` | 长度字段头部，可配置偏移和大小 | MQTT、通用二进制协议 |\n| `JsonCodec` | `Handler` | JSON 文本编解码，不处理粘包 | 文本协议（通常与 StandardCodec 级联） |\n| `SplitDataCodec` | `Handler` | 分隔符拆包（默认 `\\r\\n`） | 文本行协议 |\n| `WebSocketCodec` | `Handler` | WebSocket 帧编解码 | WebSocket 通信 |\n\n### 4.3 添加编解码器\n\n```csharp\n// 服务端添加\nserver.Add();\n\n// 客户端添加\nclient.Add();\n\n// 多层管道级联（按添加顺序组成链）\nserver.Add(); // 底层：粘包拆包 + 请求响应匹配\nserver.Add(); // 上层：JSON 编解码\n```\n\n### 4.4 StandardCodec 请求-响应\n\nStandardCodec 使用 `DefaultMessage`，包含 Flag（1字节）、Sequence（1字节）、Length（2字节），\n支持自动序列号分配和请求-响应匹配。\n\n```csharp\n// 服务端 Echo 示例\nserver.Add();\nserver.Received += (sender, e) =>\n{\n if (sender is INetSession session && e.Message is IPacket pk)\n session.SendReply(pk, e); // 使用 SendReply 关联请求上下文\n};\n\n// 客户端请求-响应\nclient.Add();\nvar response = await client.SendMessageAsync(payload);\n```\n\n### 4.5 基类选择\n\n| 基类 | 适用场景 | 典型代表 |\n|------|---------|---------|\n| `MessageCodec` | 需要粘包拆包和/或请求-响应匹配（内置 `IMatchQueue`、`Encode`/`Decode`） | `StandardCodec`、`LengthFieldCodec` |\n| `Handler` | 简单转换、帧协议、文本协议（轻量，仅 `Read`/`Write`/`Open`/`Close`） | `JsonCodec`、`SplitDataCodec`、`WebSocketCodec` |\n\n### 4.6 编解码器设计规范\n\n#### 4.6.1 粘包拆包（PacketCodec 模式）\n\nTCP 是字节流协议，必须处理粘包拆包。统一模式（完整实现见 4.7 模板）：\n\n1. 每个连接独立的 `PacketCodec` 实例，存储在 `ss[\"Codec\"]` 中\n2. 通过 `GetLength2` 委托告诉 `PacketCodec` 如何计算完整帧长度\n3. `PacketCodec.Parse()` 返回完整帧列表，自动缓存不完整数据\n\n**`GetLength2` 规范**（签名 `Int32 GetLength(ReadOnlySpan span)`）：返回帧完整长度（含头部），数据不足时返回 `0`。\n\n```csharp\npublic static Int32 GetLength(ReadOnlySpan span)\n{\n if (span.Length < 4) return 0;\n var reader = new SpanReader(span) { IsLittleEndian = true };\n reader.Advance(2);\n return 4 + reader.ReadUInt16(); // 头部4字节 + 负载长度\n}\n```\n\n#### 4.6.2 编码与内存管理\n\n- **`ExpandHeader(size)`**：编码时优先复用负载缓冲区前置空间写入头部，零拷贝；空间不足时创建 `OwnerPacket`，原包作为 `Next` 链节点\n- **`SpanWriter`**：配合 `ExpandHeader` 写入头部字段，注意 `IsLittleEndian` 大小端\n- **兜底释放**：`MessageCodec.Write` 基类自动 `TryDispose`；`Handler` 子类需在 `Write` 的 `finally` 中手动调用\n- **对象池**：`DefaultMessage.Rent()` / `DefaultMessage.Return()` 减少 GC 压力\n\n#### 4.6.3 请求-响应匹配\n\n`MessageCodec` 内置 `IMatchQueue`，流程：`Write` → `AddToQueue` 入队 → `Decode` 解码 → `Queue.Match` 按 `IsMatch` 匹配 → 唤醒 `SendMessageAsync` 的 `Task`。\n\n- 重载 `AddToQueue`：控制哪些消息入队（通常只有请求消息）\n- 重载 `IsMatch`：根据序列号等字段匹配请求和响应（见 4.7 模板）\n- `QueueSize`：匹配队列大小，默认 256\n- `Timeout`：等待响应超时，默认 30_000ms\n- `UserPacket`：为 `true` 时向上层传递 `Payload` 而非整个 `IMessage`，用于编码器级联\n\n#### 4.6.4 Close 清理\n\n**必须**在 `Close` 中执行 `ss[\"Codec\"] = null` 清理 `PacketCodec`，否则 `MemoryStream` 缓存泄漏（见 4.7 模板）。\n\n#### 4.6.5 上下文扩展（IExtend）\n\n管道处理器通过 `IExtend` 在会话/上下文上传递元数据：\n\n| 键 | 用途 | 示例 |\n|---|------|------|\n| `\"Codec\"` | 每连接的 `PacketCodec` 实例 | 编解码器的 `Decode`/`Close` 中读写 |\n| `\"Flag\"` | 数据类型标记 `DataKinds` | `JsonCodec.Write` 设置 → `StandardCodec.Write` 消费 |\n| `\"_raw_message\"` | 原始请求消息 | `MessageCodec.Read` 设置 → `Write` 中创建响应时消费 |\n| `\"TaskSource\"` | `TaskCompletionSource` | 框架内部，`AddToQueue` 消费 |\n\n#### 4.6.6 多层管道级联\n\n- 底层编解码器处理粘包拆包和请求-响应匹配，上层处理数据格式转换\n- `UserPacket = true` 让底层向上层传递 `Payload` 而非整个 `IMessage`\n- 上层通过 `ext[\"Flag\"]` 向底层传递数据类型标记\n\n### 4.7 自定义编解码器模板\n\n#### 方式一：继承 MessageCodec（需要粘包/请求响应匹配）\n\n```csharp\n/// 自定义协议编解码器\npublic class MyCodec : MessageCodec\n{\n /// 编码消息为数据包\n protected override Object? Encode(IHandlerContext context, MyMessage msg)\n {\n return msg.ToPacket();\n }\n\n /// 解码数据包为消息\n protected override IEnumerable? Decode(IHandlerContext context, IPacket pk)\n {\n if (context.Owner is not IExtend ss) yield break;\n\n if (ss[\"Codec\"] is not PacketCodec pc)\n {\n ss[\"Codec\"] = pc = new PacketCodec\n {\n GetLength2 = MyMessage.GetLength,\n MaxCache = MaxCache,\n Tracer = (context.Owner as ISocket)?.Tracer\n };\n }\n\n foreach (var item in pc.Parse(pk))\n {\n var msg = new MyMessage();\n if (msg.Read(item)) yield return msg;\n }\n }\n\n /// 是否匹配响应\n protected override Boolean IsMatch(Object? request, Object? response) =>\n request is MyMessage req && response is MyMessage res\n && req.Sequence == res.Sequence;\n\n /// 连接关闭时清理\n public override Boolean Close(IHandlerContext context, String reason)\n {\n if (context.Owner is IExtend ss) ss[\"Codec\"] = null;\n\n return base.Close(context, reason);\n }\n}\n```\n\n#### 方式二：继承 Handler（简单转换/帧协议）\n\n```csharp\n/// 自定义帧编解码器\npublic class MyFrameCodec : Handler\n{\n /// 读取数据（接收时）\n public override Object? Read(IHandlerContext context, Object message)\n {\n if (message is IPacket pk)\n {\n // 解码：二进制 → 业务对象\n var frame = MyFrame.Parse(pk);\n message = frame;\n }\n\n return base.Read(context, message);\n }\n\n /// 写入数据（发送时）\n public override Object? Write(IHandlerContext context, Object message)\n {\n IPacket? owner = null;\n if (message is MyFrame frame)\n {\n // 编码：业务对象 → 二进制\n message = owner = frame.ToPacket();\n }\n\n try\n {\n return base.Write(context, message);\n }\n finally\n {\n owner.TryDispose(); // 兜底释放\n }\n }\n\n /// 连接关闭时清理缓存\n public override Boolean Close(IHandlerContext context, String reason)\n {\n if (context.Owner is IExtend ss) ss[\"Codec\"] = null;\n\n return base.Close(context, reason);\n }\n}\n```\n\n---\n\n## 5. 常见模式与最佳实践\n\n### 5.1 端口选择\n\n- 测试代码使用端口 `0`（系统自动分配随机端口），避免端口冲突\n- 正式服务指定固定端口\n- 启动后可通过 `server.Port` 获取实际监听端口\n\n### 5.2 协议选择\n\n| 场景 | 推荐 |\n|------|------|\n| 可靠传输、长连接 | `NetType.Tcp` |\n| 低延迟、广播、允许丢包 | `NetType.Udp` |\n| 同时支持（默认） | `NetType.Unknown` |\n| Web 浏览器通信 | `NetType.WebSocket` |\n\n### 5.3 会话管理\n\n- `UseSession = true`（默认）：维护会话集合，支持群发、按 ID 查找\n- `UseSession = false`：不维护会话集合，减少内存开销，适合海量短连接\n- `SessionTimeout`：设置会话超时时间（秒），超时无数据自动断开\n- 会话中通过 `Items` 字典存储自定义数据\n\n### 5.4 日志分层\n\n| 属性 | 用途 | 建议 |\n|------|------|------|\n| `Log` | 服务器应用层日志 | 始终设置 |\n| `SessionLog` | 会话级别日志 | 调试时设置 |\n| `SocketLog` | 底层 Socket 日志 | 仅 DEBUG 时设置 |\n| `LogSend` / `LogReceive` | 收发数据内容日志 | 仅 DEBUG 时开启 |\n| `Tracer` | 应用层 APM | 生产环境追踪 |\n| `SocketTracer` | Socket 层 APM | 排查底层问题 |\n\n### 5.5 资源释放\n\n- 服务端：调用 `server.Stop(reason)` 或 `server.Dispose()`\n- 客户端：调用 `client.Close(reason)` 或 `client.Dispose()`\n- 会话自动随连接断开释放，无需手动管理\n- `ISocketClient` 实现 `IDisposable`，推荐 `using` 模式\n\n### 5.6 INetHandler 业务处理器\n\n通过重载 `NetServer.CreateHandler` 注入自定义业务处理器：\n\n```csharp\nclass MyServer : NetServer\n{\n /// 为会话创建网络数据处理器\n public override INetHandler? CreateHandler(INetSession session) => new MyHandler();\n}\n```\n\n处理器在会话 `Start` 时初始化，`OnReceive` 前调用 `Process`，适合前置协议解析。\n\n---\n\n## 6. 常见错误\n\n- ❌ 在 `OnReceive` 中执行长时间阻塞操作（会影响其他连接的数据接收）\n- ❌ 不加管道编解码器直接调用 `SendMessageAsync`（无法匹配响应）\n- ❌ 混淆 `Send` 与 `SendMessage`：前者直接发原始数据，后者经过管道编码\n- ❌ 混淆 `SendMessage` 与 `SendReply`：响应消息必须用 `SendReply` 关联请求上下文\n- ❌ 忘记调用 `base.OnConnected()` / `base.OnDisconnected(reason)` / `base.OnReceive(e)`\n- ❌ 在会话中使用 `Task.Result` 或 `Task.Wait()`（导致死锁和线程池饥饿）\n- ❌ 使用固定端口编写测试（端口冲突），应使用 `Port = 0`\n- ❌ 服务端 SSL 未指定证书\n\n---\n\n## 7. 完整示例\n\n### 7.1 带 StandardCodec 的 Echo 服务\n\n```csharp\n// 服务端\nvar server = new NetServer\n{\n Port = 8080,\n ProtocolType = NetType.Tcp,\n Log = XTrace.Log,\n};\nserver.Add();\nserver.Received += (sender, e) =>\n{\n if (sender is INetSession session && e.Message is IPacket pk)\n session.SendReply(pk, e);\n};\nserver.Start();\n\n// 客户端\nvar client = new NetUri($\"tcp://127.0.0.1:{server.Port}\").CreateRemote();\nclient.Add();\nclient.Open();\n\nvar response = await client.SendMessageAsync(new ArrayPacket(\"Hello\".GetBytes()));\n```\n\n### 7.2 自定义会话服务器\n\n```csharp\nclass ChatServer : NetServer { }\n\nclass ChatSession : NetSession\n{\n protected override void OnConnected()\n {\n base.OnConnected();\n Send($\"欢迎 [{Remote}] 进入聊天室！\\r\\n\");\n }\n\n protected override void OnReceive(ReceivedEventArgs e)\n {\n base.OnReceive(e);\n var msg = e.Packet?.ToStr();\n if (msg.IsNullOrEmpty()) return;\n\n // 广播给所有在线用户\n var host = (this as INetSession).Host;\n host.SendAllMessage($\"[{ID}] {msg}\");\n }\n\n protected override void OnDisconnected(String reason)\n {\n base.OnDisconnected(reason);\n WriteLog(\"用户离开：{0}\", reason);\n }\n}\n```\n\n---\n\n（完）\n"
},
{
"path": ".github/workflows/publish-beta.yml",
"content": "name: publish-beta\n\non:\n push:\n branches: [ master,dev ]\n paths:\n - 'NewLife.RocketMQ/**'\n workflow_dispatch:\n\njobs:\n build-publish:\n\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v4\n - name: Setup dotNET\n uses: actions/setup-dotnet@v4\n with:\n dotnet-version: |\n 6.x\n 7.x\n 8.x\n 9.x\n 10.x\n - name: Build\n run: |\n dotnet pack --version-suffix $(date \"+%Y.%m%d-beta%H%M\") -c Release -o out NewLife.RocketMQ/NewLife.RocketMQ.csproj\n - name: Publish\n run: |\n # dotnet nuget push ./out/*.nupkg --skip-duplicate --source https://nuget.pkg.github.com/NewLifeX/index.json --api-key ${{ github.token }}\n dotnet nuget push ./out/*.nupkg --skip-duplicate --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.nugetKey }}\n"
},
{
"path": ".github/workflows/publish.yml",
"content": "name: publish\n\non:\n push:\n tags: [ v* ]\n workflow_dispatch:\n\njobs:\n build-publish:\n\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v4\n - name: Setup dotNET\n uses: actions/setup-dotnet@v4\n with:\n dotnet-version: |\n 6.x\n 7.x\n 8.x\n 9.x\n 10.x\n - name: Build\n run: |\n dotnet pack -c Release -o out NewLife.RocketMQ/NewLife.RocketMQ.csproj\n - name: Publish\n run: |\n # dotnet nuget push ./out/*.nupkg --skip-duplicate --source https://nuget.pkg.github.com/NewLifeX/index.json --api-key ${{ github.token }}\n dotnet nuget push ./out/*.nupkg --skip-duplicate --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.nugetKey }}\n"
},
{
"path": ".github/workflows/test.yml",
"content": "name: test\n\non:\n push:\n branches: [ '*' ]\n pull_request:\n branches: [ '*' ]\n\njobs:\n build-test:\n\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v4\n - name: Setup dotNET\n uses: actions/setup-dotnet@v4\n with:\n dotnet-version: |\n 6.x\n 7.x\n 8.x\n 9.x\n 10.x\n - name: Build\n run: |\n dotnet build -c Release\n"
},
{
"path": ".gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n\n# User-specific files\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\nbld/\n[Bb]in/\n[Oo]bj/\n[Ll]og/\n\n# Visual Studio 2015 cache/options directory\n.vs/\n# Uncomment if you have tasks that create the project's static files in wwwroot\n#wwwroot/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n# DNX\nproject.lock.json\nproject.fragment.lock.json\nartifacts/\n\n*_i.c\n*_p.c\n*_i.h\n*.ilk\n*.meta\n*.obj\n*.pch\n*.pdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opendb\n*.opensdf\n*.sdf\n*.cachefile\n*.VC.db\n*.VC.VC.opendb\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n*.sap\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding add-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\nnCrunchTemp_*\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# TODO: Comment the next line if you want to checkin your web deploy settings\n# but database connection strings (with potential passwords) will be unencrypted\n#*.pubxml\n*.publishproj\n\n# Microsoft Azure Web App publish settings. Comment the next line if you want to\n# checkin your Azure Web App publish settings, but sensitive information contained\n# in these scripts will be unencrypted\nPublishScripts/\n\n# NuGet Packages\n*.nupkg\n# The packages folder can be ignored because of Package Restore\n**/packages/*\n# except build/, which is used as an MSBuild target.\n!**/packages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/packages/repositories.config\n# NuGet v3's project.json files produces more ignoreable files\n*.nuget.props\n*.nuget.targets\n\n# Microsoft Azure Build Output\ncsx/\n*.build.csdef\n\n# Microsoft Azure Emulator\necf/\nrcf/\n\n# Windows Store app package directories and files\nAppPackages/\nBundleArtifacts/\nPackage.StoreAssociation.xml\n_pkginfo.txt\n\n# Visual Studio cache files\n# files ending in .cache can be ignored\n*.[Cc]ache\n# but keep track of directories ending in .cache\n!*.[Cc]ache/\n\n# Others\nClientBin/\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.jfm\n*.pfx\n*.publishsettings\nnode_modules/\norleans.codegen.cs\n\n# Since there are multiple workflows, uncomment next line to ignore bower_components\n# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)\n#bower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\n\n# SQL Server files\n*.mdf\n*.ldf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# GhostDoc plugin setting file\n*.GhostDoc.xml\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\n# Visual Studio LightSwitch build output\n**/*.HTMLClient/GeneratedArtifacts\n**/*.DesktopClient/GeneratedArtifacts\n**/*.DesktopClient/ModelManifest.xml\n**/*.Server/GeneratedArtifacts\n**/*.Server/ModelManifest.xml\n_Pvt_Extensions\n\n# Paket dependency manager\n.paket/paket.exe\npaket-files/\n\n# FAKE - F# Make\n.fake/\n\n# JetBrains Rider\n.idea/\n*.sln.iml\n\n# CodeRush\n.cr/\n\n# Python Tools for Visual Studio (PTVS)\n__pycache__/\n*.pyc\n/BinTest\n/BinTest - 副本/Config\n/生产\n/BinUnitTest\n"
},
{
"path": "ChangeLog.md",
"content": "# 更新日志\n\n## v3.0.2026.0501 (2026-05-01)\n\n### 问题修复\n- **[fix]** 修复 Pop/Ack/ChangeInvisibleTime 操作缺少 `queueId` 参数导致服务端处理异常的问题\n- **便利方法**：`MessageExt` 新增多个便利访问方法，简化消息属性读取\n\n### 依赖更新\n- 升级 NewLife.Core 依赖包到最新版本（2026-04-xx）\n\n---\n\n## v3.0.2026.0305 (2026-03-05)\n\n### 云适配重构（重大版本）\n- **架构重构**：全面升级为 v3.0 云适配架构，新增 `ICloudProvider` 接口统一阿里云、华为云、腾讯云适配\n- **事务消息**：新增 RocketMQ 事务消息发布与回查接口，支持分布式事务场景\n- **请求-应答模式**：新增 Request-Reply 同步调用模式，支持消息级 RPC\n\n### gRPC 协议支持\n- **gRPC 5.x Proxy**：新增 gRPC 协议支持，零依赖不引入第三方 Protobuf/gRPC 库\n- **SpanReader/SpanWriter 重构**：将 gRPC 协议编解码器重构为基于 `SpanReader`/`SpanWriter` 的零分配实现，提升性能\n- **gRPC Telemetry**：新增 gRPC Telemetry 链路追踪支持\n\n### 新增功能\n- **VIP 通道**：支持 VIP Channel 高优先级消息通道\n- **批量确认**：支持批量 Ack 操作，减少网络往返\n- **5.x MsgId**：支持 RocketMQ 5.x 消息 ID 格式生成与解析\n- **客户端拉取超时**：新增 `Consumer.PullTimeout` 客户端侧应用层超时保护，防止 4.9.8 无响应导致消费线程永久阻塞\n\n### 测试覆盖\n- 新增 152 个单元测试，覆盖协议层、模型层、工具类等核心组件\n- 完善架构文档与需求文档\n\n---\n\n## v2.7.2026.0301 (2026-03-01)\n\n### 问题修复\n- 新增`Consumer.PullTimeout`属性，默认值0表示自动取`SuspendTimeout+10_000ms`，作为客户端拉取消息的应用层超时保护，防止RocketMQ 4.9.8在SuspendTimeout后无响应导致消费线程永久阻塞\n\n## v2.7.2026.0201 (2026-02-01)\n\n### 依赖更新\n- 升级 NewLife.Core 依赖包到最新版本（2026-01-24）\n- 升级 NewLife.Core 依赖包（2026-01-14）\n- 升级 NewLife.Core 依赖包（2026-01-12）\n\n## v2.7.2026.0102 (2026-01-03)\n\n初始发布版本\n"
},
{
"path": "DLL/NewLife.Core.xml",
"content": "\n\n \n NewLife.Core\n \n \n \n 服务类型\n \n \n 服务主函数\n \n \n 服务程序基类\n \n \n 显示名\n \n \n 描述\n \n \n 初始化\n \n \n 服务主函数\n \n \n 显示状态\n \n \n 显示菜单\n \n \n 添加菜单\n \n \n \n \n \n 开始工作\n \n \n \n 停止服务\n \n \n \n 服务管理线程封装\n \n \n \n 检查内存是否超标\n 是否超标重启\n \n \n 检查服务进程的总线程数是否超标\n \n \n \n 检查服务进程的句柄数是否超标\n \n \n \n 服务开始时间\n \n \n 检查自动重启\n \n \n \n 重启服务\n \n \n \n 服务启动事件\n \n \n \n 服务停止事件\n \n \n 在系统关闭时执行。 指定在系统关闭之前应该发生什么。\n \n \n 在计算机的电源状态已发生更改时执行。 这适用于便携式计算机，当他们进入挂起模式，这不是系统关闭相同。\n \n \n \n \n 在终端服务器会话中接收的更改事件时执行\n \n \n \n 看门狗要保护的服务\n \n \n 检查看门狗。\n \n XAgent看门狗功能由管理线程完成，每分钟一次。\n 检查指定的任务是否已经停止，如果已经停止，则启动它。\n \n \n \n 安装、卸载 服务\n 是否安装\n \n \n 获取安装服务的命令参数\n \n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 服务助手\n \n \n Exe程序名\n \n \n 启动、停止 服务\n 服务对象\n \n \n \n 执行一个命令\n \n \n \n \n \n 执行SC命令\n \n \n \n 是否已安装\n \n \n 是否已启动\n \n \n 是否已安装\n \n \n 是否已启动\n \n \n 写日志\n \n \n \n \n 服务设置\n \n \n 服务名\n \n \n 显示名\n \n \n 服务描述\n \n \n 最大占用内存。超过最大占用时，整个服务进程将会重启，以释放资源。默认8096M\n \n \n 最大线程数。超过最大占用时，整个服务进程将会重启，以释放资源。默认1000个\n \n \n 最大句柄数。超过最大占用时，整个服务进程将会重启，以释放资源。默认10000\n \n \n 自动重启时间。到达自动重启时间时，整个服务进程将会重启，以释放资源。默认0分，表示无限\n \n \n 看门狗，保护其它服务，每分钟检查一次。多个服务名逗号分隔\n \n \n IP搜索\n \n \n 数据文件\n \n \n 获取IP地址\n \n \n \n \n 获取IP地址\n \n \n \n \n 数据流\n \n \n 析构\n \n \n 销毁\n \n \n 索引结构\n \n \n 缓存\n \n \n 默认缓存\n \n \n 名称\n \n \n 默认缓存时间。默认0秒表示不过期\n \n \n 获取和设置缓存，永不过期\n \n \n \n \n 缓存个数\n \n \n 所有键\n \n \n 构造函数\n \n \n 初始化配置\n \n \n \n 是否包含缓存项\n \n \n \n \n 设置缓存项\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 设置缓存项\n 键\n 值\n 过期时间\n \n \n \n 获取缓存项\n 键\n \n \n \n 批量移除缓存项\n 键集合\n \n \n \n 清空所有缓存项\n \n \n 设置缓存项有效期\n 键\n 过期时间，秒\n \n \n 获取缓存项有效期\n 键\n \n \n \n 批量获取缓存项\n \n \n \n \n \n 批量设置缓存项\n \n \n 过期时间，秒。小于0时采用默认缓存时间\n \n \n 获取列表\n 元素类型\n 键\n \n \n \n 获取哈希\n 元素类型\n 键\n \n \n \n 获取队列\n 元素类型\n 键\n \n \n \n 获取Set\n \n \n \n \n \n 添加，已存在时不更新\n 值类型\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 设置新值并获取旧值，原子操作\n 值类型\n 键\n 值\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 提交变更。部分提供者需要刷盘\n \n \n \n 申请分布式锁\n \n \n \n \n \n 多线程性能测试\n 随机读写\n 批量操作。默认0不分批\n \n Memory性能测试[顺序]，逻辑处理器 32 个 2,000MHz Intel(R) Xeon(R) CPU E5-2640 v2 @ 2.00GHz\n \n 测试 10,000,000 项， 1 线程\n 赋值 10,000,000 项， 1 线程，耗时 3,764ms 速度 2,656,748 ops\n 读取 10,000,000 项， 1 线程，耗时 1,296ms 速度 7,716,049 ops\n 删除 10,000,000 项， 1 线程，耗时 1,230ms 速度 8,130,081 ops\n \n 测试 20,000,000 项， 2 线程\n 赋值 20,000,000 项， 2 线程，耗时 3,088ms 速度 6,476,683 ops\n 读取 20,000,000 项， 2 线程，耗时 1,051ms 速度 19,029,495 ops\n 删除 20,000,000 项， 2 线程，耗时 1,011ms 速度 19,782,393 ops\n \n 测试 40,000,000 项， 4 线程\n 赋值 40,000,000 项， 4 线程，耗时 3,060ms 速度 13,071,895 ops\n 读取 40,000,000 项， 4 线程，耗时 1,023ms 速度 39,100,684 ops\n 删除 40,000,000 项， 4 线程，耗时 994ms 速度 40,241,448 ops\n \n 测试 80,000,000 项， 8 线程\n 赋值 80,000,000 项， 8 线程，耗时 3,124ms 速度 25,608,194 ops\n 读取 80,000,000 项， 8 线程，耗时 1,171ms 速度 68,317,677 ops\n 删除 80,000,000 项， 8 线程，耗时 1,199ms 速度 66,722,268 ops\n \n 测试 320,000,000 项， 32 线程\n 赋值 320,000,000 项， 32 线程，耗时 13,857ms 速度 23,093,021 ops\n 读取 320,000,000 项， 32 线程，耗时 1,950ms 速度 164,102,564 ops\n 删除 320,000,000 项， 32 线程，耗时 3,359ms 速度 95,266,448 ops\n \n 测试 320,000,000 项， 64 线程\n 赋值 320,000,000 项， 64 线程，耗时 9,648ms 速度 33,167,495 ops\n 读取 320,000,000 项， 64 线程，耗时 1,974ms 速度 162,107,396 ops\n 删除 320,000,000 项， 64 线程，耗时 1,907ms 速度 167,802,831 ops\n \n 测试 320,000,000 项，256 线程\n 赋值 320,000,000 项，256 线程，耗时 12,429ms 速度 25,746,238 ops\n 读取 320,000,000 项，256 线程，耗时 1,907ms 速度 167,802,831 ops\n 删除 320,000,000 项，256 线程，耗时 2,350ms 速度 136,170,212 ops\n \n \n \n 使用指定线程测试指定次数\n 次数\n 线程\n 随机读写\n 批量操作\n \n \n 读取测试\n 键\n 次数\n 线程\n 随机读写\n 批量操作\n \n \n 赋值测试\n 键\n 次数\n 线程\n 随机读写\n 批量操作\n \n \n 累加测试\n 键\n 次数\n 线程\n 随机读写\n 批量操作\n \n \n 删除测试\n 键\n 次数\n 线程\n 随机读写\n \n \n 已重载。\n \n \n \n 分布式锁\n \n \n 键\n \n \n 实例化\n \n \n \n \n 申请锁\n \n \n \n \n 销毁\n \n \n \n 缓存接口\n \n \n 名称\n \n \n 默认缓存时间。默认0秒表示不过期\n \n \n 获取和设置缓存，永不过期\n \n \n \n \n 缓存个数\n \n \n 所有键\n \n \n 是否包含缓存项\n \n \n \n \n 设置缓存项\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 设置缓存项\n 键\n 值\n 过期时间\n \n \n \n 获取缓存项\n 键\n \n \n \n 批量移除缓存项\n 键集合\n \n \n \n 清空所有缓存项\n \n \n 设置缓存项有效期\n 键\n 过期时间\n \n \n 获取缓存项有效期\n 键\n \n \n \n 批量获取缓存项\n \n \n \n \n \n 批量设置缓存项\n \n \n 过期时间，秒。小于0时采用默认缓存时间\n \n \n 获取列表\n 元素类型\n 键\n \n \n \n 获取哈希\n 元素类型\n 键\n \n \n \n 获取队列\n 元素类型\n 键\n \n \n \n 获取Set\n \n \n \n \n \n 添加，已存在时不更新\n 值类型\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 设置新值并获取旧值，原子操作\n \n 常常配合Increment使用，用于累加到一定数后重置归零，又避免多线程冲突。\n \n 值类型\n 键\n 值\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 提交变更。部分提供者需要刷盘\n \n \n \n 申请分布式锁\n 要锁定的key\n \n \n \n \n 多线程性能测试\n 随机读写\n 批量操作。默认0不分批\n \n \n 生产者消费者接口\n \n \n \n 生产添加\n \n \n \n \n 消费获取\n \n \n \n \n 默认字典缓存\n \n \n 缓存核心\n \n \n 容量。容量超标时，采用LRU机制删除，默认100_000\n \n \n 定时清理时间，默认60秒\n \n \n 实例化一个内存字典缓存\n \n \n 销毁\n \n \n \n 缓存项。原子计数\n \n \n 所有键。实际返回只读列表新实例，数据量较大时注意性能\n \n \n 初始化配置\n \n \n \n 获取或添加缓存项\n 值类型\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 是否包含缓存项\n \n \n \n \n 添加缓存项，已存在时更新\n 值类型\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 获取缓存项，不存在时返回默认值\n 键\n \n \n \n 批量移除缓存项\n 键集合\n 实际移除个数\n \n \n 清空所有缓存项\n \n \n 设置缓存项有效期\n 键\n 过期时间\n 设置是否成功\n \n \n 获取缓存项有效期，不存在时返回Zero\n 键\n \n \n \n 添加，已存在时不更新，常用于锁争夺\n 值类型\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 设置新值并获取旧值，原子操作\n 值类型\n 键\n 值\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 获取列表\n \n \n \n \n \n 获取哈希\n \n \n \n \n \n 获取队列\n \n \n \n \n \n 获取Set\n 基于HashSet，非线程安全\n \n \n \n \n \n 获取 或 添加 缓存项\n \n \n \n \n \n 缓存项\n \n \n 数值\n \n \n 过期时间\n \n \n 是否过期\n \n \n 访问时间\n \n \n 构造缓存项\n \n \n \n \n 设置数值和过期时间\n \n \n \n \n 更新访问时间并返回数值\n \n \n \n 设置过期时间\n \n \n \n 递增\n \n \n \n \n 递减\n \n \n \n \n 清理会话计时器\n \n \n 移除过期的缓存项\n \n \n 使用指定线程测试指定次数\n 次数\n 线程\n 随机读写\n 批量操作\n \n \n 生产者消费者\n \n \n \n 实例化内存队列\n \n \n 实例化内存队列\n \n \n \n 生产添加\n \n \n \n \n 消费获取\n \n \n \n \n Redis缓存\n \n \n 创建指定服务器的实例\n 服务器地址。支持前面加上密码，@分隔\n 使用的数据库\n \n \n \n 创建指定服务器的实例，支持密码\n 服务器地址。支持前面加上密码，@分隔\n 密码\n 使用的数据库\n \n \n \n 服务器\n \n \n 密码\n \n \n 目标数据库。默认0\n \n \n 出错重试次数。如果出现协议解析错误，可以重试的次数，默认3\n \n \n 完全管道。读取操作是否合并进入管道，默认false\n \n \n 自动管道。管道操作达到一定数量时，自动提交，默认0\n \n \n 性能计数器\n \n \n 初始化\n \n \n \n 销毁\n \n \n \n 已重载。\n \n \n \n 为同一服务器创建不同Db的子级库\n \n \n \n \n 连接池\n \n \n 执行命令\n 返回类型\n 命令key，用于选择集群节点\n 回调函数\n 是否写入操作\n \n \n \n 开始管道模式\n \n \n 结束管道模式\n 要求结果。默认false\n \n \n 提交变更。处理某些残留在管道里的命令\n \n \n \n 缓存个数\n \n \n 所有键\n \n \n 单个实体项\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n 获取单体\n 键\n \n \n 批量移除缓存项\n 键集合\n \n \n 清空所有缓存项\n \n \n 是否存在\n 键\n \n \n 设置缓存项有效期\n 键\n 过期时间\n \n \n 获取缓存项有效期\n 键\n \n \n \n 批量获取缓存项\n \n \n \n \n \n 批量设置缓存项\n \n \n 过期时间，秒。小于0时采用默认缓存时间\n \n \n 添加，已存在时不更新\n 值类型\n 键\n 值\n 过期时间，秒。小于0时采用默认缓存时间\n \n \n \n 设置新值并获取旧值，原子操作\n 值类型\n 键\n 值\n \n \n \n 累加，原子操作\n 键\n 变化量\n \n \n \n 累加，原子操作，乘以100后按整数操作\n 键\n 变化量\n \n \n \n 递减，原子操作\n 键\n 变化量\n \n \n \n 递减，原子操作，乘以100后按整数操作\n 键\n 变化量\n \n \n \n 性能测试\n \n Redis性能测试[随机]，批大小[100]，逻辑处理器 40 个 2,400MHz Intel(R) Xeon(R) CPU E5-2640 v4 @ 2.40GHz\n 测试 100,000 项， 1 线程\n 赋值 100,000 项， 1 线程，耗时 418ms 速度 239,234 ops\n 读取 100,000 项， 1 线程，耗时 520ms 速度 192,307 ops\n 删除 100,000 项， 1 线程，耗时 125ms 速度 800,000 ops\n 测试 200,000 项， 2 线程\n 赋值 200,000 项， 2 线程，耗时 548ms 速度 364,963 ops\n 读取 200,000 项， 2 线程，耗时 549ms 速度 364,298 ops\n 删除 200,000 项， 2 线程，耗时 315ms 速度 634,920 ops\n 测试 400,000 项， 4 线程\n 赋值 400,000 项， 4 线程，耗时 694ms 速度 576,368 ops\n 读取 400,000 项， 4 线程，耗时 697ms 速度 573,888 ops\n 删除 400,000 项， 4 线程，耗时 438ms 速度 913,242 ops\n 测试 800,000 项， 8 线程\n 赋值 800,000 项， 8 线程，耗时 1,206ms 速度 663,349 ops\n 读取 800,000 项， 8 线程，耗时 1,236ms 速度 647,249 ops\n 删除 800,000 项， 8 线程，耗时 791ms 速度 1,011,378 ops\n 测试 4,000,000 项， 40 线程\n 赋值 4,000,000 项， 40 线程，耗时 4,848ms 速度 825,082 ops\n 读取 4,000,000 项， 40 线程，耗时 5,399ms 速度 740,877 ops\n 删除 4,000,000 项， 40 线程，耗时 6,281ms 速度 636,841 ops\n 测试 4,000,000 项， 64 线程\n 赋值 4,000,000 项， 64 线程，耗时 6,806ms 速度 587,716 ops\n 读取 4,000,000 项， 64 线程，耗时 5,365ms 速度 745,573 ops\n 删除 4,000,000 项， 64 线程，耗时 6,716ms 速度 595,592 ops\n \n 随机读写\n 批量操作\n \n \n 使用指定线程测试指定次数\n 次数\n 线程\n 随机读写\n 批量操作\n \n \n 日志\n \n \n 写日志\n \n \n \n \n Redis客户端\n \n 以极简原则进行设计，每个客户端不支持并行命令处理，可通过多客户端多线程解决。\n 收发共用64k缓冲区，所以命令请求和响应不能超过64k。\n \n \n \n 客户端\n \n \n 内容类型\n \n \n 密码\n \n \n 是否已登录\n \n \n 登录时间\n \n \n 是否正在处理命令\n \n \n 销毁\n \n \n \n 异步请求\n 新建连接\n \n \n \n 发出请求\n \n \n \n \n \n \n 接收响应\n \n \n \n \n \n 发出请求\n \n \n \n \n \n 重置。干掉历史残留数据\n \n \n 执行命令。返回字符串、Packet、Packet[]\n \n \n \n \n \n 执行命令。返回基本类型、对象、对象数组\n \n \n \n \n \n 尝试转换类型\n \n \n \n \n \n \n 管道命令个数\n \n \n 开始管道模式\n \n \n 结束管道模式\n 要求结果\n \n \n 心跳\n \n \n \n 选择Db\n \n \n \n \n 验证密码\n \n \n \n \n 退出\n \n \n \n 获取信息\n \n \n \n 设置\n \n \n \n 超时时间\n \n \n \n 读取\n \n \n \n \n \n 批量设置\n \n \n \n \n \n 批量获取\n \n \n \n \n \n 数值转字节数组\n \n \n \n \n 字节数组转对象\n \n \n \n \n \n 字节数组转对象\n \n \n \n \n \n 获取命令对应的字节数组，全局缓存\n \n \n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 并行哈希集合\n \n 主要用于频繁添加删除而又要遍历的场合\n \n \n \n 是否空集合\n \n \n 元素个数\n \n \n 是否包含元素\n \n \n \n \n 尝试添加\n \n \n \n \n 尝试删除\n \n \n \n \n 字典缓存。当指定键的缓存项不存在时，调用委托获取值，并写入缓存。\n 常用匿名函数或者Lambda表达式作为委托。\n 键类型\n 值类型\n \n \n 过期时间。单位是秒，默认0秒，表示永不过期\n \n \n 定时清理时间，默认0秒，表示不清理过期项\n \n \n 容量。容量超标时，采用LRU机制删除，默认10_000\n \n \n 是否允许缓存控制，避免缓存穿透。默认false\n \n \n 查找数据的方法\n \n \n 实例化一个字典缓存\n \n \n 实例化一个字典缓存\n \n \n \n 实例化一个字典缓存\n \n \n \n \n 销毁\n \n \n \n 缓存项\n \n \n 数值\n \n \n 过期时间\n \n \n 是否过期\n \n \n 访问时间\n \n \n 更新访问时间并返回数值\n \n \n \n 重写索引器。取值时如果没有该项则返回默认值；赋值时如果已存在该项则覆盖，否则添加。\n \n \n \n \n 获取 GetOrAdd\n \n \n \n \n 获取 GetOrAdd\n \n \n \n \n 设置 AddOrUpdate\n \n \n \n \n \n 尝试添加，或返回旧值\n \n \n \n \n \n \n \n 扩展获取数据项，当数据项不存在时，通过调用委托获取数据项。线程安全。\n 键\n 获取值的委托，该委托以键作为参数\n \n \n \n 移除指定缓存项\n \n \n \n \n 清空\n \n \n 缓存项。原子计数\n \n \n 是否包含指定键\n \n \n \n \n 赋值到目标缓存\n \n \n \n 清理会话计时器\n \n \n 移除过期的缓存项\n \n \n 枚举\n \n \n \n 集群管理\n \n \n \n \n 资源列表\n \n \n 打开\n \n \n 关闭\n 关闭原因。便于日志分析\n 是否成功\n \n \n 从集群中获取资源\n \n \n \n 归还\n \n \n \n 集群异常\n \n \n 资源\n \n \n 实例化\n \n \n \n \n 集群助手\n \n \n 借助集群资源处理事务\n \n \n \n \n \n \n \n \n 对集群进行多次调用\n \n \n \n \n \n \n \n \n 对象池接口\n \n \n \n 对象池大小\n \n \n 获取\n \n \n \n 归还\n \n \n \n 清空\n \n \n 对象池扩展\n \n \n 字符串构建器池\n \n \n 归还一个字符串构建器到对象池\n \n 是否需要返回结果\n \n \n \n 字符串构建器池\n \n \n 初始容量。默认100个\n \n \n 最大容量。超过该大小时不进入池内，默认4k\n \n \n 创建\n \n \n \n 归还\n \n \n \n \n 内存流池\n \n \n 归还一个内存流到对象池\n \n 是否需要返回结果\n \n \n \n 内存流池\n \n \n 初始容量。默认1024个\n \n \n 最大容量。超过该大小时不进入池内，默认64k\n \n \n 创建\n \n \n \n 归还\n \n \n \n \n 可空字典。获取数据时如果指定键不存在可返回空而不是抛出异常\n \n \n \n \n 实例化一个可空字典\n \n \n 指定比较器实例化一个可空字典\n \n \n \n 实例化一个可空字典\n \n \n \n \n 获取或设置与指定的属性是否有脏数据。\n \n \n \n \n 资源池。支持空闲释放，主要用于数据库连接池和网络连接池\n \n \n \n 名称\n \n \n 空闲个数\n \n \n 繁忙个数\n \n \n 最大个数。默认100，0表示无上限\n \n \n 最小个数。默认1\n \n \n 空闲清理时间。最小个数之上的资源超过空闲时间时被清理，默认10s\n \n \n 完全空闲清理时间。最小个数之下的资源超过空闲时间时被清理，默认0s永不清理\n \n \n 基础空闲集合。只保存最小个数，最热部分\n \n \n 扩展空闲集合。保存最小个数以外部分\n \n \n 借出去的放在这\n \n \n 实例化一个资源池\n \n \n 销毁\n \n \n \n 数值\n \n \n 过期时间\n \n \n 借出\n \n \n \n 借出时是否可用\n \n \n \n \n 申请资源包装项，Dispose时自动归还到池中\n \n \n \n 归还\n \n \n \n 归还时是否可用\n \n \n \n \n 清空已有对象\n \n \n 销毁\n \n \n \n 创建实例\n \n \n \n 总请求数\n \n \n 成功数\n \n \n 新创建数\n \n \n 释放数\n \n \n 平均耗时。单位ms\n \n \n 日志\n \n \n 写日志\n \n \n \n \n 资源池包装项，自动归还资源到池中\n \n \n \n 数值\n \n \n 池\n \n \n 包装项\n \n \n \n \n 销毁\n \n \n \n 轻量级对象池。数组无锁实现，高性能\n \n 内部 1+N 的存储结果，保留最热的一个对象在外层，便于快速存取。\n 数组具有极快的查找速度，结构体确保没有GC操作。\n \n \n \n \n 对象池大小。默认CPU*2，初始化后改变无效\n \n \n 实例化对象池。默认大小CPU*2\n \n \n \n 获取\n \n \n \n 归还\n \n \n \n \n 清空\n \n \n \n 创建实例\n \n \n \n 具有是否已释放和释放后事件的接口\n \n \n 是否已经释放\n \n \n 被销毁时触发事件\n \n \n 具有销毁资源处理的抽象基类\n \n \n /// <summary>子类重载实现资源释放逻辑时必须首先调用基类方法</summary>\n /// <param name=\"disposing\">从Dispose调用（释放所有资源）还是析构函数调用（释放非托管资源）。\n /// 因为该方法只会被调用一次，所以该参数的意义不太大。</param>\n protected override void OnDispose(bool disposing)\n {\n base.OnDispose(disposing);\n \n if (disposing)\n {\n // 如果是构造函数进来，不执行这里的代码\n }\n }\n \n \n \n \n 释放资源\n \n \n 是否已经释放\n \n \n 被销毁时触发事件\n \n \n 释放资源，参数表示是否由Dispose调用。该方法保证OnDispose只被调用一次！\n \n \n \n 子类重载实现资源释放逻辑时必须首先调用基类方法\n 从Dispose调用（释放所有资源）还是析构函数调用（释放非托管资源）。\n 因为该方法只会被调用一次，所以该参数的意义不太大。\n \n \n 析构函数\n \n 如果忘记调用Dispose，这里会释放非托管资源\n 如果曾经调用过Dispose，因为GC.SuppressFinalize(this)，不会再调用该析构函数\n \n \n \n 销毁助手。扩展方法专用\n \n \n 尝试销毁对象，如果有则调用\n \n \n \n \n 汉字拼音转换类\n \n \n 取拼音第一个字段 \n \n \n \n \n 取拼音第一个字段\n \n \n \n \n 取拼音第一个字段\n \n \n \n \n 获取单字拼音\n \n \n \n \n 把汉字转换成拼音(全拼)\n 汉字字符串\n 转换后的拼音(全拼)字符串\n \n \n 系统设置。提供系统名称、版本等基本设置。\n \n \n 系统设置。提供系统名称、版本等基本设置。泛型基类，可继承扩展。\n \n \n \n 系统名称\n \n \n 系统版本\n \n \n 显示名称\n \n \n 公司\n \n \n 开发者模式\n \n \n 启用\n \n \n 安装时间\n \n \n 实例化\n \n \n 新建配置\n \n \n 系统主程序集\n \n \n 运行时\n \n \n 是否控制台。用于判断是否可以执行一些控制台操作。\n \n \n 是否Mono环境\n \n \n 是否Web环境\n \n \n 是否Windows环境\n \n \n 是否Linux环境\n \n \n 是否OSX环境\n \n \n 7Zip\n \n \n 实例化\n \n \n 压缩文件\n \n \n \n \n \n 解压缩文件\n \n \n 是否覆盖目标同名文件\n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 二叉树\n \n \n 遍历所有二叉树\n \n \n \n \n 构建表达式树\n \n \n \n \n \n \n \n 遍历全排列\n \n \n \n \n \n 从4种运算符中挑选3个运算符\n \n \n \n \n \n 立方根\n \n \n \n \n 数学运算\n \n \n \n \n 数据行\n \n \n 数据表\n \n \n 行索引\n \n \n 构造数据行\n \n \n \n \n 基于列索引访问\n \n \n \n \n 基于列名访问\n \n \n \n \n 读取指定行的字段值\n \n \n \n \n \n 数据表\n \n \n 数据列\n \n \n 数据列类型\n \n \n 数据行\n \n \n 总函数\n \n \n 读取数据\n \n \n \n 从数据流读取\n \n \n \n 读取头部\n \n \n \n 读取数据\n \n \n \n \n \n 读取\n \n \n \n \n 从文件加载\n \n \n \n \n 写入数据流\n \n \n \n 写入头部到数据流\n \n \n \n 写入数据部分到数据流\n \n \n \n 转数据包\n \n \n \n 保存到文件\n \n \n \n \n 读取指定行的字段值\n \n \n \n \n \n \n 尝试读取指定行的字段值\n \n \n \n \n \n \n \n 根据名称找字段序号\n \n \n \n \n 数据集\n \n \n \n 克隆\n \n \n \n 获取枚举\n \n \n \n 地理地址\n \n \n 名称\n \n \n 坐标\n \n \n 地址\n \n \n 行政区域编码\n \n \n 国家\n \n \n 省份\n \n \n 城市\n \n \n 区县\n \n \n 乡镇\n \n \n 乡镇编码\n \n \n 街道\n \n \n \n \n \n 级别\n \n \n 精确打点\n \n \n 可信度。[0-100]\n \n \n 已重载。\n \n \n \n 地理区域\n \n \n 编码\n \n \n 名称\n \n \n 父级\n \n \n 中心\n \n \n 边界\n \n \n 级别\n \n \n 已重载。\n \n \n \n 经纬度坐标\n \n \n 经度\n \n \n 纬度\n \n \n 经纬度坐标\n \n \n 经纬度坐标\n \n \n \n 已重载\n \n \n \n 数据帧接口\n \n \n 数据包\n \n \n 远程地址\n \n \n 消息\n \n \n 用户数据\n \n \n 具有扩展数据的接口\n \n \n 数据项\n \n \n 设置 或 获取 数据项\n \n \n \n \n 数据过滤器\n \n \n 下一个过滤器\n \n \n 对封包执行过滤器\n \n \n \n 过滤器上下文\n \n \n 封包\n \n \n 过滤器助手\n \n \n 在链条里面查找指定类型的过滤器\n \n \n \n \n \n 数据过滤器基类\n \n \n 下一个过滤器\n \n \n 对封包执行过滤器\n \n \n \n 执行过滤\n \n 返回是否执行下一个过滤器\n \n \n 数据包\n \n \n 数据\n \n \n 偏移\n \n \n 长度\n \n \n 下一个链式包\n \n \n 总长度\n \n \n 根据数据区实例化\n \n \n \n \n \n 根据数组段实例化\n \n \n \n 从可扩展内存流实例化，尝试窃取内存流内部的字节数组，失败后拷贝\n 因数据包内数组窃取自内存流，需要特别小心，避免多线程共用\n \n \n \n 获取/设置 指定位置的字节\n \n \n \n \n 设置新的数据区\n 数据区\n 偏移\n 字节个数\n \n \n 截取子数据区\n 相对偏移\n 字节个数\n \n \n \n 查找目标数组\n 目标数组\n 本数组起始偏移\n 本数组搜索个数\n \n \n \n 附加一个包到当前包链的末尾\n \n \n \n 返回字节数组。如果是完整数组直接返回，否则截取\n 不一定是全新数据，如果需要全新数据请克隆\n \n \n \n 从封包中读取指定数据\n \n \n \n \n \n 返回数据段\n \n \n \n 返回数据段集合\n \n \n \n 获取封包的数据流形式\n \n \n \n 把封包写入到数据流\n \n \n \n 把封包写入到目标数组\n \n \n \n \n \n 异步复制到目标数据流\n \n \n \n \n 深度克隆一份数据包，拷贝数据区\n \n \n \n 以字符串表示\n 字符串编码，默认URF-8\n \n \n \n \n \n 以十六进制编码表示\n 最大显示多少个字节。默认-1显示全部\n 分隔符\n 分组大小，为0时对每个字节应用分隔符，否则对每个分组使用\n \n \n \n 重载类型转换，字节数组直接转为Packet对象\n \n \n \n \n 重载类型转换，一维数组直接转为Packet对象\n \n \n \n \n 已重载\n \n \n \n 分页参数信息\n \n \n 获取 或 设置 排序字段，前台接收，便于做安全性校验\n \n \n 获取 或 设置 是否降序\n \n \n 获取 或 设置 页面索引。从1开始，默认1\n 如果设定了开始行，分页时将不再使用PageIndex\n \n \n 获取 或 设置 页面大小。默认20，若为0表示不分页\n \n \n 获取 或 设置 总记录数\n \n \n 获取 页数\n \n \n 获取 或 设置 组合起来的排序字句。如果没有设置则取Sort+Desc，后台设置，不经过安全性校验\n \n \n 获取 或 设置 开始行\n 如果设定了开始行，分页时将不再使用PageIndex\n \n \n 获取 或 设置 是否获取总记录数，默认false\n \n \n 获取 或 设置 状态。用于传递统计等数据\n \n \n 获取 或 设置 是否获取统计，默认false\n \n \n 实例化分页参数\n \n \n 通过另一个分页参数来实例化当前分页参数\n \n \n \n 从另一个分页参数拷贝到当前分页参数\n \n \n \n \n 获取表示分页参数唯一性的键值，可用作缓存键\n \n \n \n 泛型事件参数\n \n \n \n 参数\n \n \n 使用参数初始化\n \n \n \n 弹出\n \n \n \n 泛型事件参数\n \n \n \n \n 参数\n \n \n 参数2\n \n \n 使用参数初始化\n \n \n \n \n 弹出\n \n \n \n \n 泛型事件参数\n \n \n \n \n \n 参数\n \n \n 参数2\n \n \n 参数3\n \n \n 使用参数初始化\n \n \n \n \n \n 弹出\n \n \n \n \n \n 泛型事件参数\n \n \n \n \n \n \n 参数\n \n \n 参数2\n \n \n 参数3\n \n \n 参数4\n \n \n 使用参数初始化\n \n \n \n \n \n \n 弹出\n \n \n \n \n \n \n 弱引用Action\n \n 常见的事件和委托，都包括两部分：对象和方法，当然如果委托到静态方法上，对象是为空的。\n 如果把事件委托到某个对象的方法上，同时就间接的引用了这个对象，导致其一直无法被回收，从而造成内存泄漏。\n 弱引用Action，原理就是把委托拆分，然后弱引用对象部分，需要调用委托的时候，再把对象“拉”回来，如果被回收了，就没有必要再调用它的方法了。\n \n \n \n \n 目标对象。弱引用，使得调用方对象可以被GC回收\n \n \n 委托方法\n \n \n 经过包装的新的委托\n \n \n 取消注册的委托\n \n \n 是否只使用一次，如果只使用一次，执行委托后马上取消注册\n \n \n 是否可用\n \n \n 实例化\n 目标对象\n 目标方法\n \n \n 实例化\n 目标对象\n 目标方法\n 取消注册回调\n 是否一次性事件\n \n \n 实例化\n 事件处理器\n \n \n 使用事件处理器、取消注册回调、是否一次性事件来初始化\n 事件处理器\n 取消注册回调\n 是否一次性事件\n \n \n 调用委托\n \n \n \n 把弱引用事件处理器转换为普通事件处理器\n \n \n \n \n 已重载\n \n \n \n X组件异常\n \n \n 初始化\n \n \n 初始化\n \n \n \n 初始化\n \n \n \n \n 初始化\n \n \n \n \n 初始化\n \n \n \n \n \n 初始化\n \n \n \n 异常事件参数\n \n \n 发生异常时进行的动作\n \n \n 异常\n \n \n 异常助手\n \n \n 是否对象已被释放异常\n \n \n \n \n 数学表达式\n \n \n 加法\n \n \n 减法\n \n \n 乘法\n \n \n 除法\n \n \n 实例化\n \n \n 计算运算符优先级\n \n \n \n \n 适配和替换\n \n \n \n \n 解逆波兰表达式\n 标准逆波兰表达式\n \n 逆波兰表达式的解\n \n \n 是否有效\n \n \n \n \n 转为浮点数\n \n \n \n \n \n 计算逆波兰表达式\n \n 最后压入数字堆栈的数字\n 首先压入数字堆栈的数字\n 操作运算符\n 返回计算结果\n \n \n 逆波兰表达式\n \n \n 左括号\n \n \n 右括号\n \n \n 连接符\n \n \n 空格\n \n \n 操作符数组\n \n \n 是否括号\n \n \n \n \n 是否括号\n \n \n \n \n 计算操作等级\n \n \n \n \n 是否括号匹配\n \n \n \n \n 适配器和替换\n \n \n \n \n 值\n \n \n 将中缀表达式转换为逆波兰表达式\n 标准中缀表达式\n 标准逆波兰表达式\n \n \n 是否有效\n \n \n \n \n 编译计算\n \n \n \n \n \n 与或非表达式\n \n \n 位与\n \n \n 位或\n \n \n 实例化\n \n \n 操作符等级\n \n \n \n \n 适配替换\n \n \n \n \n 容器\n \n \n 解逆波兰表达式\n 标准逆波兰表达式\n \n 逆波兰表达式的解\n \n \n 是否有效\n \n \n \n \n 所有掩码\n \n \n \n \n 停止话音播报\n \n \n \n Http请求响应基类\n \n \n 内容长度\n \n \n 内容类型\n \n \n 头部集合\n \n \n 获取/设置 头部\n \n \n \n \n 过期时间\n \n \n 是否已完整\n \n \n 主体长度\n \n \n 分析第一行\n \n \n \n 创建请求响应包\n \n \n \n \n 创建头部\n \n \n \n \n Http编解码器\n \n \n 写入数据\n \n \n \n \n \n 读取数据\n \n \n \n \n \n Http消息\n \n \n 是否响应\n \n \n 是否有错\n \n \n 单向请求\n \n \n 头部数据\n \n \n 负载数据\n \n \n 根据请求创建配对的响应消息\n \n \n \n 从数据包中读取消息\n \n 是否成功\n \n \n 把消息转为封包\n \n \n \n Http编码器\n \n \n 编码\n \n \n \n \n \n \n 解码参数\n \n \n \n \n \n 解码结果\n \n \n \n \n \n 转换为目标类型\n \n \n \n \n \n 创建请求\n \n \n \n \n \n 创建响应\n \n \n \n \n \n \n \n 解码 请求/响应\n 消息\n 服务动作\n 错误码\n 参数或结果\n \n \n \n Http帮助类\n \n \n 创建请求包\n \n \n \n \n \n \n \n 创建响应包\n \n \n \n \n \n \n 分析头部\n \n \n \n \n 建立握手包\n \n \n \n 握手\n \n \n \n \n 分析WS数据包\n \n \n \n \n 创建WS请求包\n \n \n \n \n Http请求\n \n \n Http方法\n \n \n 资源路径\n \n \n 用户代理\n \n \n 是否压缩\n \n \n 保持连接\n \n \n 可接受内容\n \n \n 接受语言\n \n \n 引用路径\n \n \n 分析第一行\n \n \n \n 创建头部\n \n \n \n \n Http响应\n \n \n 是否启用SSL\n \n \n 状态码\n \n \n 状态描述\n \n \n 分析第一行\n \n \n \n 创建头部\n \n \n \n \n 验证，如果失败则抛出异常\n \n \n Http服务器\n \n \n 实例化\n \n \n 迷你Http客户端。不支持https和302跳转\n \n \n 客户端\n \n \n 内容类型\n \n \n 内容长度\n \n \n 保持连接\n \n \n 状态码\n \n \n 超时时间。默认15s\n \n \n 头部集合\n \n \n 销毁\n \n \n \n 异步请求\n \n \n \n \n \n 异步发出请求，并接收响应\n \n \n \n \n \n 同步请求\n \n \n \n \n \n 异步发出请求，并接收响应\n \n \n \n \n \n 构造请求头\n \n \n \n \n \n 解析响应\n \n \n \n \n 根据主机获取对象池\n \n \n \n \n 异步获取\n 地址\n \n \n \n 同步获取\n \n \n \n \n Csv文件\n \n 支持整体读写以及增量式读写，目标是读写超大Csv文件\n \n \n \n 文件编码\n \n \n 分隔符。默认逗号\n \n \n 数据流实例化\n \n \n \n Csv文件实例化\n \n \n \n \n 销毁\n \n \n \n 读取一行\n \n \n \n 读取所有行\n \n \n \n 写入全部\n \n \n \n 写入一行\n \n \n \n 编码助手\n \n \n 检测文件编码\n 文件名\n \n \n \n 检测文件编码\n \n \n \n \n 检测数据流编码\n 数据流\n BOM检测失败时用于启发式探索的数据大小\n \n \n \n 检测字节数组编码\n 字节数组\n \n \n \n 检测BOM字节序\n \n \n \n \n 检测是否ASCII\n \n \n \n \n 启发式探测Unicode编码\n \n \n \n \n 是否可见ASCII\n \n \n \n \n 检测可能的UTF8序列长度\n \n \n \n \n \n 文件资源\n \n \n 释放文件\n \n \n \n \n \n \n 释放文件夹\n \n \n \n \n \n \n 释放文件夹\n \n \n \n \n \n \n \n 获取文件资源\n \n \n \n \n \n Json配置文件基类\n \n 标准用法：TConfig.Current\n \n 配置实体类通过特性指定配置文件路径以及自动更新时间。\n Current将加载配置文件，如果文件不存在或者加载失败，将实例化一个对象返回。\n \n 考虑到自动刷新，不提供LoadFile和SaveFile等方法，可通过扩展方法ToXmlFileEntity和ToXmlFile实现。\n \n 用户也可以通过配置实体类的静态构造函数修改基类的和来动态配置加载信息。\n \n \n \n \n 当前实例。通过置空可以使其重新加载。\n \n \n 一些设置。派生类可以在自己的静态构造函数中指定\n \n \n 是否调试\n \n \n 配置文件路径\n \n \n 重新加载时间。单位：毫秒\n \n \n 没有配置文件时是否保存新配置。默认true\n \n \n 配置文件\n \n \n 最后写入时间\n \n \n 过期时间。如果在这个时间之后再次访问，将检查文件修改时间\n \n \n 是否已更新。通过文件写入时间判断\n \n \n 设置过期重新加载配置的时间\n \n \n 是否新的配置文件\n \n \n 销毁\n \n \n \n 加载指定配置文件\n \n \n \n \n 从配置文件中读取完成后触发\n \n \n 保存到配置文件中去\n \n \n \n 保存到配置文件中去\n \n \n 异步保存\n \n \n 新创建配置文件时执行\n \n \n Json配置文件特性\n \n \n 配置文件名\n \n \n 重新加载时间。单位：毫秒\n \n \n 指定配置文件名\n \n \n \n 指定配置文件名和重新加载时间（毫秒）\n \n \n \n \n 依托于动作的日志类\n \n \n 方法\n \n \n 使用指定方法否则动作日志\n \n \n \n 写日志\n \n \n \n \n \n 已重载\n \n \n \n 代码性能计时器\n 参考了老赵（http://www.cnblogs.com/jeffreyzhao/archive/2009/03/10/codetimer.html）和eaglet（http://www.cnblogs.com/eaglet/archive/2009/03/10/1407791.html）两位的作品\n 为了保证性能比较的公平性，采用了多种指标，并使用计时器重写等手段来避免各种不必要的损耗\n \n \n 计时\n 次数\n 需要计时的委托\n 是否需要预热\n \n \n \n 计时，并用控制台输出行\n 标题\n 次数\n 需要计时的委托\n 是否需要预热\n \n \n 显示头部\n \n \n \n 次数\n \n \n 迭代方法，如不指定，则使用Time(int index)\n \n \n 是否显示控制台进度\n \n \n 进度\n \n \n CPU周期\n \n \n 线程时间，单位是ms\n \n \n GC代数\n \n \n 执行时间\n \n \n 实例化一个代码计时器\n \n \n 计时核心方法，处理进程和线程优先级\n \n \n 真正的计时\n \n \n 执行一次迭代，预热所有方法\n \n \n 迭代前执行，计算时间\n \n \n 每一次迭代，计算时间\n \n \n \n 迭代后执行，计算时间\n \n \n 基准时间\n \n \n 已重载。输出依次分别是：执行时间、CPU线程时间、时钟周期、GC代数\n \n \n \n 复合日志提供者，多种方式输出\n \n \n 日志提供者集合\n \n \n 实例化\n \n \n 实例化\n \n \n \n 实例化\n \n \n \n \n 添加一个日志提供者\n \n \n \n \n 删除日志提供者\n \n \n \n \n 写日志\n \n \n \n \n \n 从复合日志提供者中提取指定类型的日志提供者\n \n \n \n \n 已重载。\n \n \n \n 控制台输出日志\n \n \n 是否使用多种颜色，默认使用\n \n \n 写日志\n \n \n \n \n \n 已重载。\n \n \n \n 性能计数器接口\n \n \n 数值\n \n \n 次数\n \n \n 速度\n \n \n 平均耗时，单位us\n \n \n 增加\n 增加的数量\n 耗时，单位us\n \n \n 计数器助手\n \n \n 开始计时\n \n \n \n \n 结束计时\n \n \n \n \n 日志接口\n \n \n 写日志\n 日志级别\n 格式化字符串\n 格式化参数\n \n \n 调试日志\n 格式化字符串\n 格式化参数\n \n \n 信息日志\n 格式化字符串\n 格式化参数\n \n \n 警告日志\n 格式化字符串\n 格式化参数\n \n \n 错误日志\n 格式化字符串\n 格式化参数\n \n \n 严重错误日志\n 格式化字符串\n 格式化参数\n \n \n 是否启用日志\n \n \n 日志等级，只输出大于等于该级别的日志，默认Info，打开NewLife.Debug时默认为最低的Debug\n \n \n 日志基类。提供日志的基本实现\n \n \n 调试日志\n 格式化字符串\n 格式化参数\n \n \n 信息日志\n 格式化字符串\n 格式化参数\n \n \n 警告日志\n 格式化字符串\n 格式化参数\n \n \n 错误日志\n 格式化字符串\n 格式化参数\n \n \n 严重错误日志\n 格式化字符串\n 格式化参数\n \n \n 写日志\n \n \n \n \n \n 写日志\n \n \n \n \n \n 格式化参数，特殊处理异常和时间\n \n \n \n \n \n 是否启用日志。默认true\n \n \n 日志等级，只输出大于等于该级别的日志，默认Info，打开NewLife.Debug时默认为最低的Debug\n \n \n 空日志实现\n \n \n 输出日志头，包含所有环境信息\n \n \n 日志等级\n \n \n 打开所有日志记录\n \n \n 最低调试。细粒度信息事件对调试应用程序非常有帮助\n \n \n 普通消息。在粗粒度级别上突出强调应用程序的运行过程\n \n \n 警告\n \n \n 错误\n \n \n 严重错误\n \n \n 关闭所有日志记录\n \n \n 网络日志\n \n \n 网络套接字\n \n \n 远程服务器地址\n \n \n 实例化网络日志。默认广播到514端口\n \n \n 指定日志服务器地址来实例化网络日志\n \n \n \n 销毁\n \n \n 写日志\n \n \n \n \n \n 性能计数器。次数、TPS、平均耗时\n \n \n 是否启用。默认true\n \n \n 数值\n \n \n 次数\n \n \n 耗时，单位us\n \n \n 销毁\n \n \n \n 增加\n 增加的数量\n 耗时，单位us\n \n \n 采样间隔，默认1000毫秒\n \n \n 持续采样时间，默认60秒\n \n \n 当前速度\n \n \n 最大速度\n \n \n 最后一个采样周期的平均耗时，单位us\n \n \n 持续采样时间内的最大平均耗时，单位us\n \n \n 定期采样，保存最近60组到数组队列里面\n \n \n \n 已重载。输出统计信息\n \n \n \n 文本控件输出日志\n \n \n 文本控件\n \n \n 最大行数，超过该行数讲清空文本控件。默认1000行\n \n \n 写日志\n \n \n \n \n \n 在WinForm控件上输出日志，主要考虑非UI线程操作\n 不是常用功能，为了避免干扰常用功能，保持UseWinForm开头\n 要绑定日志输出的WinForm控件\n 日志\n 最大行数\n \n \n 文本文件日志类。提供向文本文件写日志的能力\n \n 2015-06-01 为了继承TextFileLog，增加了无参构造函数，修改了异步写日志方法为虚方法，可以进行重载\n \n \n \n 该构造函数没有作用，为了继承而设置\n \n \n 每个目录的日志实例应该只有一个，所以采用静态创建\n 日志目录或日志文件路径\n \n \n \n \n 每个目录的日志实例应该只有一个，所以采用静态创建\n 日志目录或日志文件路径\n \n \n \n 销毁\n \n \n 日志文件\n \n \n 日志目录\n \n \n 日志文件格式\n \n \n 是否当前进程的第一次写日志\n \n \n 初始化日志记录文件\n \n \n 写文件\n \n \n 关闭文件\n \n \n 写日志\n \n \n \n \n \n 已重载。\n \n \n \n 统计代码的时间消耗\n \n \n 名称\n \n \n 最大时间。毫秒\n \n \n 日志输出\n \n \n 指定最大执行时间来构造一个代码时间统计\n \n \n \n \n 析构\n \n \n \n 开始\n \n \n 停止\n \n \n 跟踪流。包装一个基础数据流，主要用于重写Read/Write等行为，跟踪程序操作数据流的过程\n \n \n 基础流\n \n \n 跟踪的成员\n \n \n 是否小端字节序。x86系列则采用Little-Endian方式存储数据；网络协议都是Big-Endian；\n \n 网络协议都是Big-Endian；\n Java编译的都是Big-Endian；\n Motorola的PowerPC是Big-Endian；\n x86系列则采用Little-Endian方式存储数据；\n ARM同时支持 big和little，实际应用中通常使用Little-Endian。\n \n \n \n 显示位置的步长，位移超过此长度后输出位置。默认16，设为0不输出位置\n \n \n 写入\n 缓冲区\n 偏移\n 数量\n \n \n 写入一个字节\n 数值\n \n \n 读取\n 缓冲区\n 偏移\n 数量\n \n \n \n 读取一个字节\n \n \n \n 异步开始读\n 缓冲区\n 偏移\n 数量\n \n \n \n \n \n 异步开始写\n 缓冲区\n 偏移\n 数量\n \n \n \n \n \n 异步读结束\n \n \n \n \n 异步写结束\n \n \n \n 设置流位置\n 偏移\n \n \n \n \n 关闭数据流\n \n \n 刷新缓冲区\n \n \n 设置长度\n 数值\n \n \n 可读\n \n \n 可搜索\n \n \n 可超时\n \n \n 可写\n \n \n 可读\n \n \n 读写超时\n \n \n 长度\n \n \n 位置\n \n \n 实例化跟踪流\n \n \n 实例化跟踪流\n \n \n \n 操作时触发\n \n \n 是否使用控制台\n \n \n 编码\n \n \n 写日志事件参数\n \n \n 日志等级\n \n \n 日志信息\n \n \n 异常\n \n \n 时间\n \n \n 线程编号\n \n \n 是否线程池线程\n \n \n 是否Web线程\n \n \n 线程名\n \n \n 任务编号\n \n \n 实例化一个日志事件参数\n \n \n 线程专有实例。线程静态，每个线程只用一个，避免GC浪费\n \n \n 初始化为新日志\n 日志等级\n 返回自身，链式写法\n \n \n 初始化为新日志\n 日志\n 异常\n 返回自身，链式写法\n \n \n 已重载。\n \n \n \n 设置当前线程输出日志时的线程名\n \n \n 日志类，包含跟踪调试功能\n \n 该静态类包括写日志、写调用栈和Dump进程内存等调试功能。\n \n 默认写日志到文本文件，可通过修改属性来增加日志输出方式。\n 对于控制台工程，可以直接通过UseConsole方法，把日志输出重定向为控制台输出，并且可以为不同线程使用不同颜色。\n \n \n \n 文本文件日志\n \n \n 日志提供者，默认使用文本文件日志\n \n \n 输出日志\n 信息\n \n \n 写日志\n \n \n \n \n 输出异常日志\n 异常信息\n \n \n \n 2012.11.05 修正初次调用的时候，由于同步BUG，导致Log为空的问题。\n \n \n \n 使用控制台输出日志，只能调用一次\n 是否使用颜色，默认使用\n 是否同时使用文件日志，默认使用\n \n \n 拦截WinForm异常并记录日志，可指定是否用显示。\n 发为捕获异常时，是否显示提示，默认显示\n \n \n 在WinForm控件上输出日志，主要考虑非UI线程操作\n 不是常用功能，为了避免干扰常用功能，保持UseWinForm开头\n 要绑定日志输出的WinForm控件\n 是否同时使用文件日志，默认使用\n 最大行数\n \n \n 控件绑定到日志，生成混合日志\n \n \n \n \n \n \n 是否调试。\n \n \n 文本日志目录\n \n \n 临时目录\n \n \n 输出核心库和启动程序的版本号\n \n \n 输出程序集版本\n \n \n \n 标准消息SRMP\n \n 标准网络封包协议：1 Flag + 1 Sequence + 2 Length + N Payload\n 1个字节标识位，标识请求、响应、错误、加密、压缩等；\n 1个字节序列号，用于请求响应包配对；\n 2个字节数据长度N，小端，指示后续负载数据长度（不包含头部4个字节），解决粘包问题；\n N个字节负载数据，数据内容完全由业务决定，最大长度65535=64k。\n 如：\n Open => OK\n 01-01-04-00-\"Open\" => 81-01-02-00-\"OK\"\n \n \n \n 标记位\n \n \n 序列号，匹配请求和响应\n \n \n 根据请求创建配对的响应消息\n \n \n \n 从数据包中读取消息\n \n 是否成功\n \n \n 把消息转为封包\n \n \n \n 获取数据包长度\n \n \n \n \n 消息摘要\n \n \n \n 消息命令\n \n \n 是否响应\n \n \n 是否有错\n \n \n 单向请求\n \n \n 负载数据\n \n \n 根据请求创建配对的响应消息\n \n \n \n 从数据包中读取消息\n \n 是否成功\n \n \n 把消息转为封包\n \n \n \n 消息命令基类\n \n \n 是否响应\n \n \n 是否有错\n \n \n 单向请求\n \n \n 负载数据\n \n \n 根据请求创建配对的响应消息\n \n \n \n 从数据包中读取消息\n \n 是否成功\n \n \n 把消息转为封包\n \n \n \n 收到消息时的事件参数\n \n \n 数据包\n \n \n 消息\n \n \n 用户数据。比如远程地址等\n \n \n 数据包编码器\n \n \n 缓存流\n \n \n 获取长度的委托\n \n \n 最后一次解包成功，而不是最后一次接收\n \n \n 缓存有效期。超过该时间后仍未匹配数据包的缓存数据将被抛弃\n \n \n 最大缓存待处理数据。默认0无限制\n \n \n 分析数据流，得到一帧数据\n 待分析数据包\n \n \n \n 检查缓存\n \n \n 无锁并行编程模型\n \n 独立线程轮询消息队列，简单设计避免影响默认线程池。\n 适用于任务颗粒较大的场合，例如IO操作。\n \n \n \n 添加消息，驱动内部处理\n 消息\n 发送者\n 返回待处理消息数\n \n \n Actor上下文\n \n \n 发送者\n \n \n 消息\n \n \n 无锁并行编程模型\n \n 独立线程轮询消息队列，简单设计避免影响默认线程池。\n \n \n \n 名称\n \n \n 是否启用\n \n \n 受限容量。最大可堆积的消息数\n \n \n 批大小。每次处理消息数，默认1，大于1表示启用批量处理模式\n \n \n 存放消息的邮箱。默认FIFO实现，外部可覆盖\n \n \n 实例化\n \n \n 销毁\n \n \n \n 已重载。显示名称\n \n \n \n 通知开始处理\n \n 添加消息时自动触发\n \n \n \n 开始时，返回执行线程包装任务，默认LongRunning\n \n \n \n 通知停止添加消息，并等待处理完成\n \n \n 添加消息，驱动内部处理\n 消息\n 发送者\n 返回待处理消息数\n \n \n 循环消费消息\n \n \n 循环消费消息\n \n \n 处理消息\n 上下文\n \n \n 批量处理消息\n 上下文集合\n \n \n 延迟队列。缓冲合并对象，批量处理\n \n 借助实体字典，缓冲实体对象，定期给字典换新，实现批量处理。\n \n 有可能外部拿到对象后，正在修改，内部恰巧执行批量处理，导致外部的部分修改未能得到处理。\n 解决办法是增加一个提交机制，外部用完后提交修改，内部需要处理时，等待一个时间。\n \n \n \n 名称\n \n \n 实体字典\n \n \n 跟踪数。达到该值时输出跟踪日志，默认1000\n \n \n 周期。默认10_000毫秒\n \n \n 最大个数。超过该个数时，进入队列将产生堵塞。默认100_000\n \n \n 批大小。默认5_000\n \n \n 等待借出对象确认修改的时间，默认3000ms\n \n \n 保存速度，每秒保存多少个实体\n \n \n 是否异步处理。true表示异步处理，共用DQ定时调度；false表示同步处理，独立线程\n \n \n 合并保存的总次数\n \n \n 实例化\n \n \n 销毁。统计队列销毁时保存数据\n \n \n \n 初始化\n \n \n 初始化\n \n \n 尝试添加\n \n \n \n \n \n 获取 或 添加 实体对象，在外部修改对象值\n \n 外部正在修改对象时，内部不允许执行批量处理\n \n \n \n \n \n \n \n 等待确认修改的借出对象数\n \n \n 提交对象的修改，外部不再使用该对象\n \n \n \n 当前缓存个数\n \n \n 定时处理全部数据\n \n \n \n 处理一批\n \n \n \n 发生错误\n \n \n \n \n 认证用户接口，具有登录验证、注册、在线等基本信息\n \n \n 密码\n \n \n 在线\n \n \n 登录次数\n \n \n 最后登录\n \n \n 最后登录IP\n \n \n 注册时间\n \n \n 注册IP\n \n \n 保存\n \n \n \n 用户接口工具类\n \n \n 比较密码相等\n \n \n \n \n \n 比较密码MD5\n \n \n \n \n \n 比较密码RC4\n \n \n \n \n \n 保存登录信息\n \n \n \n \n 保存注册信息\n \n \n \n \n 用于创建对象的工厂接口\n \n \n \n 创建对象实例\n \n \n \n \n 反射创建对象的工厂\n \n \n \n 创建对象实例\n \n \n \n \n 处理器\n \n \n 上一个处理器\n \n \n 下一个处理器\n \n \n 读取数据，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 写入数据，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 打开连接\n 上下文\n \n \n 关闭连接\n 上下文\n 原因\n \n \n 发生错误\n 上下文\n 异常\n \n \n 处理器\n \n \n 上一个处理器\n \n \n 下一个处理器\n \n \n 读取数据，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 写入数据，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 打开连接\n 上下文\n \n \n 关闭连接\n 上下文\n 原因\n \n \n 发生错误\n 上下文\n 异常\n \n \n 处理器上下文\n \n \n 管道\n \n \n 上下文拥有者\n \n \n 读取管道过滤后最终处理消息\n \n \n \n 写入管道过滤后最终处理消息\n \n \n \n 处理器上下文\n \n \n 管道\n \n \n 上下文拥有者\n \n \n 数据项\n \n \n 设置 或 获取 数据项\n \n \n \n \n 读取管道过滤后最终处理消息\n \n \n \n 写入管道过滤后最终处理消息\n \n \n \n 用户接口\n \n \n 编号\n \n \n 名称\n \n \n 昵称\n \n \n 启用\n \n \n 对象容器接口\n \n 1，如果容器里面没有这个类型，则返回空；\n 2，如果容器里面包含这个类型，返回单例；\n 3，如果容器里面包含这个类型，创建对象返回多实例；\n 4，如果有带参数构造函数，则从容器内获取各个参数的实例，最后创建对象返回。\n \n 这里有一点跟大多数对象容器非常不同，其它对象容器会控制对象的生命周期，在对象不再使用时收回到容器里面。\n 这里的对象容器主要是为了用于解耦，所以只有最简单的功能实现。\n \n 代码注册的默认优先级是0；\n 配置注册的默认优先级是1；\n 自动注册的外部实现（非排除项）的默认优先级是1，排除项的优先级是0；\n 所以，配置注册的优先级最高\n \n \n \n 注册类型和名称\n 接口类型\n 实现类型\n 实例\n 标识\n 优先级\n \n \n \n 遍历所有程序集的所有类型，自动注册实现了指定接口或基类的类型。如果没有注册任何实现，则默认注册第一个排除类型\n 自动注册一般用于单实例功能扩展型接口\n 接口或基类\n 要排除的类型，一般是内部默认实现\n \n \n \n 解析类型指定名称的实例\n 接口类型\n 标识\n \n \n \n 解析类型指定名称的实例\n 接口类型\n 标识\n \n \n \n 解析接口指定名称的实现类型\n 接口类型\n 标识\n \n \n \n 解析接口所有已注册的对象映射\n 接口类型\n \n \n \n 对象映射接口\n \n \n 名称\n \n \n 实现类型\n \n \n 对象实例\n \n \n 管道。进站顺序，出站逆序\n \n \n 头部处理器\n \n \n 尾部处理器\n \n \n 添加处理器到开头\n 处理器\n \n \n \n 添加处理器到末尾\n 处理器\n \n \n \n 添加处理器到指定名称之前\n 基准处理器\n 处理器\n \n \n \n 添加处理器到指定名称之后\n 基准处理器\n 处理器\n \n \n \n 删除处理器\n 处理器\n \n \n \n 读取数据，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 写入数据，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 打开连接\n 上下文\n \n \n 关闭连接\n 上下文\n 原因\n \n \n 发生错误\n 上下文\n 异常\n \n \n 管道。进站顺序，出站逆序\n \n \n 头部处理器\n \n \n 尾部处理器\n \n \n 添加处理器到开头\n 处理器\n \n \n \n 添加处理器到末尾\n 处理器\n \n \n \n 添加处理器到指定名称之前\n 基准处理器\n 处理器\n \n \n \n 添加处理器到指定名称之后\n 基准处理器\n 处理器\n \n \n \n 删除处理器\n 处理器\n \n \n \n 读取数据，顺序过滤消息，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 写入数据，逆序过滤消息，返回结果作为下一个处理器消息\n 上下文\n 消息\n \n \n 打开连接\n 上下文\n \n \n 关闭连接\n 上下文\n 原因\n \n \n 发生错误\n 上下文\n 异常\n \n \n 枚举器\n \n \n \n 通用插件接口\n \n 为了方便构建一个简单通用的插件系统，先规定如下：\n 1，负责加载插件的宿主，在加载插件后会进行插件实例化，此时可在插件构造函数中做一些事情，但不应该开始业务处理，因为宿主的准备工作可能尚未完成\n 2，宿主一切准备就绪后，会顺序调用插件的Init方法，并将宿主标识传入，插件通过标识区分是否自己的目标宿主。插件的Init应尽快完成。\n 3，如果插件实现了接口，宿主最后会清理资源。\n \n \n \n 初始化\n 插件宿主标识\n 服务提供者\n 返回初始化是否成功。如果当前宿主不是所期待的宿主，这里返回false\n \n \n 插件特性。用于判断某个插件实现类是否支持某个宿主\n \n \n 插件宿主标识\n \n \n 实例化\n \n \n \n 插件管理器\n \n \n 宿主标识，用于供插件区分不同宿主\n \n \n 宿主服务提供者\n \n \n 插件集合\n \n \n 日志提供者\n \n \n 实例化一个插件管理器\n \n \n 使用宿主对象实例化一个插件管理器\n \n \n \n 子类重载实现资源释放逻辑时必须首先调用基类方法\n 从Dispose调用（释放所有资源）还是析构函数调用（释放非托管资源）。\n 因为该方法只会被调用一次，所以该参数的意义不太大。\n \n \n 加载插件。此时是加载所有插件，无法识别哪些是需要的\n \n \n 开始初始化。初始化之后，不属于当前宿主的插件将会被过滤掉\n \n \n 服务接口。\n 服务代理XAgent可以附加代理实现了IServer接口的服务。\n \n \n 开始\n \n \n 停止\n 关闭原因。便于日志分析\n \n \n 实现 接口的对象容器\n \n 1，如果容器里面没有这个类型，则返回空；\n 2，如果容器里面包含这个类型，返回单例；\n 3，如果容器里面包含这个类型，创建对象返回多实例；\n 4，如果有带参数构造函数，则从容器内获取各个参数的实例，最后创建对象返回。\n \n 这里有一点跟大多数对象容器非常不同，其它对象容器会控制对象的生命周期，在对象不再使用时收回到容器里面。\n 这里的对象容器主要是为了用于解耦，所以只有最简单的功能实现。\n \n 代码注册的默认优先级是0；\n 配置注册的默认优先级是1；\n 自动注册的外部实现（非排除项）的默认优先级是1，排除项的优先级是0；\n 所以，配置注册的优先级最高\n \n \n \n 当前容器\n \n \n 初始化一个对象容器实例，自动从配置文件中加载注册\n \n \n 不存在又不添加时返回空列表\n \n \n \n \n \n 名称\n \n \n 实现类型\n \n \n 优先级\n \n \n 实例\n \n \n 注册\n 接口类型\n 实现类型\n 实例\n 标识\n 优先级\n \n \n \n 遍历所有程序集的所有类型，自动注册实现了指定接口或基类的类型。如果没有注册任何实现，则默认注册第一个排除类型\n 自动注册一般用于单实例功能扩展型接口\n 接口或基类\n 要排除的类型，一般是内部默认实现\n \n \n \n 解析类型指定名称的实例\n 接口类型\n 标识\n \n \n \n 解析类型指定名称的实例\n 接口类型\n 标识\n \n \n \n 解析接口指定名称的实现类型\n 接口类型\n 标识\n \n \n \n 解析接口所有已注册的对象映射\n 接口类型\n \n \n \n 已重载。\n \n \n \n 消息匹配队列接口。用于把响应数据包配对到请求包\n \n \n 加入请求队列\n 拥有者\n 请求消息\n 超时取消时间\n 任务源\n \n \n 检查请求队列是否有匹配该响应的请求\n 拥有者\n 响应消息\n 任务结果\n 用于检查匹配的回调\n \n \n \n 清空队列\n \n \n 消息匹配队列。子类可重载以自定义请求响应匹配逻辑\n \n \n 加入请求队列\n 拥有者\n 请求的数据\n 超时取消时间\n 任务源\n \n \n 检查请求队列是否有匹配该响应的请求\n 拥有者\n 响应消息\n 任务结果\n 用于检查匹配的回调\n \n \n \n 定时检查发送队列，超时未收到响应则重发\n \n \n \n 清空队列\n \n \n 长度字段作为头部\n \n \n 长度所在位置\n \n \n 长度占据字节数，1/2/4个字节，0表示压缩编码整数，默认2\n \n \n 过期时间，超过该时间后按废弃数据处理，默认500ms\n \n \n 编码\n \n \n \n \n \n 解码\n \n \n \n \n \n 连接关闭时，清空粘包编码器\n \n \n \n \n \n 消息封包\n \n \n 消息队列。用于匹配请求响应包\n \n \n 调用超时时间。默认30_000ms\n \n \n 使用数据包，写入时数据包转消息，读取时消息自动解包返回数据负载。默认true\n \n \n 写入数据\n \n \n \n \n \n 编码\n \n \n \n \n \n 加入队列\n \n \n \n \n \n 连接关闭时，清空粘包编码器\n \n \n \n \n \n 读取数据\n \n \n \n \n \n 解码\n \n \n \n \n \n 是否匹配响应\n \n \n \n \n \n 从数据流中获取整帧数据长度\n \n \n \n 数据帧长度（包含头部长度位）\n \n \n \n 按指定分割字节来处理粘包的处理器\n \n \n 默认以\"0x0D 0x0A\"即换行来分割，分割的包包含分割字节本身，使用时请注意。\n 默认分割方式：ISocket.Add<SplitDataCodec>()\n 自定义分割方式：ISocket.Add(new SplitDataHandler { SplitData = 自定义分割字节数组 })\n 自定义最大缓存大小方式：ISocket.Add(new SplitDataHandler { MaxCacheDataLength = 2048 })\n 自定义方式：ISocket.Add(new SplitDataHandler { MaxCacheDataLength = 2048, SplitData = 自定义分割字节数组 })\n \n \n \n \n 粘包分割字节数据（默认0x0D,0x0A）\n \n \n \n \n 最大缓存待处理数据（字节）\n \n \n \n 读取数据\n \n \n \n \n \n 连接关闭时，清空粘包编码器\n \n \n \n \n \n 解码\n \n 包\n \n \n \n \n 获取包含分割字节在内的数据长度\n \n \n \n \n \n 标准网络封包。头部4字节定长\n \n \n 写入数据\n \n \n \n \n \n 加入队列\n \n \n \n \n \n 解码\n \n \n \n \n \n 是否匹配响应\n \n \n \n \n \n 连接关闭时，清空粘包编码器\n \n \n \n \n \n 网络服务会话接口\n \n 所有应用服务器以会话作为业务处理核心。\n 应用服务器收到新会话请求后，通过启动一个会话处理。\n 会话进行业务处理的过程中，可以通过多个Send方法向客户端发送数据。\n \n \n \n 编号\n \n \n 主服务\n \n \n Socket服务器。当前通讯所在的Socket服务器，其实是TcpServer/UdpServer\n \n \n 客户端。跟客户端通讯的那个Socket，其实是服务端TcpSession/UdpSession\n \n \n 客户端地址\n \n \n 开始会话处理。\n \n \n 发送数据\n 数据包\n \n \n 发送数据流\n \n \n \n \n 发送字符串\n \n \n \n \n 异步发送并等待响应\n \n \n \n \n 数据到达事件\n \n \n 会话事件参数\n \n \n 会话\n \n \n 基础Socket接口\n \n 封装所有基础接口的共有特性！\n \n 核心设计理念：事件驱动，接口统一，简单易用！\n 异常处理理念：确保主流程简单易用，特殊情况的异常通过事件处理！\n \n \n \n 名称。主要用于日志输出\n \n \n 基础Socket对象\n \n \n 本地地址\n \n \n 端口\n \n \n 管道\n \n \n 是否抛出异常，默认false不抛出。Send/Receive时可能发生异常，该设置决定是直接抛出异常还是通过事件\n \n \n 异步处理接收到的数据。\n 异步处理有可能造成数据包乱序，特别是Tcp。true利于提升网络吞吐量。false避免拷贝，提升处理速度\n \n \n 发送统计\n \n \n 接收统计\n \n \n 日志提供者\n \n \n 是否输出发送日志。默认false\n \n \n 是否输出接收日志。默认false\n \n \n 已重载。日志加上前缀\n \n \n \n \n 错误发生/断开连接时\n \n \n 远程通信Socket，仅具有收发功能\n \n \n \n 标识\n \n \n \n 远程地址\n \n \n 通信开始时间\n \n \n 最后一次通信时间，主要表示会话活跃时间，包括收发\n \n \n 缓冲区大小\n \n \n 发送数据\n \n 目标地址由决定\n \n 数据包\n 是否成功\n \n \n 接收数据。阻塞当前线程等待返回\n \n \n \n 数据到达事件\n \n \n 异步发送数据并等待响应\n 消息\n \n \n \n 发送消息\n 消息\n \n \n \n 处理数据帧\n 数据帧\n \n \n 远程通信Socket扩展\n \n \n 获取统计信息\n \n \n \n \n 发送数据流\n 会话\n 数据流\n 返回是否成功\n \n \n 发送字符串\n 会话\n 要发送的字符串\n 文本编码，默认null表示UTF-8编码\n 返回自身，用于链式写法\n \n \n 异步多次发送数据\n 会话\n 数据包\n 次数\n 间隔\n \n \n \n 接收字符串\n 会话\n 文本编码，默认null表示UTF-8编码\n \n \n \n 添加处理器\n \n 会话\n \n \n 添加处理器\n 会话\n 处理器\n \n \n Socket客户端\n \n 具备打开关闭\n \n \n \n 超时。默认3000ms\n \n \n 是否活动\n \n \n 打开\n 是否成功\n \n \n 关闭\n 关闭原因。便于日志分析\n 是否成功\n \n \n 打开后触发。\n \n \n 关闭后触发。可实现掉线重连\n \n \n Socket服务器接口\n \n \n 是否活动\n \n \n 会话超时时间。默认20*60秒\n \n 对于每一个会话连接，如果超过该时间仍然没有收到任何数据，则断开会话连接。\n \n \n \n 会话统计\n \n \n 会话集合。用地址端口作为标识，业务应用自己维持地址端口与业务主键的对应关系。\n \n \n 新会话时触发\n \n \n 服务端通信Socket扩展\n \n \n 获取统计信息\n \n \n \n \n 用于与对方进行通讯的Socket会话，仅具有收发功能，也专用于上层应用收发数据\n \n Socket会话发送数据不需要指定远程地址，因为内部已经具有。\n 接收数据时，Tcp接收全部数据，而Udp只接受来自所属远方的数据。\n \n Socket会话不具有连接和断开的能力，所以需要外部连接好之后再创建Socket会话。\n 但是会话可以销毁，来代替断开。\n 对于Udp额外创建的会话来说，仅仅销毁会话而已。\n \n 所以，它必须具有收发数据的能力。\n \n \n \n Socket服务器。当前通讯所在的Socket服务器，其实是TcpServer/UdpServer\n \n \n 会话事件参数\n \n \n 会话\n \n \n 帧数据传输接口\n 实现者确保数据以包的形式传输，屏蔽数据的粘包和拆包\n \n \n 超时\n \n \n 打开\n \n \n 关闭\n \n \n 写入数据\n 数据包\n \n \n 读取数据\n \n \n \n 数据到达事件\n \n \n 网络异常\n \n \n 初始化\n \n \n 初始化\n \n \n \n 初始化\n \n \n \n \n 初始化\n \n \n \n \n 初始化\n \n \n \n 网络处理器上下文\n \n \n 远程连接\n \n \n 数据帧\n \n \n 读取管道过滤后最终处理消息\n \n \n \n 写入管道过滤后最终处理消息\n \n \n \n 网络服务器。可同时支持多个Socket服务器，同时支持IPv4和IPv6，同时支持Tcp和Udp\n \n 网络服务器模型，所有网络应用服务器可以通过继承该类实现。\n 该类仅实现了业务应用对网络流的操作，与具体网络协议无关。\n \n 收到请求后，会建立会话，并加入到会话集合中，然后启动会话处理；\n \n 快速用法：\n 指定端口后直接，NetServer将同时监听Tcp/Udp和IPv4/IPv6（会检查是否支持）四个端口。\n \n 简单用法：\n 重载方法来创建一个SocketServer并赋值给属性，将会在时首先被调用。\n \n 标准用法：\n 使用方法向网络服务器添加Socket服务，其中第一个将作为默认Socket服务。\n 如果Socket服务集合为空，将依据地址、端口、地址族、协议创建默认Socket服务。\n 如果地址族指定为IPv4和IPv6以外的值，将同时创建IPv4和IPv6两个Socket服务；\n 如果协议指定为Tcp和Udp以外的值，将同时创建Tcp和Udp两个Socket服务；\n 默认情况下，地址族和协议都是其它值，所以一共将会创建四个Socket服务（Tcp、Tcpv6、Udp、Udpv6）。\n \n \n \n 服务名\n \n \n 本地结点\n \n \n 端口\n \n \n 协议类型\n \n \n 寻址方案\n \n \n 服务器集合\n \n \n 服务器。返回服务器集合中的第一个服务器\n \n \n 是否活动\n \n \n 会话超时时间。默认0秒，使用SocketServer默认值\n \n 对于每一个会话连接，如果超过该时间仍然没有收到任何数据，则断开会话连接。\n \n \n \n 管道\n \n \n 使用会话集合，允许遍历会话。默认true\n \n \n 会话统计\n \n \n 发送统计\n \n \n 接收统计\n \n \n 是否输出发送日志。默认false\n \n \n 是否输出接收日志。默认false\n \n \n 用户会话数据\n \n \n 获取/设置 用户会话数据\n \n \n \n \n 实例化一个网络服务器\n \n \n 通过指定监听地址和端口实例化一个网络服务器\n \n \n \n 通过指定监听地址和端口实例化一个网络服务器\n \n \n \n \n 通过指定监听地址和端口，还有协议，实例化一个网络服务器，默认支持Tcp协议和Udp协议\n \n \n \n \n \n 已重载。释放会话集合等资源\n \n \n \n 添加Socket服务器\n \n 添加是否成功\n \n \n 同时添加指定端口的IPv4和IPv6服务器，如果协议不是指定的Tcp或Udp，则同时添加Tcp和Udp服务器\n \n \n \n \n \n \n \n 确保建立服务器\n \n \n 添加处理器\n \n \n \n 添加处理器\n 处理器\n \n \n 开始服务\n \n \n 开始时调用的方法\n \n \n 停止服务\n 关闭原因。便于日志分析\n \n \n 停止时调用的方法\n \n \n 新会话，对于TCP是新连接，对于UDP是新客户端\n \n \n 某个会话的数据到达。sender是ISocketSession\n \n \n 接受连接时，对于Udp是收到数据时（同时触发OnReceived）。\n \n \n \n \n 收到连接时，建立会话，并挂接数据接收和错误处理事件\n \n \n \n 收到数据时\n \n \n \n \n 收到数据时，最原始的数据处理，但不影响会话内部的数据处理\n \n \n \n \n 错误发生/断开连接时。sender是ISocketSession\n \n \n 触发异常\n \n \n \n \n 会话集合。用自增的数字ID作为标识，业务应用自己维持ID与业务主键的对应关系。\n \n \n 会话数\n \n \n 最高会话数\n \n \n 添加会话。子类可以在添加会话前对会话进行一些处理\n \n \n \n 创建会话\n \n \n \n \n 根据会话ID查找会话\n \n \n \n \n 异步群发\n \n \n \n \n 创建Tcp/Udp、IPv4/IPv6服务\n \n \n \n \n \n \n \n 获取统计信息\n \n \n \n 日志提供者\n \n \n 用于内部Socket服务器的日志提供者\n \n \n 用于网络会话的日志提供者\n \n \n 日志前缀\n \n \n 写日志\n \n \n \n \n 输出错误日志\n \n \n \n \n 已重载。\n \n \n \n 网络服务器\n \n \n \n 创建会话\n \n \n \n \n 获取指定标识的会话\n \n \n \n \n 网络服务的会话\n 网络服务类型\n \n \n 主服务\n \n \n 网络服务的会话\n \n 实际应用可通过重载OnReceive实现收到数据时的业务逻辑。\n \n \n \n 编号\n \n \n 主服务\n \n \n 客户端。跟客户端通讯的那个Socket，其实是服务端TcpSession/UdpServer\n \n \n 服务端\n \n \n 客户端地址\n \n \n 用户会话数据\n \n \n 获取/设置 用户会话数据\n \n \n \n \n 开始会话处理。\n \n \n 子类重载实现资源释放逻辑时必须首先调用基类方法\n 从Dispose调用（释放所有资源）还是析构函数调用（释放非托管资源）\n \n \n 收到客户端发来的数据，触发事件，重载者可直接处理数据\n \n \n \n 数据到达事件\n \n \n 发送数据\n 数据包\n \n \n 发送数据流\n \n \n \n \n 发送字符串\n \n \n \n \n 异步发送并等待响应\n \n \n \n \n 错误处理\n \n \n \n \n 日志提供者\n \n \n 是否记录会话日志\n \n \n 日志前缀\n \n \n 写日志\n \n \n \n \n 输出错误日志\n \n \n \n \n 已重载。\n \n \n \n 协议类型\n \n \n 未知协议\n \n \n 传输控制协议\n \n \n 用户数据报协议\n \n \n Http协议\n \n \n Https协议\n \n \n WebSocket协议\n \n \n 网络资源标识，指定协议、地址、端口、地址族（IPv4/IPv6）\n \n 仅序列化和，其它均是配角！\n 有可能代表主机域名，而指定主机IP地址。\n \n \n \n 协议类型\n \n \n 主机\n \n \n 地址\n \n \n 端口\n \n \n 终结点\n \n \n 是否Tcp协议\n \n \n 是否Udp协议\n \n \n 实例化\n \n \n 实例化\n \n \n \n 实例化\n \n \n \n \n 实例化\n \n \n \n \n \n 实例化\n \n \n \n \n \n 分析\n \n \n \n 分析地址\n 主机地址\n \n \n \n 已重载。\n \n \n \n 重载类型转换，字符串直接转为NetUri对象\n \n \n \n \n 收到数据时的事件参数\n \n \n 数据包\n \n \n 远程地址\n \n \n 解码后的消息\n \n \n 用户数据\n \n \n 串口配置\n \n \n 串口名\n \n \n 波特率\n \n \n 数据位\n \n \n 停止位\n \n \n 奇偶校验\n \n \n 文本编码\n \n \n 编码\n \n \n 十六进制显示\n \n \n 十六进制自动换行\n \n \n 十六进制发送\n \n \n 最后更新时间\n \n \n 扩展数据\n \n \n DtrEnable\n \n \n RtsEnable\n \n \n BreakState\n \n \n 串口传输\n \n 标准例程：\n \n var st = new SerialTransport();\n st.PortName = \"COM65\"; // 通讯口\n st.FrameSize = 16; // 数据帧大小\n \n st.Received += (s, e) =>\n {\n Console.WriteLine(\"收到 {0}\", e.ToHex());\n };\n // 开始异步操作\n st.Open();\n \n //var buf = \"01080000801A\".ToHex();\n var buf = \"0111C02C\".ToHex();\n for (int i = 0; i < 100; i++)\n {\n Console.WriteLine(\"发送 {0}\", buf.ToHex());\n st.Send(buf);\n \n Thread.Sleep(1000);\n }\n \n \n \n \n 串口对象\n \n \n 端口名称。默认COM1\n \n \n 波特率。默认115200\n \n \n 奇偶校验位。默认None\n \n \n 数据位。默认8\n \n \n 停止位。默认One\n \n \n 超时时间。超过该大小未收到数据，说明是另一帧。默认10ms\n \n \n 描述信息\n \n \n 字节超时。数据包间隔，默认20ms\n \n \n 串口传输\n \n \n 销毁\n \n \n \n 确保创建\n \n \n 打开\n \n \n 关闭\n \n \n 写入数据\n 数据包\n \n \n 异步发送数据并等待响应\n \n \n \n \n 接收数据\n \n \n \n 处理收到的数据。默认匹配同步接收委托\n \n \n \n 数据到达事件\n \n \n 断开时触发，可能是人为断开，也可能是串口链路断开\n \n \n 检查串口是否已经断开\n \n FX串口异步操作有严重的泄漏缺陷，如果外部硬件长时间断开，\n SerialPort.IsOpen检测不到，并且会无限大占用内存。\n \n \n \n \n 获取带有描述的串口名，没有时返回空数组\n \n \n \n 获取串口列表，名称和描述\n \n \n \n 从串口列表选择串口，支持自动选择关键字\n 串口名称或者描述符的关键字\n \n \n \n 日志对象\n \n \n 输出日志\n \n \n \n \n 已重载\n \n \n \n 会话基类\n \n \n 标识\n \n \n 名称\n \n \n 本地绑定信息\n \n \n 端口\n \n \n 远程结点地址\n \n \n 超时。默认3000ms\n \n \n 是否活动\n \n \n 底层Socket\n \n \n 是否抛出异常，默认false不抛出。Send/Receive时可能发生异常，该设置决定是直接抛出异常还是通过事件\n \n \n 发送数据包统计信息\n \n \n 接收数据包统计信息\n \n \n 通信开始时间\n \n \n 最后一次通信时间，主要表示活跃时间，包括收发\n \n \n 是否使用动态端口。如果Port为0则为动态端口\n \n \n 最大并行接收数。Tcp默认1，Udp默认CPU*1.6，0关闭异步接收使用同步接收\n \n \n 异步处理接收到的数据，Tcp默认false，Udp默认true。\n 异步处理有可能造成数据包乱序，特别是Tcp。true利于提升网络吞吐量。false避免拷贝，提升处理速度\n \n \n 缓冲区大小。默认8k\n \n \n 构造函数，初始化默认名称\n \n \n 销毁\n \n \n \n 已重载。\n \n \n \n 打开\n 是否成功\n \n \n 打开\n \n \n \n 检查是否动态端口。如果是动态端口，则把随机得到的端口拷贝到Port\n \n \n 关闭\n 关闭原因。便于日志分析\n 是否成功\n \n \n 关闭\n 关闭原因。便于日志分析\n \n \n \n 打开后触发。\n \n \n 关闭后触发。可实现掉线重连\n \n \n 直接发送数据包 Byte[]/Packet\n \n 目标地址由决定\n \n 数据包\n 是否成功\n \n \n 发送数据\n \n 目标地址由决定\n \n 数据包\n 是否成功\n \n \n 接收数据\n \n \n \n 当前异步接收个数\n \n \n 开始异步接收\n 是否成功\n \n \n 释放一个事件参数\n \n \n \n \n 用一个事件参数来开始异步接收\n 事件参数\n 是否在IO线程调用\n \n \n \n 同步或异步收到数据\n \n \n \n 接收预处理，粘包拆包\n \n \n \n \n 预处理\n 数据包\n 远程地址\n 将要处理该数据包的会话\n \n \n 处理收到的数据。默认匹配同步接收委托\n 接收事件参数\n 是否已处理，已处理的数据不再向下传递\n \n \n 数据到达事件\n \n \n 触发数据到达事件\n \n 接收事件参数\n \n \n 收到异常时如何处理。默认关闭会话\n \n 是否当作异常处理并结束会话\n \n \n 消息管道。收发消息都经过管道处理器\n \n \n 创建上下文\n 远程会话\n \n \n \n 通过管道发送消息\n \n \n \n \n 通过管道发送消息并等待响应\n \n \n \n \n 处理数据帧\n 数据帧\n \n \n 错误发生/断开连接时\n \n \n 触发异常\n 动作\n 异常\n \n \n 数据项\n \n \n 设置 或 获取 数据项\n \n \n \n \n 日志前缀\n \n \n 日志对象。禁止设为空对象\n \n \n 是否输出发送日志。默认false\n \n \n 是否输出接收日志。默认false\n \n \n 输出日志\n \n \n \n \n 会话集合。带有自动清理不活动会话的功能\n \n \n 服务端\n \n \n 清理周期。单位毫秒，默认10秒。\n \n \n 清理会话计时器\n \n \n 添加新会话，并设置会话编号\n \n 返回添加新会话是否成功\n \n \n 获取会话，加锁\n \n \n \n \n 关闭所有\n \n \n 移除不活动的会话\n \n \n 网络设置\n \n \n 网络调试\n \n \n 会话超时时间。默认20*60秒\n \n \n 缓冲区大小。默认64k\n \n \n 实例化\n \n \n Socket扩展\n \n \n 异步发送数据\n \n \n \n \n \n 异步发送数据\n \n \n \n \n \n \n 发送数据流\n \n \n \n 返回自身，用于链式写法\n \n \n 向指定目的地发送信息\n \n 缓冲区\n \n 返回自身，用于链式写法\n \n \n 向指定目的地发送信息\n \n \n 文本编码，默认null表示UTF-8编码\n \n 返回自身，用于链式写法\n \n \n 广播数据包\n \n 缓冲区\n \n \n \n 广播字符串\n \n \n \n \n \n 接收字符串\n \n 文本编码，默认null表示UTF-8编码\n \n \n \n 检查并开启广播\n \n \n \n \n \n 关闭连接\n \n \n \n \n SafeHandle字段\n \n \n Socket是否未被关闭\n \n \n \n \n 根据异步事件获取可输出异常，屏蔽常见异常\n \n \n \n \n TCP服务器\n \n 核心工作：启动服务时，监听端口，并启用多个（逻辑处理器数的10倍）异步接受操作。\n \n 服务器完全处于异步工作状态，任何操作都不可能被阻塞。\n \n 注意：服务器接受连接请求后，不会开始处理数据，而是由事件订阅者决定何时开始处理数据。\n \n \n \n 名称\n \n \n 本地绑定信息\n \n \n 端口\n \n \n 会话超时时间\n \n 对于每一个会话连接，如果超过该时间仍然没有收到任何数据，则断开会话连接。\n \n \n \n 异步处理接收到的数据，默认false。\n 异步处理有可能造成数据包乱序，特别是Tcp。true利于提升网络吞吐量。false避免拷贝，提升处理速度\n \n \n 底层Socket\n \n \n 是否活动\n \n \n 是否抛出异常，默认false不抛出。Send/Receive时可能发生异常，该设置决定是直接抛出异常还是通过事件\n \n \n 最大并行接收连接数。默认CPU*1.6\n \n \n 启用Http，数据处理时截去请求响应头，默认false\n \n \n 管道\n \n \n 会话统计\n \n \n 发送统计\n \n \n 接收统计\n \n \n 构造TCP服务器对象\n \n \n 构造TCP服务器对象\n \n \n \n 已重载。释放会话集合等资源\n \n \n \n 开始\n \n \n 停止\n 关闭原因。便于日志分析\n \n \n 新会话时触发\n \n \n 开启异步接受新连接\n \n 是否IO线程\n 开启异步是否成功\n \n \n 收到新连接时处理\n \n \n \n 会话集合。用地址端口作为标识，业务应用自己维持地址端口与业务主键的对应关系。\n \n \n 创建会话\n \n \n \n \n 错误发生/断开连接时\n \n \n 触发异常\n 动作\n 异常\n \n \n 日志前缀\n \n \n 日志对象\n \n \n 是否输出发送日志。默认false\n \n \n 是否输出接收日志。默认false\n \n \n 输出日志\n \n \n \n \n 已重载。\n \n \n \n 增强TCP客户端\n \n \n 收到空数据时抛出异常并断开连接。默认true\n \n \n Socket服务器。当前通讯所在的Socket服务器，其实是TcpServer/UdpServer。该属性决定本会话是客户端会话还是服务的会话\n \n \n 自动重连次数，默认3。发生异常断开连接时，自动重连服务端。\n \n \n 是否匹配空包。Http协议需要\n \n \n 不延迟直接发送。Tcp为了合并小包而设计，客户端默认false，服务端默认true\n \n \n 实例化增强TCP\n \n \n 使用监听口初始化\n \n \n \n 用TCP客户端初始化\n \n \n \n 打开\n \n \n 关闭\n 关闭原因。便于日志分析\n \n \n 发送数据\n \n 目标地址由决定\n \n 数据包\n 是否成功\n \n \n 预处理\n 数据包\n 远程地址\n 将要处理该数据包的会话\n \n \n 处理收到的数据\n 接收事件参数\n \n \n 重连次数\n \n \n 日志前缀\n \n \n 已重载。\n \n \n \n 增强的UDP\n \n 如果已经打开异步接收，还要使用同步接收，则同步Receive内部不再调用底层Socket，而是等待截走异步数据。\n \n \n \n 会话超时时间\n \n 对于每一个会话连接，如果超过该时间仍然没有收到任何数据，则断开会话连接。\n \n \n \n 最后一次同步接收数据得到的远程地址\n \n \n 是否接收来自自己广播的环回数据。默认false\n \n \n 会话统计\n \n \n 实例化增强UDP\n \n \n 使用监听口初始化\n \n \n \n 打开\n \n \n 关闭\n \n \n 发送数据\n \n 目标地址由决定\n \n 数据包\n 是否成功\n \n \n 发送消息并等待响应。必须调用会话的发送，否则配对会失败\n \n \n \n \n 预处理\n 数据包\n 远程地址\n 将要处理该数据包的会话\n \n \n 处理收到的数据\n 接收事件参数\n \n \n 收到异常时如何处理。Tcp/Udp客户端默认关闭会话，但是Udp服务端不能关闭服务器，仅关闭会话\n \n 是否当作异常处理并结束会话\n \n \n 新会话时触发\n \n \n 会话集合。用地址端口作为标识，业务应用自己维持地址端口与业务主键的对应关系。\n \n \n 创建会话\n \n \n \n \n 已重载。\n \n \n \n Udp扩展\n \n \n 发送数据流\n \n \n \n 返回自身，用于链式写法\n \n \n 向指定目的地发送信息\n \n 缓冲区\n \n 返回自身，用于链式写法\n \n \n 向指定目的地发送信息\n \n \n 文本编码，默认null表示UTF-8编码\n \n 返回自身，用于链式写法\n \n \n 广播数据包\n \n 缓冲区\n \n \n \n 广播字符串\n \n \n \n \n \n 接收字符串\n \n 文本编码，默认null表示UTF-8编码\n \n \n \n Udp会话。仅用于服务端与某一固定远程地址通信\n \n \n 会话编号\n \n \n 名称\n \n \n 服务器\n \n \n 底层Socket\n \n \n 本地地址\n \n \n 端口\n \n \n 远程地址\n \n \n 超时。默认3000ms\n \n \n 管道\n \n \n Socket服务器。当前通讯所在的Socket服务器，其实是TcpServer/UdpServer\n \n \n 是否抛出异常，默认false不抛出。Send/Receive时可能发生异常，该设置决定是直接抛出异常还是通过事件\n \n \n 异步处理接收到的数据，默认true利于提升网络吞吐量。\n 异步处理有可能造成数据包乱序，特别是Tcp。false避免拷贝，提升处理速度\n \n \n 发送数据包统计信息\n \n \n 接收数据包统计信息\n \n \n 通信开始时间\n \n \n 最后一次通信时间，主要表示活跃时间，包括收发\n \n \n 缓冲区大小。默认8k\n \n \n 发送消息\n \n \n \n \n 发送消息并等待响应\n \n \n \n \n 接收数据\n \n \n \n 处理数据帧\n 数据帧\n \n \n 错误发生/断开连接时\n \n \n 触发异常\n 动作\n 异常\n \n \n 已重载。\n \n \n \n 数据项\n \n \n 设置 或 获取 数据项\n \n \n \n \n 日志提供者\n \n \n 是否输出发送日志。默认false\n \n \n 是否输出接收日志。默认false\n \n \n 日志前缀\n \n \n 输出日志\n \n \n \n \n 输出日志\n \n \n \n \n 升级更新\n \n 自动更新的难点在于覆盖正在使用的exe/dll文件，通过改名可以解决\n \n \n \n 名称\n \n \n 服务器地址\n \n \n 版本\n \n \n 本地编译时间\n \n \n 更新完成以后自动启动主程序\n \n \n 更新目录\n \n \n 超链接信息，其中第一个为最佳匹配项\n \n \n 更新源文件\n \n \n 实例化一个升级对象实例，获取当前应用信息\n \n \n 获取版本信息，检查是否需要更新\n \n \n \n 开始更新\n \n \n 检查并执行更新操作\n \n \n 正在使用锁定的文件不可删除，但可以改名\n \n \n \n 删除备份文件\n \n \n 日志对象\n \n \n 输出日志\n \n \n \n \n 程序集辅助类。使用Create创建，保证每个程序集只有一个辅助类\n \n \n 程序集\n \n \n 名称\n \n \n 程序集版本\n \n \n 程序集标题\n \n \n 文件版本\n \n \n 编译时间\n \n \n 编译版本\n \n \n 公司名称\n \n \n 说明\n \n \n 获取包含清单的已加载文件的路径或 UNC 位置。\n \n \n 创建程序集辅助对象\n \n \n \n \n 类型集合，当前程序集的所有类型，包括私有和内嵌，非内嵌请直接调用Asm.GetTypes()\n \n \n 是否系统程序集\n \n \n 入口程序集\n \n \n 从程序集中查找指定名称的类型\n \n \n \n \n 在程序集中查找类型\n \n \n \n \n 查找插件\n \n \n \n \n 查找插件，带缓存\n 类型\n \n \n \n 查找所有非系统程序集中的所有插件\n 继承类所在的程序集会引用baseType所在的程序集，利用这一点可以做一定程度的性能优化。\n \n 是否从未加载程序集中获取类型。使用仅反射的方法检查目标类型，如果存在，则进行常规加载\n 指示是否应检查来自所有引用程序集的类型。如果为 false，则检查来自所有引用程序集的类型。 否则，只检查来自非全局程序集缓存 (GAC) 引用的程序集的类型。\n \n \n \n 是否引用了 \n 程序集\n 被引用程序集全名\n \n \n \n 根据名称获取类型\n 类型名\n 是否从未加载程序集中获取类型。使用仅反射的方法检查目标类型，如果存在，则进行常规加载\n \n \n \n 获取指定程序域所有程序集\n \n \n \n \n 程序集目录集合\n \n \n 获取当前程序域所有只反射程序集的辅助类\n \n \n \n 只反射加载指定路径的所有程序集\n \n \n \n \n 只反射加载指定路径的所有程序集\n \n \n \n \n \n 获取当前应用程序的所有程序集，不包括系统程序集，仅限本目录\n \n \n \n 在对程序集的解析失败时发生\n \n \n \n \n 已重载。\n \n \n \n 包装程序集内部类的动态对象\n \n \n 类型转换\n \n \n \n \n \n 成员取值\n \n \n \n \n \n 调用成员\n \n \n \n \n \n \n 包装\n \n \n \n \n 已重载。\n \n \n \n 动态Xml\n \n \n 节点\n \n \n 实例化\n \n \n 实例化\n \n \n \n 实例化\n \n \n \n 设置\n \n \n \n \n \n 获取\n \n \n \n \n \n \n 索引器接访问口。\n 该接口用于通过名称快速访问对象属性或字段（属性优先）。\n \n \n \n 获取/设置 指定名称的属性或字段的值\n 名称\n \n \n \n 反射接口\n 该接口仅用于扩展，不建议外部使用\n \n \n 根据名称获取类型\n 类型名\n 是否从未加载程序集中获取类型。使用仅反射的方法检查目标类型，如果存在，则进行常规加载\n \n \n \n 获取方法\n 用于具有多个签名的同名方法的场合，不确定是否存在性能问题，不建议普通场合使用\n 类型\n 名称\n 参数类型数组\n \n \n \n 获取指定名称的方法集合，支持指定参数个数来匹配过滤\n \n \n 参数个数，-1表示不过滤参数个数\n \n \n \n 获取属性\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取字段\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取成员\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取字段\n \n \n \n \n \n 获取属性\n \n \n \n \n \n 反射创建指定类型的实例\n 类型\n 参数数组\n \n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法\n 方法参数\n \n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法\n 方法参数字典\n \n \n \n 获取目标对象的属性值\n 目标对象\n 属性\n \n \n \n 获取目标对象的字段值\n 目标对象\n 字段\n \n \n \n 设置目标对象的属性值\n 目标对象\n 属性\n 数值\n \n \n 设置目标对象的字段值\n 目标对象\n 字段\n 数值\n \n \n 从源对象拷贝数据到目标对象\n 目标对象\n 源对象\n 递归深度拷贝，直接拷贝成员值而不是引用\n 要忽略的成员\n \n \n 从源字典拷贝数据到目标对象\n 目标对象\n 源字典\n 递归深度拷贝，直接拷贝成员值而不是引用\n \n \n 获取一个类型的元素类型\n 类型\n \n \n \n 类型转换\n 数值\n \n \n \n \n 获取类型的友好名称\n 指定类型\n 是否全名，包含命名空间\n \n \n \n 是否能够转为指定基类\n \n \n \n \n \n 在指定程序集中查找指定基类或接口的所有子类实现\n 指定程序集\n 基类或接口，为空时返回所有类型\n \n \n \n 在所有程序集中查找指定基类或接口的子类实现\n 基类或接口\n 是否加载为加载程序集\n \n \n \n 默认反射实现\n 该接口仅用于扩展，不建议外部使用\n \n \n 根据名称获取类型\n 类型名\n 是否从未加载程序集中获取类型。使用仅反射的方法检查目标类型，如果存在，则进行常规加载\n \n \n \n 获取方法\n 用于具有多个签名的同名方法的场合，不确定是否存在性能问题，不建议普通场合使用\n 类型\n 名称\n 参数类型数组\n \n \n \n 获取指定名称的方法集合，支持指定参数个数来匹配过滤\n \n \n 参数个数，-1表示不过滤参数个数\n \n \n \n 获取属性\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取字段\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取成员\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取字段\n \n \n \n \n \n 获取属性\n \n \n \n \n \n 反射创建指定类型的实例\n 类型\n 参数数组\n \n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法\n 方法参数\n \n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法\n 方法参数字典\n \n \n \n 获取目标对象的属性值\n 目标对象\n 属性\n \n \n \n 获取目标对象的字段值\n 目标对象\n 字段\n \n \n \n 设置目标对象的属性值\n 目标对象\n 属性\n 数值\n \n \n 设置目标对象的字段值\n 目标对象\n 字段\n 数值\n \n \n 从源对象拷贝数据到目标对象\n 目标对象\n 源对象\n 递归深度拷贝，直接拷贝成员值而不是引用\n 要忽略的成员\n \n \n 从源字典拷贝数据到目标对象\n 目标对象\n 源字典\n 递归深度拷贝，直接拷贝成员值而不是引用\n \n \n 获取一个类型的元素类型\n 类型\n \n \n \n 类型转换\n 数值\n \n \n \n \n 获取类型的友好名称\n 指定类型\n 是否全名，包含命名空间\n \n \n \n 是否子类\n \n \n \n \n \n 在指定程序集中查找指定基类的子类\n 指定程序集\n 基类或接口，为空时返回所有类型\n \n \n \n 在所有程序集中查找指定基类或接口的子类实现\n 基类或接口\n 是否加载为加载程序集\n \n \n \n 获取类型，如果target是Type类型，则表示要反射的是静态成员\n 目标对象\n \n \n \n 反射工具类\n \n \n 当前反射提供者\n \n \n 根据名称获取类型。可搜索当前目录DLL，自动加载\n 类型名\n 是否从未加载程序集中获取类型。使用仅反射的方法检查目标类型，如果存在，则进行常规加载\n \n \n \n 获取方法\n 用于具有多个签名的同名方法的场合，不确定是否存在性能问题，不建议普通场合使用\n 类型\n 名称\n 参数类型数组\n \n \n \n 获取指定名称的方法集合，支持指定参数个数来匹配过滤\n \n \n 参数个数，-1表示不过滤参数个数\n \n \n \n 获取属性。搜索私有、静态、基类，优先返回大小写精确匹配成员\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取字段。搜索私有、静态、基类，优先返回大小写精确匹配成员\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取成员。搜索私有、静态、基类，优先返回大小写精确匹配成员\n 类型\n 名称\n 忽略大小写\n \n \n \n 获取用于序列化的字段\n 过滤特性的字段\n \n \n \n \n \n 获取用于序列化的属性\n 过滤特性的属性和索引器\n \n \n \n \n \n 反射创建指定类型的实例\n 类型\n 参数数组\n \n \n \n 反射调用指定对象的方法。target为类型时调用其静态方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法名\n 方法参数\n \n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法名\n 数值\n 方法参数\n 反射调用是否成功\n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法\n 方法参数\n \n \n \n 反射调用指定对象的方法\n 要调用其方法的对象，如果要调用静态方法，则target是类型\n 方法\n 方法参数字典\n \n \n \n 获取目标对象指定名称的属性/字段值\n 目标对象\n 名称\n 出错时是否抛出异常\n \n \n \n 获取目标对象指定名称的属性/字段值\n 目标对象\n 名称\n 数值\n 是否成功获取数值\n \n \n 获取目标对象的成员值\n 目标对象\n 成员\n \n \n \n 设置目标对象指定名称的属性/字段值，若不存在返回false\n 目标对象\n 名称\n 数值\n 反射调用是否成功\n \n \n 设置目标对象的成员值\n 目标对象\n 成员\n 数值\n \n \n 从源对象拷贝数据到目标对象\n 目标对象\n 源对象\n 递归深度拷贝，直接拷贝成员值而不是引用\n 要忽略的成员\n \n \n 从源字典拷贝数据到目标对象\n 目标对象\n 源字典\n 递归深度拷贝，直接拷贝成员值而不是引用\n \n \n 获取一个类型的元素类型\n 类型\n \n \n \n 类型转换\n 数值\n \n \n \n \n 类型转换\n \n 数值\n \n \n \n 获取类型的友好名称\n 指定类型\n 是否全名，包含命名空间\n \n \n \n 从参数数组中获取类型数组\n \n \n \n \n 获取成员的类型，字段和属性是它们的类型，方法是返回类型，类型是自身\n \n \n \n \n 获取类型代码\n \n \n \n \n 是否整数\n \n \n \n \n 是否泛型列表\n \n \n \n \n 是否泛型字典\n \n \n \n \n 是否能够转为指定基类\n \n \n \n \n \n 是否能够转为指定基类\n \n \n \n \n \n 在指定程序集中查找指定基类的子类\n 指定程序集\n 基类或接口\n \n \n \n 在所有程序集中查找指定基类或接口的子类实现\n 基类或接口\n 是否加载为加载程序集\n \n \n \n 获取类型，如果target是Type类型，则表示要反射的是静态成员\n 目标对象\n \n \n \n 判断某个类型是否可空类型\n 类型\n \n \n \n 把一个方法转为泛型委托，便于快速反射调用\n \n \n \n \n \n \n 脚本引擎\n \n 三大用法：\n 1，单个表达式，根据参数计算表达式结果并返回\n 2，多个语句，最后有返回语句\n 3，多个方法，有一个名为Execute的静态方法作为入口方法\n \n 脚本引擎禁止实例化，必须通过方法创建，以代码为键进行缓存，避免重复创建反复编译形成泄漏。\n 其中方法的第二个参数为true表示前两种用法，为false表示第三种用法。\n \n \n 最简单而完整的用法：\n \n // 根据代码创建脚本实例，相同代码只编译一次\n var se = ScriptEngine.Create(\"a+b\");\n // 如果Method为空说明未编译，可设置参数\n if (se.Method == null)\n {\n se.Parameters.Add(\"a\", typeof(Int32));\n se.Parameters.Add(\"b\", typeof(Int32));\n }\n // 脚本固定返回Object类型，需要自己转换\n var n = (Int32)se.Invoke(2, 3);\n Console.WriteLine(\"2+3={0}\", n);\n \n \n 无参数快速调用：\n \n var n = (Int32)ScriptEngine.Execute(\"2*3\");\n \n \n 约定参数快速调用：\n \n var n = (Int32)ScriptEngine.Execute(\"p0*p1\", new Object[] { 2, 3 });\n Console.WriteLine(\"2*3={0}\", n);\n \n \n \n \n 代码\n \n \n 是否表达式\n \n \n 参数集合。编译后就不可修改。\n \n \n 最终代码\n \n \n 编译得到的类型\n \n \n 根据代码编译出来可供直接调用的入口方法，Eval/Main\n \n \n 命名空间集合\n \n \n 引用程序集集合\n \n \n 日志\n \n \n 工作目录。执行时，将会作为环境变量的当前目录和PathHelper目录，执行后还原\n \n \n 构造函数私有，禁止外部越过Create方法直接创建实例\n 代码片段\n 是否表达式，表达式将编译成为一个Main方法\n \n \n 为指定代码片段创建脚本引擎实例。采用缓存，避免同一脚本重复创建引擎。\n 代码片段\n 是否表达式，表达式将编译成为一个Main方法\n \n \n \n 执行表达式，返回结果\n 代码片段\n \n \n \n 执行表达式，返回结果\n 代码片段\n 参数名称\n 参数类型\n 参数值\n \n \n \n 执行表达式，返回结果\n 代码片段\n 参数名值对\n \n \n \n 执行表达式，返回结果。参数名默认为p0/p1/p2/pn\n \n 参数数组\n \n \n \n 生成代码。根据完善得到最终代码\n \n \n 获取完整源代码\n \n \n \n 编译\n \n \n 编译\n \n \n \n \n \n 按照传入参数执行代码\n 参数\n 结果\n \n \n 分析命名空间\n \n \n \n \n Api动作\n \n \n 动作名称\n \n \n 动作所在类型\n \n \n 方法\n \n \n 控制器对象\n 如果指定控制器对象，则每次调用前不再实例化对象\n \n \n 是否二进制参数\n \n \n 是否二进制返回\n \n \n 实例化\n \n \n 获取名称\n \n \n \n \n \n 已重载。\n \n \n \n 标识Api\n \n \n 名称\n \n \n 实例化\n \n \n \n 应用接口客户端\n \n \n 是否已打开\n \n \n 服务端地址集合。负载均衡\n \n \n 客户端连接集群\n \n \n 是否使用连接池。true时建立多个到服务端的连接，默认false使用单一连接\n \n \n 主机\n \n \n 最后活跃时间\n \n \n 所有服务器所有会话，包含自己\n \n \n 发送数据包统计信息\n \n \n 接收数据包统计信息\n \n \n 实例化应用接口客户端\n \n \n 实例化应用接口客户端\n 服务端地址集合，逗号分隔\n \n \n 销毁\n \n \n \n 打开客户端\n \n \n 关闭\n 关闭原因。便于日志分析\n 是否成功\n \n \n 查找Api动作\n \n \n \n \n 创建控制器实例\n \n \n \n \n 异步调用，等待返回结果\n 返回类型\n 服务操作\n 参数\n 标识\n \n \n \n 异步调用，等待返回结果\n \n 服务操作\n 参数\n 标识\n \n \n \n 同步调用，阻塞等待\n 服务操作\n 参数\n 标识\n \n \n \n 单向发送。同步调用，不等待返回\n 服务操作\n 参数\n 标识\n \n \n \n 指定客户端的异步调用，等待返回结果\n 常用于在OnLoginAsync中实现连接后登录功能\n \n 客户端\n 服务操作\n 参数\n 标识\n \n \n \n 新会话。客户端每次连接或断线重连后，可用InvokeWithClientAsync做登录\n 会话\n 状态。客户端ISocketClient\n \n \n 连接后自动登录\n 客户端\n 强制登录\n \n \n 登录\n \n \n \n 创建客户端之后，打开连接之前\n \n \n \n 显示统计信息的周期。默认600秒，0表示不显示统计信息\n \n \n 远程调用异常\n \n \n 代码\n \n \n 实例化远程调用异常\n \n \n \n \n 实例化远程调用异常\n \n \n \n \n Api主机\n \n \n 名称\n \n \n 编码器\n \n \n 处理器\n \n \n 调用超时时间。请求发出后，等待响应的最大时间，默认15_000ms\n \n \n 发送数据包统计信息\n \n \n 接收数据包统计信息\n \n \n 用户会话数据\n \n \n 获取/设置 用户会话数据\n \n \n \n \n 接口动作管理器\n \n \n 注册服务提供类。该类的所有公开方法将直接暴露\n \n \n \n 注册服务\n 控制器对象\n 动作名称。为空时遍历控制器所有公有成员方法\n \n \n 显示可用服务\n \n \n 获取消息编码器。重载以指定不同的封包协议\n \n \n \n 处理消息\n \n \n \n \n \n 执行\n \n \n \n \n \n \n 新会话。服务端收到新连接，客户端每次连接或断线重连后，可用于做登录\n 会话\n 状态。客户端ISocketClient\n \n \n 日志\n \n \n 编码器日志\n \n \n 显示调用和处理错误。默认false\n \n \n 写日志\n \n \n \n \n 已重载。返回具有本类特征的字符串\n String\n \n \n 初始化\n \n \n \n \n \n 主机\n \n \n 当前服务器所有会话\n \n \n 调用超时时间。默认30_000ms\n \n \n 初始化\n \n \n \n \n \n 主机\n \n \n 最后活跃时间\n \n \n 所有服务器所有会话，包含自己\n \n \n 开始会话处理\n \n \n 查找Api动作\n \n \n \n \n 创建控制器实例\n \n \n \n \n 远程调用\n \n 服务操作\n 参数\n 标识\n \n \n \n 应用接口服务器\n \n \n 是否正在工作\n \n \n 端口\n \n \n 服务器\n \n \n 实例化一个应用接口服务器\n \n \n 使用指定端口实例化网络服务应用接口提供者\n \n \n \n 实例化\n \n \n \n 销毁时停止服务\n \n \n \n 添加服务器\n \n \n \n 确保已创建服务器对象\n \n \n \n 开始服务\n \n \n 停止服务\n 关闭原因。便于日志分析\n \n \n 显示统计信息的周期。默认600秒，0表示不显示统计信息\n \n \n 客户端连接池负载均衡集群\n \n \n 服务器地址列表\n \n \n 创建回调\n \n \n 连接池\n \n \n 实例化连接池集群\n \n \n 打开\n \n \n 关闭\n 关闭原因。便于日志分析\n 是否成功\n \n \n 从集群中获取资源\n \n \n \n 归还\n \n \n \n Round-Robin 负载均衡\n \n \n 为连接池创建连接\n \n \n \n 客户端单连接故障转移集群\n \n \n 服务器地址列表\n \n \n 创建回调\n \n \n 打开\n \n \n 关闭\n 关闭原因。便于日志分析\n 是否成功\n \n \n 从集群中获取资源\n \n \n \n 归还\n \n \n \n Round-Robin 负载均衡\n \n \n 为连接池创建连接\n \n \n \n API控制器\n \n \n 主机\n \n \n 获取所有接口\n \n \n \n 服务器信息，用户健康检测\n 状态信息\n \n \n \n 控制器上下文\n \n \n 控制器实例\n \n \n 处理动作\n \n \n 真实动作名称\n \n \n 会话\n \n \n 请求\n \n \n 请求参数\n \n \n 获取或设置操作方法参数。\n \n \n 获取或设置由操作方法返回的结果。\n \n \n 获取或设置在操作方法的执行过程中发生的异常（如果有）。\n \n \n 获取或设置一个值，该值指示是否处理异常。\n \n \n 实例化\n \n \n 当前线程上下文\n \n \n 重置为默认状态\n \n \n 定义操作筛选器中使用的方法。\n \n \n 在执行操作方法之前调用。\n \n \n \n 在执行操作方法后调用。\n \n \n \n Api接口\n \n \n 会话\n \n \n Api处理器\n \n \n 执行\n \n \n \n \n \n \n 默认处理器\n \n \n Api接口主机\n \n \n 执行\n \n \n \n \n \n \n 准备上下文\n \n \n \n \n \n \n \n 获取参数\n \n \n \n \n \n \n Api主机\n \n \n 编码器\n \n \n 处理器\n \n \n 接口动作管理器\n \n \n 获取消息编码器。重载以指定不同的封包协议\n \n \n \n 处理消息\n \n \n \n \n \n 发送统计\n \n \n 接收统计\n \n \n 日志\n \n \n 写日志\n \n \n \n \n Api主机助手\n \n \n 调用\n \n \n 结果类型\n 服务操作\n 参数\n 标识\n \n \n \n 调用\n \n \n 服务操作\n 参数\n 标识\n \n \n \n 创建控制器实例\n \n \n \n \n \n \n 获取统计信息\n \n \n \n \n 接口管理器\n \n \n 可提供服务的方法\n \n \n 注册服务提供类。该类的所有公开方法将直接暴露\n \n \n \n 注册服务\n 控制器对象\n 动作名称。为空时遍历控制器所有公有成员方法\n \n \n 查找服务\n \n \n \n \n 可提供服务的方法\n \n \n 注册服务提供类。该类的所有公开方法将直接暴露\n \n \n \n 注册服务\n 控制器对象\n 动作名称。为空时遍历控制器所有公有成员方法\n \n \n 查找服务\n \n \n \n \n 应用接口服务器接口\n \n \n 主机\n \n \n 当前服务器所有会话\n \n \n 初始化\n \n \n \n \n \n 开始\n \n \n 停止\n 关闭原因。便于日志分析\n \n \n 日志\n \n \n Api会话\n \n \n 主机\n \n \n 最后活跃时间\n \n \n 所有服务器所有会话，包含自己\n \n \n 获取/设置 用户会话数据\n \n \n \n \n 查找Api动作\n \n \n \n \n 创建控制器实例\n \n \n \n \n 发送消息。低级接口，由框架使用\n \n \n \n \n 发送消息。低级接口，由框架使用\n \n \n \n \n 远程调用\n \n 服务操作\n 参数\n 标识\n \n \n \n 编码器\n \n \n 创建请求\n \n \n \n \n \n 创建响应\n \n \n \n \n \n \n \n 解码 请求/响应\n 消息\n 服务动作\n 错误码\n 参数或结果\n \n \n \n 解码参数\n \n \n \n \n \n 解码结果\n \n \n \n \n \n 转换为目标类型\n \n \n \n \n \n 日志提供者\n \n \n 编码器基类\n \n \n 解码 请求/响应\n 消息\n 服务动作\n 错误码\n 参数或结果\n \n \n \n 日志提供者\n \n \n 写日志\n \n \n \n \n Json编码器\n \n \n 编码 请求/响应\n \n \n \n \n \n \n 编码\n \n \n \n \n \n \n 解码参数\n \n \n \n \n \n 解码结果\n \n \n \n \n \n 转换为目标类型\n \n \n \n \n \n 创建请求\n \n \n \n \n \n 创建响应\n \n \n \n \n \n \n \n 证书\n http://blogs.msdn.com/b/dcook/archive/2008/11/25/creating-a-self-signed-certificate-in-c.aspx\n \n \n 建立自签名证书\n \n \n \n \n 建立自签名证书\n \n \n \n \n \n \n 建立自签名证书\n \n \n \n \n \n \n \n 建立自签名证书\n 例如CN=SelfSignCertificate;C=China;OU=NewLife;O=Development Team;E=nnhy@vip.qq.com，其中CN是显示名\n \n \n \n \n \n \n 建立自签名证书\n \n \n \n \n \n \n \n CRC16校验\n \n \n CRC16表\n \n \n 校验值\n \n \n 重置清零\n \n \n 添加整数进行校验\n \n the byte is taken as the lower 8 bits of value\n \n \n \n 添加字节数组进行校验 CRC16-CCITT x16+x12+x5+1 1021 ISO HDLC, ITU X.25, V.34/V.41/V.42, PPP-FCS\n 字符串123456789的Crc16是31C3\n 数据缓冲区\n 偏移量\n 字节个数\n \n \n 添加数据流进行校验 CRC-16 x16+x15+x2+1 8005 IBM SDLC\n \n 数量\n \n \n 计算校验码\n \n \n \n \n \n \n 计算数据流校验码\n \n \n \n \n \n 计算数据流校验码，指定起始位置和字节数偏移量\n \n 一般用于计算数据包校验码，需要回过头去开始校验，并且可能需要跳过最后的校验码长度。\n position小于0时，数据流从当前位置开始计算校验；\n position大于等于0时，数据流移到该位置开始计算校验，最后由count决定可能差几个字节不参与计算；\n \n \n 如果大于等于0，则表示从该位置开始计算\n 字节数偏移量，一般用负数表示\n \n \n \n CRC32校验\n \n Generate a table for a byte-wise 32-bit CRC calculation on the polynomial:\n x^32+x^26+x^23+x^22+x^16+x^12+x^11+x^10+x^8+x^7+x^5+x^4+x^2+x+1.\n \n Polynomials over GF(2) are represented in binary, one bit per coefficient,\n with the lowest powers in the most significant bit. Then adding polynomials\n is just exclusive-or, and multiplying a polynomial by x is a right shift by\n one. If we call the above polynomial p, and represent a byte as the\n polynomial q, also with the lowest power in the most significant bit (so the\n byte 0xb1 is the polynomial x^7+x^3+x+1), then the CRC is (q*x^32) mod p,\n where a mod b means the remainder after dividing a by b.\n \n This calculation is done using the shift-register method of multiplying and\n taking the remainder. The register is initialized to zero, and for each\n incoming bit, x^32 is added mod p to the register if the bit is a one (where\n x^32 mod p is p+x^32 = x^26+...+1), and the register is multiplied mod p by\n x (which is shifting right by one and adding x^32 mod p if the bit shifted\n out is a one). We start with the highest power (least significant bit) of\n q and repeat for all eight bits of q.\n \n The table is simply the CRC of all possible eight bit values. This is all\n the information needed to generate CRC's on data a byte at a time for all\n combinations of CRC register values and incoming bytes.\n \n \n \n 校验表\n \n \n 校验值\n \n \n 校验值\n \n \n 重置清零\n \n \n 添加整数进行校验\n \n the byte is taken as the lower 8 bits of value\n \n \n \n 添加字节数组进行校验\n \n The buffer which contains the data\n \n \n The offset in the buffer where the data starts\n \n \n The number of data bytes to update the CRC with.\n \n \n \n 添加数据流进行校验\n \n 数量\n \n \n 计算校验码\n \n \n \n \n \n \n 计算数据流校验码\n \n \n \n \n \n 计算数据流校验码，指定起始位置和字节数偏移量\n \n 一般用于计算数据包校验码，需要回过头去开始校验，并且可能需要跳过最后的校验码长度。\n position小于0时，数据流从当前位置开始计算校验；\n position大于等于0时，数据流移到该位置开始计算校验，最后由count决定可能差几个字节不参与计算；\n \n \n 如果大于等于0，则表示从该位置开始计算\n 字节数偏移量，一般用负数表示\n \n \n \n DSA算法\n \n \n 产生非对称密钥对（私钥和公钥）\n 密钥长度，默认1024位强密钥\n 私钥和公钥\n \n \n 签名\n \n \n \n \n \n 验证\n \n \n \n \n \n \n 从Xml加载DSA密钥\n \n \n \n \n 保存DSA密钥到Xml\n \n \n \n \n \n 随机数\n \n \n 返回一个小于所指定最大值的非负随机数\n 返回的随机数的上界（随机数不能取该上界值）\n \n \n \n 返回一个指定范围内的随机数\n \n 调用平均耗时37.76ns，其中GC耗时77.56%\n \n 返回的随机数的下界（随机数可取该下界值）\n 返回的随机数的上界（随机数不能取该上界值）\n \n \n \n 返回指定长度随机字节数组\n \n 调用平均耗时5.46ns，其中GC耗时15%\n \n \n \n \n \n 返回指定长度随机字符串\n 长度\n 是否包含符号\n \n \n \n RC4对称加密算法\n \n RC4于1987年提出，和DES算法一样，是一种对称加密算法，也就是说使用的密钥为单钥（或称为私钥）。\n 但不同于DES的是，RC4不是对明文进行分组处理，而是字节流的方式依次加密明文中的每一个字节，解密的时候也是依次对密文中的每一个字节进行解密。\n \n RC4算法的特点是算法简单，运行速度快，而且密钥长度是可变的，可变范围为1-256字节(8-2048比特)，\n 在如今技术支持的前提下，当密钥长度为128比特时，用暴力法搜索密钥已经不太可行，所以可以预见RC4的密钥范围任然可以在今后相当长的时间里抵御暴力搜索密钥的攻击。\n 实际上，如今也没有找到对于128bit密钥长度的RC4加密算法的有效攻击方法。\n \n \n \n 加密\n 数据\n 密码\n \n \n \n 打乱密码 \n 密码 \n 密码箱长度 \n 打乱后的密码 \n \n \n RSA算法\n \n RSA加密或签名小数据块时，密文长度128，速度也很快。\n \n \n \n 产生非对称密钥对\n \n RSAParameters的各个字段采用大端字节序，转为BigInteger的之前一定要倒序。\n RSA加密后密文最小长度就是密钥长度，所以1024密钥最小密文长度是128字节。\n \n 密钥长度，默认1024位强密钥\n \n \n \n RSA加密\n \n \n 如果为 true，则使用 OAEP 填充（仅可用于运行 Windows XP 及更高版本的计算机）执行直接 System.Security.Cryptography.RSA加密；否则，如果为 false，则使用 PKCS#1 v1.5 填充。\n \n \n \n RSA解密\n \n \n 如果为 true，则使用 OAEP 填充（仅可用于运行 Microsoft Windows XP 及更高版本的计算机）执行直接 System.Security.Cryptography.RSA解密；否则，如果为 false 则使用 PKCS#1 v1.5 填充。\n \n \n \n 配合DES加密\n \n \n \n \n \n 配合DES解密\n \n \n \n \n \n 配合对称算法加密\n \n \n \n \n \n \n 配合对称算法解密\n \n \n \n \n \n \n 签名\n \n \n \n \n \n 验证\n \n \n \n \n \n \n 使用随机数设置\n \n \n \n \n 访问器基类\n \n \n 从数据流中读取消息\n 数据流\n 上下文\n 是否成功\n \n \n 把消息写入到数据流中\n 数据流\n 上下文\n \n \n 消息转为字节数组\n \n \n \n 创建序列化器\n \n \n \n \n 输出消息实体\n \n \n \n 获取成员输出\n \n \n \n \n \n 获取用于输出的成员值\n \n \n \n \n 访问器泛型基类\n \n \n \n 从流中读取消息\n \n \n \n \n 从字节数组中读取消息\n \n \n \n \n 二进制编码解码器\n \n \n 使用7位编码整数。默认true使用\n \n \n 对象转二进制\n \n \n \n \n \n 二进制转对象\n \n \n \n \n \n 二进制编码解码器\n \n \n 使用7位编码整数。默认true使用\n \n \n 对象转二进制\n \n \n \n \n \n 二进制转对象\n \n \n \n \n \n 二进制序列化\n \n \n 使用7位编码整数。默认false不使用\n \n \n 小端字节序。默认false大端\n \n \n 使用指定大小的FieldSizeAttribute特性，默认false\n \n \n 使用对象引用，默认true\n \n \n 大小宽度。可选0/1/2/4，默认0表示压缩编码整数\n \n \n 要忽略的成员\n \n \n 处理器列表\n \n \n 实例化\n \n \n 添加处理器\n \n \n \n \n 添加处理器\n \n \n \n \n \n 获取处理器\n \n \n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 写入字节\n \n \n \n 将字节数组部分写入当前流，不写入数组长度。\n 包含要写入的数据的字节数组。\n buffer 中开始写入的起始点。\n 要写入的字节数。\n \n \n 写入大小，如果有FieldSize则返回，否则写入编码的大小\n \n \n \n \n 写7位压缩编码整数\n \n 以7位压缩格式写入32位整数，小于7位用1个字节，小于14位用2个字节。\n 由每次写入的一个字节的第一位标记后面的字节是否还是当前数据，所以每个字节实际可利用存储空间只有后7位。\n \n 数值\n 实际写入字节数\n \n \n 读取指定类型对象\n \n \n \n \n 读取指定类型对象\n \n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 读取字节\n \n \n \n 从当前流中将 count 个字节读入字节数组\n 要读取的字节数。\n \n \n \n 读取大小\n \n \n \n 读取整数的字节数组，某些写入器（如二进制写入器）可能需要改变字节顺序\n 数量\n \n \n \n 从当前流中读取 2 字节有符号整数，并使流的当前位置提升 2 个字节。\n \n \n \n 从当前流中读取 4 字节有符号整数，并使流的当前位置提升 4 个字节。\n \n \n \n 以压缩格式读取16位整数\n \n \n \n 以压缩格式读取32位整数\n \n \n \n 以压缩格式读取64位整数\n \n \n \n 使用跟踪流。实际上是重新包装一次Stream，必须在设置Stream后，使用之前\n \n \n 快速读取\n \n 数据流\n 使用7位编码整数\n \n \n \n 快速写入\n 对象\n 使用7位编码整数\n \n \n \n 颜色处理器。\n \n \n 实例化\n \n \n 写入对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 复合对象处理器\n \n \n 实例化\n \n \n 写入对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 获取成员\n \n \n \n \n \n 字典数据编码\n \n \n 初始化\n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 字体处理器。\n \n \n 实例化\n \n \n 写入对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 二进制基础类型处理器\n \n \n 实例化\n \n \n 写入一个对象\n 目标对象\n 类型\n 是否处理成功\n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 将一个无符号字节写入\n 要写入的无符号字节。\n \n \n 将字节数组写入，如果设置了UseSize，则先写入数组长度。\n 包含要写入的数据的字节数组。\n \n \n 将字节数组部分写入当前流，不写入数组长度。\n 包含要写入的数据的字节数组。\n buffer 中开始写入的起始点。\n 要写入的字节数。\n \n \n 写入字节数组，自动计算长度\n 缓冲区\n 数量\n \n \n 将 2 字节有符号整数写入当前流，并将流的位置提升 2 个字节。\n 要写入的 2 字节有符号整数。\n \n \n 将 4 字节有符号整数写入当前流，并将流的位置提升 4 个字节。\n 要写入的 4 字节有符号整数。\n \n \n 将 8 字节有符号整数写入当前流，并将流的位置提升 8 个字节。\n 要写入的 8 字节有符号整数。\n \n \n 判断字节顺序\n 缓冲区\n \n \n 将 2 字节无符号整数写入当前流，并将流的位置提升 2 个字节。\n 要写入的 2 字节无符号整数。\n \n \n 将 4 字节无符号整数写入当前流，并将流的位置提升 4 个字节。\n 要写入的 4 字节无符号整数。\n \n \n 将 8 字节无符号整数写入当前流，并将流的位置提升 8 个字节。\n 要写入的 8 字节无符号整数。\n \n \n 将 4 字节浮点值写入当前流，并将流的位置提升 4 个字节。\n 要写入的 4 字节浮点值。\n \n \n 将 8 字节浮点值写入当前流，并将流的位置提升 8 个字节。\n 要写入的 8 字节浮点值。\n \n \n 将一个十进制值写入当前流，并将流位置提升十六个字节。\n 要写入的十进制值。\n \n \n 将 Unicode 字符写入当前流，并根据所使用的 Encoding 和向流中写入的特定字符，提升流的当前位置。\n 要写入的非代理项 Unicode 字符。\n \n \n 将字符数组部分写入当前流，并根据所使用的 Encoding（可能还根据向流中写入的特定字符），提升流的当前位置。\n 包含要写入的数据的字符数组。\n chars 中开始写入的起始点。\n 要写入的字符数。\n \n \n 写入字符串\n 要写入的值。\n \n \n 从当前流中读取下一个字节，并使流的当前位置提升 1 个字节。\n \n \n \n 从当前流中将 count 个字节读入字节数组，如果count小于0，则先读取字节数组长度。\n 要读取的字节数。\n \n \n \n 读取整数的字节数组，某些写入器（如二进制写入器）可能需要改变字节顺序\n 数量\n \n \n \n 从当前流中读取 2 字节有符号整数，并使流的当前位置提升 2 个字节。\n \n \n \n 从当前流中读取 4 字节有符号整数，并使流的当前位置提升 4 个字节。\n \n \n \n 从当前流中读取 8 字节有符号整数，并使流的当前位置向前移动 8 个字节。\n \n \n \n 使用 Little-Endian 编码从当前流中读取 2 字节无符号整数，并将流的位置提升 2 个字节。\n \n \n \n 从当前流中读取 4 字节无符号整数并使流的当前位置提升 4 个字节。\n \n \n \n 从当前流中读取 8 字节无符号整数并使流的当前位置提升 8 个字节。\n \n \n \n 从当前流中读取 4 字节浮点值，并使流的当前位置提升 4 个字节。\n \n \n \n 从当前流中读取 8 字节浮点值，并使流的当前位置提升 8 个字节。\n \n \n \n 从当前流中读取下一个字符，并根据所使用的 Encoding 和从流中读取的特定字符，提升流的当前位置。\n \n \n \n 从当前流中读取一个字符串。字符串有长度前缀，一次 7 位地被编码为整数。\n \n \n \n 从当前流中读取十进制数值，并将该流的当前位置提升十六个字节。\n \n \n \n 以压缩格式读取16位整数\n \n \n \n 以压缩格式读取32位整数\n \n \n \n 以压缩格式读取64位整数\n \n \n \n \n 以7位压缩格式写入16位整数，小于7位用1个字节，小于14位用2个字节。\n 由每次写入的一个字节的第一位标记后面的字节是否还是当前数据，所以每个字节实际可利用存储空间只有后7位。\n \n 数值\n 实际写入字节数\n \n \n \n 以7位压缩格式写入32位整数，小于7位用1个字节，小于14位用2个字节。\n 由每次写入的一个字节的第一位标记后面的字节是否还是当前数据，所以每个字节实际可利用存储空间只有后7位。\n \n 数值\n 实际写入字节数\n \n \n \n 以7位压缩格式写入64位整数，小于7位用1个字节，小于14位用2个字节。\n 由每次写入的一个字节的第一位标记后面的字节是否还是当前数据，所以每个字节实际可利用存储空间只有后7位。\n \n 数值\n 实际写入字节数\n \n \n 列表数据编码\n \n \n 初始化\n \n \n 写入\n \n \n \n \n \n 读取\n \n \n \n \n \n 常用类型编码\n \n \n 初始化\n \n \n 写入\n \n \n \n \n \n 写入字节数组，自动计算长度\n 缓冲区\n 数量\n \n \n 读取\n \n \n \n \n \n 从当前流中将 count 个字节读入字节数组，如果count小于0，则先读取字节数组长度。\n 要读取的字节数。\n \n \n \n 从当前流中读取 count 个字符，以字符数组的形式返回数据，并根据所使用的 Encoding 和从流中读取的特定字符，提升当前位置。\n 要读取的字符数。\n \n \n \n 二进制名值对\n \n \n 初始化\n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 写入名值对\n \n \n \n \n 读取原始名值对\n \n \n \n 读取原始名值对\n 数据流\n 编码\n \n \n \n 从原始名值对读取数据\n \n \n \n \n \n \n \n 获取成员\n \n \n \n \n \n 内部对象处理器。对于其它处理器无法支持的类型，一律由该处理器解决\n \n \n 实例化\n \n \n 写入对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 字段大小特性。\n \n 可以通过Size指定字符串或数组的固有大小，为0表示自动计算；也可以通过指定参考字段ReferenceName，然后从其中获取大小。\n 支持_Header._Questions形式的多层次引用字段\n \n \n \n 大小。使用时，作为偏移量；0表示自动计算大小\n \n \n 参考大小字段名\n \n \n 通过Size指定字符串或数组的固有大小，为0表示自动计算\n \n \n \n 指定参考字段ReferenceName，然后从其中获取大小\n \n \n \n 指定参考字段ReferenceName，然后从其中获取大小\n \n 在参考字段值基础上的增量，可以是正数负数\n \n \n 找到所引用的参考字段\n 目标对象\n 目标对象的成员\n 数值\n \n \n \n 设置目标对象的引用大小值\n 目标对象\n \n \n \n \n 获取目标对象的引用大小值\n 目标对象\n \n \n \n \n 二进制序列化接口\n \n \n 编码整数\n \n \n 小端字节序。默认false大端\n \n \n 使用指定大小的FieldSizeAttribute特性，默认false\n \n \n 要忽略的成员\n \n \n 处理器列表\n \n \n 写入字节\n \n \n \n 将字节数组部分写入当前流，不写入数组长度。\n 包含要写入的数据的字节数组。\n buffer 中开始写入的起始点。\n 要写入的字节数。\n \n \n 写入大小\n 要写入的大小值\n 返回特性指定的固定长度，如果没有则返回-1\n \n \n 读取字节\n \n \n \n 从当前流中将 count 个字节读入字节数组\n 要读取的字节数。\n \n \n \n 读取大小\n \n \n \n 二进制读写处理器接口\n \n \n 二进制读写处理器基类\n \n \n 序列化访问器。接口实现者可以在这里完全自定义序列化行为\n \n \n 从数据流中读取消息\n 数据流\n 上下文\n 是否成功\n \n \n 把消息写入到数据流中\n 数据流\n 上下文\n 是否成功\n \n \n 访问器助手\n \n \n 支持访问器的对象转数据包\n 访问器\n 上下文\n \n \n \n 通过访问器读取\n \n \n 上下文\n \n \n \n 通过访问器转换数据包为实体对象\n \n \n \n \n \n \n 序列化接口\n \n \n 数据流\n \n \n 主对象\n \n \n 成员\n \n \n 文本编码\n \n \n 序列化属性而不是字段。默认true\n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 读取指定类型对象\n \n \n \n \n 读取指定类型对象\n \n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 日志提供者\n \n \n 序列化处理器接口\n \n \n \n 宿主读写器\n \n \n 优先级\n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 序列化接口\n \n \n 数据流。默认实例化一个内存数据流\n \n \n 主对象\n \n \n 成员\n \n \n 字符串编码，默认Default\n \n \n 序列化属性而不是字段。默认true\n \n \n 实例化\n \n \n 获取流里面的数据\n \n \n \n 日志提供者\n \n \n 输出日志\n \n \n \n \n 读写处理器基类\n \n \n 宿主读写器\n \n \n 优先级\n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 输出日志\n \n \n \n \n 成员序列化访问器。接口实现者可以在这里完全自定义序列化行为\n \n \n 从数据流中读取消息\n 序列化\n 成员\n 是否成功\n \n \n 把消息写入到数据流中\n 序列化\n 成员\n \n \n Json编码解码器\n \n \n 对象转Json\n \n \n \n \n \n Json转对象\n \n \n \n \n \n Json编码解码器\n \n \n 对象转Json\n \n \n \n \n \n Json转对象\n \n \n \n \n \n IJson序列化接口\n \n \n 是否缩进\n \n \n 处理器列表\n \n \n 写入字符串\n \n \n \n 写入\n \n \n \n \n 读取\n \n \n \n \n 读取字节\n \n \n \n IJson读写处理器接口\n \n \n 获取对象的Json字符串表示形式。\n \n 返回null表示不支持\n \n \n IJson读写处理器基类\n \n \n 获取对象的Json字符串表示形式。\n \n 返回null表示不支持\n \n \n 写入一个对象\n 目标对象\n 类型\n 是否处理成功\n \n \n Json序列化接口\n \n \n 写入对象，得到Json字符串\n \n 是否缩进。默认false\n 是否写控制。默认true\n 是否驼峰命名。默认false\n \n \n \n 从Json字符串中读取对象\n \n \n \n \n \n 类型转换\n \n \n \n \n \n Json助手\n \n \n 默认实现\n \n \n 写入对象，得到Json字符串\n \n 是否缩进\n \n \n \n 写入对象，得到Json字符串\n \n 是否缩进。默认false\n 是否写控制。默认true\n 是否驼峰命名。默认false\n \n \n \n 从Json字符串中读取对象\n \n \n \n \n \n 从Json字符串中读取对象\n \n \n \n \n \n 格式化Json文本\n \n \n \n \n Json类型对象转换实体类\n \n \n \n \n Json序列化\n \n \n 是否缩进\n \n \n 处理器列表\n \n \n 实例化\n \n \n 添加处理器\n \n \n \n \n 添加处理器\n \n \n \n \n \n 获取处理器\n \n \n \n \n 写入一个对象\n 目标对象\n 类型\n \n \n \n 写入字符串\n \n \n \n 写入\n \n \n \n \n 读取指定类型对象\n \n \n \n \n 读取指定类型对象\n \n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 读取\n \n \n \n \n 读取字节\n \n \n \n 列表数据编码\n \n \n 初始化\n \n \n 获取对象的Json字符串表示形式。\n \n 返回null表示不支持\n \n \n 写入\n \n \n \n \n \n 读取\n \n \n \n \n \n 复合对象处理器\n \n \n 要忽略的成员\n \n \n 实例化\n \n \n 获取对象的Json字符串表示形式。\n \n 返回null表示不支持\n \n \n 写入对象\n 目标对象\n 类型\n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 获取成员\n \n \n \n \n \n Json基础类型处理器\n \n \n 实例化\n \n \n 获取对象的Json字符串表示形式。\n \n 返回null表示不支持\n \n \n 尝试读取指定类型对象\n \n \n \n \n \n Json分析器\n \n \n 标识符\n \n \n 左大括号\n \n \n 右大括号\n \n \n 左方括号\n \n \n 右方括号\n \n \n 冒号\n \n \n 逗号\n \n \n 字符串\n \n \n 数字\n \n \n 布尔真\n \n \n 布尔真\n \n \n 空值\n \n \n 实例化\n \n \n \n 解码\n \n \n \n 读取一个Token\n \n \n Json读取器\n \n \n 是否使用UTC时间\n \n \n 读取Json到指定类型\n \n \n \n \n \n 读取Json到指定类型\n \n \n \n \n \n Json字典或列表转为具体类型对象\n Json对象\n 模板类型\n 目标对象\n \n \n \n 转为泛型列表\n \n \n 目标对象\n \n \n \n 转为数组\n \n \n 目标对象\n \n \n \n 转为泛型字典\n \n \n 目标对象\n \n \n \n 字典转复杂对象，反射属性赋值\n \n \n 目标对象\n \n \n \n 创建时间\n \n \n \n \n Json写入器\n \n \n 使用UTC时间。默认false\n \n \n 使用小写名称\n \n \n 使用驼峰命名\n \n \n 写入空值。默认true\n \n \n 实例化\n \n \n 对象序列化为Json字符串\n \n 是否缩进。默认false\n 是否写控制。默认true\n 是否驼峰命名。默认false\n \n \n \n 根据小写和驼峰格式化名称\n \n \n \n \n 序列化助手\n \n \n 获取序列化名称\n \n \n \n \n 二进制序列化接口\n \n \n 处理器列表\n \n \n 使用注释\n \n \n 写入一个对象\n 目标对象\n 名称\n 类型\n \n \n \n 获取Xml写入器\n \n \n \n 获取Xml读取器\n \n \n \n 二进制读写处理器接口\n \n \n Xml读写处理器基类\n \n \n Xml序列化\n \n \n 深度\n \n \n 处理器列表\n \n \n 使用特性\n \n \n 使用注释\n \n \n 当前名称\n \n \n 实例化\n \n \n 添加处理器\n \n \n \n \n 添加处理器\n \n \n \n \n \n 写入一个对象\n 目标对象\n 名称\n 类型\n \n \n \n 写入开头\n \n \n \n 写入结尾\n \n \n 获取Xml写入器\n \n \n \n 读取指定类型对象\n \n \n \n \n 读取指定类型对象\n \n \n \n \n 尝试读取指定类型对象\n \n \n \n \n \n 读取开始\n \n \n \n 读取结束\n \n \n 获取Xml读取器\n \n \n \n 获取字符串\n \n \n \n Xml复合对象处理器\n \n \n 实例化\n \n \n 写入对象\n 目标对象\n 类型\n \n \n \n 尝试读取\n \n \n \n \n \n 获取成员\n \n \n \n \n Xml基础类型处理器\n \n \n 实例化\n \n \n 写入一个对象\n 目标对象\n 类型\n 是否处理成功\n \n \n 尝试读取\n \n \n \n \n \n 列表数据编码\n \n \n 初始化\n \n \n 写入\n \n \n \n \n \n 读取\n \n \n \n \n \n 核心设置\n \n \n 是否启用全局调试。默认启用\n \n \n 日志等级，只输出大于等于该级别的日志，All/Debug/Info/Warn/Error/Fatal，默认Info\n \n \n 文件日志目录\n \n \n 网络日志。本地子网日志广播255.255.255.255:514\n \n \n 日志文件格式\n \n \n 临时目录\n \n \n 插件目录\n \n \n 插件服务器。将从该网页上根据关键字分析链接并下载插件\n \n \n 加载完成后\n \n \n 获取插件目录\n \n \n \n 轻量级线程池。无等待和调度逻辑，直接创建线程竞争处理器资源\n \n \n 初始化线程池\n \n \n \n 带异常处理的线程池任务调度，不允许异常抛出，以免造成应用程序退出\n \n \n \n 带异常处理的线程池任务调度，不允许异常抛出，以免造成应用程序退出\n \n \n \n \n 静态实例\n \n \n 内部池\n \n \n 实例化\n \n \n 创建实例\n \n \n \n 把委托放入线程池执行\n \n \n \n 在线程池中异步执行任务\n \n \n \n \n 在线程池中异步执行任务\n \n \n \n \n \n 在线程池中异步执行任务\n \n \n \n \n \n \n 线程任务项\n \n \n 编号\n \n \n 线程\n \n \n 主机线程池\n \n \n 活跃\n \n \n 实例化\n \n \n 销毁\n \n \n \n 已重载。\n \n \n \n 执行委托\n \n \n \n 定时器调度器\n \n \n 创建指定名称的调度器\n \n \n \n \n 默认调度器\n \n \n 当前调度器\n \n \n 名称\n \n \n 定时器个数\n \n \n 最大耗时。超过时报警告日志，默认500ms\n \n \n 把定时器加入队列\n \n \n \n 从队列删除定时器\n \n \n \n 唤醒处理\n \n \n 调度主程序\n \n \n \n 检查定时器是否到期\n \n \n \n \n \n 处理每一个定时器\n \n \n \n 已重载。\n \n \n \n 是否开启调试，输出更多信息\n \n \n 不可重入的定时器。\n \n 为了避免系统的Timer可重入的问题，差别在于本地调用完成后才开始计算时间间隔。这实际上也是经常用到的。\n \n 因为挂载在静态列表上，必须从外部主动调用才能销毁定时器。\n \n 该定时器不能放入太多任务，否则适得其反！\n \n TimerX必须维持对象，否则很容易被GC回收。\n \n \n \n 所属调度器\n \n \n 获取/设置 回调\n \n \n 获取/设置 用户数据\n \n \n 获取/设置 下一次调用时间\n \n \n 获取/设置 调用次数\n \n \n 获取/设置 间隔周期。毫秒，设为0或-1则只调用一次\n \n \n 获取/设置 异步执行任务。默认false\n \n \n 获取/设置 绝对精确时间执行。默认false\n \n \n 调用中\n \n \n 平均耗时。毫秒\n \n \n 判断任务是否执行的委托。一般跟异步配合使用，避免频繁从线程池借出线程\n \n \n 当前定时器\n \n \n 实例化一个不可重入的定时器\n 委托\n 用户数据\n 多久之后开始。毫秒\n 间隔周期。毫秒\n 调度器\n \n \n 实例化一个绝对定时器\n 委托\n 用户数据\n 绝对开始时间\n 间隔周期。毫秒\n 调度器\n \n \n 销毁定时器\n \n \n 是否已设置下一次时间\n \n \n 设置下一次运行时间\n 小于等于0表示马上调度\n \n \n 延迟执行一个委托\n \n \n \n \n \n 当前时间。定时读取系统时间，避免频繁读取系统时间造成性能瓶颈\n \n \n 已重载\n \n \n \n 超链接\n \n \n 名称\n \n \n 全名\n \n \n 超链接\n \n \n 原始超链接\n \n \n 标题\n \n \n 版本\n \n \n 时间\n \n \n 原始Html\n \n \n 分析HTML中的链接\n Html文本\n 基础Url，用于生成超链接的完整Url\n 用于基础过滤的过滤器\n \n \n \n 分解文件\n \n \n \n \n 已重载。\n \n \n \n 页面压缩模块\n \n \n 初始化模块，准备拦截请求。\n \n \n \n 网页压缩文件\n \n \n 是否可压缩文件\n \n \n \n \n 检查请求头，确认客户端是否支持压缩编码\n \n \n \n \n 添加压缩编码到响应头\n \n \n \n \n 全局错误处理模块\n \n \n 初始化模块，准备拦截请求。\n \n \n \n 是否需要处理\n \n \n \n \n \n 错误处理方法\n \n \n \n \n 页面执行时间模块\n \n \n 初始化模块，准备拦截请求。\n \n \n \n 初始化\n \n \n 执行时间字符串\n \n \n 输出运行时间\n \n \n 输出\n \n \n \n \n OAuth 2.0 客户端\n \n \n 名称\n \n \n 验证服务器地址\n \n \n 令牌服务地址。可以不同于验证地址的内网直达地址\n \n \n 应用Key\n \n \n 安全码\n \n \n 验证地址\n \n \n 访问令牌地址\n \n \n 响应类型\n \n 验证服务器跳转回来子系统时的类型，默认code，此时还需要子系统服务端请求验证服务器换取AccessToken；\n 可选token，此时验证服务器直接返回AccessToken，子系统不需要再次请求。\n \n \n \n 作用域\n \n \n 授权码\n \n \n 访问令牌\n \n \n 刷新令牌\n \n \n 统一标识\n \n \n 过期时间\n \n \n 访问项\n \n \n 实例化\n \n \n 根据名称创建客户端\n \n \n \n \n 应用参数设置\n \n \n \n 应用参数设置\n \n \n \n 构建跳转验证地址\n 验证完成后调整的目标地址\n 用户状态数据\n 相对地址的基地址\n \n \n 根据授权码获取访问令牌\n \n \n \n \n OpenID地址\n \n \n 根据授权码获取访问令牌\n \n \n \n 用户信息地址\n \n \n 用户ID\n \n \n 用户名\n \n \n 昵称\n \n \n 头像\n \n \n 获取用户信息\n \n \n \n 填充用户，登录成功并获取用户信息之后\n \n \n \n 注销地址\n \n \n 注销\n 完成后调整的目标地址\n 用户状态数据\n 相对地址的基地址\n \n \n \n 替换地址模版参数\n \n \n \n \n 获取名值字典\n \n \n \n \n 最后一次请求的响应内容\n \n \n 创建客户端\n 路径\n \n \n \n 从响应数据中获取信息\n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 配置\n \n \n 调试开关。默认true\n \n \n 应用地址。域名和端口，应用系统经过反向代理重定向时指定外部地址\n \n \n 配置项\n \n \n 已加载\n \n \n 获取\n \n \n \n \n 获取或添加\n \n \n \n \n 开放验证服务器配置项\n \n \n 服务地址\n \n \n 验证服务地址\n \n \n 令牌服务地址。可以不同于验证地址的内网直达地址\n \n \n 应用标识\n \n \n 密钥\n \n \n 授权范围\n \n \n 单点登录服务端\n \n \n 缓存\n \n \n 令牌提供者\n \n \n 令牌有效期。默认24小时\n \n \n 实例\n \n \n 验证用户身份\n \n 子系统需要验证访问者身份时，引导用户跳转到这里。\n 用户登录完成后，得到一个独一无二的code，并跳转回去子系统。\n \n 应用标识\n 回调地址\n 响应类型。默认code\n 授权域\n 用户状态数据\n \n \n \n 根据验证结果获取跳转回子系统的Url\n \n \n \n \n \n 根据Code获取令牌\n \n \n \n \n \n \n 解码令牌\n \n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 身份验证提供者\n \n \n 实例化\n \n \n 从响应数据中获取信息\n \n \n \n 身份验证提供者\n \n \n 实例化\n \n \n 从响应数据中获取信息\n \n \n \n 创建客户端\n 路径\n \n \n \n 身份验证提供者\n \n \n 实例化\n \n \n 从响应数据中获取信息\n \n \n \n 淘宝身份验证提供者\n \n \n 实例化\n \n \n 从响应数据中获取信息\n \n \n \n 身份验证提供者\n \n \n 实例化\n \n \n 从响应数据中获取信息\n \n \n \n 插件助手\n \n \n 加载插件\n \n \n \n \n 提供下载地址的多个目标页面\n \n \n \n 令牌提供者\n \n \n 密钥。签发方用私钥，验证方用公钥\n \n \n 读取密钥\n 文件\n 是否生成\n \n \n \n 编码用户和有效期得到令牌\n 用户\n 有效期\n \n \n \n 令牌解码得到用户和有效期\n 令牌\n 有效期\n \n \n \n 扩展的Web客户端\n \n \n Cookie容器\n \n \n 可接受类型\n \n \n 可接受语言\n \n \n 引用页面\n \n \n 超时，默认15000毫秒\n \n \n 自动解压缩模式。\n \n \n User-Agent 标头，指定有关客户端代理的信息\n \n \n 编码。网络时代，绝大部分使用utf8编码\n \n \n 保持连接\n \n \n 代理服务器地址\n \n \n 网页代理\n \n \n 实例化\n \n \n 初始化常用的东西\n 是否模拟ie\n 是否压缩\n \n \n 销毁\n \n \n \n 请求\n \n \n 响应\n \n \n 创建客户端会话\n \n \n \n 发送请求，获取响应\n \n \n \n \n \n 下载数据\n \n \n \n \n 下载字符串\n \n \n \n \n 下载文件\n \n \n \n \n 异步上传数据\n \n \n \n \n 异步上传表单\n \n \n \n \n 异步上传字符串\n \n \n \n \n 异步上传Json对象\n \n \n \n \n 获取指定地址的Html，自动处理文本编码\n \n \n \n \n 获取指定地址的Html，分析所有超链接\n \n \n \n \n 分析指定页面指定名称的链接，并下载到目标目录，返回目标文件\n \n 根据版本或时间降序排序选择\n \n 指定页面\n 页面上指定名称的链接\n 要下载到的目标目录\n 返回已下载的文件，无效时返回空\n \n \n 分析指定页面指定名称的链接，并下载到目标目录，解压Zip后返回目标文件\n 提供下载地址的多个目标页面\n 页面上指定名称的链接\n 要下载到的目标目录\n 是否覆盖目标同名文件\n \n \n \n 根据Http响应设置本地Cookie\n \n \n 从本地获取Cookie并设置到Http请求头\n \n \n 默认连接池\n \n \n 访问地址获取字符串\n \n \n \n \n 设置是否允许不安全头部\n \n 微软WebClient默认要求严格的Http头部，否则报错\n \n \n \n \n \n 日志\n \n \n 提供网页下载支持，在服务端把一个数据流作为附件传给浏览器，带有断点续传和限速的功能\n \n \n 数据流\n \n \n 文件名\n \n \n 内容类型\n \n \n 附件配置模式，是在浏览器直接打开，还是提示另存为\n \n \n 速度，每秒传输字节数，根据包大小，每响应一个包后睡眠指定毫秒数，0表示不限制\n \n \n 是否启用浏览器缓存 默认禁用\n \n \n 浏览器最大缓存时间 默认30天。通过Cache-Control头控制max-age，直接使用浏览器缓存，不会发出Http请求，对F5无效\n \n \n 文件数据最后修改时间，浏览器缓存时用\n \n \n 附件配置模式\n \n \n 不设置\n \n \n 内联模式，在浏览器直接打开\n \n \n 附件模式，提示另存为\n \n \n 分析模式\n \n \n \n \n 构造函数\n \n \n 构造函数\n \n \n \n 构造函数\n \n \n \n \n 检查浏览器缓存是否依然有效，如果有效则跳过Render\n \n \n \n 输出数据流\n \n \n 语音识别\n \n \n 系统名称。用于引导前缀\n \n \n 最后一次进入引导前缀的时间。\n \n \n 是否可用\n \n \n 销毁\n \n \n \n 当前实例\n \n \n 获取已注册的所有键值\n \n \n \n 注册要语音识别的关键字到委托\n \n \n \n \n 语音接口\n \n \n 语音识别事件\n \n \n 初始化\n \n \n \n 设置识别短语\n \n \n \n 识别事件参数\n \n \n 获取识别器分配的值，此值表示与给定输入匹配的可能性\n \n \n 获取语音识别器从识别的输入生成的规范化文本\n \n \n 实例化\n \n \n \n \n 支持Xml序列化的泛型字典类 \n \n \n \n \n \n \n \n \n \n \n \n 读取Xml\n Xml读取器\n \n \n 写入Xml\n Xml写入器\n \n \n Xml配置文件基类\n \n 标准用法：TConfig.Current\n \n 配置实体类通过特性指定配置文件路径以及自动更新时间。\n Current将加载配置文件，如果文件不存在或者加载失败，将实例化一个对象返回。\n \n 考虑到自动刷新，不提供LoadFile和SaveFile等方法，可通过扩展方法ToXmlFileEntity和ToXmlFile实现。\n \n 用户也可以通过配置实体类的静态构造函数修改基类的和来动态配置加载信息。\n \n \n \n \n 当前实例。通过置空可以使其重新加载。\n \n \n 一些设置。派生类可以在自己的静态构造函数中指定\n \n \n 是否调试\n \n \n 配置文件路径\n \n \n 重新加载时间。单位：毫秒\n \n \n 没有配置文件时是否保存新配置。默认true\n \n \n 配置文件\n \n \n 最后写入时间\n \n \n 过期时间。如果在这个时间之后再次访问，将检查文件修改时间\n \n \n 是否已更新。通过文件写入时间判断\n \n \n 设置过期重新加载配置的时间\n \n \n 是否新的配置文件\n \n \n 销毁\n \n \n \n 加载指定配置文件\n \n \n \n \n 从配置文件中读取完成后触发\n \n \n 保存到配置文件中去\n \n \n \n 保存到配置文件中去\n \n \n 异步保存\n \n \n 新创建配置文件时执行\n \n \n Xml配置文件特性\n \n \n 配置文件名\n \n \n 重新加载时间。单位：毫秒\n \n \n 指定配置文件名\n \n \n \n 指定配置文件名和重新加载时间（毫秒）\n \n \n \n \n Xml辅助类\n \n \n 序列化为Xml字符串\n 要序列化为Xml的对象\n 编码\n 是否附加注释，附加成员的Description和DisplayName注释\n 是否使用特性输出\n Xml字符串\n \n \n 序列化为Xml数据流\n 要序列化为Xml的对象\n 目标数据流\n 编码\n 是否附加注释，附加成员的Description和DisplayName注释\n 是否使用特性输出\n \n \n 序列化为Xml文件\n 要序列化为Xml的对象\n 目标Xml文件\n 编码\n 是否附加注释，附加成员的Description和DisplayName注释\n Xml字符串\n \n \n 字符串转为Xml实体对象\n 实体类型\n Xml字符串\n Xml实体对象\n \n \n 字符串转为Xml实体对象\n Xml字符串\n 实体类型\n Xml实体对象\n \n \n 数据流转为Xml实体对象\n 实体类型\n 数据流\n 编码\n Xml实体对象\n \n \n 数据流转为Xml实体对象\n 数据流\n 实体类型\n 编码\n Xml实体对象\n \n \n Xml文件转为Xml实体对象\n 实体类型\n Xml文件\n 编码\n Xml实体对象\n \n \n 简单Xml转为字符串字典\n \n \n \n \n 字符串字典转为Xml\n \n \n \n \n \n 高德地图\n \n 参考地址 http://lbs.amap.com/api/webservice/guide/api/georegeo/#geo\n \n \n \n 高德地图\n \n \n 远程调用\n 目标Url\n 结果字段\n \n \n \n 查询地址的经纬度坐标\n \n \n \n \n \n 查询地址获取坐标\n 地址\n 城市\n 是否格式化地址。高德地图默认已经格式化地址\n \n \n \n 根据坐标获取地址\n \n http://lbs.amap.com/api/webservice/guide/api/georegeo/#regeo\n \n \n \n \n \n 根据坐标获取地址\n \n \n \n \n 计算距离和驾车时间\n \n http://lbs.amap.com/api/webservice/guide/api/direction\n \n type:\n 0：直线距离\n 1：驾车导航距离（仅支持国内坐标）。\n 必须指出，当为1时会考虑路况，故在不同时间请求返回结果可能不同。\n 此策略和driving接口的 strategy = 4策略一致\n 2：公交规划距离（仅支持同城坐标）\n 3：步行规划距离（仅支持5km之间的距离）\n \n distance 路径距离，单位：米\n duration 预计行驶时间，单位：秒\n \n \n \n 路径计算的方式和方法\n \n \n \n 行政区划\n \n http://lbs.amap.com/api/webservice/guide/api/district\n \n 查询关键字\n 设置显示下级行政区级数\n 按照指定行政区划进行过滤，填入后则只返回该省/直辖市信息\n \n \n \n 是否无效Key。可能禁用或超出限制\n \n \n \n \n 百度地图\n \n 参考手册 http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding\n \n \n \n 高德地图\n \n \n 远程调用\n 目标Url\n 结果字段\n \n \n \n 查询地址的经纬度坐标\n \n \n \n \n \n 查询地址获取坐标\n 地址\n 城市\n 是否格式化地址\n \n \n \n 根据坐标获取地址\n \n \n \n \n 根据坐标获取地址\n \n \n \n \n 计算距离和驾车时间\n \n http://lbsyun.baidu.com/index.php?title=webapi/route-matrix-api-v2\n \n \n \n 路径计算的方式和方法\n \n \n \n 行政区划区域检索\n \n http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-placeapi\n \n \n \n \n \n \n \n \n 是否无效Key。可能禁用或超出限制\n \n \n \n \n 驾车距离和时间\n \n \n 距离。单位千米\n \n \n 路线耗时。单位秒\n \n \n 地图提供者接口\n \n \n 应用密钥\n \n \n 异步获取字符串\n \n \n \n \n 查询地址的经纬度坐标\n \n \n \n \n \n 查询地址获取坐标\n 地址\n 城市\n 是否格式化地址\n \n \n \n 根据坐标获取地址\n \n \n \n \n 根据坐标获取地址\n \n \n \n \n 计算距离和驾车时间\n \n \n 路径计算的方式和方法\n \n \n \n 日志\n \n \n 地图提供者\n \n \n 应用密钥。多个key逗号分隔\n \n \n 应用密码参数名\n \n \n 最后密钥\n \n \n 坐标系\n \n \n 最后网址\n \n \n 最后响应\n \n \n 最后结果\n \n \n 收到异常响应时是否抛出异常\n \n \n 销毁\n \n \n \n 异步获取字符串\n \n \n \n \n 远程调用\n 目标Url\n 结果字段\n \n \n \n 申请密钥\n \n \n \n 移除不可用密钥\n \n \n \n 是否无效Key。可能禁用或超出限制\n \n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 集合扩展\n \n \n 集合转为数组\n \n \n \n \n \n \n 集合转为数组\n \n \n \n \n \n \n \n 集合转为数组\n \n \n \n \n \n \n \n 目标匿名参数对象转为字典\n \n \n \n \n 合并字典参数\n 字典\n 目标对象\n 是否覆盖同名参数\n 排除项\n \n \n \n 转为可空字典\n \n \n \n \n \n \n \n 从队列里面获取指定个数元素\n \n 消费集合\n 元素个数\n \n \n \n 从消费集合里面获取指定个数元素\n \n 消费集合\n 元素个数\n \n \n \n 工具类\n \n 采用静态架构，允许外部重载工具类的各种实现。\n 所有类型转换均支持默认值，默认值为该default(T)，在转换失败时返回默认值。\n \n \n \n 类型转换提供者\n 重载默认提供者并赋值给可改变所有类型转换的行为\n \n \n 转为整数，转换失败时返回默认值。支持字符串、全角、字节数组（小端）、时间（Unix秒）\n Int16/UInt32/Int64等，可以先转为最常用的Int32后再二次处理\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为长整数，转换失败时返回默认值。支持字符串、全角、字节数组（小端）、时间（Unix毫秒）\n \n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为浮点数，转换失败时返回默认值。支持字符串、全角、字节数组（小端）\n Single可以先转为最常用的Double后再二次处理\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为布尔型，转换失败时返回默认值。支持大小写True/False、0和非零\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为时间日期，转换失败时返回最小时间。支持字符串、整数（Unix秒）\n 待转换对象\n \n \n \n 转为时间日期，转换失败时返回默认值\n 不是常量无法做默认值\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 时间日期转为yyyy-MM-dd HH:mm:ss完整字符串\n 最常用的时间日期格式，可以无视各平台以及系统自定义的时间格式\n 待转换对象\n \n \n \n 时间日期转为yyyy-MM-dd HH:mm:ss完整字符串，支持指定最小时间的字符串\n 最常用的时间日期格式，可以无视各平台以及系统自定义的时间格式\n 待转换对象\n 字符串空值时（DateTime.MinValue）显示的字符串，null表示原样显示最小时间，String.Empty表示不显示\n \n \n \n 时间日期转为指定格式字符串\n 待转换对象\n 格式化字符串\n 字符串空值时显示的字符串，null表示原样显示最小时间，String.Empty表示不显示\n \n \n \n 获取内部真实异常\n \n \n \n \n 获取异常消息\n 异常\n \n \n \n 默认转换\n \n \n 转为整数，转换失败时返回默认值。支持字符串、全角、字节数组（小端）、时间（Unix秒）\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为长整数。支持字符串、全角、字节数组（小端）、时间（Unix毫秒）\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为浮点数\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为布尔型。支持大小写True/False、0和非零\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 转为时间日期，转换失败时返回最小时间。支持字符串、整数（Unix秒）\n 待转换对象\n 默认值。待转换对象无效时使用\n \n \n \n 全角为半角\n 全角半角的关系是相差0xFEE0\n \n \n \n \n 时间日期转为yyyy-MM-dd HH:mm:ss完整字符串\n 待转换对象\n 字符串空值时显示的字符串，null表示原样显示最小时间，String.Empty表示不显示\n \n \n \n 时间日期转为指定格式字符串\n 待转换对象\n 格式化字符串\n 字符串空值时显示的字符串，null表示原样显示最小时间，String.Empty表示不显示\n \n \n \n 获取内部真实异常\n \n \n \n \n 获取异常消息\n 异常\n \n \n \n 字节单位字符串\n 数值\n 格式化字符串\n \n \n \n 数据位助手\n \n \n 设置数据位\n 数值\n \n \n \n \n \n 设置数据位\n 数值\n \n \n \n \n \n \n 设置数据位\n 数值\n \n \n \n \n \n 获取数据位\n 数值\n \n \n \n \n 获取数据位\n 数值\n \n \n \n \n \n 获取数据位\n 数值\n \n \n \n \n 并行字典扩展\n \n \n 从并行字典中删除\n \n \n \n \n \n \n \n 网络结点扩展\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 枚举类型助手类\n \n \n 枚举变量是否包含指定标识\n 枚举变量\n 要判断的标识\n \n \n \n 设置标识位\n \n \n \n 数值\n \n \n \n 获取枚举字段的注释\n 数值\n \n \n \n 获取枚举类型的所有字段注释\n \n \n \n \n 获取枚举类型的所有字段注释\n \n \n \n \n 扩展List，支持遍历中修改元素\n \n \n 线程安全，搜索并返回第一个，支持遍历中修改元素\n 实体列表\n 条件\n \n \n \n 线程安全，搜索并返回第一个，支持遍历中修改元素\n 实体列表\n 条件\n \n \n \n 字符串助手类\n \n \n 忽略大小写的字符串相等比较，判断是否以任意一个待比较字符串相等\n 字符串\n 待比较字符串数组\n \n \n \n 忽略大小写的字符串开始比较，判断是否以任意一个待比较字符串开始\n 字符串\n 待比较字符串数组\n \n \n \n 忽略大小写的字符串结束比较，判断是否以任意一个待比较字符串结束\n 字符串\n 待比较字符串数组\n \n \n \n 指示指定的字符串是 null 还是 String.Empty 字符串\n 字符串\n \n \n \n 是否空或者空白字符串\n 字符串\n \n \n \n 拆分字符串，过滤空格，无效时返回空数组\n 字符串\n 分组分隔符，默认逗号分号\n \n \n \n 拆分字符串成为整型数组，默认逗号分号分隔，无效时返回空数组\n 过滤空格、过滤无效、不过滤重复\n 字符串\n 分组分隔符，默认逗号分号\n \n \n \n 拆分字符串成为不区分大小写的可空名值字典。逗号分号分组，等号分隔\n 字符串\n 名值分隔符，默认等于号\n 分组分隔符，默认逗号分号\n \n \n \n 拆分字符串成为不区分大小写的可空名值字典。逗号分组，等号分隔\n 字符串\n 名值分隔符，默认等于号\n 分组分隔符，默认分号\n 去掉括号\n \n \n \n \n 在.netCore需要区分该部分内容\n \n \n \n \n \n \n \n \n 把一个列表组合成为一个字符串，默认逗号分隔\n \n 组合分隔符，默认逗号\n \n \n \n 把一个列表组合成为一个字符串，默认逗号分隔\n \n 组合分隔符，默认逗号\n 把对象转为字符串的委托\n \n \n \n 把一个列表组合成为一个字符串，默认逗号分隔\n \n 组合分隔符，默认逗号\n 把对象转为字符串的委托\n \n \n \n 追加分隔符字符串，忽略开头，常用于拼接\n 字符串构造者\n 分隔符\n \n \n \n 字符串转数组\n 字符串\n 编码，默认utf-8无BOM\n \n \n \n 格式化字符串。特别支持无格式化字符串的时间参数\n 格式字符串\n 参数\n \n \n \n 确保字符串以指定的另一字符串开始，不区分大小写\n 字符串\n \n \n \n \n 确保字符串以指定的另一字符串结束，不区分大小写\n 字符串\n \n \n \n \n 从当前字符串开头移除另一字符串，不区分大小写，循环多次匹配前缀\n 当前字符串\n 另一字符串\n \n \n \n 从当前字符串结尾移除另一字符串，不区分大小写，循环多次匹配后缀\n 当前字符串\n 另一字符串\n \n \n \n 从字符串中检索子字符串，在指定头部字符串之后，指定尾部字符串之前\n 常用于截取xml某一个元素等操作\n 目标字符串\n 头部字符串，在它之后\n 尾部字符串，在它之前\n 搜索的开始位置\n 位置数组，两个元素分别记录头尾位置\n \n \n \n 根据最大长度截取字符串，并允许以指定空白填充末尾\n 字符串\n 截取后字符串的最大允许长度，包含后面填充\n 需要填充在后面的字符串，比如几个圆点\n \n \n \n 从当前字符串开头移除另一字符串以及之前的部分\n 当前字符串\n 另一字符串\n \n \n \n 从当前字符串结尾移除另一字符串以及之后的部分\n 当前字符串\n 另一字符串\n \n \n \n 编辑距离搜索，从词组中找到最接近关键字的若干匹配项\n \n 算法代码由@Aimeast 独立完成。http://www.cnblogs.com/Aimeast/archive/2011/09/05/2167844.html\n \n 关键字\n 词组\n \n \n \n 编辑距离\n \n 又称Levenshtein距离（也叫做Edit Distance），是指两个字串之间，由一个转成另一个所需的最少编辑操作次数。\n 许可的编辑操作包括将一个字符替换成另一个字符，插入一个字符，删除一个字符。\n 算法代码由@Aimeast 独立完成。http://www.cnblogs.com/Aimeast/archive/2011/09/05/2167844.html\n \n \n \n \n \n \n 最长公共子序列搜索，从词组中找到最接近关键字的若干匹配项\n \n 算法代码由@Aimeast 独立完成。http://www.cnblogs.com/Aimeast/archive/2011/09/05/2167844.html\n \n \n \n \n \n \n \n 最长公共子序列问题是寻找两个或多个已知数列最长的子序列。\n 一个数列 S，如果分别是两个或多个已知数列的子序列，且是所有符合此条件序列中最长的，则 S 称为已知序列的最长公共子序列。\n The longest common subsequence (LCS) problem is to find the longest subsequence common to all sequences in a set of sequences (often just two). Note that subsequence is different from a substring, see substring vs. subsequence. It is a classic computer science problem, the basis of diff (a file comparison program that outputs the differences between two files), and has applications in bioinformatics.\n \n \n 算法代码由@Aimeast 独立完成。http://www.cnblogs.com/Aimeast/archive/2011/09/05/2167844.html\n \n \n 多个关键字。长度必须大于0，必须按照字符串长度升序排列。\n \n \n \n 根据列表项成员计算距离\n \n \n \n \n \n \n \n 在列表项中进行模糊搜索\n \n \n \n \n \n \n \n \n 模糊匹配\n \n \n \n \n \n \n \n 模糊匹配\n \n \n \n \n \n \n 模糊匹配\n \n 列表项\n 关键字\n 匹配字符串选择\n 获取个数\n 权重阀值\n \n \n \n 调用语音引擎说出指定话\n \n \n \n 异步调用语音引擎说出指定话。可能导致后来的调用打断前面的语音\n \n \n \n 启用语音提示\n \n \n 语音提示操作\n \n \n \n \n 停止所有语音播报\n \n \n \n \n 以隐藏窗口执行命令行\n 文件名\n 命令参数\n 等待毫秒数\n 进程输出内容。默认为空时输出到日志\n 进程退出时执行\n 进程退出代码\n \n \n IO工具类\n \n \n 压缩数据流\n 输入流\n 输出流。如果不指定，则内部实例化一个内存流\n 返回输出流，注意此时指针位于末端\n \n \n 解压缩数据流\n 输入流\n 输出流。如果不指定，则内部实例化一个内存流\n 返回输出流，注意此时指针位于末端\n \n \n 压缩字节数组\n 字节数组\n \n \n \n 解压缩字节数组\n 字节数组\n \n \n \n 压缩数据流\n 输入流\n 输出流。如果不指定，则内部实例化一个内存流\n 返回输出流，注意此时指针位于末端\n \n \n 解压缩数据流\n 输入流\n 输出流。如果不指定，则内部实例化一个内存流\n 返回输出流，注意此时指针位于末端\n \n \n 复制数据流\n 源数据流\n 目的数据流\n 缓冲区大小，也就是每次复制的大小\n 最大复制字节数\n 返回复制的总字节数\n \n \n 把一个数据流写入到另一个数据流\n 目的数据流\n 源数据流\n 缓冲区大小，也就是每次复制的大小\n 最大复制字节数\n \n \n \n 把一个字节数组写入到一个数据流\n 目的数据流\n 源数据流\n \n \n \n 写入字节数组，先写入压缩整数表示的长度\n \n \n \n \n \n 读取字节数组，先读取压缩整数表示的长度\n \n \n \n \n 写入Unix格式时间，1970年以来秒数，绝对时间，非UTC\n \n \n \n \n \n 读取Unix格式时间，1970年以来秒数，绝对时间，非UTC\n \n \n \n \n 复制数组\n 源数组\n 起始位置\n 复制字节数\n 返回复制的总字节数\n \n \n 向字节数组写入一片数据\n 目标数组\n 目标偏移\n 源数组\n 源数组偏移\n 数量\n 返回实际写入的字节个数\n \n \n 合并两个数组\n 源数组\n 目标数组\n 起始位置\n 字节数\n \n \n \n 数据流转为字节数组\n \n 针对MemoryStream进行优化。内存流的Read实现是一个个字节复制，而ToArray是调用内部内存复制方法\n 如果要读完数据，又不支持定位，则采用内存流搬运\n 如果指定长度超过数据流长度，就让其报错，因为那是调用者所期望的值\n \n 数据流\n 长度，0表示读到结束\n \n \n \n 数据流转为字节数组，从0开始，无视数据流的当前位置\n 数据流\n \n \n \n 从数据流中读取字节数组，直到遇到指定字节数组\n 数据流\n 字节数组\n 字节数组中的偏移\n 字节数组中的查找长度\n 未找到时返回空，0位置范围大小为0的字节数组\n \n \n 从数据流中读取字节数组，直到遇到指定字节数组\n 数据流\n \n \n \n \n \n 从数据流中读取一行，直到遇到换行\n 数据流\n \n 未找到返回null，0位置返回String.Empty\n \n \n 流转换为字符串\n 目标流\n 编码格式\n \n \n \n 字节数组转换为字符串\n 字节数组\n 编码格式\n 字节数组中的偏移\n 字节数组中的查找长度\n \n \n \n 从字节数据指定位置读取一个无符号16位整数\n \n 偏移\n 是否小端字节序\n \n \n \n 从字节数据指定位置读取一个无符号32位整数\n \n 偏移\n 是否小端字节序\n \n \n \n 从字节数据指定位置读取一个无符号64位整数\n \n 偏移\n 是否小端字节序\n \n \n \n 向字节数组的指定位置写入一个无符号16位整数\n \n 数字\n 偏移\n 是否小端字节序\n \n \n \n 向字节数组的指定位置写入一个无符号32位整数\n \n 数字\n 偏移\n 是否小端字节序\n \n \n \n 向字节数组的指定位置写入一个无符号64位整数\n \n 数字\n 偏移\n 是否小端字节序\n \n \n \n 整数转为字节数组，注意大小端字节序\n \n \n \n \n \n 整数转为字节数组，注意大小端字节序\n \n \n \n \n \n 整数转为字节数组，注意大小端字节序\n \n \n \n \n \n 整数转为字节数组，注意大小端字节序\n \n \n \n \n \n 整数转为字节数组，注意大小端字节序\n \n \n \n \n \n 整数转为字节数组，注意大小端字节序\n \n \n \n \n \n 以压缩格式读取32位整数\n 数据流\n \n \n \n 以压缩格式读取32位整数\n 数据流\n \n \n \n 尝试读取压缩编码整数\n \n \n \n \n \n \n 以7位压缩格式写入32位整数，小于7位用1个字节，小于14位用2个字节。\n 由每次写入的一个字节的第一位标记后面的字节是否还是当前数据，所以每个字节实际可利用存储空间只有后7位。\n \n 数据流\n 数值\n 实际写入字节数\n \n \n 获取压缩编码整数\n \n \n \n \n 在数据流中查找字节数组的位置，流指针会移动到结尾\n 数据流\n 字节数组\n 字节数组中的偏移\n 字节数组中的查找长度\n \n \n \n 在字节数组中查找另一个字节数组的位置，不存在则返回-1\n 字节数组\n 另一个字节数组\n 偏移\n 查找长度\n \n \n \n 在字节数组中查找另一个字节数组的位置，不存在则返回-1\n 字节数组\n 源数组起始位置\n 查找长度\n 另一个字节数组\n 偏移\n 查找长度\n \n \n \n 比较两个字节数组大小。相等返回0，不等则返回不等的位置，如果位置为0，则返回1。\n \n 缓冲区\n \n \n \n 比较两个字节数组大小。相等返回0，不等则返回不等的位置，如果位置为0，则返回1。\n \n \n 数量\n 缓冲区\n 偏移\n \n \n \n \n 字节数组分割\n \n \n \n \n \n 一个数据流是否以另一个数组开头。如果成功，指针移到目标之后，否则保持指针位置不变。\n \n 缓冲区\n \n \n \n 一个数据流是否以另一个数组结尾。如果成功，指针移到目标之后，否则保持指针位置不变。\n \n 缓冲区\n \n \n \n 一个数组是否以另一个数组开头\n \n 缓冲区\n \n \n \n 一个数组是否以另一个数组结尾\n \n 缓冲区\n \n \n \n 倒序、更换字节序\n 字节数组\n \n \n \n 把字节数组编码为十六进制字符串\n 字节数组\n 偏移\n 数量。超过实际数量时，使用实际数量\n \n \n \n 把字节数组编码为十六进制字符串，带有分隔符和分组功能\n 字节数组\n 分隔符\n 分组大小，为0时对每个字节应用分隔符，否则对每个分组使用\n 最大显示多少个字节。默认-1显示全部\n \n \n \n 解密\n Hex编码的字符串\n 起始位置\n 长度\n \n \n \n 字节数组转为Base64编码\n \n \n \n 是否换行显示\n \n \n \n 字节数组转为Url改进型Base64编码\n \n \n \n \n \n \n Base64字符串转为字节数组\n \n \n \n \n 路径操作帮助\n \n \n 基础目录。GetFullPath依赖于此，默认为当前应用程序域基础目录\n \n \n 获取文件或目录的全路径，过滤相对目录\n 不确保目录后面一定有分隔符，是否有分隔符由原始路径末尾决定\n 文件或目录\n \n \n \n 获取文件或目录基于应用程序域基目录的全路径，过滤相对目录\n 不确保目录后面一定有分隔符，是否有分隔符由原始路径末尾决定\n 文件或目录\n \n \n \n 获取文件或目录基于当前目录的全路径，过滤相对目录\n 不确保目录后面一定有分隔符，是否有分隔符由原始路径末尾决定\n 文件或目录\n \n \n \n 确保目录存在，若不存在则创建\n \n 斜杠结尾的路径一定是目录，无视第二参数；\n 默认是文件，这样子只需要确保上一层目录存在即可，否则如果把文件当成了目录，目录的创建会导致文件无法创建。\n \n 文件路径或目录路径，斜杠结尾的路径一定是目录，无视第二参数\n 该路径是否是否文件路径。文件路径需要取目录部分\n \n \n \n 合并多段路径\n \n \n \n \n \n 文件路径作为文件信息\n \n \n \n \n 从文件中读取数据\n \n \n \n \n \n \n 把数据写入文件指定位置\n \n \n \n \n \n \n 读取所有文本，自动检测编码\n 性能较File.ReadAllText略慢，可通过提前检测BOM编码来优化\n \n \n \n \n \n 把文本写入文件，自动检测编码\n \n \n \n \n \n \n 复制到目标文件，目标文件必须已存在，且源文件较新\n 源文件\n 目标文件\n \n \n \n 打开并读取\n 返回类型\n 文件信息\n 要对文件流操作的委托\n \n \n \n 打开并写入\n 返回类型\n 文件信息\n 要对文件流操作的委托\n \n \n \n 解压缩\n \n \n 是否覆盖目标同名文件\n \n \n 压缩文件\n \n \n \n \n 路径作为目录信息\n \n \n \n \n 获取目录内所有符合条件的文件，支持多文件扩展匹配\n 目录\n 文件扩展列表。比如*.exe;*.dll;*.config\n 是否包含所有子孙目录文件\n \n \n \n 复制目录中的文件\n 源目录\n 目标目录\n 文件扩展列表。比如*.exe;*.dll;*.config\n 是否包含所有子孙目录文件\n 复制每一个文件之前的回调\n \n \n \n 对比源目录和目标目录，复制双方都存在且源目录较新的文件\n 源目录\n 目标目录\n 文件扩展列表。比如*.exe;*.dll;*.config\n 是否包含所有子孙目录文件\n 复制每一个文件之前的回调\n \n \n \n 从多个目标目录复制较新文件到当前目录\n 当前目录\n 多个目标目录\n 文件扩展列表。比如*.exe;*.dll;*.config\n 是否包含所有子孙目录文件\n \n \n \n 压缩\n \n \n \n \n 模型扩展\n \n \n 获取指定类型的服务对象\n \n \n \n \n \n 对象容器助手。扩展方法专用\n \n \n 注册类型和名称\n 接口类型\n 实现类型\n 对象容器\n 标识\n 优先级\n \n \n \n 注册类型指定名称的实例\n 接口类型\n 对象容器\n 实例\n 标识\n 优先级\n \n \n \n 解析类型指定名称的实例\n 接口类型\n 对象容器\n 标识\n \n \n \n 解析类型指定名称的实例\n 接口类型\n 对象容器\n 标识\n \n \n \n 遍历所有程序集的所有类型，自动注册实现了指定接口或基类的类型。如果没有注册任何实现，则默认注册第一个排除类型\n 自动注册一般用于单实例功能扩展型接口\n 接口类型\n 要排除的类型，一般是内部默认实现\n 对象容器\n \n \n \n 解析接口指定名称的实现类型\n 接口类型\n 对象容器\n 标识\n \n \n \n 网络工具类\n \n \n 设置超时检测时间和检测间隔\n 要设置的Socket对象\n 是否启用Keep-Alive\n 多长时间后开始第一次探测（单位：毫秒）\n 探测时间间隔（单位：毫秒）\n \n \n 分析地址，根据IP或者域名得到IP地址，缓存60秒，异步更新\n \n \n \n \n 分析网络终结点\n 地址，可以不带端口\n 地址不带端口时指定的默认端口\n \n \n \n 针对IPv4和IPv6获取合适的Any地址\n 除了Any地址以为，其它地址不具备等效性\n \n \n \n \n \n 是否Any地址，同时处理IPv4和IPv6\n \n \n \n \n 是否Any结点\n \n \n \n \n 是否IPv4地址\n \n \n \n \n 是否本地地址\n \n \n \n \n 获取相对于指定远程地址的本地地址\n \n \n \n \n \n 获取相对于指定远程地址的本地地址\n \n \n \n \n \n 指定地址的指定端口是否已被使用，似乎没办法判断IPv6地址\n \n \n \n \n \n \n 检查该协议的地址端口是否已经呗使用\n \n \n \n \n 获取活动的接口信息\n \n \n \n 获取可用的DHCP地址\n \n \n \n 获取可用的DNS地址\n \n \n \n 获取可用的网关地址\n \n \n \n 获取可用的IP地址\n \n \n \n 获取本机可用IP地址，缓存60秒，异步更新\n \n \n \n 获取可用的多播地址\n \n \n \n 获取以太网MAC地址\n \n \n \n 获取本地第一个IPv4地址\n \n \n \n 获取本地第一个IPv6地址\n \n \n \n 唤醒指定MAC地址的计算机\n \n \n \n 根据IP地址获取MAC地址\n \n \n \n \n 获取IP地址的物理地址位置\n \n \n \n \n 根据字符串形式IP地址转为物理地址\n \n \n \n \n IP地址提供者接口\n \n \n 获取IP地址的物理地址位置\n \n \n \n \n 根据本地网络标识创建客户端\n \n \n \n \n 根据远程网络标识创建客户端\n \n \n \n \n 特性辅助类\n \n \n 获取自定义属性，带有缓存功能，避免因.Net内部GetCustomAttributes没有缓存而带来的损耗\n \n \n \n \n \n 获取成员绑定的显示名，优先DisplayName，然后Description\n \n \n \n \n \n 获取成员绑定的显示名，优先DisplayName，然后Description\n \n \n \n \n \n 获取自定义属性的值。可用于ReflectionOnly加载的程序集\n \n \n \n \n \n 获取自定义属性的值。可用于ReflectionOnly加载的程序集\n \n \n 目标对象\n 是否递归\n \n \n \n 安全算法\n \n \n MD5散列\n \n \n \n \n MD5散列\n \n 字符串编码，默认Default\n \n \n \n MD5散列\n \n 字符串编码，默认Default\n \n \n \n Crc散列\n \n \n \n \n Crc16散列\n \n \n \n \n SHA128\n \n \n \n \n \n SHA256\n \n \n \n \n \n SHA384\n \n \n \n \n \n SHA512\n \n \n \n \n \n 对称加密算法扩展\n 注意：CryptoStream会把 outstream 数据流关闭\n \n \n \n \n \n \n 对称加密算法扩展\n 算法\n 数据\n 密码\n 模式。.Net默认CBC，Java默认ECB\n 填充算法。默认PKCS7，等同Java的PKCS5\n \n \n \n 对称解密算法扩展\n 注意：CryptoStream会把 instream 数据流关闭\n \n \n \n \n \n \n \n 对称解密算法扩展\n 算法\n 数据\n 密码\n 模式。.Net默认CBC，Java默认ECB\n 填充算法。默认PKCS7，等同Java的PKCS5\n \n \n \n RC4对称加密算法\n \n \n \n \n \n 控件助手\n \n \n 执行无参委托\n \n \n \n \n \n 执行单一参数无返回值的委托\n \n \n \n \n \n \n \n 执行二参数无返回值的委托\n \n \n \n \n \n \n \n \n 附加文本到文本控件末尾。主要解决非UI线程以及滚动控件等问题\n 控件\n 消息\n 最大行数。超过该行数讲清空控件\n \n \n \n 滚动控件的滚动条\n 指定控件\n 是否底端，或者顶端\n \n \n \n 处理回车，移到行首\n \n \n \n \n 设置默认样式，包括字体、前景色、背景色\n 控件\n 字体大小\n \n \n \n 设置字体大小\n \n \n \n \n \n 采用默认着色方案进行着色\n 文本控件\n 开始位置\n \n \n 改变C++类名方法名颜色\n \n \n 着色文本控件的内容\n 文本控件\n 正则表达式\n 开始位置\n 颜色数组\n \n \n \n 着色文本控件的内容\n 文本控件\n 正则表达式\n 开始位置\n 颜色数组\n \n \n \n 当前Dpi\n \n \n 修正ListView的Dpi\n \n \n \n 修正窗体的Dpi\n \n \n \n\n"
},
{
"path": "DLL/NewLife.RocketMQ.xml",
"content": "\n\n \n NewLife.RocketMQ\n \n \n \n 代理客户端\n \n \n 服务器地址\n \n \n 实例化代理客户端\n \n \n \n 启动\n \n \n 注销客户端\n \n \n \n \n 心跳\n \n \n 获取运行时信息\n \n \n \n 集群客户端\n \n 维护到一个集群的客户端连接，内部采用负载均衡调度算法。\n \n \n \n 编号\n \n \n 名称\n \n \n 超时。默认3000ms\n \n \n 服务器地址集合\n \n \n 配置\n \n \n 实例化\n \n \n 销毁\n \n \n \n 开始\n \n \n 确保创建连接\n \n \n 发送命令\n \n \n \n \n 发送指定类型的命令\n \n \n \n \n \n \n \n 建立命令时，处理头部\n \n \n \n 收到命令时\n \n \n 收到命令\n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 权限\n \n \n 写入\n \n \n 读取\n \n \n 代理信息\n \n \n 名称\n \n \n 地址集合\n \n \n 权限\n \n \n 读队列数\n \n \n 写队列数\n \n \n 主题同步标记\n \n \n 相等比较\n \n \n \n \n 计算哈希\n \n \n \n 带权重负载均衡算法\n \n \n 权重集合\n \n \n 最小权重\n \n \n 状态值\n \n \n 次数\n \n \n 实例化\n \n \n 根据权重选择，并返回该项是第几次选中\n \n \n \n 根据权重选择\n \n \n \n 消费者\n \n \n 数据\n \n \n 消费间隔。默认15_000ms\n \n \n 持久化消费偏移间隔。默认5_000ms\n \n \n 拉取的批大小。默认32\n \n \n 启动时间\n \n \n 从最后偏移开始消费。默认true\n \n \n 消费委托\n \n \n 销毁\n \n \n \n 启动\n \n \n \n 从指定队列拉取消息\n \n \n \n \n \n \n \n 查询指定队列的偏移量\n \n \n \n \n \n 查询“队列”最大偏移量，不是消费提交的最后偏移量\n \n \n \n \n \n \n 获取最小偏移量\n \n \n \n \n \n 根据时间戳查询偏移\n \n \n \n \n \n 更新队列的偏移\n \n \n \n \n \n 获取消费者下所有消费者\n \n \n \n 启动消费者时自动开始调度。默认true\n \n \n 开始调度\n \n \n 拉取到一批消息\n \n \n \n \n \n 当前所需要消费的队列。由均衡算法产生\n \n \n 相等比较\n \n \n \n \n 计算哈希\n \n \n \n 重新平衡消费队列\n \n \n \n 收到命令\n \n \n \n 业务基类\n \n \n 名称服务器地址\n \n \n 消费组\n \n \n 主题\n \n \n 本地IP地址\n \n \n 实例名\n \n \n 拉取名称服务器间隔。默认30_000ms\n \n \n Broker心跳间隔。默认30_000ms\n \n \n 单元名称\n \n \n 单元模式\n \n \n 是否可用\n \n \n 代理集合\n \n \n 名称服务器\n \n \n 获取名称服务器地址的http地址\n \n \n 访问令牌\n \n \n 访问密钥\n \n \n 阿里云MQ通道\n \n \n 客户端标识\n \n \n 实例化\n \n \n 销毁\n \n \n \n 友好字符串\n \n \n \n 开始\n \n \n \n 获取代理客户端\n \n \n \n \n Broker客户端集合\n \n \n 收到命令\n \n \n \n 日志\n \n \n 写日志\n \n \n \n \n 连接名称服务器的客户端\n \n \n Broker集合\n \n \n 代理改变时触发\n \n \n 实例化\n \n \n \n \n 启动\n \n \n 获取主题的路由信息，含登录验证\n \n \n \n \n 生产者\n \n \n 启动\n \n \n \n 发送消息\n \n \n \n \n \n 发布消息\n \n \n \n \n \n \n 创建主题\n \n \n \n \n \n 选择队列\n \n \n \n 命令\n \n \n 头部\n \n \n 主体\n \n \n 是否响应\n \n \n \n \n \n \n \n \n 从数据流中读取\n \n \n \n \n \n 读取Body作为Json返回\n \n \n \n 写入命令到数据流\n \n \n \n \n \n 命令转字节数组\n \n \n \n 创建响应\n \n \n \n 友好字符串\n \n \n \n 头部\n \n \n 请求/响应码\n \n \n 扩展字段\n \n 这个字段不通的请求/响应不一样，完全自定义。数据结构上是java的hashmap。\n 在Java的每个RemotingCammand中，其实都带有一个CommandCustomHeader的属性成员，可以认为他是一个强类型的extFields，\n 再最后传输的时候，这个CommandCustomHeader会被忽略，而传输前会把其中的所有字段全部都原封不动塞到extFields中，以作传输。\n \n \n \n 标识\n \n 第0位标识是这次通信是request还是response，0标识request, 1 标识response。\n 第1位标识是否是oneway请求，1标识oneway。应答方在处理oneway请求的时候，不会做出响应，请求方也无需等待应答方响应。\n \n \n \n 由于要支持多语言，所以这一字段可以给通信双方知道对方通信层锁使用的开发语言\n 这里必须是JAVA，不能是CSharp，甚至Java都不行\n \n \n 请求标识码。在Java版的通信层中，这个只是一个不断自增的整形，为了收到应答方响应的的时候找到对应的请求。\n \n \n 序列化类型\n \n \n 给通信层知道对方的版本号，响应方可以以此做兼容老版本等的特殊操作\n \n \n 附带的文本信息。常见的如存放一些broker/nameserver返回的一些异常信息，方便开发人员定位问题。\n \n \n 获取扩展字段。如果为空则创建\n \n \n \n 心跳数据\n \n \n 客户端编号\n \n \n 消费数据集\n \n \n 生产者数据集\n \n \n 生产者数据\n \n \n 组名\n \n \n 消费者数据\n \n \n 从哪里开始消费\n \n \n 消费类型\n \n \n 组名\n \n \n 消息模型。广播/集群\n \n \n 订阅数据集\n \n \n 单元模式\n \n \n 订阅者数据\n \n \n 主题\n \n \n 表达式类型\n \n \n 子字符串\n \n \n 标签集合\n \n \n 代码集合\n \n \n 过滤模式\n \n \n 过滤源\n \n \n 子版本\n \n \n 消息\n \n \n 主题\n \n \n 标签\n \n \n 键\n \n \n 标记\n \n \n 消息体\n \n \n 消息体。字符串格式\n \n \n 等待存储消息\n \n \n 延迟时间等级\n \n \n 友好字符串\n \n \n \n 获取属性\n \n \n \n 设置数据\n \n \n \n 消息扩展\n \n \n 队列编号\n \n \n 存储大小\n \n \n CRC校验\n \n \n 队列偏移\n \n \n 提交日志偏移\n \n \n 系统标记\n \n \n 生产时间\n \n \n 生产主机\n \n \n 存储时间\n \n \n 存储主机\n \n \n 重新消费次数\n \n \n 准备事务偏移\n \n \n 属性\n \n \n 消息编号\n \n \n 友好字符串\n \n \n \n 从数据流中读取\n \n \n \n \n \n 读取所有消息\n \n \n \n \n 写入命令到数据流\n \n \n \n \n \n 消息队列\n \n \n 主题\n \n \n 代理名称\n \n \n 队列编号\n \n \n 相等比较\n \n \n \n \n 计算哈希\n \n \n \n 友好字符串\n \n \n \n 编码器\n \n \n 实例化编码器\n \n \n 编码\n \n \n \n \n \n 加入队列\n \n \n \n \n \n 解码\n \n \n \n \n \n 连接关闭时，清空粘包编码器\n \n \n \n \n \n 是否匹配响应\n \n \n \n \n \n 拉取信息请求头\n \n \n 消费组\n \n \n 主题\n \n \n 订阅表达式\n \n \n 挂起超时时间。默认20_000ms\n \n \n 子版本\n \n \n 队列\n \n \n 队列偏移\n \n \n 最大消息数\n \n \n 提交偏移\n \n \n 系统标记\n \n \n 获取属性字典\n \n \n \n 拉取状态\n \n \n 已发现\n \n \n 没有新的消息\n \n \n 没有匹配消息\n \n \n 偏移量非法\n \n \n 未知类型\n \n \n 拉取结果\n \n \n 状态\n \n \n 最小偏移\n \n \n 最大偏移\n \n \n 下一轮拉取偏移\n \n \n 消息\n \n \n 友好字符串\n \n \n \n 读取数据\n \n \n \n 查询结果\n \n \n 最后更新时间\n \n \n 消息列表\n \n \n 请求代码\n \n \n 发消息\n \n \n 收消息\n \n \n 查询消费偏移\n \n \n 用于向brokers查询所有的topic和它们的配置\n \n \n 获取代理配置\n \n \n 获取代理运行时信息,包括broker版本、磁盘容量、系统负载等\n \n \n 获取topic/队列偏移量的最大值\n \n \n 获取topic/队列偏移量的最小值\n \n \n 发送心跳\n \n \n 注销\n \n \n 当consumer客户端无法处理消息时,将这些消息发送回brokers,以便将来将这些消息重新发送给consumers\n \n \n 查询每个consumer group的存活成员\n \n \n 当broker得知一个consumer宕机时,它会通知其他工作的consumers尽快重新平衡\n \n \n 获取所有的消费的偏移量\n \n \n 获取延迟topic的偏移量\n \n \n 获取topic路由信息\n \n \n 获取群集信息\n \n \n 创建新的consumer group或更新现有的consumer group以更改属性\n \n \n 查询所有已知的consumer group配置\n \n \n 查询topic相关的统计信息\n \n \n 查询所有topic\n \n \n 要求broker从consumer客户端按给定的时间戳重置偏移量\n \n \n update the config of name server\n \n \n get config from name server\n \n \n 批处理模式发送消息\n \n \n 响应码\n \n \n 响应异常\n \n \n 响应代码\n \n \n 实例化响应异常\n \n \n \n \n 发送消息请求头\n \n \n 生产组\n \n \n 主题\n \n \n 默认主题\n \n \n 默认主题队列数\n \n \n 队列编号\n \n \n 系统标记\n \n \n 生产时间。毫秒\n \n \n 标记\n \n \n 属性。Tags/Keys等\n \n \n 重新消费次数\n \n \n 单元模式\n \n \n 获取属性字典\n \n \n \n 发送状态\n \n \n 成功\n \n \n 刷盘超时\n \n \n 刷从机超时\n \n \n 从机不可用\n \n \n 发送结果\n \n \n 状态\n \n \n 消息编号\n \n \n 队列\n \n \n 队列偏移\n \n \n 事务编号\n \n \n 偏移消息编号\n \n \n 区域\n \n \n 读取结果\n \n \n \n 服务状态\n \n \n 刚刚建立\n \n \n 运行中\n \n \n 已经关闭\n \n \n 启动失败\n \n \n\n"
},
{
"path": "Doc/Changelog.md",
"content": "# NewLife.RocketMQ 更新日志 2026\n\n## v3.0.2026.0304 (2026-03-04)\n\n### 架构优化\n* 重构 RocketMQ gRPC 协议为 SpanReader/SpanWriter 实现，提升性能\n* 重构架构文档，优化编解码器实现\n* 优化项目文件描述及标题信息\n\n### 文档完善\n* 文档体系重构：新增架构与需求文档，优化 Readme\n* 新增架构设计文档和功能分析文档\n\n### 依赖升级\n* 升级 NewLife.Core 依赖到最新版本\n\n---\n\n## v3.0.2026.0228 (2026-02-28)\n\n### 问题修复\n* 修复逻辑缺陷并补充单元测试\n* 新增客户端拉取超时机制，防止 RocketMQ 4.9.8 消费者线程卡死\n\n---\n\n## v3.0.2026.0216 (2026-02-16)\n\n### 重大更新：v3.0 云适配重构\n* 云适配重构与功能全面单元测试覆盖\n* 完善兼容性梳理与优化进展\n\n### 新增特性\n* 新增 VIP 通道支持\n* 新增批量消息确认机制\n* 新增 5.x MsgId 支持\n* 新增 gRPC Telemetry 遥测支持\n* 完整实现**事务消息**功能（PR #108）\n - 增加 RocketMQ 事务消息发布与结束接口\n - 完善事务消息实现并通过审查与安全扫描\n* 完整实现**请求-应答模式** (Request-Reply) 功能（PR #107）\n - 完善 RocketMQ 5.0 特性支持\n - 通过单元测试和文档验证\n\n### 文档完善\n* 新增功能分析与架构设计文档\n* Phase 6 文档总结：兼容性梳理与优化进展\n\n### 依赖升级\n* 升级 NuGet 依赖包\n\n---\n\n## v3.0.2026.0211 (2026-02-11)\n\n### 依赖升级\n* 升级 NewLife.Core 依赖到最新版本\n"
},
{
"path": "Doc/RequestReply_Guide.md",
"content": "# RocketMQ Request-Reply 使用指南\n\n## 概述\n\n从 RocketMQ 4.6.0 版本开始，引入了 Request-Reply 特性，该特性允许生产者在发送消息后同步或异步等待消费者消费完消息并返回响应消息，实现类似 RPC 调用的效果。\n\nNewLife.RocketMQ 现已支持此特性，并兼容 RocketMQ 5.0+。\n\n## 主要特性\n\n- **同步请求**：发送请求后阻塞等待响应\n- **异步请求**：发送请求后异步等待响应\n- **超时控制**：支持设置请求超时时间\n- **自动关联**：自动管理请求和响应的关联\n- **简单易用**：API 设计简洁，易于集成\n\n## 使用示例\n\n### 1. 生产者端 - 发送请求\n\n#### 同步请求\n\n```csharp\nusing NewLife.RocketMQ;\n\n// 创建生产者\nvar producer = new Producer\n{\n Topic = \"request_topic\",\n NameServerAddress = \"127.0.0.1:9876\",\n RequestTimeout = 3000 // 设置默认超时时间为3秒\n};\nproducer.Start();\n\ntry\n{\n // 发送请求并同步等待响应\n var requestBody = \"这是一个请求消息\";\n var response = producer.Request(requestBody, timeout: 5000);\n \n Console.WriteLine($\"收到响应: {response.BodyString}\");\n}\nfinally\n{\n producer.Stop();\n producer.Dispose();\n}\n```\n\n#### 异步请求\n\n```csharp\nusing NewLife.RocketMQ;\n\n// 创建生产者\nvar producer = new Producer\n{\n Topic = \"request_topic\",\n NameServerAddress = \"127.0.0.1:9876\",\n RequestTimeout = 3000\n};\nproducer.Start();\n\ntry\n{\n // 异步发送请求并等待响应\n var requestBody = \"这是一个异步请求消息\";\n var response = await producer.RequestAsync(requestBody, timeout: 5000);\n \n Console.WriteLine($\"收到响应: {response.BodyString}\");\n}\nfinally\n{\n producer.Stop();\n producer.Dispose();\n}\n```\n\n### 2. 消费者端 - 处理请求并发送回复\n\n#### 同步处理\n\n```csharp\nusing NewLife.RocketMQ;\n\n// 创建消费者\nvar consumer = new Consumer\n{\n Topic = \"request_topic\",\n Group = \"request_consumer_group\",\n NameServerAddress = \"127.0.0.1:9876\",\n FromLastOffset = false\n};\n\n// 设置消息处理回调\nconsumer.OnConsume = (queue, messages) =>\n{\n foreach (var message in messages)\n {\n Console.WriteLine($\"收到请求: {message.BodyString}\");\n \n // 检查是否是请求消息\n if (!String.IsNullOrEmpty(message.CorrelationId))\n {\n // 处理业务逻辑\n var result = ProcessRequest(message.BodyString);\n \n // 发送回复\n consumer.SendReply(message, result);\n \n Console.WriteLine($\"已发送回复: {result}\");\n }\n }\n return true;\n};\n\nconsumer.Start();\n\n// 保持运行\nConsole.WriteLine(\"消费者已启动，按任意键退出...\");\nConsole.ReadKey();\n\nconsumer.Stop();\nconsumer.Dispose();\n\nstring ProcessRequest(string request)\n{\n // 实现你的业务逻辑\n return $\"处理结果: {request}\";\n}\n```\n\n#### 异步处理\n\n```csharp\nusing NewLife.RocketMQ;\n\n// 创建消费者\nvar consumer = new Consumer\n{\n Topic = \"request_topic\",\n Group = \"request_consumer_group\",\n NameServerAddress = \"127.0.0.1:9876\",\n FromLastOffset = false\n};\n\n// 设置异步消息处理回调\nconsumer.OnConsumeAsync = async (queue, messages, cancellationToken) =>\n{\n foreach (var message in messages)\n {\n Console.WriteLine($\"收到请求: {message.BodyString}\");\n \n // 检查是否是请求消息\n if (!String.IsNullOrEmpty(message.CorrelationId))\n {\n // 异步处理业务逻辑\n var result = await ProcessRequestAsync(message.BodyString, cancellationToken);\n \n // 异步发送回复\n await consumer.SendReplyAsync(message, result, cancellationToken);\n \n Console.WriteLine($\"已发送回复: {result}\");\n }\n }\n return true;\n};\n\nconsumer.Start();\n\n// 保持运行\nConsole.WriteLine(\"消费者已启动，按任意键退出...\");\nConsole.ReadKey();\n\nconsumer.Stop();\nconsumer.Dispose();\n\nasync Task ProcessRequestAsync(string request, CancellationToken ct)\n{\n // 实现你的异步业务逻辑\n await Task.Delay(100, ct); // 模拟异步操作\n return $\"处理结果: {request}\";\n}\n```\n\n### 3. 超时处理\n\n```csharp\nusing NewLife.RocketMQ;\n\nvar producer = new Producer\n{\n Topic = \"request_topic\",\n NameServerAddress = \"127.0.0.1:9876\",\n RequestTimeout = 1000 // 默认超时1秒\n};\nproducer.Start();\n\ntry\n{\n var response = await producer.RequestAsync(\"请求消息\");\n Console.WriteLine($\"收到响应: {response.BodyString}\");\n}\ncatch (TimeoutException ex)\n{\n Console.WriteLine($\"请求超时: {ex.Message}\");\n}\nfinally\n{\n producer.Stop();\n producer.Dispose();\n}\n```\n\n## API 参考\n\n### Producer 类\n\n#### 属性\n\n- `RequestTimeout`：请求超时时间（毫秒），默认 3000ms\n\n#### 方法\n\n- `MessageExt Request(Message message, Int32 timeout = -1)`\n - 发送请求消息，同步等待响应\n - 参数：\n - `message`：请求消息\n - `timeout`：超时时间（毫秒），-1 表示使用默认超时时间\n - 返回：响应消息\n - 异常：`TimeoutException` - 请求超时\n\n- `MessageExt Request(Object body, Int32 timeout = -1)`\n - 发送请求消息，同步等待响应（简化版本）\n - 参数：\n - `body`：消息体内容\n - `timeout`：超时时间（毫秒）\n - 返回：响应消息\n\n- `Task RequestAsync(Message message, Int32 timeout = -1, CancellationToken cancellationToken = default)`\n - 异步发送请求消息并等待响应\n - 参数：\n - `message`：请求消息\n - `timeout`：超时时间（毫秒）\n - `cancellationToken`：取消令牌\n - 返回：响应消息\n - 异常：`TimeoutException` - 请求超时\n\n- `Task RequestAsync(Object body, Int32 timeout = -1, CancellationToken cancellationToken = default)`\n - 异步发送请求消息并等待响应（简化版本）\n\n### Consumer 类\n\n#### 方法\n\n- `SendResult SendReply(MessageExt requestMessage, Object replyBody)`\n - 发送回复消息\n - 参数：\n - `requestMessage`：原始请求消息\n - `replyBody`：回复消息内容\n - 返回：发送结果\n - 异常：\n - `ArgumentNullException` - 参数为空\n - `InvalidOperationException` - 请求消息缺少必要属性\n\n- `Task SendReplyAsync(MessageExt requestMessage, Object replyBody, CancellationToken cancellationToken = default)`\n - 异步发送回复消息\n - 参数：\n - `requestMessage`：原始请求消息\n - `replyBody`：回复消息内容\n - `cancellationToken`：取消令牌\n - 返回：发送结果\n\n### Message 类新增属性\n\n- `ReplyToClient`：回复地址，指示回复消息应发送到的客户端ID\n- `CorrelationId`：关联ID，用于将回复消息与请求消息关联\n- `MessageType`：消息类型，用于区分普通消息和回复消息（\"REQUEST\"/\"REPLY\"）\n- `RequestTimeout`：请求超时时间（毫秒）\n\n## 注意事项\n\n1. **版本要求**：需要 RocketMQ 服务器版本 4.6.0 或更高\n2. **超时设置**：合理设置超时时间，避免长时间阻塞\n3. **异常处理**：务必捕获 `TimeoutException` 处理超时情况\n4. **资源释放**：使用完毕后及时释放 Producer 和 Consumer 资源\n5. **Topic 规划**：建议为 Request-Reply 使用独立的 Topic\n6. **消费者处理**：消费者必须检查 `CorrelationId` 属性来判断是否为请求消息\n\n## 兼容性\n\n- 支持 .NET Framework 4.5+\n- 支持 .NET Standard 2.0+\n- 支持 .NET Core 2.0+\n- 支持 .NET 5.0+\n- 兼容 RocketMQ 4.6.0 或以上版本\n- 兼容 RocketMQ 5.0 或以上版本\n\n## 性能建议\n\n1. 复用 Producer 和 Consumer 实例，避免频繁创建销毁\n2. 合理设置超时时间，避免资源浪费\n3. 对于高并发场景，建议使用异步 API\n4. 监控回复消息的处理时间，及时优化业务逻辑\n\n## 故障排查\n\n### 请求超时\n\n- 检查消费者是否正常运行\n- 检查网络连接是否正常\n- 检查消费者处理逻辑是否耗时过长\n- 适当增加超时时间\n\n### 收不到回复\n\n- 确认消费者正确调用了 `SendReply` 或 `SendReplyAsync`\n- 检查消费者日志，确认是否有异常\n- 确认消息的 `CorrelationId` 属性正确设置\n- 检查 Topic 配置是否正确\n\n## 更多示例\n\n更多使用示例请参考项目源码中的单元测试：`XUnitTestRocketMQ/RequestReplyTests.cs`\n"
},
{
"path": "Doc/架构设计.md",
"content": "# NewLife.RocketMQ 架构\n\n## 1. 架构概览\n\nNewLife.RocketMQ 采用**分层清晰、职责单一、可扩展**的架构设计，纯 C# 实现，零外部依赖。\n\n### 1.1 设计理念\n\n- **纯托管实现**：完全使用 C# 实现，无需 Java、gRPC、Protobuf 第三方库\n- **双协议支持**：同时支持 Remoting 协议（4.x）和 gRPC 协议（5.x）\n- **云厂商适配**：统一 `ICloudProvider` 接口，轻松接入各云服务商\n- **高性能优化**：连接复用、对象池、VIP 通道、消息压缩等优化手段\n- **可测试性**：30+ 测试类覆盖核心功能和边缘场景\n\n### 1.2 层次结构\n\n```\n┌──────────────────────────────────────────────────────────┐\n│ 业务层 (MqBase) │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ Producer │ │ Consumer │ │\n│ │ 生产者业务逻辑 │ │ 消费者业务逻辑 │ │\n│ └─────────────────┘ └─────────────────┘ │\n└──────────────────────────────────────────────────────────┘\n │\n┌──────────────────────────────────────────────────────────┐\n│ 通信层 (Client) │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ ClusterClient │ │ GrpcClient │ │\n│ │ TCP 长连接管理 │ │ HTTP/2 gRPC │ │\n│ └─────────────────┘ └─────────────────┘ │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ NameClient │ │GrpcMessaging │ │\n│ │ 路由发现 │ │Service │ │\n│ └─────────────────┘ └─────────────────┘ │\n│ ┌─────────────────┐ │\n│ │ BrokerClient │ │\n│ │ 心跳/注销 │ │\n│ └─────────────────┘ │\n└──────────────────────────────────────────────────────────┘\n │\n┌──────────────────────────────────────────────────────────┐\n│ 协议层 (Protocol) │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ Command │ │ GrpcModels │ │\n│ │ Remoting 帧 │ │ gRPC 消息模型 │ │\n│ └─────────────────┘ └─────────────────┘ │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ MessageExt │ │ ProtoWriter │ │\n│ │ 消息模型 │ │ Protobuf 编码 │ │\n│ └─────────────────┘ └─────────────────┘ │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ RequestCode │ │ ProtoReader │ │\n│ │ 请求码枚举 │ │ Protobuf 解码 │ │\n│ └─────────────────┘ └─────────────────┘ │\n└──────────────────────────────────────────────────────────┘\n │\n┌──────────────────────────────────────────────────────────┐\n│ 传输层 (Transport) │\n│ ┌─────────────────┐ ┌─────────────────┐ │\n│ │ NewLife.Net │ │ HttpClient │ │\n│ │ TCP Socket │ │ HTTP/2 │ │\n│ └─────────────────┘ └─────────────────┘ │\n└──────────────────────────────────────────────────────────┘\n │\n┌──────────────────────────────────────────────────────────┐\n│ 云厂商适配层 (CloudProvider) │\n│ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │\n│ │Aliyun │ │Huawei │ │Tencent │ │ ACL │ │\n│ │Provider│ │Provider│ │Provider│ │Provider│ │\n│ └────────┘ └────────┘ └────────┘ └────────┘ │\n└──────────────────────────────────────────────────────────┘\n```\n\n### 1.3 代码组织结构\n\n```\nMqBase (业务基类，NameServer连接/Broker管理/Topic与消费组CRUD/消息查询)\n├── Producer (生产者：普通/异步/单向/延迟/事务/批量/Request-Reply/gRPC)\n└── Consumer (消费者：Pull/调度/Rebalance/多Topic/顺序/重试/Pop/gRPC)\n\nClusterClient (集群客户端/通信层，Remoting协议)\n├── NameClient (名称服务器客户端：路由发现/定时轮询/多Topic路由/Broker主从解析)\n└── BrokerClient (Broker客户端：心跳/注销/命令收发)\n\nGrpc/ (gRPC传输层，RocketMQ 5.x Proxy协议，netstandard2.1+)\n├── GrpcClient (HTTP/2 gRPC客户端，帧编解码，Unary + Server Streaming)\n├── GrpcMessagingService (消息服务：路由/发送/接收/确认/心跳/事务/延迟/死信)\n├── ProtoWriter / ProtoReader (轻量级Protobuf编解码器，无外部依赖)\n├── GrpcModels (Resource/Endpoints/Message/SystemProperties/MessageQueue等)\n├── GrpcServiceMessages (Request/Response消息类型，约25个，含Telemetry)\n└── GrpcEnums (GrpcCode/GrpcMessageType/GrpcClientType/AddressScheme等)\n\nProtocol/\n├── Command (命令帧，Remoting协议编解码)\n├── MqCodec (网络编解码器)\n├── Message / MessageExt (消息模型，含批量解码/ZLIB解压/IPv4+IPv6/5.x MessageId)\n├── RequestCode (约60个指令码) / ResponseCode (约20个响应码)\n├── MQVersion (V3.0 ~ V5.9.9 + HIGHER_VERSION，约450个版本)\n└── 各类 Header / State / Enum\n\nCloudProvider/\n├── ICloudProvider (统一云厂商接口)\n├── AliyunProvider (阿里云适配)\n├── AclProvider (Apache ACL适配)\n├── HuaweiProvider (华为云适配)\n└── TencentProvider (腾讯云适配)\n```\n\n---\n\n## 2. 数据模型\n\n### 2.1 消息模型\n\n| 类型 | 说明 | 字段 |\n|------|------|------|\n| Message | 基础消息 | Topic, Tags, Keys, Body, Properties, DelayTimeLevel |\n| MessageExt | 扩展消息（接收端） | MsgId, QueueId, QueueOffset, BornTimestamp, StoreTimestamp, BornHost, StoreHost, SysFlag, ReconsumeTimes |\n| GrpcMessage | gRPC 消息（5.x） | Topic(GrpcResource), UserProperties, SystemProperties(GrpcSystemProperties), Body |\n\n### 2.2 路由模型\n\n| 类型 | 说明 | 字段 |\n|------|------|------|\n| BrokerInfo | Broker 信息 | BrokerName, MasterAddress, SlaveAddresses, Weight |\n| MessageQueue | 消息队列 | BrokerName, QueueId, ReadQueueNums, WriteQueueNums |\n\n### 2.3 协议帧模型\n\n**Remoting 协议帧**：\n\n```\n┌────────┬────────────┬────────────┬─────────────────┐\n│ Length │HeaderLength│ Header │ Body │\n│ 4 bytes│ 4 bytes │ N bytes │ M bytes │\n└────────┴────────────┴────────────┴─────────────────┘\nLength = 4 + N + M\nHeaderLength 高 8 位：SerializeType (0=JSON, 1=ROCKETMQ)\nHeaderLength 低 24 位：实际 Header 长度\n```\n\n**gRPC 消息帧**：\n\n```\n┌────────┬────────────┬──────────────────────────────┐\n│ Comp │ Length │ Body │\n│ 1 byte │ 4 bytes │ N bytes │\n└────────┴────────────┴──────────────────────────────┘\nComp: 0=不压缩, 1=gzip\nLength: 大端序，Protobuf 消息体长度\n```\n\n---\n\n## 3. 接口设计\n\n### 3.1 生产者 API\n\n| 接口 | 方法 | 签名 | 入参 | 出参 | 说明 |\n|------|------|------|------|------|------|\n| Producer | Publish | `SendResult Publish(Object message, String tags)` | message: 消息体, tags: 标签 | SendResult | 同步发送 |\n| Producer | PublishAsync | `Task PublishAsync(Object message, String tags)` | 同上 | Task\\ | 异步发送 |\n| Producer | PublishOneway | `void PublishOneway(Object message, String tags)` | 同上 | 无 | 单向发送 |\n| Producer | PublishBatch | `SendResult PublishBatch(IList messages)` | messages: 消息列表 | SendResult | 批量发送 |\n| Producer | PublishDelay | `SendResult PublishDelay(Object message, DelayTimeLevels delay)` | message, delay: 延迟等级 | SendResult | 延迟消息 |\n| Producer | PublishDelayViaGrpcAsync | `Task PublishDelayViaGrpcAsync(String body, DateTime deliveryTime)` | body, deliveryTime: 投递时间 | Task | gRPC 任意延迟 |\n| Producer | PublishTransaction | `SendResult PublishTransaction(Object message)` | message: 消息体 | SendResult | 事务半消息 |\n| Producer | EndTransaction | `void EndTransaction(SendResult result, TransactionState state)` | result, state: 提交/回滚 | 无 | 结束事务 |\n| Producer | Request | `MessageExt Request(Object message, Int32 timeout)` | message, timeout: 超时 | MessageExt | Request-Reply |\n\n### 3.2 消费者 API\n\n| 接口 | 方法 | 签名 | 入参 | 出参 | 说明 |\n|------|------|------|------|------|------|\n| Consumer | OnConsume | `Func` | 委托 | — | 消费回调 |\n| Consumer | Pull | `PullResult Pull(MessageQueue queue, Int64 offset, Int32 maxNums)` | queue, offset, maxNums | PullResult | 拉取消息 |\n| Consumer | PopMessageAsync | `Task> PopMessageAsync(...)` | timeout 等 | IList\\ | Pop 消费 |\n| Consumer | AckMessageAsync | `Task AckMessageAsync(MessageExt msg)` | msg: 消息 | Task | 确认消费 |\n| Consumer | BatchAckMessageAsync | `Task BatchAckMessageAsync(IList msgs)` | msgs: 消息列表 | Task | 批量确认 |\n\n### 3.3 云厂商适配接口\n\n| 接口 | 方法 | 签名 | 入参 | 出参 | 说明 |\n|------|------|------|------|------|------|\n| ICloudProvider | TransformTopic | `String TransformTopic(String topic)` | topic: 原始主题名 | 转换后主题名 | 主题名转换 |\n| ICloudProvider | TransformGroup | `String TransformGroup(String group)` | group: 原始组名 | 转换后组名 | 消费组名转换 |\n| ICloudProvider | GetNameServerAddress | `String GetNameServerAddress()` | 无 | NameServer 地址 | 获取 NameServer |\n\n### 3.4 核心 RequestCode\n\n| 分类 | RequestCode | 值 | 说明 |\n|------|------------|:--:|------|\n| 消息发送 | SEND_MESSAGE_V2 | 310 | 发送消息V2 |\n| | SEND_BATCH_MESSAGE | 320 | 批量发送 |\n| | SEND_REPLY_MESSAGE_V2 | 325 | 回复消息 |\n| 消息拉取 | PULL_MESSAGE | 11 | 拉取消息 |\n| | POP_MESSAGE | 200050 | Pop 消费 |\n| | ACK_MESSAGE | 200051 | Pop 确认 |\n| | BATCH_ACK_MESSAGE | 200151 | 批量 Pop 确认 |\n| 事务消息 | END_TRANSACTION | 37 | 结束事务 |\n| | CHECK_TRANSACTION_STATE | 39 | 事务回查 |\n| 偏移管理 | QUERY_CONSUMER_OFFSET | 14 | 查询偏移 |\n| | UPDATE_CONSUMER_OFFSET | 15 | 更新偏移 |\n| | SEARCH_OFFSET_BY_TIMESTAMP | 29 | 按时间戳搜索 |\n| 顺序消费 | LOCK_BATCH_MQ | 41 | 锁定队列 |\n| | UNLOCK_BATCH_MQ | 42 | 解锁队列 |\n| 路由管理 | GET_ROUTEINTO_BY_TOPIC | 105 | Topic 路由 |\n| | GET_BROKER_CLUSTER_INFO | 106 | 集群信息 |\n| 心跳 | HEART_BEAT | 34 | 心跳 |\n| | UNREGISTER_CLIENT | 35 | 注销客户端 |\n\n### 3.5 gRPC RPC 方法\n\n| 方法 | 类型 | 说明 |\n|------|------|------|\n| QueryRoute | Unary | 查询主题路由 |\n| SendMessage | Unary | 发送消息（普通/延迟/FIFO/事务） |\n| QueryAssignment | Unary | 查询队列分配 |\n| ReceiveMessage | Server Streaming | 接收消息（长轮询） |\n| AckMessage | Unary | 确认消息消费 |\n| Heartbeat | Unary | 心跳 |\n| EndTransaction | Unary | 结束事务 |\n| ForwardToDeadLetterQueue | Unary | 转发到死信队列 |\n| ChangeInvisibleDuration | Unary | 修改不可见时间 |\n| NotifyClientTermination | Unary | 通知客户端终止 |\n| Telemetry | Bidirectional Streaming | 客户端资源上报 |\n\n---\n\n## 4. 技术选型\n\n| 领域 | 选型 | 理由 |\n|------|------|------|\n| 网络通信（Remoting） | NewLife.Net | 高性能 TCP 库，单机千万级吞吐，内置连接池 |\n| 网络通信（gRPC） | System.Net.Http.HttpClient | .NET 原生 HTTP/2 支持，无需第三方库 |\n| 序列化（Remoting） | NewLife.Serialization | 内置 JSON 序列化，无外部依赖 |\n| 序列化（gRPC） | 自研 ProtoWriter/ProtoReader | 轻量级 Protobuf 编解码，零外部依赖 |\n| 加密签名 | System.Security.Cryptography | .NET 内置 HMAC-SHA1 |\n| SSL/TLS | System.Net.Security.SslStream | .NET 内置 SSL/TLS 支持 |\n| 日志 | NewLife.Log.ILog | NewLife 核心日志组件 |\n| 追踪 | NewLife.Model.ITracer | NewLife APM 追踪组件 |\n| 负载均衡 | 自研 WeightRoundRobin | 加权轮询算法，支持 Broker 权重 |\n| 压缩 | System.IO.Compression.DeflateStream | .NET 内置 ZLIB 压缩 |\n\n---\n\n## 5. 关键设计决策\n\n| 决策点 | 方案 | 备选方案 | 选择理由 |\n|--------|------|---------|---------|\n| Protobuf 编解码 | 自研 ProtoWriter/ProtoReader | Google.Protobuf / protobuf-net | 零外部依赖，减少包体积和部署复杂度 |\n| gRPC 通信 | 原生 HttpClient + HTTP/2 | Grpc.Net.Client | 零外部依赖，仅需 netstandard2.1+ |\n| 连接管理 | ConcurrentDictionary 连接池 | 第三方连接池库 | 简单高效，满足 Broker 少连接场景 |\n| 消费者负载均衡 | 客户端平均分配 | 服务端 Rebalance | 兼容 4.x，5.x 服务端 Rebalance 需 Broker 配合 |\n| 云厂商适配 | ICloudProvider 接口 + 策略模式 | 硬编码各厂商逻辑 | 易扩展，新增厂商只需实现接口 |\n| 多目标框架 | net45/net461/netstandard2.0/netstandard2.1 | 仅 netstandard2.0 | 覆盖企业遗留系统和最新平台 |\n| 消息压缩 | 发送端 ZLIB 自动压缩 | 不压缩 / 手动压缩 | 大消息体自动优化带宽 |\n| VIP 通道 | BrokerPort - 2 优先级连接 | 仅标准端口 | 提升高优先级消息性能 |\n\n---\n\n## 6. 任务分解\n\n所有任务已按迭代完成，详见需求文档「6. 功能清单与迭代计划」。\n\n### 已完成批次\n\n| 批次 | 任务范围 | 状态 |\n|------|---------|:----:|\n| 批次 1 | T001~T008：核心通信与基础消息 | ✅ |\n| 批次 2 | T009~T016：生产可靠性增强 | ✅ |\n| 批次 3 | T017~T027：功能完善 | ✅ |\n| 批次 4 | T028~T032：云厂商适配 | ✅ |\n| 批次 5 | T033~T038：gRPC 协议与 5.x 新特性 | ✅ |\n| 批次 6 | T039~T044：功能增强与优化 | ✅ |\n\n---\n\n## 7. 风险与缓解\n\n| 风险 | 影响 | 缓解措施 |\n|------|------|---------|\n| 各云厂商 5.x gRPC 接入未验证 | 阿里云 Serverless / 华为云 5.x / 腾讯云可能不兼容 | 客户端已具备完整 gRPC 能力，待实际环境逐步验证 |\n| Language 标识为 DOTNET | 部分 Broker 可能不识别 | DOTNET 为合理标识，暂无实际影响报告 |\n| 自研 Protobuf 编解码与官方不一致 | 极端数据格式可能解析失败 | 30+ 测试覆盖核心编解码场景，持续补充边界用例 |\n| RocketMQ 新版本协议变更 | 新增 RequestCode / Header 字段 | MQVersion 枚举已扩展到 V5.9.9 + HIGHER_VERSION，跟进社区更新 |\n| 阿里云公网版 BrokerName 不匹配 | 消费者偏移匹配可能失败 | 已用容错代码处理，不影响核心消费流程 |\n| 连接泄漏或超时 | 长时间运行可能资源不足 | 心跳保活 30s + 连接池管理 + Dispose 释放 |\n\n---\n\n## 附录 A：核心文件清单\n\n| 文件 | 行数 | 说明 |\n|------|:----:|------|\n| MqBase.cs | ~1500 | 业务基类 |\n| Producer.cs | ~1200 | 生产者实现 |\n| Consumer.cs | ~1800 | 消费者实现 |\n| ClusterClient.cs | ~423 | TCP 连接管理 |\n| NameClient.cs | ~243 | 路由发现 |\n| BrokerClient.cs | ~142 | 心跳/注销 |\n| Command.cs | ~333 | Remoting 帧编解码 |\n| MessageExt.cs | ~244 | 消息扩展模型 |\n| RequestCode.cs | ~277 | 60+ 请求码 |\n| MQVersion.cs | ~909 | 450+ 协议版本 |\n| GrpcClient.cs | ~310 | gRPC HTTP/2 客户端 |\n| ProtoWriter.cs | ~343 | Protobuf 编码器 |\n| ProtoReader.cs | ~308 | Protobuf 解码器 |\n| GrpcModels.cs | ~520 | gRPC 消息模型 |\n| GrpcServiceMessages.cs | ~883 | gRPC 服务消息 |\n| GrpcMessagingService.cs | ~417 | 11 个 RPC 方法 |\n\n## 附录 B：双协议特性对比\n\n| 特性 | Remoting 协议 | gRPC 协议 |\n|------|--------------|-----------|\n| 传输层 | TCP 长连接（NewLife.Net） | HTTP/2（HttpClient） |\n| 编解码 | 自定义二进制帧 + JSON | Protobuf（自研编解码器） |\n| 支持版本 | RocketMQ 4.x / 5.x Broker | RocketMQ 5.x Proxy |\n| 目标框架 | net45+ | netstandard2.1+ / net5+ |\n| 连接复用 | 单连接 Opaque 复用 | HTTP/2 多路复用 |\n| SSL/TLS | 支持 | 原生支持（HTTPS） |\n| VIP 通道 | 支持（BrokerPort - 2） | N/A |\n| 签名认证 | HMAC-SHA1 | HTTP Header |\n| 消息压缩 | ZLIB（SysFlag 标记） | gzip（HTTP Content-Encoding） |\n\n## 附录 C：各厂商 RocketMQ 产品对比\n\n| 厂商 | 产品 | 协议 | 认证方式 | NameServer 发现 | 适配器 |\n|------|------|------|---------|----------------|--------|\n| Apache | RocketMQ 4.x | Remoting (TCP) | ACL (AccessKey) | 直连/HTTP | AclProvider |\n| Apache | RocketMQ 5.x | Remoting + gRPC | ACL | 直连/HTTP/Proxy | AclProvider |\n| 阿里云 | 消息队列 RocketMQ 4.x | Remoting | AK/SK + HMAC-SHA1 | HTTP 接口 | AliyunProvider |\n| 阿里云 | 消息队列 RocketMQ 5.x | gRPC 为主 | AK/SK | SDK/HTTP | AliyunProvider |\n| 华为云 | DMS for RocketMQ | Remoting | SASL / AK/SK | 实例地址 | HuaweiProvider |\n| 腾讯云 | TDMQ RocketMQ | Remoting | HMAC-SHA1 | VPC 内网 | TencentProvider |\n\n## 附录 D：测试覆盖\n\n测试框架：xUnit，目标框架 net10.0，共 30 个测试文件。\n\n| 分类 | 测试文件 | 覆盖功能 |\n|------|---------|---------|\n| 核心功能 | ProducerTests, ConsumerTests, CommandTests, MessageTests, NameClientTests | 基础收发、协议编解码、路由发现 |\n| 高级特性 | TransactionCheckTests, BatchMessageTests, RetryTests, OrderConsumeTests, PopConsumeTests | 事务回查、批量消息、重试、顺序消费、Pop |\n| 协议兼容 | IPv6Tests, MessageId5xTests, MQVersionTests, ProtoTests | IPv6、5.x MessageId、协议版本、Protobuf |\n| 云厂商 | AliyunTests, AliyunIssuesTests, CloudProviderTests | 阿里云适配、云厂商接口 |\n| 性能优化 | CompressionTests, ConcurrentConsumeTests, VipChannelTests | 压缩、并发控制、VIP 通道 |\n| 管理功能 | ManagementTests, ConsumeStatsTests, QueryMessageTests | 管理 API、消费统计、消息查询 |\n| 扩展功能 | MultiTopicTests, RequestReplyTests, MessageTraceTests, SQL92FilterTests | 多 Topic、Request-Reply、轨迹、SQL92 |\n"
},
{
"path": "Doc/需求文档.md",
"content": "# NewLife.RocketMQ 需求\n\n## 1. 背景与目标\n\n### 1.1 背景与痛点\n\nApache RocketMQ 是国内使用最广泛的分布式消息中间件之一，广泛应用于电商交易、金融支付、物联网、大数据等领域。然而 .NET 生态中缺乏成熟、轻量、功能完整的 RocketMQ 客户端：\n\n- **官方 C# 客户端（rocketmq-client-csharp）**：仅支持 gRPC 协议（5.x），依赖 Google.Protobuf 和 Grpc.Net.Client 等第三方库，不支持 Remoting 协议（4.x），且更新缓慢（最新 commit 10个月前）\n- **社区第三方客户端**：功能不完整，多数已停止维护，缺乏云厂商适配\n- **.NET Framework 兼容**：大量企业 .NET Framework 4.5+ 项目无法使用现有客户端\n\n### 1.2 目标\n\n打造企业级**纯托管 .NET RocketMQ 客户端**，实现以下可衡量目标：\n\n- 完整支持 RocketMQ Remoting 协议（4.x/5.x Broker）和 gRPC Proxy 协议（5.x Proxy）\n- 零外部依赖（无需 Java、gRPC、Protobuf 第三方库），NuGet 一键安装\n- 覆盖生产者、消费者全部核心功能及企业级特性（重试、死信、事务、顺序消费等）\n- 统一云厂商适配接口，支持阿里云、华为云、腾讯云及 Apache ACL 认证\n- 兼容 .NET Framework 4.5+ 到 .NET 10 全版本\n\n## 2. 用户角色\n\n| 角色 | 说明 | 核心诉求 |\n|------|------|---------|\n| .NET 开发者 | 使用 .NET 平台开发业务系统的开发人员 | 简单易用、功能完整、文档清晰的 RocketMQ 客户端 |\n| 架构师 | 负责技术选型和系统架构设计 | 高性能、高可靠、可扩展、多云适配的消息中间件方案 |\n| 运维工程师 | 负责系统部署与运维 | 零外部依赖、易于部署、可观测性（日志/轨迹/监控） |\n| 云平台用户 | 使用阿里云/华为云/腾讯云消息队列服务 | 无缝接入云厂商 RocketMQ 实例，支持认证和路由转换 |\n\n## 3. 功能需求\n\n### 3.1 Remoting 协议通信层\n\n- **描述**：实现 RocketMQ 4.x/5.x Broker 的 TCP 私有协议通信\n- **用户故事**：作为 .NET 开发者，我希望通过 Remoting 协议连接 RocketMQ 4.x/5.x Broker，以便使用成熟稳定的通信方式\n- **验收条件**（AC）：\n - [x] 支持 Remoting 二进制帧编解码（Length + HeaderLength + Header + Body）\n - [x] 支持 JSON 和 ROCKETMQ 两种序列化格式\n - [x] 支持 TCP 长连接管理与复用（ConcurrentDictionary 连接池）\n - [x] 支持 Opaque 请求-响应匹配\n - [x] 支持 HMAC-SHA1 统一签名\n - [x] 支持 SSL/TLS 加密传输\n - [x] 支持 VIP 通道（BrokerPort - 2）\n - [x] 实现 60+ RequestCode 指令\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.2 gRPC Proxy 协议通信层\n\n- **描述**：实现 RocketMQ 5.x Proxy 的 gRPC 协议通信（HTTP/2 + Protobuf）\n- **用户故事**：作为 .NET 开发者，我希望通过 gRPC 协议连接 RocketMQ 5.x Proxy，以便使用 5.x 新架构的特性\n- **验收条件**（AC）：\n - [x] 自研轻量级 Protobuf 编解码器（ProtoWriter/ProtoReader），无外部依赖\n - [x] 支持 gRPC 帧格式（Comp + Length + Body）\n - [x] 支持 HTTP/2 多路复用\n - [x] 支持 Unary（请求-响应）调用\n - [x] 支持 Server Streaming（服务端流式）调用\n - [x] 实现 11 个核心 RPC 方法（QueryRoute/SendMessage/ReceiveMessage/AckMessage/Heartbeat/EndTransaction/ForwardToDeadLetterQueue/ChangeInvisibleDuration/NotifyClientTermination/Telemetry/QueryAssignment）\n - [x] 仅在 netstandard2.1+ / net5+ 目标框架可用\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.3 NameServer 路由发现\n\n- **描述**：实现 Topic 路由发现与定时轮询更新\n- **用户故事**：作为 .NET 开发者，我希望客户端自动发现 Topic 路由并定时刷新，以便无需手动管理 Broker 连接\n- **验收条件**（AC）：\n - [x] 支持 Topic 路由查询（GET_ROUTEINTO_BY_TOPIC）\n - [x] 支持定时轮询路由更新（30s 间隔）\n - [x] 支持多 Topic 路由管理\n - [x] 支持 Broker 主从地址解析\n - [x] 支持 HTTP 方式获取 NameServer 地址（阿里云）\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.4 生产者核心功能\n\n- **描述**：实现消息生产者全部核心功能\n- **用户故事**：作为 .NET 开发者，我希望使用丰富的消息发送方式，以便满足各种业务场景\n- **验收条件**（AC）：\n - [x] 同步发送（Publish）\n - [x] 异步发送（PublishAsync）\n - [x] 单向发送（PublishOneway）\n - [x] 批量消息发送（PublishBatch / SEND_BATCH_MESSAGE）\n - [x] 延迟消息发送（PublishDelay，18 级预设延迟）\n - [x] 任意时间延迟消息（PublishDelayViaGrpcAsync，gRPC 协议）\n - [x] 事务消息（PublishTransaction / EndTransaction）\n - [x] 事务回查回调（OnCheckTransaction，同步/异步委托）\n - [x] 顺序消息（指定 MessageQueue 发送）\n - [x] Request-Reply 模式（Request / RequestAsync）\n - [x] 消息压缩（CompressOverBytes 阈值自动 ZLIB 压缩）\n - [x] 发送重试（RetryTimesWhenSendFailed）\n - [x] 发送端钩子（ISendMessageHook）\n - [x] 消息轨迹追踪（AsyncTraceDispatcher / MessageTraceHook）\n - [x] 加权轮询负载均衡（ILoadBalance / WeightRoundRobin）\n - [x] gRPC 发送（SendMessageViaGrpcAsync / PublishTransactionViaGrpcAsync）\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.5 消费者核心功能\n\n- **描述**：实现消息消费者全部核心功能\n- **用户故事**：作为 .NET 开发者，我希望使用灵活的消息消费方式，以便满足不同业务消费模式需求\n- **验收条件**（AC）：\n - [x] Pull 模式消费（长轮询拉取）\n - [x] 消费调度（自动分配队列并启动消费线程）\n - [x] 集群消费模式（Clustering，平均分配 Rebalance）\n - [x] 广播消费模式（Broadcasting，本地 JSON 文件持久化偏移）\n - [x] Tag 过滤\n - [x] SQL92 表达式过滤\n - [x] 多 Topic 订阅（Topics 属性，按 Topic 分别 Rebalance）\n - [x] 消费重试（EnableRetry + MaxReconsumeTimes，自动回退到 RETRY Topic）\n - [x] 死信队列（超过最大重试次数自动进入 %DLQ% Topic）\n - [x] 消费回退（SendMessageBackAsync / CONSUMER_SEND_MSG_BACK）\n - [x] 顺序消费（LockBatchMQAsync / UnlockBatchMQAsync / OrderConsume）\n - [x] Pop 消费模式（PopMessageAsync / AckMessageAsync / ChangeInvisibleTimeAsync）\n - [x] 批量确认 Pop 消息（BatchAckMessageAsync / BATCH_ACK_MESSAGE）\n - [x] 按时间戳消费（SearchOffset / SEARCH_OFFSET_BY_TIMESTAMP）\n - [x] 消费限流（MaxConcurrentConsume 信号量控制）\n - [x] 消费者变更通知（NOTIFY_CONSUMER_IDS_CHANGED 触发重平衡）\n - [x] Request-Reply 回复（SendReply / SendReplyAsync）\n - [x] 消费端钩子（IConsumeMessageHook）\n - [x] gRPC 消费（ReceiveMessageViaGrpcAsync / AckMessageViaGrpcAsync / HeartbeatViaGrpcAsync）\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.6 管理与运维功能\n\n- **描述**：实现 RocketMQ 管理 API\n- **用户故事**：作为运维工程师，我希望通过客户端管理 Topic、消费组、查询消息，以便方便运维操作\n- **验收条件**（AC）：\n - [x] Topic 创建/更新/删除（CreateTopic / DeleteTopic）\n - [x] 消费组创建/更新/删除（CreateSubscriptionGroup / DeleteSubscriptionGroup）\n - [x] 消息查询（按 ID：ViewMessage / 按 Key：QueryMessageByKey）\n - [x] 消费统计查询（GetConsumeStats / GetTopicStatsInfo）\n - [x] 集群信息查询（GetClusterInfo）\n - [x] 消费者连接列表查询（GetConsumerConnectionList）\n - [x] 偏移量管理与重置（QueryOffset / UpdateOffset / ResetConsumerOffset）\n - [x] Broker 运行信息（GetRuntimeInfo）\n - [x] 消息过滤服务器注册（RegisterFilterServer）\n- **优先级**：Should\n- **完成状态**：✅ 已完成\n\n### 3.7 云厂商适配\n\n- **描述**：统一云厂商适配接口，支持多云平台接入\n- **用户故事**：作为云平台用户，我希望通过统一接口接入不同云厂商的 RocketMQ 实例，以便减少适配工作量\n- **验收条件**（AC）：\n - [x] 统一 ICloudProvider 接口（SignatureTransformTopic/TransformGroup/GetNameServerAddress）\n - [x] 阿里云适配（AliyunProvider：实例 ID 前缀路由 + HTTP NameServer 发现 + HMAC-SHA1 签名）\n - [x] 华为云适配（HuaweiProvider：SSL/TLS + 实例 ID 路由）\n - [x] 腾讯云适配（TencentProvider：Namespace 前缀路由）\n - [x] Apache ACL 适配（AclProvider：HMAC-SHA1 签名，不转换 Topic/Group）\n - [x] 旧版参数兼容（AliyunOptions / AclOptions 自动桥接到新适配器）\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.8 消息编解码\n\n- **描述**：完整实现消息二进制编解码\n- **用户故事**：作为 .NET 开发者，我希望客户端正确处理各种消息格式，以便与不同版本的 RocketMQ 兼容\n- **验收条件**（AC）：\n - [x] 标准 4.x 消息二进制格式编解码\n - [x] ZLIB 消息解压缩（SysFlag 第 0 位标识）\n - [x] IPv4/IPv6 地址自动识别和解析（SysFlag 第 2 位标识）\n - [x] 批量消息解码（DecodeBatch，SysFlag 第 4 位标识）\n - [x] 5.x MessageId 新格式编解码（CreateMessageId5x / TryParseMessageId5x / IsMessageId5x）\n - [x] 消息属性分隔符与 Java 官方一致（\\x01 和 \\x02）\n- **优先级**：Must\n- **完成状态**：✅ 已完成\n\n### 3.9 可观测性\n\n- **描述**：提供日志、轨迹、监控等可观测手段\n- **用户故事**：作为运维工程师，我希望能追踪消息链路和监控客户端运行状态，以便快速定位问题\n- **验收条件**（AC）：\n - [x] 结构化日志（ILog）\n - [x] 消息轨迹追踪（AsyncTraceDispatcher / MessageTraceHook）\n - [x] 性能追踪集成（Tracer / NewSpan）\n - [x] 客户端资源上报（gRPC Telemetry）\n - [x] 消费者运行信息上报（GetConsumerRunningInfo）\n- **优先级**：Should\n- **完成状态**：✅ 已完成\n\n## 4. 非功能需求\n\n### 4.1 性能\n\n- 基于 NewLife.Net 高性能网络层，支持连接复用（单连接 Opaque 复用 / HTTP/2 多路复用）\n- 支持 VIP 通道（BrokerPort - 2 优先级连接）\n- 支持消息压缩（发送端 ZLIB，超阈值自动压缩）\n- 支持消费限流（信号量控制最大并发）\n- 对象池和内存池优化（Pool.StringBuilder、ArrayPool 等）\n\n### 4.2 安全\n\n- 支持 HMAC-SHA1 签名认证（统一由 ICloudProvider 实现）\n- 支持 SSL/TLS 加密传输（SslProtocol + Certificate 配置）\n- 支持 Apache ACL 权限控制\n- 不暴露内部实现路径和敏感凭据\n\n### 4.3 兼容性\n\n- 目标框架：net45 / net461 / netstandard2.0 / netstandard2.1（gRPC 功能 netstandard2.1+）\n- RocketMQ 服务端兼容：4.0 ~ 5.x（Remoting 协议）/ 5.x Proxy（gRPC 协议）\n- 云厂商兼容：阿里云 4.x/5.x、华为云 DMS、腾讯云 TDMQ\n- 新增 API 评估各框架降级实现\n\n## 5. 边界与约束\n\n### 5.1 不做什么（明确排除项）\n\n- **Compaction Topic**：RocketMQ 5.1+ KV 语义 Topic，属于小众特性，暂不实现\n- **服务端 Rebalance**：需 RocketMQ 5.0+ Broker 端深度配合，属于 Broker 端特性，客户端暂不实现\n- **SASL 认证**：华为云可能使用的 SASL/PLAIN 或 SASL/SCRAM 认证，待有明确需求再实现\n- **非 .NET 平台支持**：仅支持 .NET 平台\n\n### 5.2 已知限制\n\n- Controller 模式对客户端透明，无需特殊适配\n- 阿里云 Serverless 实例仅支持 gRPC 接入，客户端已具备能力但待实际环境验证\n- 华为云/腾讯云 gRPC 接入待实际环境验证\n- Language 标识为 DOTNET，不在 Java 官方枚举中，部分 Broker 可能不识别\n\n## 6. 功能清单与迭代计划\n\n### 迭代 1：核心通信与基础消息（Must）— ✅ 已完成\n\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 完成状态 |\n|------|--------|---------|---------|:-------:|\n| F001 | Remoting 协议帧编解码 | 正确编解码二进制帧 | 无 | ✅ |\n| F002 | TCP 连接管理与复用 | 支持连接池、Opaque 匹配 | F001 | ✅ |\n| F003 | NameServer 路由发现 | 30s 定时轮询、多 Topic 路由 | F002 | ✅ |\n| F004 | Broker 心跳机制 | 30s 心跳、注销 | F002 | ✅ |\n| F005 | 消息发送（同步/异步/单向） | 三种发送模式均可用 | F003 | ✅ |\n| F006 | Pull 消费 | 长轮询拉取消息 | F003 | ✅ |\n| F007 | 消费调度与 Rebalance | 自动分配队列、平均分配算法 | F006 | ✅ |\n| F008 | 偏移量管理 | 查询/更新/搜索偏移 | F006 | ✅ |\n\n### 迭代 2：生产可靠性增强（Must）— ✅ 已完成\n\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 完成状态 |\n|------|--------|---------|---------|:-------:|\n| F009 | 延迟消息（18 级定时） | 支持预设延迟等级 | F005 | ✅ |\n| F010 | 事务消息（半消息） | 发送/提交/回滚 | F005 | ✅ |\n| F011 | 事务回查回调 | 响应 CHECK_TRANSACTION_STATE | F010 | ✅ |\n| F012 | 批量消息发送 | SEND_BATCH_MESSAGE | F005 | ✅ |\n| F013 | 顺序消息发送 | 指定 MessageQueue | F005 | ✅ |\n| F014 | 消费重试 | RETRY Topic + 自动回退 | F007 | ✅ |\n| F015 | 死信队列 | 超过重试次数进入 %DLQ% | F014 | ✅ |\n| F016 | 顺序消费锁定 | LOCK/UNLOCK_BATCH_MQ | F007 | ✅ |\n\n### 迭代 3：功能完善（Should）— ✅ 已完成\n\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 完成状态 |\n|------|--------|---------|---------|:-------:|\n| F017 | Tag 过滤 | 支持 Tag 表达式 | F006 | ✅ |\n| F018 | SQL92 过滤 | ExpressionType=SQL92 | F006 | ✅ |\n| F019 | 消息压缩 | 发送端 ZLIB 压缩 | F005 | ✅ |\n| F020 | IPv6 支持 | 自动识别 IPv4/IPv6 | F006 | ✅ |\n| F021 | 多 Topic 订阅 | Topics 属性分别 Rebalance | F007 | ✅ |\n| F022 | 广播模式本地偏移 | OffsetStorePath JSON 持久化 | F008 | ✅ |\n| F023 | Request-Reply 模式 | 同步/异步请求回复 | F005 | ✅ |\n| F024 | 消费限流 | MaxConcurrentConsume 信号量 | F007 | ✅ |\n| F025 | Pop 消费模式 | Pop/Ack/ChangeInvisibleTime | F006 | ✅ |\n| F026 | 消息轨迹 | AsyncTraceDispatcher 分发 | F005 | ✅ |\n| F027 | 消息查询 | 按 ID / 按 Key 查询 | F003 | ✅ |\n\n### 迭代 4：云厂商适配（Must）— ✅ 已完成\n\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 完成状态 |\n|------|--------|---------|---------|:-------:|\n| F028 | ICloudProvider 统一接口 | 7 个方法/属性定义 | 无 | ✅ |\n| F029 | 阿里云适配 | 实例 ID 路由 + HTTP NameServer | F028 | ✅ |\n| F030 | 华为云适配 | SSL/TLS + 实例 ID 路由 | F028 | ✅ |\n| F031 | 腾讯云适配 | Namespace 前缀路由 | F028 | ✅ |\n| F032 | Apache ACL 适配 | HMAC-SHA1 签名 | F028 | ✅ |\n\n### 迭代 5：gRPC 协议与 5.x 新特性（Must）— ✅ 已完成\n\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 完成状态 |\n|------|--------|---------|---------|:-------:|\n| F033 | Protobuf 编解码器 | ProtoWriter/ProtoReader 自研 | 无 | ✅ |\n| F034 | gRPC 客户端 | HTTP/2 Unary + Server Streaming | F033 | ✅ |\n| F035 | gRPC 消息服务 | 11 个 RPC 方法实现 | F034 | ✅ |\n| F036 | 任意时间延迟消息 | PublishDelayViaGrpcAsync | F035 | ✅ |\n| F037 | 5.x MessageId | 新格式编解码 | 无 | ✅ |\n| F038 | 客户端资源上报 | gRPC Telemetry | F035 | ✅ |\n\n### 迭代 6：功能增强与优化（Should）— ✅ 已完成\n\n| 编号 | 功能点 | 验收条件 | 前置依赖 | 完成状态 |\n|------|--------|---------|---------|:-------:|\n| F039 | VIP 通道 | VipChannelEnabled 属性 | F002 | ✅ |\n| F040 | 批量确认 Pop 消息 | BatchAckMessageAsync | F025 | ✅ |\n| F041 | 消费统计完整 API | GetConsumeStats / GetTopicStatsInfo | F003 | ✅ |\n| F042 | 消息过滤服务器注册 | RegisterFilterServer | F003 | ✅ |\n| F043 | Broker 主从切换 | 消费失败自动切换从节点 | F003 | ✅ |\n| F044 | 管理功能 | Topic/消费组 CRUD、偏移重置 | F003 | ✅ |\n\n### 待验证功能（各云厂商 5.x 环境）\n\n| 编号 | 功能点 | 状态 | 说明 |\n|------|--------|:----:|------|\n| F045 | 阿里云 5.x gRPC 接入 | ⚠️ 待验证 | 客户端已具备能力，待实际环境测试 |\n| F046 | 阿里云 Serverless 实例 | ⚠️ 待验证 | 仅支持 gRPC 接入 |\n| F047 | 华为云 5.x gRPC 接入 | ⚠️ 待验证 | HuaweiProvider + gRPC 理论可行 |\n| F048 | 腾讯云 TDMQ 验证 | ⚠️ 待验证 | TencentProvider 待生产环境验证 |\n\n### 暂不实现功能\n\n| 编号 | 功能点 | 原因 |\n|------|--------|------|\n| F049 | 服务端 Rebalance | Broker 端特性，客户端需深度配合 |\n| F050 | Compaction Topic | 5.1+ 小众特性，Broker 端支持 |\n| F051 | SASL 认证 | 华为云特有，待有明确需求 |\n\n## 7. 竞品分析\n\n### 7.1 .NET 生态 RocketMQ 客户端对比\n\n| 维度 | NewLife.RocketMQ | Apache rocketmq-client-csharp | 其他社区客户端 |\n|------|:----------------:|:---------------------------:|:------------:|\n| **协议支持** | Remoting + gRPC 双协议 | 仅 gRPC（5.x） | 仅 Remoting（部分） |\n| **4.x 兼容** | ✅ 完整支持 | ❌ 不支持 | ⚠️ 部分支持 |\n| **5.x 支持** | ✅ Remoting + gRPC | ✅ gRPC | ❌ 不支持 |\n| **外部依赖** | ✅ 零依赖 | ❌ Google.Protobuf / Grpc.Net.Client / NLog 等 | ⚠️ 部分依赖 |\n| **Protobuf 实现** | 自研 ProtoWriter/ProtoReader | Google.Protobuf | 无 |\n| **目标框架** | net45 ~ netstandard2.1 | .NET 5+ / .NET Core 3.1 | 不一致 |\n| **.NET Framework 支持** | ✅ 4.5+ | ❌ 不支持 | ⚠️ 部分 |\n| **多云适配** | ✅ 统一 ICloudProvider 接口 | ❌ 需自行适配 | ❌ 无 |\n| **阿里云适配** | ✅ AliyunProvider | ❌ | ❌ |\n| **华为云适配** | ✅ HuaweiProvider | ❌ | ❌ |\n| **腾讯云适配** | ✅ TencentProvider | ❌ | ❌ |\n| **事务消息** | ✅ 发送+回查 | ✅ 发送+回查 | ⚠️ 部分 |\n| **消费重试/死信** | ✅ 完整 | ✅ 内置 | ❌ 无 |\n| **顺序消费** | ✅ 锁定机制 | ✅ FIFO | ❌ 无 |\n| **批量消息** | ✅ 发送+解码 | ❌ 不支持 | ❌ 无 |\n| **Pop 消费** | ✅ Pop/Ack/BatchAck | ✅ SimpleConsumer | ❌ 无 |\n| **Request-Reply** | ✅ 同步/异步 | ❌ 不支持 | ❌ 无 |\n| **消息轨迹** | ✅ MessageTraceHook | ⚠️ OpenTelemetry 集成 | ❌ 无 |\n| **VIP 通道** | ✅ | N/A（gRPC） | ❌ 无 |\n| **消息压缩** | ✅ ZLIB 自动压缩 | ✅ ZLib | ❌ 无 |\n| **管理 API** | ✅ Topic/消费组 CRUD、消息查询、偏移重置 | ❌ 无 | ❌ 无 |\n| **测试覆盖** | 30+ 测试类 | 有单元测试 | 少量或无 |\n| **维护活跃度** | ✅ 持续维护（新生命团队） | ⚠️ 更新较慢（最新 10 个月前） | ❌ 多数已停止 |\n| **文档语言** | 中文为主 | 中英文 | 不一致 |\n| **NuGet 包名** | NewLife.RocketMQ | RocketMQ.Client | — |\n| **开源协议** | MIT | Apache 2.0 | 不一致 |\n\n### 7.2 跨语言 RocketMQ 客户端对比\n\n| 维度 | NewLife.RocketMQ (.NET) | 官方 Java 客户端 | 官方 Go 客户端 | 官方 C++ 客户端 |\n|------|:----------------------:|:----------------:|:--------------:|:--------------:|\n| **语言生态** | .NET 原生 | Java 原生 | Go 原生 | C++ 原生 |\n| **部署复杂度** | ✅ 单一 DLL，零依赖 | ⚠️ 需要 JRE | ✅ 单一二进制 | ⚠️ 需编译 |\n| **4.x Remoting** | ✅ 完整 | ✅ 完整 | ❌ 仅 5.x gRPC | ❌ 仅 5.x gRPC |\n| **5.x gRPC** | ✅ 自研编解码 | ✅ 官方实现 | ✅ 官方实现 | ✅ 官方实现 |\n| **消息类型** | Normal/Delay/FIFO/Transaction | 全部 | 全部 | 全部 |\n| **消费者类型** | Pull/Push(模拟)/Pop/Simple | 全部 | SimpleConsumer/PushConsumer | SimpleConsumer |\n| **功能完整度** | ✅ 4.x 100%，5.x ~90% | ✅ 100% | ✅ 5.x 功能完整 | ✅ 5.x 功能完整 |\n| **消息批量** | ✅ 发送+解码 | ✅ 发送+解码 | ❌ | ❌ |\n| **管理 API** | ✅ 完整 | ✅ 完整 | ❌ 无 | ❌ 无 |\n| **社区活跃度** | ⚠️ 新生命团队维护 | ✅ Apache 官方 | ✅ Apache 官方 | ✅ Apache 官方 |\n\n### 7.3 与同类消息队列 .NET 客户端对比\n\n| 维度 | NewLife.RocketMQ | Confluent.Kafka | RabbitMQ.Client | NewLife.Redis (队列) |\n|------|:----------------:|:--------------:|:--------------:|:------------------:|\n| **消息中间件** | RocketMQ | Kafka | RabbitMQ | Redis Stream/List |\n| **协议** | Remoting + gRPC | Kafka 协议 | AMQP | RESP |\n| **外部依赖** | ✅ 零依赖 | ⚠️ librdkafka | ✅ 零依赖 | ✅ 零依赖 |\n| **事务消息** | ✅ | ✅（幂等生产者） | ⚠️ 确认机制 | ❌ |\n| **延迟消息** | ✅ 18 级 + 任意时间 | ❌ 不支持 | ✅ TTL + 死信 | ✅ 延迟队列 |\n| **顺序消息** | ✅ 队列锁定 | ✅ 分区有序 | ❌ 不保证 | ❌ 不保证 |\n| **消费重试** | ✅ 内置 | ❌ 需自行实现 | ✅ 死信交换器 | ❌ 需自行实现 |\n| **消息轨迹** | ✅ 内置 | ⚠️ 需集成 | ⚠️ 需集成 | ❌ |\n| **多云适配** | ✅ 统一接口 | ⚠️ Confluent Cloud | ❌ | ❌ |\n| **消息规模** | 万亿级 | 万亿级 | 百亿级 | 十亿级 |\n| **适用场景** | 企业级业务消息 | 大数据流处理 | 微服务解耦 | 轻量级队列/缓存 |\n\n### 7.4 核心竞争优势总结\n\n1. **零外部依赖**：纯 C# 实现，无需 Java、gRPC、Protobuf 第三方库，部署运维成本最低\n2. **双协议支持**：唯一同时支持 Remoting（4.x）和 gRPC（5.x）的 .NET 客户端，向后兼容且面向未来\n3. **最广框架覆盖**：.NET Framework 4.5+ 到 .NET 10，覆盖企业遗留系统和最新平台\n4. **统一多云适配**：唯一内置阿里云/华为云/腾讯云/Apache ACL 四家适配器的客户端\n5. **生产级特性**：完整的企业级功能（事务回查、消费重试、死信队列、顺序消费、Pop 消费、消息轨迹等）\n6. **管理 API 完整**：Topic/消费组 CRUD、消息查询、消费统计、偏移重置等运维功能\n7. **持续维护**：新生命团队持续迭代更新，紧跟 RocketMQ 社区演进\n\n## 8. 验收记录\n\n### 功能验收\n\n| 编号 | 功能点 | 验收条件 | 状态 | 备注 |\n|------|--------|---------|:----:|------|\n| F001~F008 | 核心通信与基础消息 | 协议编解码、连接管理、路由发现、消费调度 | ✅ 通过 | — |\n| F009~F016 | 生产可靠性增强 | 延迟/事务/批量/顺序/重试/死信 | ✅ 通过 | — |\n| F017~F027 | 功能完善 | 过滤/压缩/IPv6/多 Topic/Pop/轨迹/查询 | ✅ 通过 | — |\n| F028~F032 | 云厂商适配 | 四家适配器全部实现 | ✅ 通过 | 云厂商 5.x 环境待验证 |\n| F033~F038 | gRPC 协议与 5.x 新特性 | Protobuf 编解码/gRPC 通信/11 个 RPC | ✅ 通过 | netstandard2.1+ |\n| F039~F044 | 功能增强与优化 | VIP 通道/批量 Ack/管理 API | ✅ 通过 | — |\n\n### 遗留问题\n\n| 问题 | 影响 | 后续计划 |\n|------|------|---------|\n| 阿里云公网版 BrokerName 不匹配 | 消费者状态中偏移匹配需容错 | 已用 `?? new OffsetWrapperModel()` 容错处理 |\n| 各云厂商 5.x gRPC 接入未验证 | 阿里云 Serverless/华为云 5.x/腾讯云 | 客户端已具备能力，待实际环境测试 |\n| Language 标识为 DOTNET | 部分 Broker 可能不识别 | 暂无影响，DOTNET 为合理标识 |\n\n### 经验总结\n\n- **做得好的**：零依赖的 Protobuf 编解码器设计、统一云厂商适配接口、50+ 测试类高覆盖率\n- **待改进的**：云厂商 5.x 环境的实际验证、性能基准测试数据补充\n\n### 单元测试覆盖统计\n\n| 测试类 | 测试数 | 覆盖目标 | 状态 |\n|--------|:------:|---------|:----:|\n| CommandTests | 16 | Command 协议帧编解码 | ✅ 通过 |\n| SpanRefactorTests | 20+ | 二进制协议序列化、MessageExt 5.x ID | ✅ 通过 |\n| ProtoTests | 30+ | Protobuf 编解码（Varint/Fixed/Map/嵌套/gRPC） | ✅ 通过 |\n| NameClientTests | 8 | 路由发现解析、缓存、主从地址 | ✅ 通过 |\n| BatchMessageTests | 10 | 批量消息编解码、SysFlag、自动展开 | ✅ 通过 |\n| MessageTests | 5 | 消息体设置、属性解析 | ✅ 通过 |\n| MessageExtendedTests | 20 | Request-Reply 属性、延迟/等待/事务/UserProperty | ✅ 通过 |\n| MessageId5xTests | 11 | 5.x 消息ID生成与解析 | ✅ 通过 |\n| IPv6Tests | 5 | IPv6 消息解码、SysFlag 位判断 | ✅ 通过 |\n| CloudProviderTests | 25 | Aliyun/ACL/Huawei/Tencent 适配器 | ✅ 通过 |\n| HeaderTests | 9 | 协议头默认值、GetExtFields、CreateException | ✅ 通过 |\n| SendResultTests | 8 | 发送结果 Read 方法、ToString、枚举值 | ✅ 通过 |\n| PullResultTests | 8 | 拉取结果 Read 方法、ToString、枚举值 | ✅ 通过 |\n| MessageQueueTests | 10 | 消息队列 Equals/GetHashCode/ToString | ✅ 通过 |\n| ResponseExceptionTests | 5 | 响应异常构造与捕获 | ✅ 通过 |\n| RequestHeaderTests | 7 | 三种请求头 GetProperties 反射映射 | ✅ 通过 |\n| WeightRoundRobinTests | 8 | 负载均衡算法（等/不等权重分配、初始化） | ✅ 通过 |\n| BrokerInfoTests | 9 | 代理信息属性、Equals/GetHashCode、Permissions | ✅ 通过 |\n| ProtocolDataTests | 12 | HeartbeatData/ProducerData/ConsumerData/SubscriptionData/QueryResult | ✅ 通过 |\n| TraceModelTests | 9 | TraceContext/TraceBean/SendMessageContext/ConsumeMessageContext | ✅ 通过 |\n| ModelTests | 11 | 枚举值验证（DelayTimeLevels/RequestCode/ResponseCode 等） | ✅ 通过 |\n| MqBasePropertyTests | 15 | MqBase 默认值、ClientId、属性设置、Active 状态 | ✅ 通过 |\n| ConsumerStatesModelTests | 7 | ConsumerStatesModel/MessageQueueModel/OffsetWrapperModel | ✅ 通过 |\n| MqSettingTests | 1 | MqSetting 配置属性 | ✅ 通过 |\n| MQVersionTests | 1 | MQVersion 版本转换 | ✅ 通过 |\n| MQVersionUpdateTests | 4 | 版本枚举 5.x、默认版本 | ✅ 通过 |\n| VipChannelTests | 6 | VIP 通道启用/禁用 | ✅ 通过 |\n| SQL92FilterTests | 5 | SQL92 过滤表达式类型 | ✅ 通过 |\n| CompressionTests | 3 | 消息压缩阈值 | ✅ 通过 |\n| BroadcastOffsetTests | 4 | 广播模式消息模型与偏移存储 | ✅ 通过 |\n| MultiTopicTests | 6 | 多主题消费 | ✅ 通过 |\n| RetryTests | 7 | 重试机制参数 | ✅ 通过 |\n| ConcurrentConsumeTests | 3 | 并发消费参数 | ✅ 通过 |\n| TransactionCheckTests | 3 | 事务回查回调 | ✅ 通过 |\n| OrderConsumeTests | 6 | 顺序消费与队列锁 | ✅ 通过 |\n| PopConsumeTests | 5 | Pop 消费异常处理与请求码 | ✅ 通过 |\n| BatchAckTests | 6 | 批量确认异常处理与请求码 | ✅ 通过 |\n| QueryMessageTests | 3 | 消息查询参数校验 | ✅ 通过 |\n| RequestReplyTests | 1 | Request-Reply 消息属性 | ✅ 通过 |\n| BrokerFailoverTests | 5 | Broker 主从切换 | ✅ 通过 |\n| ConsumeStatsTests | 2 | 消费统计请求码 | ✅ 通过 |\n| **合计** | **344** | — | **✅ 全部通过** |\n\n> 另有 30 个集成测试标记为 Skip（需要 RocketMQ 服务器支持），包括 ProducerTests、ConsumerTests、AliyunTests、ManagementTests 等。\n\n## 9. 术语表\n\n| 术语 | 定义 |\n|------|------|\n| Remoting 协议 | RocketMQ 4.x 的经典 TCP 私有协议，采用二进制帧格式 + JSON/二进制序列化 |\n| gRPC 协议 | RocketMQ 5.x 引入的新协议，基于 HTTP/2 + Protobuf |\n| Proxy | RocketMQ 5.x 架构中的代理层，接收 gRPC 请求并转发到 Broker |\n| NameServer | RocketMQ 的名称服务器，提供 Topic 路由发现 |\n| Broker | RocketMQ 的消息存储和转发服务器 |\n| Rebalance | 消费者负载均衡，将队列均匀分配给消费者 |\n| Pop 消费 | RocketMQ 4.9+ 引入的新消费模式，不自动提交偏移，需手动确认 |\n| VIP 通道 | 使用 BrokerPort - 2 的优先级端口，提供更高性能的连接 |\n| ICloudProvider | 统一云厂商适配接口，封装签名、路由转换、NameServer 发现等逻辑 |\n| HMAC-SHA1 | 基于哈希的消息认证码，用于请求签名 |\n| Opaque | 请求唯一标识符，用于 TCP 连接上的请求-响应匹配 |\n| SysFlag | 消息系统标志位，标识压缩、IPv6、批量等特征 |\n| 死信队列（DLQ） | Dead Letter Queue，超过最大重试次数后消息进入的队列 |\n"
},
{
"path": "LICENSE",
"content": "MIT License\n\nCopyright (c) 2018 新生命开发团队\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
},
{
"path": "NewLife.RocketMQ/.github/copilot-instructions.md",
"content": "# NewLife Copilot 协作指令\n\n本说明适用于新生命团队（NewLife）及其全部开源/衍生项目，规范 Copilot 及类似智能助手在 C#/.NET 项目中的协作行为。\n\n> 目标：把\"每次请求必须携带的通用规则\"控制在可接受体积；组件/业务专项流程放在 `.github/instructions/`，按需读取。\n\n---\n\n## 1. 核心原则\n\n| 原则 | 说明 |\n|------|------|\n| **提效** | 减少机械样板，聚焦业务/核心算法 |\n| **一致** | 风格、结构、命名、API 行为稳定 |\n| **可控** | 限制改动影响面，可审计，兼容友好 |\n| **可靠** | 先检索再生成，不虚构，不破坏现有合约 |\n| **主动** | 发现问题主动修复，不回避合理优化 |\n\n---\n\n## 2. 适用范围\n\n- 含 NewLife 组件或衍生的全部 C#/.NET 仓库\n- 不含纯前端/非 .NET/市场文案\n- 存在本文件 → 必须遵循\n\n---\n\n## 3. 组件专用指令索引（按需加载）\n\n以下专用指令**仅在相关任务时**才需要读取，避免每次请求都携带大段流程/示例。\n\n### 3.1 XCode / Cube（数据库 & Web 快速开发）\n\n当任务涉及以下任一信号时，请**先搜索并检查当前仓库** `.github/instructions/xcode.instructions.md` **是否存在**，若存在则读取并遵循：\n\n- 需求包含：XCode/Cube/魔方/实体生成/模型 XML/数据类库/数据库 CRUD/Controller 生成/`xcodetool`/`xcode` 命令\n- 解决方案/项目中出现：`NewLife.XCode` 包引用\n- 存在：`Model.xml`、`*.xcode.xml`、`*.Data.csproj`（或项目名以 `.Data` 结尾）\n- 代码出现命名空间/类型：`XCode.*`、`Entity`（XCode 实体基类）、XCode 相关特性/接口\n- **用户提到修改任意 `.xml` 文件**（如 `member.xml`、`area.xml` 等配置文件），应**主动搜索** `xcode.instructions.md` 判断是否需要引入\n\n**主动检测策略**：当用户提及 XML 文件修改时，即使未明确提到 XCode 关键字，也应先用 `file_search` 搜索 `xcode.instructions.md`，若存在则读取，以确定该 XML 文件是否属于 XCode/Cube 体系。\n\n未满足以上条件时，**不要**引入 XCode/Cube 初始化流程，避免干扰其它仓库的常规开发。\n\n---\n\n## 4. 工作流\n\n```\n需求分类 → 检索 → 评估 → 设计 → 实施 → 验证 → 说明\n```\n\n1. **需求分类**：功能/修复/性能/重构/文档\n2. **检索**：相关类型、目录、方法、已有扩展/工具（**优先复用**）\n3. **评估**：是否公共 API？是否性能热点？**是否存在潜在问题？**\n4. **设计**：列出改动点 + 兼容/降级策略\n5. **实施**：\n - 完成用户请求的核心任务\n - **顺带修复**发现的明显缺陷（资源泄漏、空引用、逻辑错误）\n - **顺带优化**可简化的重复代码\n - 保留原注释与结构，除非注释本身有误\n6. **验证**：\n - 代码变更：必须编译通过；运行相关单元测试（未找到需说明）\n - 仅文档变更（未修改任何代码文件）：可跳过编译与单元测试\n7. **说明**：变更摘要/影响范围/风险点\n\n### 4.1 主动优化原则\n\n当用户请求分析或优化代码时，**应主动**：\n\n| 类型 | 行动 |\n|------|------|\n| **架构梳理** | 梳理代码架构并进行重构，让代码结构更清晰易懂 |\n| **语法现代化** | 使用最新的 C# 语法来简化代码，提升可读性 |\n| **缺陷修复** | 资源泄漏、空引用风险、并发问题、逻辑错误 → 直接修复，让代码更健壮 |\n| **性能优化** | 无用分配、重复计算、可池化资源 → 通过缓存减少耗时的重复计算 |\n| **代码简化** | 重复代码提取、冗余判断合并、现代语法替换 → 在不影响可读性前提下简化 |\n| **注释完善** | 补充类、接口、属性、方法头部的注释，以及方法内部重要代码的注释 |\n| **架构参考** | 参考网络上同类功能的优秀架构，给出架构调整建议 |\n\n**架构调整策略**：\n- **改动较小**：直接调整，完成后说明变更内容\n- **改动较大**：先列出调整方案，询问用户意见，待确认后再修改\n\n**不应过度保守**：\n- ❌ 仅添加注释而忽略明显的代码问题\n- ❌ 发现资源泄漏却不修复\n- ❌ 看到重复代码却不提取\n- ❌ 用户要求优化时只做表面工作\n\n**保持谨慎的场景**：\n- 公共 API 签名变更 → 需说明兼容性影响\n- 性能关键路径 → 需有依据或说明推理\n- 大范围重构 → 需先与用户确认范围\n\n### 4.2 防御性注释规则\n\n在旧有代码中，经常可以看到**被注释掉的代码**，这些注释代码前面通常带有说明文字。\n\n**这些是防御性注释**：\n- 记录了过去曾经踩过的坑\n- 目的是告诉后来人不要按照注释代码去写，否则会有问题\n- **禁止删除此类防御性注释**，用于警示后人\n\n**识别特征**：\n```csharp\n// 曾经尝试过 xxx 方案，但会导致 yyy 问题\n// var result = DoSomethingWrong();\n\n// 不要使用 xxx，否则会造成 yyy\n// await client.SendAsync(data);\n\n// 这里不能用 xxx，因为 yyy\n// stream.Flush();\n```\n\n**处理原则**：\n- ✅ 保留这类带说明的注释代码\n- ✅ 可以补充更详细的说明，解释为什么不能这样做\n- ❌ 不要删除这类防御性注释\n- ❌ 不要尝试\"恢复\"这些被注释的代码\n\n---\n\n## 5. 编码规范\n\n### 5.1 基础规范\n\n| 项目 | 规范 |\n|------|------|\n| 语言版本 | `latest`，所有目标框架均使用最新 C# 语法 |\n| 命名空间 | file-scoped namespace |\n| 类型名 | **必须**使用 .NET 正式名 `String`/`Int32`/`Boolean` 等，避免 `string`/`int`/`bool` |\n| 兼容性 | 代码需兼容 .NET 4.5+；**禁止**使用 `ArgumentNullException.ThrowIfNull`，改用 `if (value == null) throw new ArgumentNullException(nameof(value));` |\n| 单文件 | 每文件一个主要公共类型；较大平台差异使用 `partial` |\n\n### 5.2 命名规范\n\n| 成员类型 | 命名规则 | 示例 |\n|---------|---------|------|\n| 类型/公共成员 | PascalCase | `UserService`、`GetName()` |\n| 参数/局部变量 | camelCase | `userName`、`count` |\n| 私有字段（实例/静态） | `_camelCase` | `_cache`、`_instance` |\n| 属性/方法（实例/静态） | PascalCase | `Name`、`Default`、`Create()` |\n| 扩展方法类 | `xxxHelper` 或 `xxxExtensions` | `StringHelper`、`CollectionExtensions` |\n\n### 5.3 代码风格\n\n```csharp\n// ✅ 单行 if：单语句且整行不过长时同行\nif (value == null) return;\nif (key == null) throw new ArgumentNullException(nameof(key));\n\n// ✅ 单行 if：语句较长时另起一行\nif (value == null)\n throw new ArgumentNullException(nameof(value), \"Value cannot be null\");\n\n// ✅ 多分支单语句：不加花括号\nif (count > 0)\n DoSomething();\nelse\n DoOther();\n\n// ✅ 循环必须保留花括号（即使单语句）\nforeach (var item in list)\n{\n Process(item);\n}\n```\n\n### 5.4 Region 组织结构\n\n较长的类使用 `#region` 分段组织，顺序为：`属性` → `静态`（如有）→ `构造` → `方法` → `辅助`（如有）→ `日志`。\n\n**日志 Region 规则**：\n- 类代码中如果带有 `ILog Log { get; set; }` 和 `WriteLog` 方法\n- **必须放在类代码的最后**\n- **必须用名为\"日志\"的 region 包裹**\n- 不要放在\"辅助\" region 中，应单独作为\"日志\" region\n\n### 5.5 现代 C# 语法\n\n优先使用最新语法（switch 表达式、模式匹配、目标类型 `new`、record 等），即使目标框架是 net45。\n\n### 5.6 集合表达式\n\n优先使用集合表达式 `[]` 初始化集合：`List Tags { get; set; } = [];`\n\n### 5.7 Null 条件运算符\n\n优先使用 `?.` / `??` 简化空值检查：`span?.AppendTag(\"test\");` `var name = user?.Profile?.Name ?? \"\";`\n\n---\n\n## 6. 多目标框架\n\nNewLife 支持 `net45` 到 `net10`，常用条件符号：`NETFRAMEWORK`、`NETSTANDARD2_0`、`NETCOREAPP`、`NET5_0_OR_GREATER`、`NET6_0_OR_GREATER`、`NET8_0_OR_GREATER`。\n\n新增 API 时需评估各框架兼容性，必要时提供降级实现。\n\n---\n\n## 7. 文档注释\n\n| 规则 | 说明 |\n|------|------|\n| `` | **必须同一行闭合**，简短描述方法用途 |\n| `` | **必须为每个参数添加**，无论方法可见性如何 |\n| `` | 有返回值时必须添加 |\n| `` | 复杂方法可增加详细说明（可多行） |\n| 覆盖范围 | `public`/`protected` 成员必须注释；`private`/`internal` 建议添加 |\n| `[Obsolete]` | 必须包含迁移建议 |\n\n**正确示例**：`/// 获取名称` `/// 编号`\n\n**禁止**：`` 拆成多行；缺少 ``；有参数但无 param 标签。\n\n---\n\n## 8. 异步与性能\n\n| 规范 | 说明 |\n|------|------|\n| 方法命名 | 异步方法后缀 `Async` |\n| ConfigureAwait | 库内部默认 `ConfigureAwait(false)` |\n| 高频路径 | 优先对象池/`ArrayPool`/`Span`，避免多余分配 |\n| 反射/Linq | 仅用于非热点路径；热点使用手写循环/缓存 |\n| 池化资源 | 明确获取/归还；异常分支不遗失归还 |\n\n**内置工具优先**：`Pool.StringBuilder`、`Runtime.TickCount64`、`ToInt()`/`ToBoolean()` 等扩展方法。\n\n---\n\n## 9. 日志与追踪\n\n规则：若类包含 `ILog Log` 与 `WriteLog`，必须放在类末尾，并用名为\"日志\"的 `#region` 包裹；关键过程可使用 `Tracer?.NewSpan()` 埋点。\n\n---\n\n## 10. 错误处理\n\n- **精准异常类型**：`ArgumentNullException`/`InvalidOperationException` 等\n- **参数校验**：空/越界/格式\n- **TryXxx 模式**：不用异常作常规分支\n- **类型转换**：优先使用 `ToInt()`/`ToBoolean()` 等扩展方法\n- **对外异常**：不暴露内部实现/路径\n\n---\n\n## 11. 测试规范\n\n| 项目 | 规范 |\n|------|------|\n| 框架 | xUnit |\n| 命名 | `{ClassName}Tests` |\n| 描述 | `[DisplayName(\"中文描述意图\")]` |\n| IO | 使用临时目录；端口用 0/随机 |\n| 覆盖 | 正常/边界/异常/并发（必要时） |\n\n### 测试执行策略\n\n1. 优先检索 `{ClassName}` 引用，若落入测试项目则运行\n2. 未命中则查找 `{ClassName}Tests.cs`\n3. **未发现相关测试需明确说明**，不自动创建测试项目\n\n---\n\n## 12. NuGet 发布规范\n\n| 类型 | 命名规则 | 示例 |\n|------|---------|------|\n| 正式版 | `{主版本}.{子版本}.{年}.{月日}` | `11.9.2025.0701` |\n| 测试版 | `{主版本}.{子版本}.{年}.{月日}-beta{时分}` | `11.9.2025.0701-beta0906` |\n\n- **正式版**：每月月初发布\n- **测试版**：提交代码到 GitHub 时自动发布\n\n---\n\n## 13. Markdown 文档规范\n\n| 项目 | 规范 |\n|------|------|\n| 文件编码 | **必须** UTF-8，**禁止** GB2312/GBK/UTF-8 BOM |\n| 默认存放 | 代码库根目录下的 `Doc` 目录 |\n| 文件命名 | 优先**中文文件名**，简洁描述内容 |\n\n**注意**：已有文件**必须先读取**再增量修改，**禁止直接覆盖**。\n\n---\n\n## 14. Copilot 行为守则\n\n### 必须\n\n- 简体中文回复\n- 输出前检索现有实现，**禁止重复造轮子**\n- 先列方案再实现\n- 标记不确定上下文为\"需查看文件\"\n- **发现明显缺陷时主动修复**（资源泄漏、空引用、逻辑错误）\n- **用户要求优化时深入分析**，不做表面工作\n\n### 鼓励\n\n- 提取重复代码为公共方法\n- 简化冗余的条件判断\n- 使用现代 C# 语法改进可读性\n- 补充缺失的资源释放逻辑\n- 修正错误或过时的注释\n\n### 禁止\n\n- 虚构 API/文件/类型\n- 伪造测试结果/性能数据\n- 擅自删除公共/受保护成员\n- 擅自删除已有代码注释（除非注释本身错误）\n- **删除防御性注释**（带说明的注释代码，记录历史踩坑经验）\n- 仅删除空白行制造\"格式优化\"提交\n- 删除循环体的花括号\n- 将 `` 拆成多行\n- 将 `String`/`Int32` 改为 `string`/`int`\n- 新增外部依赖（除非说明理由并给出权衡）\n- 在热点路径添加未缓存反射/复杂 Linq\n- 输出敏感凭据/内部地址\n- **发现问题却视而不见**\n- **用户要求优化时仅做注释/测试等表面工作**\n\n---\n\n## 15. 变更说明模板\n\n提交或答复需包含：\n\n```markdown\n## 概述\n做了什么 / 为什么\n\n## 影响\n- 公共 API：是/否\n- 性能影响：无/有（说明）\n\n## 兼容性\n降级策略 / 条件编译点\n\n## 风险\n潜在回归 / 性能开销\n\n## 后续\n是否补测试 / 文档\n```\n\n---\n\n## 16. 术语说明\n\n| 术语 | 定义 |\n|------|------|\n| **热点路径** | 经性能分析或高频调用栈确认的关键执行段 |\n| **基线** | 变更前的功能/性能参考数据 |\n| **顺带修复** | 在完成主任务过程中，修复发现的相关问题 |\n| **防御性注释** | 被注释掉的代码，前面带有说明，记录历史踩坑经验，用于警示后人 |\n\n---\n\n## 17. 代码优化检查清单\n\n当进行代码优化时，按以下清单逐项检查：\n\n### 架构与结构\n- [ ] 代码架构是否清晰？是否需要重构？\n- [ ] 类的职责是否单一？是否需要拆分？\n- [ ] 是否有重复代码可以提取为公共方法？\n- [ ] Region 组织是否符合规范（属性→静态→构造→方法→辅助→日志）？\n\n### 语法现代化\n- [ ] 是否可以使用更简洁的 C# 语法？（switch 表达式、模式匹配等）\n- [ ] 集合初始化是否使用了集合表达式 `[]`？\n- [ ] 是否可以使用 null 条件运算符 `?.` 简化代码？\n\n### 健壮性\n- [ ] 是否存在空引用风险？\n- [ ] 资源是否正确释放？（IDisposable、流、连接等）\n- [ ] 异常处理是否完善？\n- [ ] 并发场景是否线程安全？\n\n### 性能\n- [ ] 是否存在可以缓存的重复计算？\n- [ ] 是否有不必要的对象分配？\n- [ ] 热点路径是否避免了反射和复杂 Linq？\n- [ ] 是否使用了对象池/ArrayPool 等池化技术？\n\n### 注释与文档\n- [ ] 类、接口是否有 `` 注释？\n- [ ] 公共方法是否有完整的参数和返回值注释？\n- [ ] 方法内重要逻辑是否有注释说明？\n- [ ] 防御性注释是否保留？\n\n### 日志\n- [ ] `ILog Log` 和 `WriteLog` 是否放在类的最后？\n- [ ] 是否用名为\"日志\"的 region 包裹？\n\n---\n\n（完）\n"
},
{
"path": "NewLife.RocketMQ/AclOptions.cs",
"content": "namespace NewLife.RocketMQ\n{\n /// \n /// 支持 Apache RocketMQ ACL机制\n /// \n public class AclOptions\n {\n /// Acl访问令牌\n public String AccessKey { get; set; }\n\n /// Acl访问密钥\n public String SecretKey { get; set; }\n\n /// 通道\n public String OnsChannel { get; set; } = \"LOCAL\";\n }\n}\n"
},
{
"path": "NewLife.RocketMQ/AclProvider.cs",
"content": "namespace NewLife.RocketMQ;\n\n/// Apache RocketMQ ACL 适配器\npublic class AclProvider : ICloudProvider\n{\n /// 提供者名称\n public String Name => \"ACL\";\n\n /// 访问令牌\n public String AccessKey { get; set; }\n\n /// 访问密钥\n public String SecretKey { get; set; }\n\n /// 通道标识。默认空\n public String OnsChannel { get; set; } = \"\";\n\n /// 转换主题名。ACL模式不转换\n public String TransformTopic(String topic) => topic;\n\n /// 转换消费组名。ACL模式不转换\n public String TransformGroup(String group) => group;\n\n /// 获取 NameServer 地址。ACL模式不从HTTP获取\n public String GetNameServerAddress() => null;\n\n /// 从旧版 AclOptions 创建\n /// 旧版ACL选项\n /// \n public static AclProvider FromOptions(AclOptions options)\n {\n if (options == null) return null;\n\n return new AclProvider\n {\n AccessKey = options.AccessKey,\n SecretKey = options.SecretKey,\n OnsChannel = options.OnsChannel ?? \"\",\n };\n }\n}\n"
},
{
"path": "NewLife.RocketMQ/AliyunOptions.cs",
"content": "using System;\n\nnamespace NewLife.RocketMQ\n{\n /// \n /// 阿里云选项\n /// \n public class AliyunOptions\n {\n #region 阿里云属性\n /// 获取名称服务器地址的http地址。阿里云专用\n public String Server { get; set; } = \"http://onsaddr-internet.aliyun.com/rocketmq/nsaddr4client-internet\";\n\n /// 访问令牌。阿里云专用\n public String AccessKey { get; set; }\n\n /// 访问密钥。阿里云专用\n public String SecretKey { get; set; }\n\n /// 实例ID。阿里云专用\n public String InstanceId { get; set; }\n\n /// 阿里云MQ通道。阿里云专用\n public String OnsChannel { get; set; } = \"ALIYUN\";\n #endregion\n\n }\n}"
},
{
"path": "NewLife.RocketMQ/AliyunProvider.cs",
"content": "namespace NewLife.RocketMQ;\n\n/// 阿里云 RocketMQ 适配器\npublic class AliyunProvider : ICloudProvider\n{\n /// 提供者名称\n public String Name => \"Aliyun\";\n\n /// 访问令牌\n public String AccessKey { get; set; }\n\n /// 访问密钥\n public String SecretKey { get; set; }\n\n /// 通道标识。默认ALIYUN\n public String OnsChannel { get; set; } = \"ALIYUN\";\n\n /// 实例ID。MQ_INST_xxx\n public String InstanceId { get; set; }\n\n /// NameServer HTTP 发现地址\n public String Server { get; set; }\n\n /// 转换主题名。阿里云需要加实例ID前缀\n /// 原始主题名\n /// \n public String TransformTopic(String topic)\n {\n var ins = InstanceId;\n if (!String.IsNullOrEmpty(ins) && !topic.StartsWith(ins))\n return $\"{ins}%{topic}\";\n\n return topic;\n }\n\n /// 转换消费组名。阿里云需要加实例ID前缀\n /// 原始消费组名\n /// \n public String TransformGroup(String group)\n {\n var ins = InstanceId;\n if (!String.IsNullOrEmpty(ins) && !group.StartsWith(ins))\n return $\"{ins}%{group}\";\n\n return group;\n }\n\n /// 获取 NameServer 地址。从阿里云 HTTP 接口获取\n /// \n public String GetNameServerAddress()\n {\n var addr = Server;\n if (String.IsNullOrEmpty(addr) || !addr.StartsWith(\"http\", StringComparison.OrdinalIgnoreCase))\n return null;\n\n var http = new System.Net.Http.HttpClient();\n var html = http.GetStringAsync(addr).ConfigureAwait(false).GetAwaiter().GetResult();\n\n return String.IsNullOrWhiteSpace(html) ? null : html.Trim();\n }\n\n /// 从旧版 AliyunOptions 创建\n /// 旧版阿里云选项\n /// \n public static AliyunProvider FromOptions(AliyunOptions options)\n {\n if (options == null) return null;\n\n return new AliyunProvider\n {\n AccessKey = options.AccessKey,\n SecretKey = options.SecretKey,\n OnsChannel = options.OnsChannel ?? \"ALIYUN\",\n InstanceId = options.InstanceId,\n Server = options.Server,\n };\n }\n}\n"
},
{
"path": "NewLife.RocketMQ/BrokerClient.cs",
"content": "using NewLife.Log;\nusing NewLife.Net;\nusing NewLife.RocketMQ.Protocol;\nusing NewLife.Threading;\n\nnamespace NewLife.RocketMQ;\n\n/// 代理客户端\npublic class BrokerClient : ClusterClient\n{\n #region 属性\n /// 服务器地址\n private readonly String[] _Servers;\n #endregion\n\n #region 构造\n /// 实例化代理客户端\n /// \n public BrokerClient(String[] servers) => _Servers = servers;\n #endregion\n\n #region 方法\n /// 启动\n protected override void OnStart()\n {\n //Servers = _Servers.Select(e => new NetUri(e)).ToArray();\n var list = new List();\n foreach (var item in _Servers)\n {\n var uri = new NetUri(item);\n if (uri.Type == NetType.Unknown) uri.Type = NetType.Tcp;\n\n // VIP通道使用端口-2\n if (Config != null && Config.VipChannelEnabled && uri.Port > 2)\n uri.Port -= 2;\n\n list.Add(uri);\n }\n Servers = list.ToArray();\n\n base.OnStart();\n\n // 心跳\n StartPing();\n }\n #endregion\n\n #region 注销\n /// 注销客户端\n /// \n public virtual Command UnRegisterClient(String group)\n {\n if (group.IsNullOrEmpty()) group = \"CLIENT_INNER_PRODUCER\";\n\n return Invoke(RequestCode.UNREGISTER_CLIENT, new\n {\n ClientId = Id,\n ProducerGroup = group,\n ConsumerGroup = group,\n });\n }\n\n /// \n\n protected override void Dispose(Boolean disposing)\n {\n if (disposing)\n _timer?.Dispose();\n\n base.Dispose(disposing);\n }\n #endregion\n\n #region 心跳\n private TimerX _timer;\n\n private void StartPing()\n {\n if (_timer == null)\n {\n var period = Config.HeartbeatBrokerInterval;\n\n _timer = new TimerX(OnPing, null, 100, period) { Async = true };\n }\n }\n\n private void OnPing(Object state)\n {\n DefaultSpan.Current = null;\n\n Ping();\n }\n\n /// 心跳\n public void Ping()\n {\n using var span = Tracer?.NewSpan($\"mq:{Name}:Ping\");\n try\n {\n var cfg = Config;\n\n var body = new HeartbeatData { ClientID = Id };\n\n // 生产者 和 消费者 略有不同\n if (cfg is Producer pd)\n {\n body.ProducerDataSet = [\n new ProducerData { GroupName = pd.Group },\n new ProducerData { GroupName = \"CLIENT_INNER_PRODUCER\" },\n ];\n body.ConsumerDataSet = [];\n }\n else if (cfg is Consumer cm)\n {\n body.ProducerDataSet = [new ProducerData { GroupName = \"CLIENT_INNER_PRODUCER\" }];\n body.ConsumerDataSet = cm.Data.ToArray();\n }\n\n span?.AppendTag(body);\n\n // 心跳忽略错误。有时候报40错误\n Invoke(RequestCode.HEART_BEAT, body, null, true);\n }\n catch (Exception ex)\n {\n span?.SetError(ex, null);\n\n if (ex.GetTrue() is not TaskCanceledException)\n throw;\n }\n }\n #endregion\n\n #region 运行信息\n /// 获取运行时信息\n /// \n public IDictionary GetRuntimeInfo()\n {\n var rs = Invoke(RequestCode.GET_BROKER_RUNTIME_INFO, null);\n if (rs == null || rs.Payload == null) return null;\n\n var dic = rs.ReadBodyAsJson();\n\n return dic?[\"table\"] as IDictionary;\n }\n #endregion\n}"
},
{
"path": "NewLife.RocketMQ/ClusterClient.cs",
"content": "using System.Net.Sockets;\nusing System.Security.Cryptography;\nusing NewLife.Data;\nusing NewLife.Log;\nusing NewLife.Net;\nusing NewLife.RocketMQ.Client;\nusing NewLife.RocketMQ.Protocol;\nusing NewLife.Serialization;\n\nnamespace NewLife.RocketMQ;\n\n/// 集群客户端\n/// \n/// 维护到一个集群的客户端连接，内部采用负载均衡调度算法。\n/// \npublic abstract class ClusterClient : DisposeBase\n{\n #region 属性\n /// 编号\n public String Id { get; set; }\n\n /// 名称\n public String Name { get; set; }\n\n /// 超时。默认3000ms\n public Int32 Timeout { get; set; } = 3_000;\n\n /// 服务器地址集合\n public NetUri[] Servers { get; set; }\n\n /// 配置\n public MqBase Config { get; set; }\n\n /// 性能跟踪\n public ITracer Tracer { get; set; }\n\n private ISocketClient _Client;\n private SerializeType _serializeType = SerializeType.JSON;\n #endregion\n\n #region 构造\n /// 实例化\n public ClusterClient()\n {\n //_Pool = new MyPool { Client = this };\n }\n\n /// 销毁\n /// \n protected override void Dispose(Boolean disposing)\n {\n base.Dispose(disposing);\n\n //_Pool.TryDispose();\n _Client.TryDispose();\n }\n #endregion\n\n #region 方法\n /// 开始\n public void Start()\n {\n using var span = Tracer?.NewSpan($\"mq:{Name}:Start\", Servers);\n OnStart();\n }\n\n /// 开始\n protected virtual void OnStart()\n {\n WriteLog(\"集群地址：{0}\", Servers.Join(\";\"));\n\n if (Config != null)\n _serializeType = Config.SerializeType;\n\n EnsureCreate();\n }\n\n /// 确保创建连接\n protected void EnsureCreate()\n {\n var client = _Client;\n if (client != null && client.Active && !client.Disposed) return;\n lock (this)\n {\n client = _Client;\n if (client != null && client.Active && !client.Disposed) return;\n _Client = null;\n\n foreach (var uri in Servers)\n {\n WriteLog(\"正在连接[{0}]\", uri);\n\n if (uri.Type == NetType.Unknown) uri.Type = NetType.Tcp;\n\n client = uri.CreateRemote();\n client.Timeout = Timeout;\n client.Log = Log;\n if (Log != null && Log.Level <= LogLevel.Debug) client.Tracer = Tracer;\n client.Add(new MqCodec { Timeout = Timeout });\n\n // 关闭Tcp延迟以合并小包的算法，降低延迟\n if (client is TcpSession tcp)\n {\n tcp.SslProtocol = Config.SslProtocol;\n tcp.Certificate = Config.Certificate;\n tcp.NoDelay = true;\n }\n\n try\n {\n if (client.Open())\n {\n client.Received += Client_Received;\n _Client = client;\n break;\n }\n }\n catch { }\n }\n\n if (_Client == null) throw new XException(\"[{0}]集群所有地址[{1}]连接失败！\", Name, Servers.Length);\n }\n }\n\n private Int32 g_id;\n /// 发送命令\n /// \n /// \n /// 取消通知\n /// \n protected virtual async Task SendAsync(Command cmd, Boolean waitResult, CancellationToken cancellationToken = default)\n {\n if (cmd.Header.Opaque == 0) cmd.Header.Opaque = Interlocked.Increment(ref g_id);\n\n if (Log != null && Log.Level <= LogLevel.Debug) WriteLog(\"=> {0}\", cmd);\n\n var code = (RequestCode)cmd.Header.Code;\n using var span = Tracer?.NewSpan($\"mq:{Name}:SendAsync:{code}\");\n\n // 签名\n SetSignature(cmd);\n\n EnsureCreate();\n var client = _Client;\n try\n {\n if (span is DefaultSpan ds && ds.TraceFlag > 0)\n {\n span.AppendTag(cmd);\n span.AppendTag(cmd.Payload?.ToStr());\n }\n\n if (waitResult)\n {\n var rs = await client.SendMessageAsync(cmd, cancellationToken).ConfigureAwait(false);\n\n if (Log != null && Log.Level <= LogLevel.Debug) WriteLog(\"<= {0}\", rs as Command);\n\n var result = rs as Command;\n if (rs != null && span is DefaultSpan ds2 && ds2.TraceFlag > 0)\n {\n span.AppendTag(Environment.NewLine);\n span.AppendTag(rs);\n span.AppendTag(result?.Payload?.ToStr());\n }\n\n return result;\n }\n else\n {\n var row = client.SendMessage(cmd);\n return new Command\n {\n Reply = true,\n Header = new Header() { Code = (Int32)ResponseCode.SUCCESS }\n };\n }\n }\n catch (Exception ex)\n {\n // 拉取消息超时，不记录错误日志\n if (code == RequestCode.PULL_MESSAGE && ex is TaskCanceledException)\n span?.AppendTag(ex.Message);\n else\n span?.SetError(ex, null);\n\n // 销毁，下次使用另一个地址\n if (ex is SocketException or IOException)\n client.TryDispose();\n\n throw;\n }\n }\n\n private void SetSignature(Command cmd)\n {\n // 各云厂商和Apache ACL统一使用HMAC-SHA1签名：\n // 将扩展字段按ASCII排序拼接值，再加上body，计算HmacSHA1\n\n String accessKey;\n String secretKey;\n String onsChannel;\n\n // 优先使用新的 CloudProvider 接口\n var provider = Config.CloudProvider;\n if (provider != null && !provider.AccessKey.IsNullOrEmpty())\n {\n accessKey = provider.AccessKey;\n secretKey = provider.SecretKey;\n onsChannel = provider.OnsChannel;\n }\n else\n {\n // 兼容旧版：依次检查 Aliyun / AclOptions\n#pragma warning disable CS0618\n var aliyun = Config.Aliyun;\n if (aliyun != null && !aliyun.AccessKey.IsNullOrEmpty())\n {\n accessKey = aliyun.AccessKey;\n secretKey = aliyun.SecretKey;\n onsChannel = aliyun.OnsChannel;\n }\n else\n {\n var acl = Config.AclOptions;\n if (acl == null || acl.AccessKey.IsNullOrEmpty()) return;\n\n accessKey = acl.AccessKey;\n secretKey = acl.SecretKey;\n onsChannel = acl.OnsChannel;\n }\n#pragma warning restore CS0618\n }\n\n var sha = new HMACSHA1(secretKey.GetBytes());\n var ms = new MemoryStream();\n\n var dic = cmd.Header.GetExtFields();\n dic[\"AccessKey\"] = accessKey;\n dic[\"OnsChannel\"] = onsChannel;\n\n // 按照 asscii 排序已有 key\n var comparer = Comparer.Create(string.CompareOrdinal);\n foreach (var item in dic.OrderBy(e => e.Key, comparer).ToDictionary(e => e.Key, e => e.Value))\n {\n if (item.Value != null)\n {\n ms.Write(item.Value.GetBytes());\n }\n }\n\n // Body\n cmd.Payload?.CopyTo(ms);\n\n var sign = sha.ComputeHash(ms.ToArray());\n dic[\"Signature\"] = sign.ToBase64();\n }\n\n /// 发送指定类型的命令\n /// \n /// \n /// \n /// \n /// \n public virtual Command Invoke(RequestCode request, Object body, Object extFields = null, Boolean ignoreError = false)\n {\n var cmd = CreateCommand(request, body, extFields);\n\n // 避免UI死锁\n var rs = SendAsync(cmd, true).ConfigureAwait(false).GetAwaiter().GetResult();\n\n // 判断异常响应\n if (!ignoreError && rs.Header != null && rs.Header.Code != 0) throw rs.Header.CreateException();\n\n return rs;\n }\n\n /// 发送指定类型的命令\n public virtual async Task InvokeAsync(RequestCode request, Object body, Object extFields = null,\n Boolean ignoreError = false, CancellationToken cancellationToken = default)\n {\n var cmd = CreateCommand(request, body, extFields);\n\n var rs = await SendAsync(cmd, true, cancellationToken).ConfigureAwait(false);\n\n // 判断异常响应\n if (!ignoreError && rs.Header != null && rs.Header.Code != 0)\n {\n throw rs.Header.CreateException();\n }\n\n return rs;\n }\n\n /// 发送指定类型的命令\n /// \n /// \n /// \n /// \n public virtual Command InvokeOneway(RequestCode request, Object body, Object extFields = null)\n {\n var cmd = CreateCommand(request, body, extFields);\n cmd.OneWay = true;\n\n // 避免UI死锁\n var rs = Task.Run(() => SendAsync(cmd, false)).Result;\n\n return rs;\n }\n\n /// 创建命令\n /// \n /// \n /// \n /// \n public virtual Command CreateCommand(RequestCode request, Object body, Object extFields)\n {\n var header = new Header\n {\n Code = (Int32)request,\n SerializeTypeCurrentRPC = _serializeType + \"\",\n Remark = request + \"\",\n };\n if (Config != null && Config.Version > 0) header.Version = Config.Version;\n\n var cmd = new Command\n {\n Header = header,\n };\n\n // 主体\n if (body is IPacket pk)\n cmd.Payload = pk;\n else if (body is Byte[] buf)\n cmd.Payload = (ArrayPacket)buf;\n else if (body != null)\n cmd.Payload = (ArrayPacket)Config.JsonHost.Write(body, false, false, false).GetBytes();\n\n if (extFields != null)\n {\n var dic = header.GetExtFields();\n foreach (var item in extFields.ToDictionary())\n {\n if (item.Value != null && item.Value.GetType() == typeof(Boolean))\n dic[item.Key] = item.Value.ToBoolean() ? \"true\" : \"false\";\n else\n dic[item.Key] = item.Value + \"\";\n }\n }\n\n OnBuild(header);\n\n return cmd;\n }\n\n /// 建立命令时，处理头部\n /// \n protected virtual void OnBuild(Header header)\n {\n header.Language = \"DOTNET\";\n }\n #endregion\n\n #region 接收数据\n private void Client_Received(Object sender, ReceivedEventArgs e)\n {\n if (e.Message is not Command cmd) return;\n\n if (cmd.Reply)\n {\n //if (cmd.Header != null) _serializeType = cmd.Header.SerializeTypeCurrentRPC.ToEnum(SerializeType.JSON);\n\n return;\n }\n\n var rs = OnReceive(cmd);\n if (rs != null)\n {\n var ss = sender as ISocketRemote;\n ss.SendMessage(rs);\n }\n }\n\n /// 收到命令时\n public event EventHandler> Received;\n\n /// 收到命令\n /// \n protected virtual Command OnReceive(Command cmd)\n {\n var code = !cmd.Reply ? (RequestCode)cmd.Header.Code + \"\" : (ResponseCode)cmd.Header.Code + \"\";\n WriteLog(\"收到：Code={0} {1}\", code, cmd.Header.ToJson());\n\n using var span = Tracer?.NewSpan($\"mq:{Name}:Receive:{code}\", cmd);\n span?.AppendTag(cmd.Payload?.ToStr());\n try\n {\n if (Received == null) return null;\n\n var e = new EventArgs(cmd);\n Received.Invoke(this, e);\n\n return e.Arg;\n }\n catch (Exception ex)\n {\n span?.SetError(ex, null);\n\n throw;\n }\n }\n #endregion\n\n #region 日志\n /// 日志\n public ILog Log { get; set; }\n\n /// 写日志\n /// \n /// \n public void WriteLog(String format, params Object[] args) => Log?.Info($\"[{Name}]{format}\", args);\n #endregion\n}"
},
{
"path": "NewLife.RocketMQ/Common/BrokerInfo.cs",
"content": "namespace NewLife.RocketMQ;\n\n/// 权限\n[Flags]\npublic enum Permissions\n{\n /// 写入\n Write = 2,\n\n /// 读取\n Read = 4,\n}\n\n/// 代理信息\npublic class BrokerInfo\n{\n #region 属性\n /// 名称\n public String Name { get; set; }\n\n /// 集群\n public String Cluster { get; set; }\n\n /// 地址集合\n public String[] Addresses { get; set; }\n\n /// 主节点地址（BrokerId=0）\n public String MasterAddress { get; set; }\n\n /// 从节点地址集合（BrokerId>0）\n public String[] SlaveAddresses { get; set; }\n\n /// 权限\n public Permissions Permission { get; set; }\n\n /// 读队列数\n public Int32 ReadQueueNums { get; set; }\n\n /// 写队列数\n public Int32 WriteQueueNums { get; set; }\n\n /// 主题同步标记\n public Int32 TopicSynFlag { get; set; }\n\n /// 是否主节点\n public Boolean IsMaster { get; set; }\n #endregion\n\n #region 相等\n /// 相等比较\n /// \n /// \n public override Boolean Equals(Object obj)\n {\n var x = this;\n if (obj is not BrokerInfo y) return false;\n\n return x.Name == y.Name && (x.Addresses == y.Addresses || x.Addresses != null && y.Addresses != null && x.Addresses.SequenceEqual(y.Addresses))\n && x.Permission == y.Permission && x.TopicSynFlag == y.TopicSynFlag\n && x.ReadQueueNums == y.ReadQueueNums && x.WriteQueueNums == y.WriteQueueNums;\n }\n\n /// 计算哈希\n /// \n public override Int32 GetHashCode()\n {\n var obj = this;\n return obj.Name.GetHashCode() ^ obj.Addresses.GetHashCode()\n ^ obj.Permission.GetHashCode() ^ obj.TopicSynFlag\n ^ obj.ReadQueueNums ^ obj.WriteQueueNums;\n }\n #endregion\n}"
},
{
"path": "NewLife.RocketMQ/Common/ILoadBalance.cs",
"content": "using System;\n\nnamespace NewLife.RocketMQ.Common\n{\n /// 负载均衡接口\n public interface ILoadBalance\n {\n /// 已就绪\n Boolean Ready { get; set; }\n\n /// 设置每个选项的权重数据\n /// \n void Set(Int32[] weights);\n\n /// 根据权重选择，并返回该项是第几次选中\n /// 第几次选中\n /// \n Int32 Get(out Int32 times);\n }\n}"
},
{
"path": "NewLife.RocketMQ/Common/WeightRoundRobin.cs",
"content": "namespace NewLife.RocketMQ.Common;\n\n/// 带权重负载均衡算法\npublic class WeightRoundRobin : ILoadBalance\n{\n #region 属性\n /// 已就绪\n public Boolean Ready { get; set; }\n\n /// 权重集合\n public Int32[] Weights { get; private set; }\n\n /// 最小权重\n private Int32 minWeight;\n\n /// 状态值\n private Int32[] _states;\n\n /// 次数\n private Int32[] _times;\n #endregion\n\n #region 方法\n /// 设置每个选项的权重数据\n /// \n public void Set(Int32[] weights)\n {\n if (weights == null) throw new ArgumentNullException(nameof(weights));\n if (Weights != null && Weights.SequenceEqual(weights)) return;\n\n Weights = weights;\n\n minWeight = weights.Min();\n\n _states = new Int32[weights.Length];\n _times = new Int32[weights.Length];\n\n Ready = true;\n }\n\n /// 根据权重选择，并返回该项是第几次选中\n /// 第几次选中\n /// \n public Int32 Get(out Int32 times)\n {\n times = 1;\n var ts = _states;\n if (ts == null) return 0;\n\n // 选择状态最大值\n var cur = GetMax(ts, out var idx);\n\n // 如果所有状态都不达标，则集体加盐\n if (cur < minWeight)\n {\n for (var i = 0; i < Weights.Length; i++)\n {\n ts[i] += Weights[i];\n }\n\n // 重新选择状态最大值\n cur = GetMax(ts, out idx);\n }\n\n // 已选择，减状态\n ts[idx] -= minWeight;\n\n times = ++_times[idx];\n\n return idx;\n }\n\n /// 根据权重选择\n /// \n public Int32 Get() => Get(out var n);\n\n private Int32 GetMax(Int32[] ds, out Int32 idx)\n {\n var n = Int32.MinValue;\n idx = 0;\n for (var i = 0; i < ds.Length; i++)\n {\n if (ds[i] > n)\n {\n n = ds[i];\n idx = i;\n }\n }\n\n return n;\n }\n #endregion\n}"
},
{
"path": "NewLife.RocketMQ/Consumer.cs",
"content": "using System.Reflection;\nusing System.Text;\nusing System.Xml.Serialization;\nusing NewLife.Data;\nusing NewLife.Log;\nusing NewLife.Reflection;\nusing NewLife.RocketMQ.Client;\nusing NewLife.RocketMQ.Models;\nusing NewLife.RocketMQ.Protocol;\nusing NewLife.RocketMQ.Protocol.ConsumerStates;\nusing NewLife.Serialization;\nusing NewLife.Threading;\n\nusing NewLife.RocketMQ.MessageTrace;\n\nnamespace NewLife.RocketMQ;\n\n/// 消费者\npublic class Consumer : MqBase\n{\n #region 属性\n /// 数据\n public IList Data { get; set; }\n\n /// 标签集合\n public String[] Tags { get; set; }\n\n /// 多主题订阅列表。设置后一个Consumer可同时消费多个Topic，每个Topic使用相同的Tags和ExpressionType\n /// \n /// 设置 Topics 后，原 Topic 属性作为默认主题，Topics 中的所有主题都会被订阅。\n /// 如果 Topics 未设置，则保持原有单 Topic 行为不变。\n /// \n public String[] Topics { get; set; }\n\n /// 消费挂起超时。每次拉取消息，服务端如果没有消息时的挂起时间，默认15_000ms\n public Int32 SuspendTimeout { get; set; } = 15_000;\n\n /// 客户端拉取消息超时。默认0表示自动使用SuspendTimeout加10_000ms，防止服务端超时后无响应导致消费线程永久阻塞\n public Int32 PullTimeout { get; set; } = 0;\n\n /// 拉取的批大小。默认32\n public Int32 BatchSize { get; set; } = 32;\n\n /// 启动时间\n private DateTime StartTime { get; set; } = DateTime.Now;\n\n /// 首次消费时的消费策略，默认值false，表示从头开始收，等同于Java版的COMSUME_FROM_FIRST_OFFSET\n public Boolean FromLastOffset { get; set; } = false;\n\n /// \n /// 订阅表达式 TAG\n /// \n public String Subscription { get; set; } = \"*\";\n\n /// 表达式类型。TAG或SQL92，默认TAG。使用SQL92时Subscription填写SQL表达式\n public String ExpressionType { get; set; } = \"TAG\";\n\n /// 启动消费者时自动开始调度。默认true\n public Boolean AutoSchedule { get; set; } = true;\n\n /// 消息模型。广播/集群\n public MessageModels MessageModel { get; set; } = MessageModels.Clustering;\n\n /// 消费类型。CONSUME_PASSIVELY/CONSUME_ACTIVELY\n public String ConsumeType { get; set; } = \"CONSUME_PASSIVELY\";\n\n /// 最大重试次数。默认16次，超过后进入死信队列\n public Int32 MaxReconsumeTimes { get; set; } = 16;\n\n /// 是否启用消费重试。默认true，消费失败时自动将消息发回Broker的RETRY Topic\n public Boolean EnableRetry { get; set; } = true;\n\n /// 重试延迟等级。默认0表示由Broker根据重试次数决定延迟，大于0时使用指定等级\n public Int32 RetryDelayLevel { get; set; }\n\n /// 是否顺序消费。启用后消费前自动锁定队列，确保同一时刻只有一个消费者\n public Boolean OrderConsume { get; set; }\n\n /// 最大并发消费数。0表示不限制，每个队列一个消费线程。大于0时使用信号量控制所有队列的总并发\n public Int32 MaxConcurrentConsume { get; set; }\n\n /// 消费委托\n public Func OnConsume;\n\n /// 异步消费委托\n public Func> OnConsumeAsync;\n\n /// 消费事件\n public event EventHandler Consumed;\n\n private readonly IList _consumeMessageHooks = new List();\n private AsyncTraceDispatcher _traceDispatcher;\n\n /// 本地偏移存储路径。广播模式时使用，默认当前目录下的 .offsets/{Group}.json\n public String OffsetStorePath { get; set; }\n\n private SemaphoreSlim _concurrentSemaphore;\n\n /// 获取所有有效的订阅主题\n private String[] GetEffectiveTopics()\n {\n var topics = Topics;\n if (topics != null && topics.Length > 0) return topics;\n return [Topic];\n }\n #endregion\n\n #region 构造\n\n /// 销毁\n /// \n protected override void Dispose(Boolean disposing)\n {\n // 停止并保存偏移\n Stop();\n\n base.Dispose(disposing);\n\n _source.TryDispose();\n _source = null;\n\n _timer.TryDispose();\n _timer = null;\n }\n\n #endregion\n\n #region 方法\n\n /// 启动\n /// \n protected override void OnStart()\n {\n var allTopics = GetEffectiveTopics();\n WriteLog(\"正在准备消费 {0}\", allTopics.Join(\",\"));\n\n if (EnableMessageTrace)\n {\n _traceDispatcher = new AsyncTraceDispatcher();\n _traceDispatcher.Start(NameServerAddress);\n _consumeMessageHooks.Add(new MessageTraceHook(_traceDispatcher));\n }\n\n var list = Data;\n if (list == null)\n {\n // 为每个Topic建立订阅数据\n var sds = allTopics.Select(t => new SubscriptionData\n {\n Topic = t,\n TagsSet = Tags\n }).ToArray();\n\n var cd = new ConsumerData\n {\n GroupName = Group,\n ConsumeFromWhere = FromLastOffset ? \"CONSUME_FROM_LAST_OFFSET\" : \"CONSUME_FROM_FIRST_OFFSET\",\n MessageModel = MessageModel.ToString().ToUpper(),\n SubscriptionDataSet = sds,\n ConsumeType = ConsumeType,\n };\n\n list = new[] { cd };\n\n Data = list;\n }\n\n base.OnStart();\n\n // 多Topic时，通知NameClient轮询额外主题的路由\n if (allTopics.Length > 1 && _NameServer != null)\n {\n var extras = allTopics.Where(t => t != Topic).ToArray();\n _NameServer.ExtraTopics = extras;\n\n // 首次获取额外主题的路由\n foreach (var topic in extras)\n {\n try\n {\n _NameServer.GetRouteInfo(topic);\n }\n catch (Exception ex)\n {\n WriteLog(\"获取主题[{0}]路由失败：{1}\", topic, ex.Message);\n }\n }\n }\n\n // 默认自动开始调度\n if (AutoSchedule) StartSchedule();\n }\n\n /// \n /// 停止\n /// \n protected override void OnStop()\n {\n // 停止并保存偏移\n StopSchedule();\n PersistAll(_Queues).Wait();\n\n base.OnStop();\n }\n\n /// 创建Broker客户端，已重载，设置更大的超时时间\n /// \n /// \n /// \n protected override BrokerClient CreateBroker(String name, String[] addrs)\n {\n var client = base.CreateBroker(name, addrs);\n if (client.Timeout < SuspendTimeout) client.Timeout = SuspendTimeout;\n\n return client;\n }\n #endregion\n\n #region 拉取消息\n\n /// 从指定队列拉取消息\n /// \n /// \n /// \n /// \n /// 取消通知\n /// \n public async Task Pull(MessageQueue mq, Int64 offset, Int32 maxNums, Int32 msTimeout = -1, CancellationToken cancellationToken = default)\n {\n var header = new PullMessageRequestHeader\n {\n ConsumerGroup = Group,\n Topic = mq.Topic ?? Topic,\n Subscription = Subscription,\n ExpressionType = ExpressionType,\n QueueId = mq.QueueId,\n QueueOffset = offset,\n MaxMsgNums = maxNums,\n SysFlag = 6,\n SubVersion = StartTime.ToLong(),\n };\n if (msTimeout >= 0) header.SuspendTimeoutMillis = msTimeout;\n\n var st = _Queues.FirstOrDefault(e => e.Queue == mq);\n if (st != null) header.CommitOffset = st.CommitOffset;\n\n var dic = header.GetProperties();\n var bk = GetBroker(mq.BrokerName);\n\n var rs = await bk.InvokeAsync(RequestCode.PULL_MESSAGE, null, dic, true, cancellationToken).ConfigureAwait(false);\n if (rs?.Header == null) return null;\n\n var pr = new PullResult();\n\n if (rs.Header.Code == 0)\n pr.Status = PullStatus.Found;\n else if (rs.Header.Code == (Int32)ResponseCode.PULL_NOT_FOUND)\n pr.Status = PullStatus.NoNewMessage;\n else if (rs.Header.Code == (Int32)ResponseCode.PULL_OFFSET_MOVED || rs.Header.Code == (Int32)ResponseCode.PULL_RETRY_IMMEDIATELY)\n pr.Status = PullStatus.OffsetIllegal;\n else\n {\n pr.Status = PullStatus.Unknown;\n Log.Warn(\"[{0}]{1} 序列编号：{2} 序列偏移量：{3}\", (ResponseCode)rs.Header.Code, rs.Header.Remark, mq.QueueId, offset);\n }\n\n pr.Read(rs.Header?.ExtFields);\n\n // 读取内容\n var pk = rs.Payload;\n if (pk != null) pr.Messages = MessageExt.ReadAll(pk).ToArray();\n\n return pr;\n }\n\n #endregion\n\n #region 业务方法\n\n /// 查询指定队列的偏移量\n /// \n /// 取消通知\n /// \n public async Task QueryOffset(MessageQueue mq, CancellationToken cancellationToken = default)\n {\n var bk = GetBroker(mq.BrokerName);\n var rs = await bk.InvokeAsync(RequestCode.QUERY_CONSUMER_OFFSET, null, new\n {\n consumerGroup = Group,\n topic = mq.Topic ?? Topic,\n queueId = mq.QueueId,\n }, true, cancellationToken).ConfigureAwait(false);\n\n var dic = rs.Header?.ExtFields;\n if (dic == null) return -1;\n\n return dic.TryGetValue(\"offset\", out var str) ? str.ToLong() : -1;\n }\n\n /// \n /// 查询“队列”最大偏移量，不是消费提交的最后偏移量\n /// \n /// \n /// 取消通知\n /// \n public async Task QueryMaxOffset(MessageQueue mq, CancellationToken cancellationToken = default)\n {\n var bk = GetBroker(mq.BrokerName);\n var rs = await bk.InvokeAsync(RequestCode.GET_MAX_OFFSET, null, new\n {\n consumerGroup = Group,\n topic = mq.Topic ?? Topic,\n queueId = mq.QueueId,\n }, true, cancellationToken).ConfigureAwait(false);\n\n var dic = rs.Header?.ExtFields;\n if (dic == null) return -1;\n\n return dic.TryGetValue(\"offset\", out var str) ? str.ToLong() : -1;\n }\n\n /// \n /// 获取最小偏移量\n /// \n /// \n /// 取消通知\n /// \n public async Task QueryMinOffset(MessageQueue mq, CancellationToken cancellationToken = default)\n {\n var bk = GetBroker(mq.BrokerName);\n var rs = await bk.InvokeAsync(RequestCode.GET_MIN_OFFSET, null, new\n {\n consumerGroup = Group,\n topic = mq.Topic ?? Topic,\n queueId = mq.QueueId,\n }, true, cancellationToken).ConfigureAwait(false);\n\n var dic = rs.Header?.ExtFields;\n if (dic == null) return -1;\n\n return dic.TryGetValue(\"offset\", out var str) ? str.ToLong() : -1;\n }\n\n /// 根据时间戳查询偏移\n /// 队列\n /// 时间戳（毫秒）\n /// 取消通知\n /// \n public async Task SearchOffset(MessageQueue mq, Int64 timestamp, CancellationToken cancellationToken = default)\n {\n var bk = GetBroker(mq.BrokerName);\n var rs = await bk.InvokeAsync(RequestCode.SEARCH_OFFSET_BY_TIMESTAMP, null, new\n {\n topic = mq.Topic ?? Topic,\n queueId = mq.QueueId,\n timestamp,\n }, true, cancellationToken).ConfigureAwait(false);\n\n var dic = rs.Header?.ExtFields;\n if (dic == null) return -1;\n\n return dic.TryGetValue(\"offset\", out var str) ? str.ToLong() : -1;\n }\n\n /// 更新队列的偏移\n /// \n /// \n /// 取消通知\n /// \n public async Task UpdateOffset(MessageQueue mq, Int64 commitOffset, CancellationToken cancellationToken = default)\n {\n var bk = GetBroker(mq.BrokerName);\n var rs = await bk.InvokeAsync(RequestCode.UPDATE_CONSUMER_OFFSET, null, new\n {\n commitOffset,\n consumerGroup = Group,\n queueId = mq.QueueId,\n topic = mq.Topic ?? Topic,\n }, false, cancellationToken).ConfigureAwait(false);\n\n //var dic = rs?.Header?.ExtFields;\n //if (dic == null) return false;\n\n return true;\n }\n\n /// 获取消费者下所有消费者\n /// \n public async Task> GetConsumers(String group = null)\n {\n if (group.IsNullOrEmpty()) group = Group;\n\n var header = new { consumerGroup = group, };\n\n var cs = new HashSet();\n\n // 在所有Broker上查询\n foreach (var item in Brokers)\n {\n using var span = Tracer?.NewSpan($\"mq:{Name}:GetConsumers\", item.Name);\n try\n {\n var bk = GetBroker(item.Name);\n //bk.Ping();\n var rs = await bk.InvokeAsync(RequestCode.GET_CONSUMER_LIST_BY_GROUP, null, header).ConfigureAwait(false);\n span?.AppendTag(rs.Payload?.ToStr());\n //WriteLog(rs.Header.ExtFields?.ToJson());\n var js = rs.ReadBodyAsJson();\n if (js != null && js[\"consumerIdList\"] is IList