3、线程通信EventHandler使用

作者：韩茹

公司：程序咖（北京）科技有限公司

鸿蒙巴士专栏作家

一、使用场景

EventHandler开发场景

EventHandler的主要功能是将InnerEvent事件或者Runnable任务投递到其他的线程进行处理，其使用的场景包括：

• 开发者需要将InnerEvent事件投递到新的线程，按照优先级和延时进行处理。投递时，EventHandler的优先级可在IMMEDIATE、HIGH、LOW、IDLE中选择，并设置合适的delayTime。
• 开发者需要将Runnable任务投递到新的线程，并按照优先级和延时进行处理。投递时，EventHandler的优先级可在IMMEDIATE、HIGH、LOW、IDLE中选择，并设置合适的delayTime。
• 开发者需要在新创建的线程里投递事件到原线程进行处理。

EventRunner工作模式

EventRunner的工作模式可以分为托管模式和手动模式。两种模式是在调用EventRunner的create()方法时，通过选择不同的参数来实现的，详见API参考。默认为托管模式。

• 托管模式：不需要开发者调用run()和stop()方法去启动和停止EventRunner。当EventRunner实例化时，系统调用run()来启动EventRunner；当EventRunner不被引用时，系统调用stop()来停止EventRunner。
• 手动模式：需要开发者自行调用EventRunner的run()方法和stop()方法来确保线程的启动和停止。

二、EventHandler

EventHandler，允许在异步线程上发送和处理InnerEvent和Runnable对象。每个EventHandler实例都绑定一个线程，该线程有一个事件队列。线程周期性地从事件队列中检索事件，并将事件分派给EventHandler进行处理。EventHandler将事件或Runnable任务传递到线程的事件队列，并在事件或任务从事件队列中出来时执行它。

您可以使用EventHandler在不同的线程之间调度和处理事件和Runnable 对象，并将事件或Runnable 对象安排在特定的时间间隔内进行处理。

您可以使用此类中提供的方法发送同步或异步事件、延迟事件处理以及设置事件优先级。

您需要重写processEvent（ohos.eventhandler.InnerEvent）方法来处理事件。

EventHandler类的定义：

java.lang.Object

|---ohos.eventhandler.EventHandler
public class EventHandler extends Object

EventHandler的属性Priority(优先级)介绍：

EventRunner将根据优先级的高低从事件队列中获取事件或者Runnable任务进行处理。

EventHandler的主要方法介绍：

三、EventRunner

EventRunner，在当前线程中创建和管理事件队列。

调用run()方法后，EventRunner将从事件队列中连续检索事件，并将事件分派给匹配的EventHandler。然后将调用EventHandler#processEvent（InnerEvent）方法来处理事件。

EventRunner类定义。

java.lang.Object

|---ohos.eventhandler.EventRunner

public final class EventRunner extends Object

EventRunner的主要方法介绍：

四、InnerEvent

InnerEvent，用于定义可以发送到EventHandler的事件的结构。

InnerEvent类的定义：

public final class InnerEvent
extends Object
implements Sequenceable

一个InnerEvent 对象，包含了一个额外的整数字段和一个额外的对象字段来携带特定数据。

InnerEvent的属性介绍：

InnerEvent的构造函数是私有的。因此，需要调用get()方法来创建InnerEvent实例。该方法将从回收对象池中提取InnerEvent实例。

常用方法：

更多方法请查看，官方API

五、流程逻辑

5.1 EventHandler投递InnerEvent事件

EventHandler投递InnerEvent事件，并按照优先级和延时进行处理，开发步骤如下：

1. 创建EventHandler的子类，在子类中重写实现方法processEvent()来处理事件。

	 private static final int EVENT_MESSAGE_NORMAL = 1;
   private static final int EVENT_MESSAGE_DELAY = 2;
   
   private class MyEventHandler extends EventHandler {
   
   
       private MyEventHandler(EventRunner runner) {
   
   
           super(runner);
       }
       // 重写实现processEvent方法
       @Override
       public void processEvent(InnerEvent event) {
   
   
           super.processEvent(event);
           if (event == null) {
   
   
               return;
           }
           int eventId = event.eventId;
           switch (eventId) {
   
   
               case EVENT_MESSAGE_NORMAL:
                   // 待执行的操作，由开发者定义
                   break;
               case EVENT_MESSAGE_DELAY:
                   // 待执行的操作，由开发者定义
                   break;
               default:
                   break;
           }
       }
   }

2. 创建EventRunner，以手动模式为例。

   EventRunner runner = EventRunner.create(false);// create()的参数是true时，则为托管模式

3. 创建EventHandler子类的实例。

MyEventHandler myHandler = new MyEventHandler(runner);

4. 获取InnerEvent事件。

   // 获取事件实例，其属性eventId, param, object由开发者确定，代码中只是示例。
   long param = 0L; 
   Object object = null; 
   InnerEvent normalInnerEvent = InnerEvent.get(EVENT_MESSAGE_NORMAL, param, object);
   InnerEvent delayInnerEvent = InnerEvent.get(EVENT_MESSAGE_DELAY, param, object);

5. 投递事件，投递的优先级以IMMEDIATE为例，延时选择0ms和2ms。

// 优先级IMMEDIATE，投递之后立即处理，延时为0ms，该语句等价于同步投递sendSyncEvent(event1，EventHandler.Priority.IMMEDIATE);
myHandler.sendEvent(normalInnerEvent, 0, EventHandler.Priority.IMMEDIATE);
myHandler.sendEvent(delayInnerEvent, 2, EventHandler.Priority.IMMEDIATE); // 延时2ms后立即处理

6. 启动和停止EventRunner，如果为托管模式，则不需要此步骤。

   runner.run();// 待执行操作runner.stop();// 开发者根据业务需要在适当时机停止EventRunner

5.2 EventHandler投递Runnable任务

EventHandler投递Runnable任务，并按照优先级和延时进行处理，开发步骤如下：

1. 创建EventHandler的子类，创建EventRunner，并创建EventHandler子类的实例，步骤与EventHandler投递InnerEvent场景的步骤1-3相同。

2. 创建Runnable任务。

   Runnable normalTask = new Runnable() {
   
   
       @Override
       public void run() {
   
   
           // 待执行的操作，由开发者定义
       }
   };
   Runnable delayTask = new Runnable() {
   
   
       @Override
       public void run() {
   
   
           // 待执行的操作