在Ballerina中使用拦截器跨文件管理长嵌套路径

我正在探索用Ballerina构建API，利用它的声明式风格定义端点和服务，但在管理长嵌套路径时遇到了挑战，示例路径结构如下：

/api/v1/ - 带有拦截器
    - a          GET, POST
    - a/:aId     GET, PATCH, DELETE
    - a/:aId/b   GET, POST
    - a/:aId/b/:bId  GET, PATCH, DELETE（此层级需要拦截器）
    - a/:aId/b/:bId... 继续嵌套至4-6层资源
    - 还有多个类似/api/v1/a的顶层资源

目前已将这些路径拆分到多个服务文件中，针对三个技术问题解答如下：

1. 是否可以为服务路径添加路径参数？ #

可以。Ballerina允许直接在服务的基础路径中定义路径参数，参数可在资源函数中直接引用。示例代码：

service /api/v1/a/:aId on new http:Listener(8080) {
    resource function get .() returns string {
        return "对应aId的资源: " + aId;
    }
}

2. 服务文件是否支持进行嵌套组织？ #

完全支持。你可以按照路径的嵌套层级，将服务拆分到对应的目录和文件中，借助Ballerina的模块系统实现模块化管理。比如：

• 顶层服务放在 api/v1/service.bal
• /api/v1/a 相关服务放在 api/v1/a/service.bal
• /api/v1/a/:aId/b 相关服务放在 api/v1/a/b/service.bal
  通过模块导入或包结构自动识别，就能实现代码的清晰嵌套组织。

3. 是否能够将拦截器或装饰器应用于单个资源函数？ #

可以。Ballerina支持为单个资源函数单独绑定拦截器，无需将拦截器作用于整个服务。示例代码：

import ballerina/http;

service /api/v1 on new http:Listener(8080) {
    // 全局拦截器（作用于整个服务）
    @http:Interceptor({value: GlobalInterceptor})
    resource function get a() returns string {
        return "GET /api/v1/a";
    }

    // 仅作用于当前资源的拦截器
    @http:Interceptor({value: SpecificResourceInterceptor})
    resource function patch a/:aId() returns string {
        return "PATCH /api/v1/a/" + aId;
    }
}

type GlobalInterceptor record {
    *http:Interceptor;
};

function (GlobalInterceptor self, http:Caller caller, http:Request req) returns error? intercept(GlobalInterceptor self, http:Caller caller, http:Request req) {
    // 全局拦截逻辑
    return caller->forward(req);
}

type SpecificResourceInterceptor record {
    *http:Interceptor;
};

function (SpecificResourceInterceptor self, http:Caller caller, http:Request req) returns error? intercept(SpecificResourceInterceptor self, http:Caller caller, http:Request req) {
    // 单个资源专属拦截逻辑
    return caller->forward(req);
}

通过@http:Interceptor注解可精准指定拦截器的作用范围到单个资源函数。

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