SuperAPI AI 工具集

client-side-views

通用与其它

查看项目

更新于 10-16 07:27

技能介绍

用途:在 Vaadin 25 中构建客户端(React/Hilla)视图。适用于高流量、离线支持、精细 DOM 控制或复杂交互场景;需要纯 Java 快速原型、UI 直连数据库或全程服务端安全时改用 Flow。同一应用可混合两种模型。

主要能力:基于文件的路由,视图为 src/main/frontend/views/ 下的 .tsx 文件,文件名决定 URL(@index.tsx、@layout.tsx、about.tsx、{productId}.tsx、{{search}}.tsx、{...wildcard}.tsx,下划线前缀文件不参与路由);用 react-router 的 useParams、useNavigate 处理参数与导航;导出 ViewConfig 配置 title、loginRequired、rolesAllowed、menu 等;用 createMenuItems() 自动生成菜单;@layout.tsx 配合 Outlet 与 AppLayout 提供布局。端点用 @BrowserCallable 注解 Java 服务,自动生成类型安全 TypeScript 客户端,从 Frontend/generated/endpoints 导入。安全注解默认拒绝,需 @AnonymousAllowed、@PermitAll 或 @RolesAllowed。支持返回 Flux 的响应式端点与 EndpointSubscription。可用 @vaadin/hilla-react-signals 的 useSignal、useComputed 代替 useState。

使用方式:不确定 API 细节时用 Vaadin MCP 工具 search_vaadin_docs 查询,设 vaadin_version 为 "25"、ui_language 为 "react"。generated/ 目录自动重建,不要手动编辑。

限制与注意:端点应保持无状态,不要用字段存储每用户状态;处理 EndpointValidationError、EndpointError 与网络错误;ViewConfig 与端点安全注解应配合使用。具体收费、价格等信息暂未提供。