HMENetCore.Extensions 10.0.9

HMENetCore.Extensions

简介

HMENetCore.Extensions 是一个功能丰富的 .NET Core 扩展库，集成了日志记录、路由配置、IP限流、配置管理等多种常用功能。该库旨在简化开发流程，提高开发效率，同时保持代码的整洁和可维护性。

功能特性

• NLog 日志集成：增强的 NLog 日志记录功能
• 全局异常处理：统一的异常处理中间件
• 模型验证：自定义模型验证响应格式
• 集中式路由：全局路由前缀配置
• IP 限流：防止过度请求的保护机制
• 自定义配置：JSON 配置文件管理
• 静态配置访问：全局访问应用配置

运行环境

• 跨平台支持: Supports .NET 8 and .NET 10.

安装

dotnet add package HMENetCore.Extensions

使用说明

1. NLog 日志集成

服务注册

// 使用默认配置
services.AddNLogSingleton();

// 或使用自定义配置
services.AddNLogSingleton(config => {
 // 自定义 NLog 配置
});

使用示例

public class MyService
{
 private readonly INLogHelper _logger;
 
 public MyService(INLogHelper logger)
 {
 _logger = logger;
 }
 
 public void DoWork()
 {
 try {
 // 业务逻辑
 _logger.Info(this, "工作正常完成");
 }
 catch (Exception ex) {
 _logger.Error(this, "工作发生错误", ex);
 }
 }
}

2. 全局异常处理

• 统一异常处理格式
• 支持开发环境详细错误信息
• 集成 NLog 记录异常

服务注册

services.AddControllers(options => {
 options.Filters.Add<GlobalExceptionsFilter>();
 });

3. 集中式路由

服务注册

 services.AddControllers(options => {
 options.UseCentralRoutePrefix(new RouteAttribute("api/v1"));
 });

4. IP 限流

appsettings.json 配置

 {
 "IpRateLimiting": {
 "EnableEndpointRateLimiting": true,
 "StackBlockedRequests": false,
 "RealIpHeader": "X-Real-IP",
 "ClientIdHeader": "X-ClientId",
 "HttpStatusCode": 429,
 "GeneralRules": [
 {
 "Endpoint": "*",
 "Period": "1s",
 "Limit": 5
 }
 ]
 }
}

服务注册

services.AddIpPolicyRateLimit(Configuration.GetSection("IpRateLimiting"));
app.UseIpLimit();

5. 自定义配置管理

加载自定义 JSON 配置

builder.Configuration.AddJsonFileBuilder(AppDomain.CurrentDomain.BaseDirectory + "Config");
// 在应用启动时配置
AppSettingsHelper.AppSettingsConfigure(Configuration);

使用静态配置访问

// 任何地方访问配置
var setting = AppSettingsHelper.GetValue("ConnectionStrings:Default");