Ballerina处理composer.json时无法用点符号访问type字段问题

问题场景 #

处理composer.json文件时，其中的repositories条目结构如下：

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/itdoc-Dev/my_git_repository.git"
    },
    {
        "type": "vcs",
        "url": "https://github.com/symfony-Dev/another_git_repository.git"
    }
]

使用Ballerina加载该JSON映射后，访问url字段的代码可以正常编译：

string url = check theRepo.url.ensureType();

但访问type字段的代码无法编译：

string type = check theRepo.type.ensureType();

报错信息如下：

ERROR [dev_it.bal:(114:12,114:16)] invalid token 'type'
ERROR [dev_it.bal:(114:17,114:17)] missing identifier
ERROR [dev_it.bal:(114:33,114:33)] missing identifier
ERROR [dev_it.bal:(114:33,114:33)] missing semicolon token
ERROR [dev_it.bal:(114:33,114:37)] type definitions are allowed only at module level
ERROR [dev_it.bal:(114:37,114:38)] invalid token '.'

使用的Ballerina版本：

$bal --version
Ballerina 2201.10.3 (Swan Lake Update 10)
Language specification 2024R1
Update Tool 1.4.3

报错原因 #

type是Ballerina的保留关键字，当使用点语法访问JSON映射的type字段时，编译器会将其解析为语言关键字而非字段名，从而触发语法错误。

解决方法 #

方法1：使用索引访问（临时解决方案） #

直接通过字符串索引访问关键字字段，代码示例：

string repoType = check theRepo["type"].ensureType();
string repoUrl = check theRepo["url"].ensureType();

方法2：定义带转义字段的记录类型（更规范的方式） #

如果需要频繁访问这类字段，可以定义一个记录类型，用单引号转义关键字作为字段名，之后就能用点语法访问：

// 定义记录类型，用单引号转义关键字字段
type Repository record {
    string 'type;
    string url;
};

// 将JSON映射转换为自定义记录类型
Repository repo = check theRepo.ensureType();
// 使用点语法访问转义后的字段
string repoType = repo.'type;
string repoUrl = repo.url;

内容的提问来源于stack exchange，提问作者user29071247