# 文件名解析器

> 所属模块：[解析器设计](./概览.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. 解析器实现

```csharp
// 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. 使用示例

```csharp
// 在 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);
    // 继续解析文件内容...
}
```