Dagger2 知識梳理(4) @Scope 註解的使用

時間  2019-11-21
標籤 dagger2 dagger 知識 梳理 scope 註解 使用 简体版
原文   原文鏈接

1、前言

對於@Scope註解，不少同窗都疑惑，今天咱們就來了解一下@Scope相關的知識，這裏將會分爲兩部分介紹：java

  • 單個Component狀況下@Scope的做用
  • 組織多個Component狀況下對於@Scope的限制

首先，咱們須要瞭解@Scope實際上是一個 元註解，它和咱們在 Dagger2 知識梳理(2) - @Qulifier 和 @Named 解決依賴注入迷失 一文中介紹的@Qualifier同樣，是用於 描述註解的註解，關於元註解更多的知識能夠參考以前的這篇文章 Java&Android 基礎知識梳理(1) - 註解。git

@Scope所描述的註解用於兩個地方：github

  • Component類
  • Module中用於建立實例的provideXXX方法

而咱們常常看見的@Singleton註解其實就是用@Scope描述的註解，雖然它的表面意思是「單例」，可是咱們後面會看到它和單例其實並無必然的關係。ide

2、單個 Component 狀況下 @Scope 的使用

@Scope描述的註解相似於下面這樣，這裏的PerScopeActivity就是用@Scope描述的註解：ui

@Documented
@Retention(RUNTIME)
@Scope
public @interface PerScopeActivity {}
複製代碼

有可能會用到該註解的有兩個地方：this

  • Component類
@Component(dependencies = {ScopeAppComponent.class}, modules = {ScopeActivityModule.class})
@PerScopeActivity
public interface ScopeActivityComponent {
    public void inject(ScopeActivity scopeActivity);
    ScopeFragmentComponent scopeFragmentComponent();
}
複製代碼
  • Module中用於建立實例的provideXXX方法
@Module
public class ScopeActivityModule {

    @Provides
    @PerScopeActivity
    public ScopeActivitySharedData provideScopeActivityData() {
        return new ScopeActivitySharedData();
    }

    @Provides
    public ScopeActivityNormalData provideScopeActivityNormalData() {
        return new ScopeActivityNormalData();
    }
}
複製代碼

在單個Component狀況下使用@Scope有如下幾點說明：spa

  • 若是在Module的provideXXX方法上加上了@Scope聲明，那麼在與他關聯的Component上也必須加上相同的@Scope聲明
  • 若是Component加上了@Scope聲明，provideXXX，那麼和Component不加聲明的狀況相同。
  • 當Module的provideXXX方法和Component都加上了@Scope聲明，那麼在Component實例的生命週期內，只會建立一個由provideXXX方法返回的實例。也就是說，該Component會持有以前經過provideXXX方法建立的實例的引用，若是以前建立過，那麼就再也不調用Module的provideXXX去建立新的實例，而是直接返回它以前持有的那一份。

上面的例子中，咱們經過ScopeActivityModule建立了兩種類型的數據，provideScopeActivityData()方法上加上了@PerScopeActivity，而提供ScopeActivityNormalData的provideScopeActivityNormalData()方法則沒有，後面咱們將會看到，若是在目標類中使用同一個ScopeActivityComponent注入，而有多個ScopeActivitySharedData變量的狀況下它們指向的是同一塊內存地址，而ScopeActivityNormalData則會指向不一樣的內存地址。3d

3、組織多個 Component 狀況下對於 @Scope 的限制

對於單個Component還比較好理解，可是在組織多個Component的狀況下就有些複雜了，這裏的「組織」就是咱們在前一篇 Dagger2 知識梳理(3) - 使用 dependencies 和 @SubComponent 完成依賴注入 談到的 依賴方式 和 繼承方式。code

  • 在依賴或者繼承的組織方式中，若是其中一個Component聲明瞭@Scope，那麼其它的Component也須要聲明。
  • 在依賴關係中，被依賴的Component和須要依賴的Component的@Scope不能相同
  • 在依賴關係中，須要依賴的Component的@Scope不能夠爲@Singleton。
  • 在組織關係中，子Component的@Scope不能夠和父Component的@Scope相同：
  • 在組織關係中，若是父Component的@Scope不爲@Singleton，那麼子Component的@Scope能夠爲@Singleton。

這些限制是由Dagger2在編譯時去檢查的，其目的是保證使用者不要對@Scope產生濫用的現象，由於@Scope的目的是 在特定做用域內控制被注入實例的複用。component

4、示例

爲了讓你們更好的驗證上面關於@Scope的解釋，下面用一個Demo來演示，完整代碼能夠從 Dagger2Sample 的第四章獲取，這個Demo包括三個大部分：

(1) ScopeApp

對應於咱們平時的Application類，並提供了全局的ScopeAppData類，在其ScopeAppComponent上有@Singleton註解。

@Singleton
@Component(modules = {ScopeAppModule.class})
public interface ScopeAppComponent {
    public ScopeAppData getScopeAppData(); //若是它被其它的Component依賴，那麼須要聲明getXXX方法。
}
複製代碼
@Module
public class ScopeAppModule {

    @Provides
    @Singleton
    public ScopeAppData provideScopeAppData() {
        return new ScopeAppData();
    }
}
複製代碼

(2) ScopeActivity

對應於一個主頁面，其內部包含了ScopeActivitySharedData和ScopeActivityNormalData，前者在ScopeActivityComponent的生命週期內保持惟一性，並帶有PerScopeActivity註解。

@Component(dependencies = {ScopeAppComponent.class}, modules = {ScopeActivityModule.class})
@PerScopeActivity
public interface ScopeActivityComponent {
    public void inject(ScopeActivity scopeActivity);
    ScopeFragmentComponent scopeFragmentComponent();
}
複製代碼
@Module
public class ScopeActivityModule {

