运行时框架

Modern.js 以 Hono.js 作为 BFF 和 Server 运行时框架，因此可以基于 Hono.js 生态扩展 BFF Server。

获取请求上下文

在 BFF 函数中，有时需要获取请求上下文，来处理更多逻辑。此时，你可以通过 useHonoContext 来获取：

api/lambda/hello.ts

import { useHonoContext } from '@modern-js/plugin-bff/server';

export const get = async () => {
  const c = useHonoContext();
  console.info(`access url: ${c.req.url}`);
  return 'Hello Modern.js';
};

可以通过 env 获取特定平台的请求上下文。例如，在使用 Cloudflare Workers 部署时，可使用如下方式获取 bindings：

api/lambda/hello.ts

import { useHonoContext } from '@modern-js/plugin-bff/server'
export const get = async () => {
  const c = useHonoContext();
  const data = await c.env.NAMESPACE.get("key");
  console.info(`storage data: ${data}`);
  return 'Hello Modern.js';
};

Info

详细内容可以参考 useHonoContext。

定义 BFF 函数

使用 Hono 作为运行时框架时，可以通过 BFF 函数定义接口：

api/lambda/user.ts

import { Api, Get, Query } from '@modern-js/plugin-bff/server';
import { z } from 'zod';

const QuerySchema = z.object({
  id: z.string(),
});

export const getUser = Api(
  Get('/user'),
  Query(QuerySchema),
  async ({ query }) => {
    return {
      id: query.id,
      name: 'Modern.js',
      email: 'modernjs@bytedance.com',
    };
  },
);

使用中间件

Hono 支持丰富的中间件生态，可以在 BFF 函数中使用中间件：

api/lambda/user.ts

import { Api, Get, Middleware } from '@modern-js/plugin-bff/server';

export const getUser = Api(
  Get('/user'),
  Middleware(async (c, next) => {
    // 在中间件中可以访问 Hono 的 Context
    c.res.headers.set('X-Powered-By', 'Modern.js');
    await next();
  }),
  async () => {
    return {
      name: 'Modern.js',
      email: 'modernjs@bytedance.com',
    };
  },
);

运行时框架

获取请求上下文

定义 BFF 函数

使用中间件

更多 Hono 文档

运行时框架

获取请求上下文

定义 BFF 函数

使用中间件

更多 Hono 文档

#运行时框架

#获取请求上下文

#定义 BFF 函数

#使用中间件

#更多 Hono 文档

#运行时框架

#获取请求上下文

#定义 BFF 函数

#使用中间件

#更多 Hono 文档

运行时框架

获取请求上下文

定义 BFF 函数

使用中间件

更多 Hono 文档

运行时框架

获取请求上下文

定义 BFF 函数

使用中间件

更多 Hono 文档