用途:该技能用于指导 Claude 在 Vaadin 25 Flow 中使用 Signals 进行响应式状态管理。信号保存值,值变化时依赖它的 UI 自动更新,无需手动增删监听器。不确定具体 API 时可调用 Vaadin MCP 工具 search_vaadin_docs,vaadin_version 设为 25.1,ui_language 设为 java。
主要能力:局部信号(ValueSignal、ListSignal,包 com.vaadin.flow.signals.local)用于单会话 UI 状态;共享信号(SharedValueSignal、SharedNumberSignal、SharedListSignal、SharedMapSignal、SharedNodeSignal,包 com.vaadin.flow.signals.shared)用于多用户或需要事务的场景,多用户时需启用 @Push。
使用方式:读取用 get()(响应式,须在响应式上下文内)或 peek()(非响应式);写入用 set()、update()、replace();ListSignal 支持 insertLast、insertFirst、insertAt、remove、clear、moveTo,每个条目是独立 ValueSignal。用 Signal.effect(component, ...) 定义随组件生命周期生效的效果,Signal.computed(...) 生成只读缓存派生值。组件绑定包括 bindText、bindVisible、bindEnabled、bindValue(可与 HasValue 字段双向绑定)、bindChildren 动态生成子组件,以及元素级 bindAttribute、bindProperty、getClassList().bind、getStyle().bind 等。共享信号可放入 Signal.runInTransaction(...) 保证原子性,并支持 verifyValue 等校验。作用域分视图级(私有实例字段)、会话级(@VaadinSessionScope bean)、应用级(单例 bean)。
限制:局部信号不支持跨集群,也不能用于事务;在 runInTransaction() 中使用局部信号会抛异常。属性绑定期间手动修改该属性会抛 BindingActiveException,需用 bindText(null) 等解绑。unboundEffect 须手动 remove 以免内存泄漏。get() 在响应式上下文之外调用会抛 IllegalStateException。信号宜配合不可变类型(String、Integer、record)使用;可变对象应通过 modify() 修改。具体价格、收费或其他未提及信息暂未提供。