WCTDataMiner/docs/architecture/parser/FileNameParser.md

文件名解析器

所属模块：解析器设计

---

1. 文件名格式

格式约定：TX面板-TX硬件-TX软件-RX类型-测试目的-年月日-测试次数.log

分隔符：支持 -（短横线）和 _（下划线）两种分隔符，文件名解析时将同时拆分这两种字符。

⚠️ 注意：字段值内部不应包含分隔符字符。例如，若 TX面板值为 single-mold，解析时会拆分为 single 和 mold 两个字段，导致解析失败。请确保字段值本身不含 - 或 _。

示例：

• 标准：singleMold-v1.0-hex2_1-iPhone15-compatibility-20260702-1.log（字段值无分隔符）
• 避免：single-mold-v1.0-hex2.1-iPhone15-兼容性测试-20260702-1.log（single-mold 会拆分）

位置说明：表格中的"位置"采用 1-based 索引（从 1 开始计数），与代码中的 0-based 数组索引对应。

---

2. 字段映射

位置	字段	对应维度表	示例值
1	TxPanel	tx_panel.name	single-mold
2	TxHardware	tx_hardware.version	v1.0
3	TxSoftware	tx_software.version	hex2.1
4	RxType	rx_type.name	iPhone15
5	TestPurpose	test_scenario.test_purpose	兼容性测试
6	TestDate	test_scenario.test_date	20260702
7	TestSequence	test_scenario.test_sequence	1

---

3. 解析器实现

// Parsers/FileNameParser.cs
using System.Globalization;
using WCTDataMiner.Services;

namespace WCTDataMiner.Parsers;

public class FileNameParser
{
    private static readonly char[] Separators = { '-', '_' };

    /// <summary>
    /// 解析日志文件名，提取场景信息
    /// </summary>
    /// <param name="fileName">文件名（不含路径）</param>
    /// <returns>场景信息，若格式不匹配返回 null</returns>
    public ScenarioInfo? Parse(string fileName)
    {
        // 移除 .log 扩展名
        var nameWithoutExt = Path.GetFileNameWithoutExtension(fileName);
        if (string.IsNullOrEmpty(nameWithoutExt))
            return null;

        var parts = nameWithoutExt.Split(Separators);
        if (parts.Length < 7)
            return null;

        // 解析日期
        if (!TryParseDate(parts[5], out var testDate))
            return null;

        // 解析测试序号
        if (!int.TryParse(parts[6], out var testSequence))
            testSequence = 1;

        return new ScenarioInfo(
            TxPanel: parts[0],
            TxHardware: parts[1],
            TxSoftware: parts[2],
            RxType: parts[3],
            TestPurpose: parts.Length > 4 ? parts[4] : null,
            TestDate: testDate,
            TestSequence: testSequence
        );
    }

    private static bool TryParseDate(string dateStr, out DateOnly date)
    {
        // 支持多种日期格式
        var formats = new[] { "yyyyMMdd", "yyyy-MM-dd", "yyMMdd" };
        return DateOnly.TryParseExact(dateStr, formats, CultureInfo.InvariantCulture, DateTimeStyles.None, out date);
    }
}

---

4. 容错处理

场景	处理方式
文件名为空或 null	返回 null，ParseService 记录错误日志
文件名仅含扩展名（如 .log）	返回 null
文件名少于 7 个字段	返回 null，缺少必要字段
日期格式不匹配	返回 null，无法解析 test_date
测试序号解析失败	使用默认值 1
文件名扩展名无效（非 .log）	仍会解析，仅去除扩展名后尝试

说明：由于解析器要求 parts.Length >= 7 才会成功返回，"测试目的缺失"不会单独发生——当字段不足时整体解析失败。若需支持可选字段，需调整解析逻辑。

---

5. 使用示例

// 在 ParseService 中使用
var fileNameParser = new FileNameParser();
var scenarioInfo = fileNameParser.Parse("single-mold-v1.0-hex2.1-iPhone15-兼容性测试-20260702-1.log");

if (scenarioInfo != null)
{
    var scenario = await scenarioService.GetOrCreateScenarioAsync(scenarioInfo);
    // 继续解析文件内容...
}