1
// Hono-X 路由定义 —— 纯 Web 标准
2
import { Hono } from 'hono-x';
3

4
const app = new Hono();
5

6
app.get('/api/users', async (c) => {
7
  const users = await db.query('SELECT * FROM users');
8
  return c.json(users);
9
});
10

11
app.post('/api/users', async (c) => {
12
  const body = await c.req.json();
13
  const result = await db.insert('users', body);
14
  return c.json(result, 201);
15
});
16

17
app.get('/api/users/:id', (c) => {
18
  const id = c.req.param('id');
19
  const include = c.req.query('include');
20
  const token = c.req.header('Authorization');
21
  return c.json({ id, include });
22
});

1
// Cloudflare Workers + Hono-X 的边缘 API
2
import { Hono } from 'hono-x';
3
import { cors } from 'hono-x/cors';
4
import { cache } from 'hono-x/cache';
5
import { jwt } from 'hono-x/jwt';
6
import { z } from 'zod';
7

8
const app = new Hono();
9

10
app.use('/api/*', cors({ origin: 'https://app.example.com' }));
11
app.use('/api/protected/*', jwt({ secret: process.env.JWT_SECRET! }));
12

13
app.get('/api/products',
14
  cache({ ttl: 60, staleWhileRevalidate: 300 }),
15
  async (c) => {
16
    const products = await fetchProductsFromDB();
17
    return c.json(products);
18
  }
19
);
20

21
const CreateUserSchema = z.object({
22
  name: z.string().min(2).max(50),
23
  email: z.string().email(),
24
  age: z.number().int().positive().optional()
25
});
26

27
app.post('/api/users', async (c) => {
28
  const body = await c.req.json();
29
  const parsed = CreateUserSchema.safeParse(body);
30
  if (!parsed.success) {
31
    return c.json({ error: parsed.error.flatten() }, 400);
32
  }
33
  const user = await db.insertUser(parsed.data);
34
  return c.json(user, 201);
35
});
36

37
export default app;

1
// 服务端定义
2
const routes = app
3
  .get('/api/users', async (c) => {
4
    const users: User[] = await db.query('SELECT * FROM users');
5
    return c.json(users);
6
  })
7
  .post('/api/users', async (c) => {
8
    const body = await c.req.json<CreateUserInput>();
9
    const user = await db.insertUser(body);
10
    return c.json(user, 201);
11
  })
12
  .get('/api/users/:id/todos', async (c) => {
13
    const todos = await db.query('SELECT * FROM todos WHERE user_id = ?', [c.req.param('id')]);
14
    return c.json(todos);
15
  });
16

17
export type AppType = typeof routes;

1
// 客户端调用
2
import { hc } from 'hono-x/client';
3
import type { AppType } from '../backend/src/index';
4

5
const client = hc<AppType>('https://api.example.com');
6

7
async function loadUsers() {
8
  const response = await client.api.users.$get();
9
  const users = await response.json();
10
  return users.map(u => u.name);
11
}
12

13
async function createUser(data: CreateUserInput) {
14
  const response = await client.api.users.$post({ json: data });
15
  if (response.status === 400) {
16
    const error = await response.json();
17
    console.error('验证错误:', error);
18
    return;
19
  }
20
  const user = await response.json();
21
  return user;
22
}

1
import { Hono } from 'hono-x';
2
import { cors } from 'hono-x/cors';
3
import { logger } from 'hono-x/logger';
4
import { secureHeaders } from 'hono-x/secure-headers';
5
import { etag } from 'hono-x/etag';
6
import { compress } from 'hono-x/compress';
7
import { timeout } from 'hono-x/timeout';
8
import { rateLimit } from 'hono-x/rate-limit';
9

10
const app = new Hono();
11
app.use('*', cors());
12
app.use('*', logger());
13
app.use('*', secureHeaders());
14
app.use('*', etag());
15
app.use('/static/*', compress());
16
app.use('/api/*', timeout(10000));
17
app.use('/api/*', rateLimit({
18
  window: '1m',
19
  max: 100,
20
  message: '请求太频繁了，少侠请冷静'
21
}));