Dependency Injection 一歩目

3173827605_427626c6af-1

話題でした.

「なぜDI(依存性注入)が必要なのか?」についてGoogleが解説しているページを翻訳した  - Qiita

これを幼稚に理解しておこうかとな.

 

「Dependency Injection」という言葉

「依存性注入」てのがしっくりこないので少し調べてみる.

「オブジェクトを注入する」と言うと日本語としても意味がはっきりしていますね。

「Dependency」は「依存性」ではなく「使われる側のオブジェクト」(依存オブジェクト)という意味になります。

やはりあなた方のDependency Injectionはまちがっている。 — A Day in Serenity

「外部オブジェクトの注入」と覚えたら直感的にわかりやすいですよね.

 

修正前/後のコードを比べてみる

修正前.

メソッド内で外部オブジェクトを生成している.


public class RealBillingService implements BillingService { 

  public Receipt chargeOrder(PizzaOrder order, CreditCard creditCard) {
    CreditCardProcessor processor = new PaypalCreditCardProcessor();
    TransactionLog transactionLog = new DatabaseTransactionLog();
    // ...
  }

}

修正後.

外部オブジェクトを外部で生成してコンストラクタから注入している.


public class RealBillingService implements BillingService {

  private final CreditCardProcessor processor;
  private final TransactionLog transactionLog;

  public RealBillingService(CreditCardProcessor processor,TransactionLog transactionLog) {
    this.processor = processor;
    this.transactionLog = transactionLog;
  }

  public Receipt chargeOrder(PizzaOrder order, CreditCard creditCard) {
     // ...
  }
}

これをテスト時には, メンバ初期化で生成したオブジェクトを各メソッド内でコンストラクタから注入して利用する.


public class RealBillingServiceTest extends TestCase {

  private final PizzaOrder order = new PizzaOrder(100);
  private final CreditCard creditCard = new CreditCard("1234", 11, 2010);

  private final InMemoryTransactionLog transactionLog = new InMemoryTransactionLog();
  private final FakeCreditCardProcessor processor = new FakeCreditCardProcessor();

  public void testSuccessfulCharge() {
    RealBillingService billingService
        = new RealBillingService(processor, transactionLog);
    Receipt receipt = billingService.chargeOrder(order, creditCard);

    // assert etc...
  }

}

 

例) データ抽出先のサーバを切り替える

Repository クラスに, RemoteDataSource オブジェクトを注入しておいてテスト時には切り替えます.

それぞれのインスタンスは Singleton によって一意であることを保証しています.

公開用コード.
android-architecture/Injection.java at todo-mvp · googlesamples/android-architecture


public class Injection {

    public static TasksRepository provideTasksRepository(@NonNull Context context) {
        checkNotNull(context);
        return TasksRepository.getInstance(TasksRemoteDataSource.getInstance(),
                TasksLocalDataSource.getInstance(context));
    }
}

テスト用コード.
android-architecture/Injection.java at todo-mvp · googlesamples/android-architecture


public class Injection {

    public static TasksRepository provideTasksRepository(@NonNull Context context) {
        checkNotNull(context);
        return TasksRepository.getInstance(FakeTasksRemoteDataSource.getInstance(),
                TasksLocalDataSource.getInstance(context));
    }
}

外部オブジェクトの変更が容易になっていることがよくわかります.

注入の方法は他にもあるようですがまあいいか.

 

まとめ

メソッド外で生成してコンストラクタから注入する.
(メソッド内で生成しない)


関連ワード:  Android今さら聞けない開発