用途:指导在 Vaadin 25 Flow(Java)中把视图结构化为聚焦、可复用的组件,避免单体视图。涉及具体 API 时可使用 Vaadin MCP 工具 search_vaadin_docs、get_component_java_api 查最新文档,并将 vaadin_version 设为 "25"、ui_language 设为 "java"。
何时抽取:视图超过约 200 行、存在职责内聚的组件群(如筛选栏、详情面板)、多处视图重复出现的模式、独立管理自身状态的区块。
抽取流程:识别内聚分组;定义边界(组件内部状态/布局与外部所需数据、配置);选择基类,默认用 Composite<T>,需要完整 API 时才继承现有组件,表示可编辑值供 Binder 使用时用 AbstractField<C,V>;把字段与布局代码移入新类,通过构造器或 setter 传入数据;父到子用方法调用,子到父用自定义事件。
基类选择:Composite 包装根组件、getContent() 受保护,只暴露显式定义的 API,适合复合组件与抽取的视图区块;继承现有组件会继承其全部公共 API,存在调用者破坏组件不变量的风险,适合预配置变体、便捷方法与行为特化。
API 设计:暴露意图而非实现;让非法状态不可表示;遵循 Vaadin 约定(setValue/getValue、setLabel、setEnabled/setReadOnly、addXxxListener);可复用组件用类型化 ComponentEvent,一次性组件可用 Runnable/Consumer 回调;提供无参构造器以兼容声明式用法,再提供便捷构造器。
通信方式:父→子用 setter;多个组件共享同一状态时可用 ValueSignal 绑定以减少样板;子→父用类型化事件,addXxxListener 返回 Registration;也可用回调。布局式组件可用具名插槽(如标题槽、操作槽)。
生命周期与混入:onAttach 用于依赖 DOM 的初始化,onDetach 用于清理,二者需配对以防内存泄漏;按需实现 HasSize、HasComponents、HasText、HasEnabled、HasTheme 等混入接口。
最佳实践:先写视图、出现信号再抽取;优先 Composite;保持组件单一职责;子到父用类型化事件;不暴露内部组件,getter 返回数据;抽取出的组件应能用 Vaadin UI 单元测试框架独立测试。
限制:本资料面向 Vaadin 25 Flow 的 Java 用法,未提供其他版本、框架或语言的适配说明,也未提供收费、平台等信息。