【EventBus】Subscribe 注解分析 ( Subscribe 注解属性 | threadMode 线程模型 | POSTING | MAIN | MAIN_ORDERED | ASYNC)
生活随笔
收集整理的這篇文章主要介紹了
【EventBus】Subscribe 注解分析 ( Subscribe 注解属性 | threadMode 线程模型 | POSTING | MAIN | MAIN_ORDERED | ASYNC)
小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.
文章目錄
- 一、Subscribe 注解屬性
- 二、threadMode 線程模式 ( POSTING | MAIN | MAIN_ORDERED | BACKGROUND | ASYNC )
一、Subscribe 注解屬性
查看 Subscribe 注解的源碼 , 其中定義了 333 個注解屬性 ;
threadMode 注解屬性 用于配置 線程模式 , 用于標明執(zhí)行事件對應(yīng)的方法處于的線程類型 , 默認是 ThreadMode.POSTING 類型 ;
sticky 注解屬性用于配置粘性事件 ;
priority 注解屬性用于配置事件處理的優(yōu)先級 , 如果要處理的事件分先后順序時 , 需要使用優(yōu)先級進行配置 ;
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)先級。在同一傳遞線程({@link ThreadMode})中,* 優(yōu)先級較高的訂閱者將在其他優(yōu)先級較低的訂閱者之前接收事件。默認優(yōu)先級為0。* 注意:優(yōu)先級*不*影響具有不同{@link ThreadMode}的訂閱服務(wù)器之間的傳遞順序! */int priority() default 0; }二、threadMode 線程模式 ( POSTING | MAIN | MAIN_ORDERED | BACKGROUND | ASYNC )
發(fā)布線程 : 調(diào)用 EventBus.getDefault().post() 發(fā)布消息的線程 ;
ThreadMode 線程模式 : 有 555 個可設(shè)置項 , POSTING , MAIN , MAIN_ORDERED , BACKGROUND , ASYNC ;
- POSTING 模式 : 默認的最小開銷處理方式 , 不進行線程切換 , 在哪個線程發(fā)送事件 , 就在哪個線程處理事件 ;
- 如果使用該模式 , 不要處理耗時事件 , 否則會長時間阻塞發(fā)布事件的線程 ;
- 主線程發(fā)布消息 : 在主線程執(zhí)行 ;
- 子線程發(fā)布消息 : 在子線程執(zhí)行 ;
- MAIN 模式 : 在主線程處理事件 , 如果在子線程發(fā)送消息 , 處理消息時會將線程切換成主線程 ;
- 如果發(fā)送事件的線程是 主線程 , 則立刻調(diào)用消息處理事件 , 此時 主線程會阻塞 ;
- 如果發(fā)送事件的線程是 子線程 , 事件在隊列中排隊等待傳遞 , 不會阻塞發(fā)布線程 ;
- MAIN_ORDERED 模式 : 在主線程處理事件 ; 不管是在主線程還是在子線程發(fā)布事件 , 事件都在隊列中排隊等待傳遞 , 都不會阻塞發(fā)布線程 ;
- BACKGROUND 模式 : 子線程模式 ;
- 在 主線程 中發(fā)布事件 , 會將事件加入隊列中 , 然后 通過線程池執(zhí)行 ;
- 在 子線程 中發(fā)布事件 , 直接在該線程中調(diào)用事件處理方法 , 會阻塞發(fā)布線程 ;
- ASYNC 模式 : 不管在哪個線程發(fā)布事件 , 都會將放入隊列 , 通過線程池執(zhí)行事件 ;
下面是 ThreadMode 的詳細源碼及注釋 :
package org.greenrobot.eventbus;/*** 每個訂戶方法都有一個線程模式,該模式確定EventBus將在哪個線程中調(diào)用該方法。* EventBus獨立于發(fā)布線程處理線程。** @see EventBus#register(Object)* @author Markus*/ public enum ThreadMode {/*** 訂閱服務(wù)器將在發(fā)布事件的同一線程中直接調(diào)用。* 這是默認設(shè)置。* 事件傳遞意味著開銷最小,因為它完全避免了線程切換。* 因此,對于已知可以在很短時間內(nèi)完成而不需要主線程的簡單任務(wù),這是推薦的模式。* 使用此模式的事件處理程序必須快速返回,以避免阻塞發(fā)布線程(可能是主線程)。*/POSTING,/*** 在Android上,訂戶將在Android的主線程(UI線程)中被調(diào)用。* 如果發(fā)布線程是主線程,則將直接調(diào)用訂閱者方法,從而阻塞發(fā)布線程。* 否則,事件將排隊等待傳遞(非阻塞)。使用此模式的訂閱服務(wù)器必須快速返回以避免阻塞主線程。* 如果不在Android上,其行為與{@link#POSTING}相同。*/MAIN,/*** 在Android上,訂戶將在Android的主線程(UI線程)中被調(diào)用。* 與{@link#MAIN}不同,事件將始終排隊等待傳遞。這確保post調(diào)用是非阻塞的。*/MAIN_ORDERED,/*** 在Android上,訂閱者將在后臺線程中被調(diào)用。* 如果發(fā)布線程不是主線程,則將在發(fā)布線程中直接調(diào)用訂閱方方法。* 如果發(fā)布線程是主線程,EventBus將使用一個后臺線程,該線程將按順序傳遞其所有事件。* 使用此模式的訂閱者應(yīng)嘗試快速返回,以避免阻塞后臺線程。* 如果不在Android上,則始終使用后臺線程。*/BACKGROUND,/*** 訂戶將在單獨的線程中被調(diào)用。* 這始終獨立于發(fā)布線程和主線程。* 發(fā)布事件從不等待使用此模式的訂閱服務(wù)器方法。* 如果訂戶方法的執(zhí)行可能需要一些時間,例如網(wǎng)絡(luò)訪問,則訂戶方法應(yīng)使用此模式。* 避免同時觸發(fā)大量長時間運行的異步訂閱服務(wù)器方法,以限制并發(fā)線程的數(shù)量。* EventBus使用線程池高效地重用已完成異步訂戶通知中的線程。*/ASYNC }總結(jié)
以上是生活随笔為你收集整理的【EventBus】Subscribe 注解分析 ( Subscribe 注解属性 | threadMode 线程模型 | POSTING | MAIN | MAIN_ORDERED | ASYNC)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 【EventBus】EventBus 使
- 下一篇: 【EventBus】发布-订阅模式 (