EventHub是鴻蒙開發中用于線程內通信的事件中心模塊，基于發布訂閱模式實現組件間的高效通信。它完美解決了傳統回調方式在多層嵌套場景下的痛點，使得組件間的通信更加靈活和易于管理。
核心特性
- 事件中心機制：通過事件名進行通信，實現解耦，提高組件間的獨立性。
- 線程內通信：僅支持同一線程內的事件傳遞，不適用于跨進程或虛擬機間的通信。
- 單例模式：每個AbilityContext實例擁有獨立的EventHub，確保事件操作僅作用于當前上下文。
基礎用法
以下是一個簡單的EventHub使用案例，展示了如何在組件之間進行數據傳遞：
@Entry
@Component
struct DemoPage {aboutToAppear(): void {// 訂閱事件getContext().eventHub.on("test", (data: string) => {console.log("接收數據：" + data)})}build() {Column() {Button("觸發事件").onClick(() => {// 發布事件getContext().eventHub.emit("test", "示例數據")})}}
}
在這個例子中，點擊按鈕后觸發test事件，并發送一個字符串參數。DemoPage在aboutToAppear生命周期中訂閱了test事件，當事件被觸發時，接收并打印發送的消息。
API詳解
EventHub提供了三個主要方法：
-
on(event: string, callback: Function): void;
- 參數：
event: 事件名稱。callback: 回調函數。
- 說明：訂閱指定事件。
- 參數：
-
off(event: string, callback?: Function): void;
- 參數：
event: 事件名稱。callback(可選): 回調函數。
- 說明：取消訂閱事件。如果提供了回調函數，則取消該回調對指定事件的訂閱；否則取消所有回調對該事件的訂閱。
- 參數：
-
emit(event: string, …args: Object[]): void;
- 參數：
event: 事件名稱。...args: 可變參數。
- 說明：觸發指定事件，并可傳遞參數給訂閱該事件的回調函數。
- 參數：
實戰案例：組件間通信
以下是一個更復雜的實戰案例，展示了父組件和子組件之間的通信：
@Entry
@Component
struct ParentComponent {@State message: string = ""aboutToAppear(): void {// 訂閱事件getContext().eventHub.on("childEvent", (data: string) => {this.message = data})}aboutToDisappear(): void {// 取消訂閱事件getContext().eventHub.off("childEvent")}build() {Column() {Text(this.message)ChildComponent()}}
}@Component
struct ChildComponent {@State count: number = 0build() {Button("通知父組件").onClick(() => {this.count++// 觸發事件并發送參數getContext().eventHub.emit("childEvent", `點擊次數: ${this.count}`)})}
}
在這個例子中，ChildComponent中的按鈕每次被點擊時會觸發childEvent事件，并將點擊次數傳遞給ParentComponent。ParentComponent訂閱了該事件，并在事件觸發時更新message狀態并顯示在界面上。
最佳實踐
- 及時取消訂閱：在
aboutToDisappear生命周期中取消訂閱，避免內存泄漏。 - 命名規范化：使用常量定義事件名，避免硬編碼錯誤。
- 參數設計：合理設計事件參數結構，保持接口簡潔。
- 單一職責：每個事件應只處理單一業務邏輯，確保代碼的清晰和可維護性。
適用場景
- 跨多級組件通信：適用于多層嵌套組件間的通信。
- 狀態變更通知：用于通知組件狀態的變化。
- 數據回傳：從子組件向父組件回傳數據。
- 松耦合的模塊交互：實現模塊間的松耦合通信。
總結
EventHub以其簡潔的API和高效的通信機制，成為鴻蒙應用開發中組件通信的首選方案。通過EventHub，開發者可以輕松地實現跨組件的數據傳遞和狀態通知，提升應用的開發效率和用戶體驗。
