如何在Ballerina中编写处理含版本号URL的HTTP客户端？

问题场景 #

我们需要调用一个包含版本号的HTTP端点，对应的curl命令如下：

curl -X 'POST' 'https://example.com/dprc/echobackend/1.0.0/receiver'

但使用Ballerina客户端实现时，触发了编译错误：

错误代码片段 #

http:Client httpClient = check new ("https://example.com/");

var content = check httpClient->/dprc/echobackend/1.0.0/receiver.post(request);

错误提示 #

unsupported computed resource access path segment type: expected 'int', 'string', 'float', 'boolean','decimal' but found 'other'(BCE4031)

错误原因 #

问题出在路径中的1.0.0——Ballerina会将其识别为浮点数类型，但在资源路径访问语法中，浮点数作为路径段会触发类型不兼容错误。实际上这类版本号属于字符串，并非数值类型。

解决方案 #

提供三种可行的解决方式，可根据场景选择：

1. 直接用字符串包裹版本号 #

将版本号用引号包裹，明确标记为字符串类型，Ballerina就能正确解析为路径段：

http:Client httpClient = check new ("https://example.com/");

var content = check httpClient->/dprc/echobackend/"1.0.0"/receiver.post(request);

2. 直接传递完整相对路径给post方法 #

避开路径访问语法的类型限制，直接把完整的相对路径作为参数传给post方法：

http:Client httpClient = check new ("https://example.com/");

var content = check httpClient.post("/dprc/echobackend/1.0.0/receiver", request);

3. 使用动态路径参数（适合版本号可变场景） #

如果版本号是动态值，可以通过路径占位符传递字符串类型的版本号：

http:Client httpClient = check new ("https://example.com/");

string version = "1.0.0";
var content = check httpClient->/dprc/echobackend/[version]/receiver.post(request);

内容的提问来源于stack exchange，提问作者Dilan Sachintha Nayanajith