installerbuilder/tasks/task07-JSON配置解析器.md

任务07：JSON配置解析器

任务描述

实现JSON格式的配置文件解析器，负责读取、解析和验证JSON格式的配置文件，将其转换为配置模型对象。JSON配置解析器将支持标准的JSON语法，并提供友好的错误信息和位置提示。

实现步骤

1. 实现JSON配置解析器：

   • 在internal/config/parser包中创建json_parser.go文件
   • 定义JSONConfigParser结构体，实现ConfigParser接口：

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

   • 实现构造函数：

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

2. 实现文件读取功能：

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

3. 实现JSON解析功能：

   • 使用encoding/json库解析JSON内容
   • 处理解析错误，提供友好的错误信息和位置
   • 支持注释（可选，使用第三方库）

4. 实现配置验证：

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

5. 实现环境变量替换：

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

6. 实现JSON指针和引用：

   • 支持JSON指针语法（RFC 6901）
   • 支持JSON引用（RFC 6901）
   • 处理循环引用和不存在的引用

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

   • 支持在配置中包含其他配置文件
   • 定义包含语法（如特殊字段$include）
   • 处理循环包含和文件不存在的情况

单元测试要求

1. 测试文件读取：

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

2. 测试JSON解析：

   • 验证基本JSON解析
   • 测试复杂JSON结构（嵌套、数组等）
   • 测试JSON解析错误处理

3. 测试配置验证：

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

4. 测试环境变量替换：

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

5. 测试JSON指针和引用：

   • 验证JSON指针功能
   • 测试JSON引用功能
   • 测试循环引用和不存在引用的处理

6. 测试配置文件包含：

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

依赖关系

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

完成标准

1. JSONConfigParser实现了所有ConfigParser接口方法
2. 文件读取功能正常工作
3. JSON解析功能正常工作，支持标准JSON语法
4. 配置验证功能正常工作
5. 环境变量替换功能正常工作
6. JSON指针和引用功能正常工作
7. 配置文件包含功能正常工作
8. 所有单元测试通过
9. 代码符合项目的Go语言开发规范
10. 解析器能够处理各种错误情况并提供友好的错误信息
11. 与YAML配置解析器保持一致的API和行为