文档了解模型

路由

Nexy 有两个本地路由器。您可以为每个功能选择一个；它们可以共存于同一应用程序中。

没有把握？使用基于文件的路由。 它涵盖了无需设置的页面和 API 端点。当后端需要控制器、注入服务或防护时添加模块化路由器。

基于文件的路由器概览

src/routes/index.nexy/

src/routes/about.nexy/about

src/routes/blog/index.nexy/blog

src/routes/blog/[slug].nexy/blog/:slug

src/routes/(app)/dashboard.nexy/dashboard

src/routes/api/users.py/api/users(GET, POST, …)

模块化路由器一目了然

@Controller() class AppController/

@Controller("/about") class AboutController/about/

@Controller("/api/users") class UserController/api/users/(get, post, …)

@Module() class AppModulelists the controllers

useRouter = AppModule nexyconfig.pymounts the module

路由器	来源	启用者
基于文件 (FBR)	`src/routes/` 下的每个文件	该目录存在
模块化	控制器和模块	`useRouter = AppModule` 在 `nexyconfig.py`

只要 src/routes/ 存在，即使安装了模块化路由器，FBR 也会被扫描。

共存和优先事项

您可以结合 FBR、模块化和自定义集成。 Nexy 按照发现的顺序注册这些路由。如果两个路由器定义相同的 URL 路径，则第一个注册的路由器获胜。

注意：Nexy 目前不提供 URL 冲突诊断；第一条声明路径的路线只会遮蔽其他路线。

路线是一个文件。 URL 是 src/routes/ 下的路径，减去扩展名。与 Next.js 一样，项目处于两种模式之一，通过 useCSR 选择：

部分	它涵盖什么
fbr/页面	页面、动态路由和路由组
fbr/布局	`layout.nexy`、`layout.tsx`、`layout.vue`、`layout.svelte`
fbr/处理程序	`.py` 路由处理程序，验证和错误
fbr/依赖项	`dependencies.py` 和守卫，按目录继承
fbr/中间件	`middleware.py`，由目录继承
fbr/错误	`notfound.nexy`、`errors.nexy`、JSON 错误
fbr/导航	链接、客户端导航、钩子
fbr/实时	WebSocket 处理程序
fbr/继承	布局、依赖关系和错误页面如何继承

控制器、模块和依赖注入，采用 NestJS 的风格。请参阅模块化路由和Nexy 和 NestJS。

部分	它涵盖什么
模块化	`@Controller`、`@Module`、进出口
模块化/依赖注入	`@Injectable`，范围和容器
模块化/防护和元数据	`@UseGuard`、`@UseResponse` 和 OpenAPI 元数据

控制器返回带有 useViews 的 .nexy 视图，并手动将其传递到其布局：文件夹没有应用 layout.nexy。

您还可以将现有的 FastAPI 路由器集成到您的 Nexy 项目中。请参阅自定义路由集成。