Smart.Helper 3.5.5

Smart.Helper

English | 中文

<a name="english"></a>

English

Smart.Helper is a .NET utility library for byte buffers, conversions, checksums, compression, network helpers, caching, logging, assembly loading, and async synchronization. It supports .NET 8, 9, and 10.

Features

• SmartByteBuffer: dynamic byte buffer with endian support.
• SmartConvert: base conversion, hex conversion, string reversal, JWT payload decoding, and struct/byte conversions.
• SmartCompress: ZLib, GZip, and Deflate compression helpers.
• SmartNetwork: IP, MAC, ping, gateway, and TCP port helpers.
• SmartLog: simple file logger with optional background writing.
• SmartAutoResetEvent: async auto-reset event with timeout and cancellation support.
• SmartCache, BusLock, BusLockManager, SmartAssemblyLoader, CRC16, and CRC32 helpers.

Installation

dotnet add package Smart.Helper

Examples

using Smart.Helper;

var buffer = new SmartByteBuffer(isLittleEndian: true);
buffer.SetInt32(1024);
buffer.SetString("Hello");

buffer.Position = 0;
int value = buffer.GetInt32();
string text = buffer.GetString(5);
byte[] data = buffer.ToArray();

byte[] bytes = SmartConvert.HexStringToByteArray("AA BB CC", " ");
string hex = SmartConvert.ByteArrayToHexString(bytes, " ");
string binary = SmartConvert.ConvertBase("FF", 16, 2);

byte[] raw = Encoding.UTF8.GetBytes("Some data to compress");
byte[] compressed = SmartCompress.GZipCompress(raw);
byte[] decompressed = SmartCompress.GZipDecompress(compressed);

var ips = SmartNetwork.GetAllValidIPAddresses(IPTypeFlags.IPv4);
bool pingOk = await SmartNetwork.PingAsync("www.google.com");
bool portOpen = await SmartNetwork.IsTcpPortOpenAsync("127.0.0.1", 80);

using var logger = new SmartLog("MyService");
logger.StartThread();
logger.Info("Service started successfully.");
logger.Error("An error occurred.");
logger.StopThread();

using var evt = new SmartAutoResetEvent();

try
{
    await evt.WaitAsync(TimeSpan.FromSeconds(5));
}
catch (TimeoutException)
{
    Console.WriteLine("Wait timed out.");
}

evt.Set();

<a name="chinese"></a>

中文

Smart.Helper 是一个 .NET 工具库，提供字节缓冲、数据转换、校验、压缩、网络工具、缓存、日志、程序集加载和异步同步原语等能力，兼容 .NET 8/9/10。

功能特性

• SmartByteBuffer：支持大小端的动态字节缓冲区。
• SmartConvert：进制转换、Hex 转换、字符串反转、JWT 内容解码、结构体与字节数组互转。
• SmartCompress：ZLib、GZip、Deflate 压缩与解压。
• SmartNetwork：IP、MAC、Ping、默认网关和 TCP 端口检测。
• SmartLog：简单文件日志，支持后台写入。
• SmartAutoResetEvent：支持超时和取消令牌的异步自动重置事件。
• SmartCache、BusLock、BusLockManager、SmartAssemblyLoader、CRC16、CRC32 等辅助工具。

安装

dotnet add package Smart.Helper

示例

using Smart.Helper;

var buffer = new SmartByteBuffer(isLittleEndian: true);
buffer.SetInt32(1024);
buffer.SetString("Hello");

buffer.Position = 0;
int value = buffer.GetInt32();
string text = buffer.GetString(5);
byte[] data = buffer.ToArray();

byte[] bytes = SmartConvert.HexStringToByteArray("AA BB CC", " ");
string hex = SmartConvert.ByteArrayToHexString(bytes, " ");
string binary = SmartConvert.ConvertBase("FF", 16, 2);

byte[] raw = Encoding.UTF8.GetBytes("Some data to compress");
byte[] compressed = SmartCompress.GZipCompress(raw);
byte[] decompressed = SmartCompress.GZipDecompress(compressed);

var ips = SmartNetwork.GetAllValidIPAddresses(IPTypeFlags.IPv4);
bool pingOk = await SmartNetwork.PingAsync("www.baidu.com");
bool portOpen = await SmartNetwork.IsTcpPortOpenAsync("127.0.0.1", 80);

using var logger = new SmartLog("MyService");
logger.StartThread();
logger.Info("服务启动成功。");
logger.Error("发生了一个错误。");
logger.StopThread();

using var evt = new SmartAutoResetEvent();

try
{
    await evt.WaitAsync(TimeSpan.FromSeconds(5));
}
catch (TimeoutException)
{
    Console.WriteLine("等待超时。");
}

evt.Set();

Developed by zenglei