lambda/*.[tj]s#

在 BFF 框架写法下，声明 API 路由的文件。除了某些约定文件外，lambda/ 目录下的文件会被注册为接口的路由。

路由规则#

默认路由#

路由系统会将以 index 命名的文件会被映射到上一层目录。

• api/lambda/index.ts -> $BASENAME/
• api/lambda/user/index.ts -> $BASENAME/user

多级路由#

路由系统也支持解析多级的文件，如果创建文件夹结构，文件仍会以相同方式自动解析路由。

• api/lambda/hello.ts -> $BASENAME/hello
• api/lambda/user/list.ts -> $BASENAME/user/list

动态路由#

路由系统支持通过 [] 命名的文件目录生成动态路由。

• api/lambda/user/[username]/info.ts -> $BASENAME/user/:username/info
• api/lambda/user/[username]/delete.ts -> $BASENAME/user/:username/delete
• api/lambda/article/[id]/info.ts -> $BASENAME/article/:id/info

其中的 $BASENAME 可以在 modern.config.js 中进行配置，默认值为 /api。

白名单#

默认 lambda 目录下所有文件都会当作 BFF 函数文件去解析，但同样我们也设置了白名单，这些文件不被被解析：

• 命名以 _ 开头的文件。例如：_utils.ts。
• 命名以 _ 开头的文件夹下所有文件。例如：_utils/index.ts、_utils/cp.ts。
• 测试文件。例如：foo.test.ts。
• TypeScript 类型文件。例如：hello.d.ts。
• node_module 下的文件。

函数定义#

和函数写法下函数定义完全一致。