Healnet.Common 1.0.7

Healnet.Common

Healnet.Common 是 Healnet 框架的基础通用工具类库，提供核心的帮助方法和通用扩展。

功能特性

安装

Install-Package Healnet.Common

使用示例

CryptoHelper

// 密码哈希与验证
var hashedPassword = CryptoHelper.HashPassword("user123");
bool isValid = CryptoHelper.VerifyPassword("user123", hashedPassword);

// MD5/SHA 加密
var md5 = CryptoHelper.Md5Encrypt("test");
var sha256 = CryptoHelper.Sha256Encrypt("test");

// AES 加密解密
var encrypted = CryptoHelper.AesEncrypt("secret", "mykey123456789012345");
var decrypted = CryptoHelper.AesDecrypt(encrypted, "mykey123456789012345");

// RSA 密钥对生成与加解密
var (publicKey, privateKey) = CryptoHelper.GenerateRsaKeyPair();
var rsaEncrypted = CryptoHelper.RsaEncrypt("secret", publicKey);
var rsaDecrypted = CryptoHelper.RsaDecrypt(rsaEncrypted, privateKey);

JsonHelper

// 序列化对象
var user = new User { Name = "John", Age = 30 };
string json = JsonHelper.Serialize(user);
string formattedJson = JsonHelper.SerializeIndented(user);

// 反序列化 JSON
User? user = JsonHelper.Deserialize<User>(json);

// 深度克隆
var clonedUser = JsonHelper.Clone(user);

CollectionExtensions

// 空值检查
if (list.IsNullOrEmpty()) { /* 处理空集合 */ }
if (list.HasValue()) { /* 处理非空集合 */ }

// 安全获取元素
var first = list.FirstOrDefaultSafe();
var last = list.LastOrDefaultSafe();

// 分批处理
foreach (var batch in list.Batch(100))
{
    await ProcessBatch(batch);
}

// 去重
var distinctList = list.DistinctBy(item => item.Id);

ServiceAddressHelper

用于在不同环境（Kubernetes、Docker、开发环境）中自动获取服务地址：

// 获取服务地址（自动适配环境）
var address = ServiceAddressHelper.GetServiceAddress();
var addressWithDefault = ServiceAddressHelper.GetServiceAddress("127.0.0.1");

// 获取服务端口（从环境变量或默认值）
var port = ServiceAddressHelper.GetServicePort(8080);

// 判断运行环境
bool isK8s = ServiceAddressHelper.IsKubernetesEnvironment();
bool isDocker = ServiceAddressHelper.IsDockerEnvironment();
string env = ServiceAddressHelper.GetRunningEnvironment();

// 生成服务 ID（用于 Consul 注册）
var serviceId = ServiceAddressHelper.GetServiceId("my-service");
var serviceIdFromEnv = ServiceAddressHelper.GetServiceIdFromEnvironment("my-service");

// 获取健康检查 URL
var healthUrl = ServiceAddressHelper.GetHealthCheckUrl(8080);

NetworkHelper

// 获取本机 IP 地址
var localIp = NetworkHelper.GetLocalIpAddress();
var allIps = NetworkHelper.GetLocalIpAddresses();

// 获取 MAC 地址和主机名
var macAddress = NetworkHelper.GetMacAddress();
var hostName = NetworkHelper.GetHostName();

// 端口检查
bool portInUse = NetworkHelper.IsPortInUse(8080);
int availablePort = NetworkHelper.FindAvailablePort(10000, 20000);

EnvironmentHelper

// 环境变量操作
var dbConnection = EnvironmentHelper.GetEnvironmentVariable("DB_CONNECTION");
var apiUrl = EnvironmentHelper.GetEnvironmentVariable("API_URL", "http://localhost:5000");

// 环境判断
bool isDev = EnvironmentHelper.IsDevelopment();
bool isProd = EnvironmentHelper.IsProduction();

// 系统信息
var machineName = EnvironmentHelper.GetMachineName();
var osVersion = EnvironmentHelper.GetOsVersion();

SnowflakeHelper

// 初始化雪花ID生成器
var snowflake = SnowflakeHelper.Instance;

// 生成唯一ID
long id = snowflake.NextId();

// 获取ID的时间戳
DateTime timestamp = snowflake.GetTimestamp(id);

DateTimeHelper

// 获取当前时间戳（秒）
long timestamp = DateTimeHelper.GetTimestamp();

// 时间戳转DateTime
DateTime date = DateTimeHelper.FromTimestamp(1620000000);

// 格式化日期
string formatted = DateTimeHelper.Format(DateTime.Now, "yyyy-MM-dd HH:mm:ss");

// 时区转换
DateTime utcTime = DateTimeHelper.ConvertToUtc(DateTime.Now);
DateTime localTime = DateTimeHelper.ConvertToLocal(utcTime);

// 判断是否是工作日
bool isWorkDay = DateTimeHelper.IsWorkDay(DateTime.Now);

命名空间

using Healnet.Common.Helpers;
using Healnet.Common.Extensions;

依赖包

许可证

MIT License