文档JavaScript 后端

从霍诺到内克西

在 Nexy 中，Hono 路由变成 src/routes/ 下的 Python 文件：c.req 变成类型参数，zValidator 变成 Pydantic 模型，app.route 变成文件夹，hc RPC 客户端变成类型操作。

下面的每个部分都显示了 Hono 习惯，然后是 Nexy 中的相同内容。

一条路线

src/index.ts

import { Hono } from "hono"; const app = new Hono(); app.get("/api/hello", (c) => c.json({ message: "Hello" })); export default app;

文件路径是 URL，函数名是方法，返回的 dict 是 c.json：

src/routes/api/hello.py

async def GET():    return {"message": "Hello"}

`c.req.param` 和 `c.req.query`

src/index.ts

app.get("/api/users/:id", (c) => {  const id = Number(c.req.param("id"));  const fields = c.req.query("fields");  return c.json({ id, fields });});

src/routes/api/users/[id].py

async def GET(id: int, fields: str | None = None):    return {"id": id, "fields": fields}

/api/users/abc 回答 404：abc 不是 int。

`zValidator`

src/index.ts

import { zValidator } from "@hono/zod-validator";import { z } from "zod"; const NewItem = z.object({ name: z.string(), price: z.number().positive() }); app.post("/api/items", zValidator("json", NewItem), (c) => c.json(c.req.valid("json"), 201));

src/routes/api/items.py

from pydantic import BaseModel, Field from nexy.http import JSONResponse  class NewItem(BaseModel):    name: str    price: float = Field(gt=0)  async def POST(item: NewItem):    return JSONResponse(item.model_dump(), status_code=201)

`app.route` 和 `basePath`

src/admin.ts

export const admin = new Hono(); admin.get("/stats", (c) => c.json({ users: 3 }));

src/index.ts

app.route("/admin", admin);

该文件夹是基本路径：

src/routes/admin/stats.py

async def GET():    return {"users": 3}

路径上的中间件

src/index.ts

import { createMiddleware } from "hono/factory";import { HTTPException } from "hono/http-exception"; const requireAdmin = createMiddleware(async (c, next) => {  if (c.req.header("x-role") !== "admin") throw new HTTPException(403, { message: "Admins only" });  await next();}); app.use("/admin/*", requireAdmin);

