文章目錄

• 一、Subscribe 注解屬性
• 二、threadMode 線程模式 ( POSTING | MAIN | MAIN_ORDERED | BACKGROUND | ASYNC )

一、Subscribe 注解屬性

---

查看 Subscribe 注解的源碼 , 其中定義了 $3$ 個(gè)注解屬性 ;

threadMode 注解屬性 用于配置 線程模式 , 用于標(biāo)明執(zhí)行事件對(duì)應(yīng)的方法處于的線程類型 , 默認(rèn)是 ThreadMode.POSTING 類型 ;

sticky 注解屬性用于配置粘性事件 ;

priority 注解屬性用于配置事件處理的優(yōu)先級(jí) , 如果要處理的事件分先后順序時(shí) , 需要使用優(yōu)先級(jí)進(jìn)行配置 ;

package org.greenrobot.eventbus;import java.lang.annotation.Documented; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target;@Documented @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.METHOD}) public @interface Subscribe {ThreadMode threadMode() default ThreadMode.POSTING;/*** 如果為true，則將最近的粘性事件 (posted with* {@link EventBus#postSticky(Object)}) 傳遞到此訂閱服務(wù)器（如果事件可用）。*/boolean sticky() default false;/** 影響事件傳遞順序的訂戶優(yōu)先級(jí)。在同一傳遞線程（{@link ThreadMode}）中，* 優(yōu)先級(jí)較高的訂閱者將在其他優(yōu)先級(jí)較低的訂閱者之前接收事件。默認(rèn)優(yōu)先級(jí)為0。* 注意：優(yōu)先級(jí)*不*影響具有不同{@link ThreadMode}的訂閱服務(wù)器之間的傳遞順序！ */int priority() default 0; }

二、threadMode 線程模式 ( POSTING | MAIN | MAIN_ORDERED | BACKGROUND | ASYNC )

---

發(fā)布線程 : 調(diào)用 EventBus.getDefault().post() 發(fā)布消息的線程 ;

ThreadMode 線程模式 : 有 $5$ 個(gè)可設(shè)置項(xiàng) , POSTING , MAIN , MAIN_ORDERED , BACKGROUND , ASYNC ;

• POSTING 模式 : 默認(rèn)的最小開(kāi)銷處理方式 , 不進(jìn)行線程切換 , 在哪個(gè)線程發(fā)送事件 , 就在哪個(gè)線程處理事件 ;
  • 如果使用該模式 , 不要處理耗時(shí)事件 , 否則會(huì)長(zhǎng)時(shí)間阻塞發(fā)布事件的線程 ;
  • 主線程發(fā)布消息 : 在主線程執(zhí)行 ;
  • 子線程發(fā)布消息 : 在子線程執(zhí)行 ;
• MAIN 模式 : 在主線程處理事件 , 如果在子線程發(fā)送消息 , 處理消息時(shí)會(huì)將線程切換成主線程 ;
  • 如果發(fā)送事件的線程是 主線程 , 則立刻調(diào)用消息處理事件 , 此時(shí) 主線程會(huì)阻塞 ;
  • 如果發(fā)送事件的線程是 子線程 , 事件在隊(duì)列中排隊(duì)等待傳遞 , 不會(huì)阻塞發(fā)布線程 ;
• MAIN_ORDERED 模式 : 在主線程處理事件 ; 不管是在主線程還是在子線程發(fā)布事件 , 事件都在隊(duì)列中排隊(duì)等待傳遞 , 都不會(huì)阻塞發(fā)布線程 ;
• BACKGROUND 模式 : 子線程模式 ;
  • 在 主線程 中發(fā)布事件 , 會(huì)將事件加入隊(duì)列中 , 然后 通過(guò)線程池執(zhí)行 ;
  • 在 子線程 中發(fā)布事件 , 直接在該線程中調(diào)用事件處理方法 , 會(huì)阻塞發(fā)布線程 ;
• ASYNC 模式 : 不管在哪個(gè)線程發(fā)布事件 , 都會(huì)將放入隊(duì)列 , 通過(guò)線程池執(zhí)行事件 ;

下面是 ThreadMode 的詳細(xì)源碼及注釋 :

package org.greenrobot.eventbus;/*** 每個(gè)訂戶方法都有一個(gè)線程模式，該模式確定EventBus將在哪個(gè)線程中調(diào)用該方法。* EventBus獨(dú)立于發(fā)布線程處理線程。** @see EventBus#register(Object)* @author Markus*/ public enum ThreadMode {/*** 訂閱服務(wù)器將在發(fā)布事件的同一線程中直接調(diào)用。* 這是默認(rèn)設(shè)置。* 事件傳遞意味著開(kāi)銷最小，因?yàn)樗耆苊饬司€程切換。* 因此，對(duì)于已知可以在很短時(shí)間內(nèi)完成而不需要主線程的簡(jiǎn)單任務(wù)，這是推薦的模式。* 使用此模式的事件處理程序必須快速返回，以避免阻塞發(fā)布線程（可能是主線程）。*/POSTING,/*** 在Android上，訂戶將在Android的主線程（UI線程）中被調(diào)用。* 如果發(fā)布線程是主線程，則將直接調(diào)用訂閱者方法，從而阻塞發(fā)布線程。* 否則，事件將排隊(duì)等待傳遞（非阻塞）。使用此模式的訂閱服務(wù)器必須快速返回以避免阻塞主線程。* 如果不在Android上，其行為與{@link#POSTING}相同。*/MAIN,/*** 在Android上，訂戶將在Android的主線程（UI線程）中被調(diào)用。* 與{@link#MAIN}不同，事件將始終排隊(duì)等待傳遞。這確保post調(diào)用是非阻塞的。*/MAIN_ORDERED,/*** 在Android上，訂閱者將在后臺(tái)線程中被調(diào)用。* 如果發(fā)布線程不是主線程，則將在發(fā)布線程中直接調(diào)用訂閱方方法。* 如果發(fā)布線程是主線程，EventBus將使用一個(gè)后臺(tái)線程，該線程將按順序傳遞其所有事件。* 使用此模式的訂閱者應(yīng)嘗試快速返回，以避免阻塞后臺(tái)線程。* 如果不在Android上，則始終使用后臺(tái)線程。*/BACKGROUND,/*** 訂戶將在單獨(dú)的線程中被調(diào)用。* 這始終獨(dú)立于發(fā)布線程和主線程。* 發(fā)布事件從不等待使用此模式的訂閱服務(wù)器方法。* 如果訂戶方法的執(zhí)行可能需要一些時(shí)間，例如網(wǎng)絡(luò)訪問(wèn)，則訂戶方法應(yīng)使用此模式。* 避免同時(shí)觸發(fā)大量長(zhǎng)時(shí)間運(yùn)行的異步訂閱服務(wù)器方法，以限制并發(fā)線程的數(shù)量。* EventBus使用線程池高效地重用已完成異步訂戶通知中的線程。*/ASYNC }

總結(jié)

以上是生活随笔為你收集整理的【EventBus】Subscribe 注解分析 ( Subscribe 注解属性 | threadMode 线程模型 | POSTING | MAIN | MAIN_ORDERED | ASYNC)的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。