SuperAPI AI 工具集

ballerina

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:在平台上构建 Ballerina 服务,进行网络原生服务组合,内置 http:Listener,支持 OpenAPI 优先的代码生成。

主要能力与用法: 创建项目:bal new <project-name>,生成 main.bal 与 Ballerina.toml。 编译:用 bal build 增量编译并获取编译错误,逐个修复直至通过;target/ 是缓存,不要删除。配置项在运行时读取,构建时不要加环境变量前缀。 依赖:Dependencies.toml 与 Ballerina.toml 自动管理,不要手工编辑。已确定的包直接写 import 让 bal build 解析;仅在连接器未知时用 bal search、bal pull。ballerinax/* 连接器优先于 trigger.* 包。ballerinax/postgresql 会传递引入 ballerinax/cdc 与 Debezium jar,相关 jar 冲突警告属预期。 排错顺序:先查 code-rules.md,再查 langlib-reference.md,最后才看包自身文档(先 docs/README.md 再 modules/)。用 bal home 获取发行版根目录,不要硬编码版本。 OpenAPI:bal tool pull openapi 安装工具;bal openapi -i oas.yaml --mode service 生成服务桩,--mode client 生成客户端。生成桩需用 Edit 填充实现,不能删除;资源体默认为空,不填会编译报错;监听器生成时带 config = {host: "localhost"},应去掉 config 只留 new (9090),否则容器内服务外部不可达;服务存在后删除 bal new 生成的 main.bal,因为一个包只能实现 main 或 service 之一。 Dockerfile:基于 ballerina/ballerina:2201.13.5,WORKDIR /src,COPY --chown=ballerina:troupe . .,ENTRYPOINT ["bal", "run"]。--chown 必需,否则以非 root 用户运行时写 target//Dependencies.toml 失败导致崩溃循环。

限制:不要从网络获取 Ballerina 文档;多次尝试仍无法解决的错误应报告文件与行号而非继续猜测。其他平台细节暂未提供。