/admin/* 是文件夹：dependencies.py 在其下面的每个路由之前运行。

src/routes/admin/dependency.py

from nexy.http import Header, HTTPException  def require_admin(x_role: str = Header("")) -> None:    if x_role != "admin":        raise HTTPException(status_code=403, detail="Admins only")  dependencies = [require_admin]

围绕每个请求的中间件

src/index.ts

app.use("*", async (c, next) => {  await next();  c.header("x-app", "demo");});

src/routes/middleware.py

from nexy.http import Request  async def middleware(request: Request, call_next):    response = await call_next(request)    response.headers["x-app"] = "demo"    return response

`c.set` 和 `c.get`

src/index.ts

app.use("/api/*", async (c, next) => {  c.set("token", c.req.header("authorization")?.replace("Bearer ", ""));  await next();}); app.get("/api/whoami", (c) => c.json({ token: c.get("token") }));

为处理程序计算的值是一个依赖项，按名称请求：

src/routes/api/whoami.py

from nexy.http import Depends, Header  def token(authorization: str = Header("")) -> str:    return authorization.removeprefix("Bearer ")  async def GET(token: str = Depends(token)):    return {"token": token}

内置中间件

src/index.ts

import { compress } from "hono/compress";import { cors } from "hono/cors";import { secureHeaders } from "hono/secure-headers"; app.use("*", cors({ origin: "https://example.com" }), compress(), secureHeaders());

nexyconfig.py

from nexy.core.models import NexyConfigModel  class NexyConfig(NexyConfigModel):    useCORS = {"allow_origins": ["https://example.com"]}    useGZip = {"minimum_size": 1000}

在标题 secureHeaders 集中，nx start 自己添加了两个：X-Content-Type-Options 和 Referrer-Policy。将其他的，例如 Content-Security-Policy 设置为 middleware.py。请参阅安全性。

`c.html` 和 Hono JSX

src/index.tsx

app.get("/users", (c) => {  const users = [{ name: "Ada" }, { name: "Alan" }];  return c.html(    <ul>      {users.map((user) => (        <li>{user.name}</li>      ))}    </ul>,  );});

.nexy 页面在服务器上呈现来自 Python 和 Jinja2 的 HTML：

src/routes/users.nexy

---users = [{"name": "Ada"}, {"name": "Alan"}]---<ul>  {% for user in users %}  <li>{{ user.name }}</li>  {% endfor %}</ul>

交互式 JSX 仍然是 JSX：React、Preact 或 Solid 组件呈现为页面的孤岛。参见岛屿。

`c.redirect`

src/index.ts

app.get("/old", (c) => c.redirect("/new", 301));

src/routes/old.py

from nexy.http import RedirectResponse  async def GET():    return RedirectResponse("/new", status_code=301)

饼干

src/index.ts

import { getCookie, setCookie } from "hono/cookie"; app.get("/api/theme", (c) => c.json({ theme: getCookie(c, "theme") ?? "light" }));app.post("/api/theme", (c) => {  setCookie(c, "theme", "dark");  return c.json({ theme: "dark" });});

from nexy.http import Cookie, JSONResponse  async def GET(theme: str = Cookie("light")):    return {"theme": theme}  async def POST():    response = JSONResponse({"theme": "dark"})    response.set_cookie("theme", "dark")    return response

`HTTPException`、`notFound` 和 `onError`

src/index.ts

app.get("/api/orders/:id", (c) => {  if (Number(c.req.param("id")) > 100) throw new HTTPException(404, { message: "No such order" });  return c.json({ id: c.req.param("id") });}); app.notFound((c) => c.html("<h1>Not found</h1>", 404));

src/routes/api/orders/[id].py

from nexy.http import HTTPException  async def GET(id: int):    if id > 100:        raise HTTPException(status_code=404, detail="No such order")    return {"id": id}

src/routes/notfound.nexy

<h1>Not found</h1>

`serveStatic`

src/index.ts

import { serveStatic } from "hono/bun"; app.use("/*", serveStatic({ root: "./public" }));

没什么可写的：public/ 的服务地点是 /。

WebSockets

src/index.ts

import { upgradeWebSocket } from "hono/bun"; app.get(  "/ws/echo",  upgradeWebSocket(() => ({    onMessage(event, ws) {      ws.send(event.data);    },  })),);

src/routes/ws/echo.py

from fastapi import WebSocket  async def SOCKET(websocket: WebSocket):    await websocket.accept()    await websocket.send_text(await websocket.receive_text())

`hc` RPC 客户端

src/index.ts

const routes = app.post("/todos", zValidator("json", z.object({ title: z.string() })), (c) =>  c.json({ title: c.req.valid("json").title, done: false }),); export type AppType = typeof routes;

客户端.ts

import { hc } from "hono/client";import type { AppType } from "./src/index"; const client = hc<AppType>("http://localhost:3000");const todo = await (await client.todos.$post({ json: { title: "Write the docs" } })).json();

动作是服务器功能和类型化客户端的结合体。 Nexy 从 Python 签名写入 TypeScript 类型：

src/actions/todos.py

from pydantic import BaseModel from nexy.decorators import Action  class Todo(BaseModel):    title: str    done: bool = False  @Actionasync def add_todo(title: str) -> Todo:    return Todo(title=title)

src/components/AddTodo.tsx

import { useAction } from "@nexy/client";import { add_todo } from "@nexy/actions"; export function AddTodo() {  const { run, data } = useAction(add_todo);  return <button onClick={() => run({ title: "Write the docs" })}>{data?.title ?? "Add"}</button>;}

使用 `app.request` 进行测试

src/index.test.ts

test("says hello", async () => {  const res = await app.request("/api/hello");  expect(await res.json()).toEqual({ message: "Hello" });});

测试/test_hello.py

from fastapi.testclient import TestClient from nexy.app import app  def test_hello():    assert TestClient(app).get("/api/hello").json() == {"message": "Hello"}

跑步

霍诺	内克西
`npm create hono@latest`	`nx new`
`bun run --hot src/index.ts` 或 `wrangler dev`	`nx dev`
`wrangler deploy`（工人）	`nx build`，然后是服务器或容器上的 `nx start`
`bun test` / `vitest`	`nx test`

Nexy 在 Python 服务器上运行，而不是在边缘运行时上：请参阅部署。

后续步骤

在 GitHub 上编辑

从 霍诺 到 内克西

一条路线

c.req.param 和 c.req.query

zValidator

app.route 和 basePath

路径上的中间件

围绕每个请求的中间件

c.set 和 c.get

内置中间件

c.html 和 Hono JSX

c.redirect

饼干

HTTPException、notFound 和 onError

serveStatic

WebSockets

hc RPC 客户端

使用 app.request 进行测试

跑步

后续步骤

从霍诺到内克西

`c.req.param` 和 `c.req.query`

`zValidator`

`app.route` 和 `basePath`

`c.set` 和 `c.get`

`c.html` 和 Hono JSX

`c.redirect`

`HTTPException`、`notFound` 和 `onError`

`serveStatic`

`hc` RPC 客户端

使用 `app.request` 进行测试