installerbuilder/tasks/task06-YAML配置解析器.md

任务06：YAML配置解析器

任务描述

实现YAML格式的配置文件解析器，负责读取、解析和验证YAML格式的配置文件，将其转换为配置模型对象。YAML配置解析器将支持完整的YAML语法，包括锚点、引用和多文档等特性。

实现步骤

1. 定义配置解析器接口：

   • 在internal/config/parser包中创建parser.go文件
   • 定义ConfigParser接口：

     type ConfigParser interface {
         // Parse 从指定路径解析配置文件
         Parse(path string) (*model.Config, error)
     
         // ParseBytes 从字节数组解析配置
         ParseBytes(data []byte) (*model.Config, error)
     
         // Validate 验证配置是否有效
         Validate(config *model.Config) error
     }
     

2. 实现YAML配置解析器：

   • 创建yaml_parser.go文件
   • 定义YAMLConfigParser结构体，实现ConfigParser接口：

     type YAMLConfigParser struct {
         schema      *jsonschema.Schema // JSON Schema用于验证
         validator   ConfigValidator
         logger      log.Logger
         resourceMgr resource.ResourceManager
     }
     

   • 实现构造函数：

     func NewYAMLConfigParser(validator ConfigValidator, logger log.Logger, resourceMgr resource.ResourceManager) *YAMLConfigParser {
         return &YAMLConfigParser{
             validator:   validator,
             logger:      logger,
             resourceMgr: resourceMgr,
         }
     }
     

3. 实现文件读取功能：

   • 使用ResourceManager读取配置文件
   • 处理文件不存在或权限问题
   • 支持相对路径和绝对路径

4. 实现YAML解析功能：

   • 使用gopkg.in/yaml.v3库解析YAML内容
   • 处理解析错误，提供友好的错误信息
   • 支持YAML的高级特性（锚点、引用等）

5. 实现配置验证：

   • 调用验证器验证解析后的配置
   • 收集并报告所有验证错误
   • 提供详细的错误位置和原因

6. 实现环境变量替换：

   • 支持在配置中使用环境变量
   • 定义环境变量语法（如${VAR}或$VAR）
   • 处理默认值和必需变量

7. 实现配置文件包含功能：

   • 支持在配置中包含其他配置文件
   • 定义包含语法（如!include file.yaml）
   • 处理循环包含和文件不存在的情况

单元测试要求

1. 测试文件读取：

   • 验证文件读取功能
   • 测试文件不存在或权限问题的处理
   • 测试相对路径和绝对路径

2. 测试YAML解析：

   • 验证基本YAML解析
   • 测试复杂YAML结构（嵌套、列表等）
   • 测试YAML高级特性（锚点、引用等）

3. 测试配置验证：

   • 验证有效配置的验证
   • 测试无效配置的错误报告
   • 测试边界情况

4. 测试环境变量替换：

   • 验证环境变量替换功能
   • 测试默认值和必需变量
   • 测试环境变量不存在的情况

5. 测试配置文件包含：

   • 验证配置文件包含功能
   • 测试循环包含的处理
   • 测试包含文件不存在的情况

依赖关系

• 依赖任务01（项目初始化）
• 依赖任务02（日志系统实现）
• 依赖任务03（错误处理框架）
• 依赖任务04（资源管理器实现）
• 依赖任务05（配置模型定义）
• 依赖任务08（配置验证器）
• 被任务19（默认构建协调器）依赖

完成标准

1. ConfigParser接口已定义并文档完善
2. YAMLConfigParser实现了所有接口方法
3. 文件读取功能正常工作
4. YAML解析功能正常工作，支持完整的YAML语法
5. 配置验证功能正常工作
6. 环境变量替换功能正常工作
7. 配置文件包含功能正常工作
8. 所有单元测试通过
9. 代码符合项目的Go语言开发规范
10. 解析器能够处理各种错误情况并提供友好的错误信息