    @Provides
    @PerScopeActivity
    public ScopeActivitySharedData provideScopeActivityData() {
        return new ScopeActivitySharedData();
    }

    @Provides
    public ScopeActivityNormalData provideScopeActivityNormalData() {
        return new ScopeActivityNormalData();
    }
}
複製代碼

(3) ScopeFragment

對於於Activity下的一個子界面，它和ScopeActivityComponent是繼承關係，並帶有@PerScopeFragment註解：

@Subcomponent(modules = {ScopeFragmentModule.class})
@PerScopeFragment
public interface ScopeFragmentComponent {
    public void inject(ScopeFragment scopeFragment);
}
複製代碼
@Module
public class ScopeFragmentModule {

    @Provides
    @PerScopeFragment
    public ScopeFragmentData provideScopeFragmentData() {
        return new ScopeFragmentData();
    }
}
複製代碼

以上三個部分的關係爲：

  • ScopeActivityComponent依賴於ScopeAppComponent
  • ScopeFragmentComponent繼承於ScopeActivityComponent
  • 它們的Module上都有用@Scope描述的註解：@Singleton、@PerScopeActivity，@PerScopeFragment。

示例驗證

經過這個例子能夠覆蓋到上面咱們介紹的全部場景，你們能夠直接在Github上查看，也能夠clone下來，進行修改驗證。

在Activity和Fragment中，咱們打印出變量的地址來驗證前面的結論：

  • App
public class ScopeApp extends Application {

    private ScopeAppComponent mScopeAppComponent;

    @Override
    public void onCreate() {
        super.onCreate();
        mScopeAppComponent = DaggerScopeAppComponent.builder().scopeAppModule(new ScopeAppModule()).build();
    }

    public ScopeAppComponent getAppComponent() {
        return mScopeAppComponent;
    }
}
複製代碼
  • Activity類
public class ScopeActivity extends AppCompatActivity {

    private static final String TAG = ScopeActivity.class.getSimpleName();

    private ScopeActivityComponent mScopeActivityComponent;

    @Inject
    ScopeAppData mScopeAppData;

    @Inject
    ScopeActivitySharedData mScopeActivitySharedData1;

    @Inject
    ScopeActivitySharedData mScopeActivitySharedData2;

    @Inject
    ScopeActivityNormalData mScopeActivityNormalData1;

    @Inject
    ScopeActivityNormalData mScopeActivityNormalData2;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_scope);
        getScopeActivityComponent().inject(this);
        TextView tvData = (TextView) findViewById(R.id.tv_scope_activity);
        String result = "[ScopeActivity Space] \n mScopeAppData=" + mScopeAppData
                + "\n\n" + "mScopeActivitySharedData1=" + mScopeActivitySharedData1
                + "\n\n" + "mScopeActivitySharedData2=" + mScopeActivitySharedData2
                + "\n\n" + "mScopeActivityNormalData1=" + mScopeActivityNormalData1
                + "\n\n" + "mScopeActivityNormalData2=" + mScopeActivityNormalData2;
        tvData.setText(result);
    }

    public ScopeActivityComponent getScopeActivityComponent() {
        if (mScopeActivityComponent == null) {
            ScopeAppComponent scopeAppComponent = ((ScopeApp) getApplication()).getAppComponent();
            mScopeActivityComponent = DaggerScopeActivityComponent.builder().scopeAppComponent(scopeAppComponent).build();
        }
        return mScopeActivityComponent;
    }
}
複製代碼
  • Fragment類
public class ScopeFragment extends Fragment {

    private ScopeActivity mScopeActivity;

    @Inject
    ScopeAppData mScopeAppData;

    @Inject
    ScopeActivitySharedData mScopeActivitySharedData;

    @Inject
    ScopeActivityNormalData ScopeActivityNormalData;

    @Inject
    ScopeFragmentData mScopeFragmentData;

    @Override
    public void onAttach(Context context) {
        super.onAttach(context);
        mScopeActivity = (ScopeActivity) context;
    }

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, Bundle savedInstanceState) {
        View rootView = inflater.inflate(R.layout.fragment_scope, container, false);
        mScopeActivity.getScopeActivityComponent().scopeFragmentComponent().inject(this);
        TextView tv = (TextView) rootView.findViewById(R.id.tv_scope_fragment);
        String result = "[ScopeFragment Space] \n mScopeAppData=" + mScopeAppData
                + "\n\n" + "mScopeActivitySharedData1=" + mScopeActivitySharedData
                + "\n\n" + "ScopeActivityNormalData=" + ScopeActivityNormalData
                + "\n\n" + "mScopeFragmentData=" + mScopeFragmentData;
        tv.setText(result);
        return rootView;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
    }
}
複製代碼

結果爲：

由上面例子中的現象，能夠總結出如下幾點：

  • ScopeAppData：該數據是由ScopeAppModule提供的，而它加上了@Singleton註解，而且咱們調用的是同一個對象，所以在Activity和Fragment中地址相同。
  • ScopeActivitySharedData：在它的provide方法上，咱們加上了@PerScopeActivity註解，所以在Activity和Fragment中，它的地址相同。
  • ScopeActivityNormalData：雖然在提供它的ScopeActivityModule中加上了@PerScopeActivity註解，可是在provide方法上沒有聲明，所以不管是在Activity，仍是在Fragment中，都是指向不一樣的地址。
  • ScopeFragmentData：用於演示如何經過繼承的方式，來實現依賴注入。

更多文章，歡迎訪問個人 Android 知識梳理系列：

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程