XYS.Utils.Sys 2.3.3

XYS.Utils.Sys

系统级通用工具类库：HTTP/JSON 调用、文件、类型转换、反射、XML、邮件、CSV 导出、数据库映射辅助与配置读取等。

目标框架

net8.0 · net462 · netcoreapp3.1 · netstandard2.0 · netstandard2.1

依赖

• Newtonsoft.Json 13.0.4
• Microsoft.CSharp 4.7.0
• XYS（同解决方案内项目引用）

HttpJsonUtil

基于 HttpClient 的 JSON 请求工具，提供 POST / GET 并自动反序列化响应，支持 HTTPS。

using XYS.Utils.Sys;

// POST：对象自动序列化为 JSON，反序列化为指定类型
var res = HttpJsonUtil.Post<ResultDto>("https://api.example.com/order", new { id = 1 }, timeout: 5000);

// GET
var dto = HttpJsonUtil.Get<ResultDto>("https://api.example.com/order/1");

// 带 Cookie / 自定义 UserAgent
var res2 = HttpJsonUtil.Post("https://api.example.com/x", req, timeout: 3000, userAgent: "MyApp", cookies: myCookies);

• HTTPS：静态构造时自动启用 TLS 1.2/1.1（兼容 net462 等旧框架访问现代 HTTPS 服务；.NET Core/5+ 由系统协商，无副作用）。
• 证书校验：HttpJsonUtil.AllowUntrustedCertificate 默认 true，放行自签名/内网证书；生产环境建议置为 false 以启用标准 TLS 校验，防止中间人攻击。
• timeout 单位毫秒。无 Cookie 时复用静态 HttpClient；带 Cookie 时创建独立实例并自动释放。

需要按 baseUrl 复用客户端、请求级超时隔离与 Token 注入的高并发场景，参见 XYS.Utils.Web 中的 HttpRestUtil。

NovaWebClient

基于 HttpClient 的下载客户端（IDisposable），支持"无数据接收即超时取消"的文件下载。

using XYS.Utils.Sys;

using (var client = new NovaWebClient { Timeout = 5000 }) // 毫秒
{
    byte[] data = client.DownloadData("https://.../file.bin");
    string text = client.DownloadString("https://.../data.json");

    client.TimeOver += token => { /* 超时回调 */ };
    client.DownloadFileAsyncWithTimeout(new Uri("https://.../big.zip"), "big.zip", null);
}

• Timeout 单位为毫秒，作为每次读取的空闲超时；在超时时间内无任何数据到达则自动取消。
• 用完请 Dispose（或 using）以释放内部 HttpClient。

TypeExtension

常用类型扩展方法。

using XYS.Utils.Sys;

string json = anyObject.ToJson();                 // 序列化为 JSON
int? n = "123".ToInt();                            // 安全转 int?
DateTime? d = "2026-07-21".ToDateTime();           // 安全转 DateTime?
string xml = raw.ToXmlStr();                        // XML 特殊字符转义

ToJson / ToInt / ToFloat / ToDouble / ToDecimal / ToDateTime / ToSmallDateTime / ToXmlStr 等，均对 null/非法输入做安全处理。

FileUtil

文件与目录辅助：

• File2Bytes(fullFileName) — 读取文件为字节数组
• GetFullName(params paths) — 拼接路径
• MakeDir(filePath) — 创建目录
• IsFileExist / IsDictExist / DeleteFile / DeleteDict

ConvertUtil

安全类型转换：TryParse 的 int / long / short 重载，转换失败返回 false 且不抛异常。

ReflexUtil

反射辅助：AssemblyShortName / AssemblyFileName / GetTypeFromString（按类型名解析 Type）。

XmlUtil

XML 辅助：TypeConvert(input, type) 按目标类型转换字符串，DefaultForType(type) 返回类型默认值。

MailHelper

邮件发送：MailHelper.SendMail(MailRequest request)，MailRequest 支持正文、收件人及 MailRequestAttachments 附件。

ExportHelper

CSV 导出：ExportCVS(fileName, rows, csvSeparator = ',', coding = null)，rows 为 List<List<string>>。

SystemInfo

配置读取与系统辅助（配置文件 xys.config.json，读取后缓存）：

• GetAppSetting(key) / GetConfigValue(key) — 读取配置项
• GetConnString(name) / GetConnStruct(name) — 读取数据库连接串
• ReloadConfig() — 重新加载配置
• 另含 GUID、日期格式化、路径、类型判断等杂项工具。

DB（数据库映射辅助）

配合 DBColAttribute + 反射实现实体与数据行/存储过程参数的映射：

• DBUtil.Convert / DeConvert — 实体与数据源对象互转
• DBHelper — 存储过程入/出参装配、DB 值与类型解析
• DBParse — 安全取值（GetSafeInt / GetSafeDate / GetSafeDecimal / GetSafeStr 等）
• NConvert — 数值/日期/布尔转换，含金额转大写 ToCapital
• SqlUtil.GetWhere(paramDict, tableAlias) — 由字典拼接 WHERE 条件

版本

当前版本 2.3.3。