通配符匹配算法迁移指南

🎯 迁移完成

通配符匹配算法已成功迁移到 Dpz.Core.Infrastructure.ApplicationTools 类中，现在作为公共API提供给整个项目使用。

📋 新的公共API

主要方法

/// <summary>
/// 高性能通配符匹配算法
/// 支持 * (匹配任意字符) 和 ? (匹配单个字符)
/// 默认忽略大小写，包含缓存机制以提高重复匹配的性能
/// </summary>
/// <param name="input">要匹配的输入字符串</param>
/// <param name="pattern">通配符模式</param>
/// <param name="ignoreCase">是否忽略大小写，默认为 true</param>
/// <returns>是否匹配成功</returns>
public static bool WildcardMatch(string input, string pattern, bool ignoreCase = true)

缓存管理方法

/// <summary>
/// 清空通配符匹配缓存
/// </summary>
public static void ClearWildcardCache()

/// <summary>
/// 获取当前通配符匹配缓存的大小
/// </summary>
public static int GetWildcardCacheSize()

🔧 使用示例

基础用法

// 基础匹配（默认忽略大小写）
bool result1 = ApplicationTools.WildcardMatch("/api/users/123", "/api/*"); // true
bool result2 = ApplicationTools.WildcardMatch("file.txt", "*.txt"); // true  
bool result3 = ApplicationTools.WildcardMatch("test", "t??t"); // true

// 大小写处理
bool result4 = ApplicationTools.WildcardMatch("ABC", "abc"); // true (默认忽略大小写)
bool result5 = ApplicationTools.WildcardMatch("ABC", "abc", false); // false (区分大小写)

Web 中间件中的使用

// 在中间件中使用
private static bool IsPatternMatched(string input, string pattern)
{
    return ApplicationTools.WildcardMatch(input, pattern, ignoreCase: true);
}

性能监控

// 检查缓存状态
Console.WriteLine($"当前缓存大小: {ApplicationTools.GetWildcardCacheSize()}");

// 在内存压力大时清理缓存
if (ApplicationTools.GetWildcardCacheSize() > 5000)
{
    ApplicationTools.ClearWildcardCache();
}

🚀 新增特性

1. 更灵活的大小写控制

• 默认忽略大小写（适合 Web 场景）
• 可选择区分大小写（适合文件系统场景）

2. 改进的缓存机制

• 基于输入和模式的智能缓存键
• 区分大小写和忽略大小写的独立缓存
• 公开的缓存管理API

3. 更好的边界情况处理

• 完善的空字符串处理
• 更准确的匹配逻辑
• 修复了之前发现的边界问题

📈 性能特性

缓存优化

// 缓存命中时的性能（微秒级）
var sw = Stopwatch.StartNew();
for (int i = 0; i < 10000; i++)
{
    ApplicationTools.WildcardMatch("/api/users/123", "/api/*");
}
sw.Stop();
// 预期: < 10ms for 10k operations

内存管理

• 自动缓存限制: 最大 10,000 个缓存项
• 智能清理: 缓存满时自动清理一半最旧的项
• 手动控制: 可通过API主动管理缓存

🔄 迁移步骤

1. 中间件更新

• ✅ 移除了重复的匹配算法代码
• ✅ 更新为使用 ApplicationTools.WildcardMatch
• ✅ 简化了 IsPatternMatched 方法

2. 测试覆盖

• ✅ 创建了 ApplicationToolsWildcardTest 完整测试套件
• ✅ 包含基础功能、边界情况、性能测试
• ✅ 验证了 Web 场景的常见用例

3. 向后兼容

• ✅ 保持了原有的匹配逻辑
• ✅ 修复了已知的边界问题
• ✅ 性能特性保持不变或更好

🎯 使用建议

Web 应用场景

// 路径匹配（推荐默认设置）
bool isApiPath = ApplicationTools.WildcardMatch(requestPath, "/api/*");

// URL 模式匹配
bool isStaticResource = ApplicationTools.WildcardMatch(requestPath, "/static/*");

文件系统场景

// 文件名匹配（可能需要区分大小写）
bool isConfigFile = ApplicationTools.WildcardMatch(fileName, "*.config", false);

// 跨平台兼容（建议忽略大小写）
bool isImageFile = ApplicationTools.WildcardMatch(fileName, "*.jpg");

性能敏感场景

// 在高频调用前预热缓存
var commonPatterns = new[] { "/api/*", "*.css", "*.js" };
foreach (var pattern in commonPatterns)
{
    ApplicationTools.WildcardMatch("warmup", pattern);
}

🛡️ 最佳实践

1. 使用默认参数: 大多数 Web 场景使用默认的忽略大小写
2. 监控缓存: 在高负载应用中定期检查缓存大小
3. 合理清理: 在模式变化频繁时主动清理缓存
4. 测试边界: 确保测试空字符串和特殊字符的情况

📊 性能对比

🎉 总结

通过这次迁移，我们实现了：

• ✅ 代码重用: 统一的通配符匹配实现
• ✅ 功能增强: 更灵活的大小写控制
• ✅ 性能优化: 改进的缓存机制
• ✅ 易于维护: 集中的实现和测试
• ✅ 向后兼容: 保持原有功能不变

现在整个项目都可以通过 ApplicationTools.WildcardMatch 享受高性能的通配符匹配功能！