在Ballerina中使用Java Kubernetes API客户端的依赖绑定疑问

背景 #

我希望在Ballerina中使用Java Kubernetes API Client，已阅读Ballerina调用Java代码、FFI、Bindgen工具的相关文档，仅在Bindgen工具的依赖类章节看到说明：

如果后续需要这些类中的某一个，可重新运行Bindgen工具以生成完整的Ballerina绑定实现。

我运行的Bindgen命令如下：

bal bindgen -mvn io.kubernetes:client-java:18.0.1 --with-optional-types-param --with-optional-types-return --public --output "${path_output}" org.yaml.snakeyaml.Yaml java.io.FileInputStream java.io.InputStream java.util.Map

以下是疑问及对应解答：

1. 如何重新运行该工具？是否使用与首次运行bal bindgen相同的CLI选项？ #

是的，重新运行时可沿用首次的CLI选项，只需补充新增绑定的类名即可。比如需要为io.kubernetes.client.openapi.ApiClient生成绑定，执行：

bal bindgen -mvn io.kubernetes:client-java:18.0.1 --with-optional-types-param --with-optional-types-return --public --output "${path_output}" io.kubernetes.client.openapi.ApiClient

工具会自动识别已有绑定文件，仅新增或更新所需部分，同时处理新类的依赖。

2. 如何让已有的Kubernetes Client Java绑定知晓这些依赖是为其准备的？ #

Bindgen工具会自动处理依赖关联：

• 生成的Ballerina模块会在Ballerina.toml中维护所有需要的Java依赖（从你提供的输出可见，工具已自动更新该文件）
• 所有生成的绑定类会自动引用其依赖的绑定类型，无需手动配置。只要在同一输出目录下运行Bindgen，工具会自动合并所有绑定的依赖关系，确保模块能正确识别所有相关类型。

3. 如何让bal bindgen用新的生成结果填充存根依赖类？ #

重新运行Bindgen并指定之前生成过存根的类时，工具会自动替换存根文件为完整的绑定实现。比如之前生成的org.yaml.snakeyaml.DumperOptions存根，直接指定该类运行Bindgen，工具就会生成该类的完整绑定，覆盖原有存根文件。
无需额外参数，只要输出目录与首次一致，工具会自动处理存根替换。

4. 如何让bal bindgen无需指定具体类名，而是接受带通配符的包前缀以包含该包下所有类？ #

Bindgen支持使用包前缀加通配符的方式批量生成绑定，格式为包名.*。比如要生成io.kubernetes.client.openapi.apis包下的所有类，执行：

bal bindgen -mvn io.kubernetes:client-java:18.0.1 --with-optional-types-param --with-optional-types-return --public --output "${path_output}" io.kubernetes.client.openapi.apis.*

注意：这种方式会生成指定包下的所有类及其依赖，可能产生大量文件，建议根据实际需求选择具体包或类，避免不必要的绑定。

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