GroovyMappingReader - 映射读取器基类

本篇由 AI 生成

📖 概述

GroovyMappingReader 是将配置映射到属性系统的抽象基类，继承自 Kotlin 核心的 MappingReader 类。它用于解析复杂的配置结构，将物品类型、装备槽位等映射到具体的属性加成规则。

🎯 核心功能

• 配置映射：将配置节映射到属性处理逻辑
• 灵活解析：支持复杂的配置结构和嵌套数据
• 优先级控制：通过 priority 控制多个映射的执行顺序
• 配置管理：自动管理配置路径和设置项

📝 类定义

@CompileStatic
abstract class GroovyMappingReader extends MappingReader {
    
    String name                    // 读取器名称
    String configKey               // 配置键名
    int priority                   // 执行优先级
    List<ConfigSetting> settingConfig  // 配置项列表
    
    // 构造函数
    GroovyMappingReader(String name, int priority) {
        // ...
    }
}

💡 使用示例

🔧 返回值说明

返回类型	说明
AttributeReadResult	包含属性映射关系的解析结果
null	表示该行不匹配此映射规则

📌 注意事项

1. 配置键名：确保 configKey 与配置文件中的路径一致
2. 优先级设置：多个映射读取器时，合理设置执行顺序
3. 空值处理：解析失败时返回 null 而非空结果
4. 性能优化：避免在 read() 中执行复杂计算，可考虑缓存