Acme .NET 工具类库：一站式解决.NET开发高频场景问题

dotnet add package Acme

using Acme;

var builder = WebApplication.CreateBuilder(args);

// 注册Acme核心服务
builder.Services.AddAcmeBuilderServer();

var app = builder.Build();

using Acme.Tools;

publicclassHomeController : Controller
{
    public IActionResult Index()
    {
        // JSON序列化
        var user = new { Name = "张三", Age = 25 };
        string json = user.ToJson();
        
        // 安全类型转换
        int number = "123".ToInt();
        
        // MD5加密
        string hashedPassword = MD5Encryption.Encrypt("password123");
        
        return View();
    }
}

// 对象转JSON
var user = new { Name = "张三", Age = 25 };
string json = user.ToJson();

// JSON转实体
string jsonStr = "{\"Name\":\"李四\",\"Age\":30}";
User user = jsonStr.ToEntity<User>();

// 动态类型解析
dynamic dynamicUser = jsonStr.ToEntity<dynamic>();
Console.WriteLine(dynamicUser.Name); // 输出：李四

// 安全类型转换（带默认值）
int safeNum = "abc".ToInt(0); // 转换失败返回默认值0
double price = "99.9".ToDouble();
bool isTrue = "true".ToBool();

// 路径处理
string webPath = @"C:\files\image.jpg".ToUrlPath(); // 输出：/files/image.jpg

// 时间戳处理
long timestamp = ConvHelper.GetTimeStamp(); // 13位时间戳
DateTime date = ConvHelper.GetDateTimeFromTimestamp(timestamp);

// 随机码生成
string verifyCode = "0-9".ToRandomCode(6); // 6位数字验证码

// GET请求
string response = HttpHelper.HttpClientGet("https://api.example.com/users?id=1");

// POST请求（自动序列化JSON）
var postData = new { UserId = 1, Name = "新名称" };
string postResp = HttpHelper.HttpClientPost("https://api.example.com/update", postData);

// 带请求头的请求
var headers = new Dictionary<string, string>
{
    { "Authorization", "Bearer your-token" },
    { "Content-Type", "application/json" }
};
string authResp = HttpHelper.HttpClientGet("https://api.example.com/protected", headers);

// 基础加密
string password = "123456";
string md5Lower = MD5Encryption.Encrypt(password); // 小写
string md5Upper = MD5Encryption.Encrypt(password, true); // 大写

// 密码验证
bool isValid = MD5Encryption.Compare(inputPwd, storedHash);

// Session操作
publicclassAccountController : Controller
{
    privatereadonly IHttpSessionService _sessionService;
    
    public AccountController(IHttpSessionService sessionService)
    {
        _sessionService = sessionService;
    }
    
    public IActionResult Login(string username)
    {
        // 存储字符串
        _sessionService.SetSession("CurrentUser", username);
        
        // 存储对象
        var userInfo = new { Name = username, Role = "Admin" };
        _sessionService.SetObjectAsJson("UserInfo", userInfo);
        
        return RedirectToAction("Index");
    }
}

// Cookie操作
_cookieService.SetCookies("AuthToken", "abc123", 60); // 60分钟过期
string token = _cookieService.GetCookies("AuthToken");
_cookieService.DeleteCookies("AuthToken");

// 中文转拼音首字母
string initials = Pinyin.GetInitials("中文拼音处理"); // 输出：ZWPYCL

// 搜索场景示例
public List<User> SearchUsers(string keyword)
{
    string pinyinKey = Pinyin.GetInitials(keyword).ToLower();
    return _userRepo.SearchByPinyinKey(pinyinKey);
}

// 定义数据模型
publicclassProduct
{
    publicstring Name { get; set; }
    publicdecimal Price { get; set; }
    publicint Stock { get; set; }
}

// 导出Excel
public void ExportProducts(List<Product> products)
{
    var excelService = new NpolExcelService<Product>();
    // 自定义表头映射
    var headers = new Dictionary<string, string>
    {
        { "Name", "产品名称" },
        { "Price", "价格" },
        { "Stock", "库存" }
    };
    excelService.ExportToExcel(products, "products.xlsx", "产品列表", headers);
}

// 导入Excel
public List<Product> ImportProducts(string filePath)
{
    var excelService = new NpolExcelService<Product>();
    return excelService.ImportFromExcel(filePath);
}

// Scoped：每个请求一个实例（用户服务、业务服务）
builder.Services.AddScoped<IUserService, UserService>();

// Transient：每次注入新实例（工具类、临时服务）
builder.Services.AddTransient<IExcelService, ExcelService>();

// Singleton：全局单例（缓存服务、配置服务）
builder.Services.AddSingleton<ICacheService, CacheService>();

// 安全数据处理封装
publicclassSafeDataProcessor
{
    publicint? SafeConvertToInt(string input)
    {
        try { return input.ToInt(); }
        catch { returnnull; }
    }
    
    public T SafeJsonDeserialize<T>(string json) where T : new()
    {
        try { return json.ToEntity<T>(); }
        catch { returnnew T(); }
    }
}

// 全局异常处理
app.UseExceptionHandler(options =>
{
    options.Run(async context =>
    {
        var exception = context.Features.Get<IExceptionHandlerFeature>();
        if (exception != null)
        {
            // 记录日志
            Console.WriteLine($"全局异常：{exception.Error.Message}");
            
            // 返回友好响应
            context.Response.StatusCode = 500;
            await context.Response.WriteAsJsonAsync(new
            {
                success = false,
                message = "服务器处理失败，请稍后重试"
            });
        }
    });
});

public classCachedUserService : IUserService
{
    privatereadonly IUserService _userService;
    privatereadonly ICacheService _cacheService;
    
    public async Task<User> GetUserById(int id)
    {
        string cacheKey = $"User:{id}";
        
        // 优先从缓存获取
        var cachedUser = _cacheService.Get<User>(cacheKey);
        if (cachedUser != null) return cachedUser;
        
        // 缓存未命中，从数据库获取
        var user = await _userService.GetUserById(id);
        
        // 存入缓存（10分钟过期）
        _cacheService.Set(cacheKey, user, TimeSpan.FromMinutes(10));
        
        return user;
    }
}

// 控制器异步示例
[HttpGet("{id}")]
public async Task<IActionResult> GetUser(int id)
{
    try
    {
        var user = await _userService.GetUserById(id);
        return Ok(user);
    }
    catch (Exception ex)
    {
        return BadRequest(new { message = ex.Message });
    }
}

public string HashPassword(string password)
{
    // 生成8位盐值
    string salt = Guid.NewGuid().ToString().Substring(0, 8);
    // 密码+盐值加密
    return MD5Encryption.Encrypt(password + salt) + ":" + salt;
}

// 密码验证
public bool VerifyPassword(string inputPwd, string storedHash)
{
    var parts = storedHash.Split(':');
    if (parts.Length != 2) returnfalse;
    
    string hash = parts[0];
    string salt = parts[1];
    
    return MD5Encryption.Encrypt(inputPwd + salt) == hash;
}

// 常用验证正则
publicstaticclassValidationPatterns
{
    publicconststring Email = @"^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$";
    publicconststring Phone = @"^1[3-9]\d{9}$";
    publicconststring IdCard = @"^[1-9]\d{5}(18|19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$";
}

// 验证逻辑
public bool ValidateUser(User user)
{
    if (user.Id.IsDefault()) returnfalse;
    if (!user.Email.RegexVerification(ValidationPatterns.Email)) returnfalse;
    if (!user.Phone.RegexVerification(ValidationPatterns.Phone)) returnfalse;
    
    returntrue;
}