Dagger2---用户引导（翻译）

原文链接：http://google.github.io/dagger/users-guide.html
从Why Dagger 2 is Different 开始翻译。

为什么Dagger2是不同的

依赖注入的框架在几年前就已经存在了，有许多中API实现了依赖和注入。为什么要重复造轮子呢？Dagger2是第一个实现了全部代码生成。它的目标原则是模仿用户那些手写的代码（实现依赖注入的代码）使依赖注入的过程实现起来更加简单。

使用Dagger2

我们将通过CoffeeMaker的例子证明Dagger的依赖注入。已经完成的代码可以从coffee example查看，并进行编译和运行。

声明依赖

使用Dagger为你的应用类构造实例，并且满足它们的依赖。Dagger使用 javax.inject.Inject
注解标明哪些构造方法和参数是需要注解的。
使用@Inject注解一个构造方法表示应该用Dagger为这个类创建一个实例。当一个请求为该对象创建一个新的实例时，Dagger会获得请求的参数值然后执行该构造方法。

class Thermosiphon implements Pump { 
     private final Heater heater;
     @Inject 
     Thermosiphon(Heater heater) { 
         this.heater = heater; 
     }
 ...
}

Dagger也可以直接注解参数，在这个例子中将为一个heater对象获得一个 Heater实例，为pump对象获得一个Pump实例。

class CoffeeMaker { 
@Inject 
Heater heater; 
@Inject
Pump pump;
 ...}

如果你用@inject标注了参数，但没有用@inject标注方法。当有请求到这些参数的时候，Dagger会为这些对象提供注入，但不会为他们创建实例。用@inject标注一个无参的构造函数，以表明Dagger也可以创建一个实例。
Dagger同样也支持方法的注入，尽管通常情况下优先考虑的是参数和构造方法。
如果一个类缺乏@Inject是不能通过Dagger构建的

满意的依赖

默认情况下，Dagger通过构造请求类型对象的实例满足每一个依赖。像上面描述（例子）的那样，当你请求（需要）一个CoffeeMaker对象，你将通过调用new Caffee（）对象获得一个对象，注入到可以注入的参数中。
但是@Inject不是任何对象都可以标记的

• interface是不能被构建的
• 第三方的类不能被注解
• 通过配置得到的对象，仍然必须通过配置得到（Builder模式构造的对象）

在这些情况下，@Inject是不足的（尴尬的），但是可以通过使用@Provide注解标注的方法来满足依赖，这个方法的返回值的来满足那些依赖。

就像下面这样：当需要一个Heater对象时provideHeater(）方法会被执行。

@Provides 
static Heater provideHeater() { 
    return new ElectricHeater();
}

@Provides同样可以为它自己提供依赖，当我们需要一个Pump对象时，下面这个例子返回一个Thermosiphon对象时

@Provides 
static Pump providePump(Thermosiphon pump) {
  return pump;
}

所有被标注了@Provides注解的方法必须要属于一个module类（模块），这仅仅需要一个类被@module注解标注。

@Module
class DripCoffeeModule { 
@Provides
 static Heater provideHeater() { 
    return new ElectricHeater();
 } 
@Provides 
static Pump providePump(Thermosiphon pump) {
    return pump; 
 }
}

注：通常@Provides标注的方法名都拥有provide前缀，@Module标注的类都有一个叫做Module的后缀。

构建对象关系图

@Inject注解和@Provides注解类由他们之间的依赖关系形成了对关系的图，通过一组定义好的关系图调用代码就像使用应用程序的main方法或者Android的应用程序访问。它的定义是通过一个接口：具备无参的方法和需要的返回值类型。通过使用@component注解去标注这样一个接口和通过module参数去配置module类型，Dagger2随后会生成一个符合的实现。

@Component(modules = DripCoffeeModule.class)
interface CoffeeShop { 
   CoffeeMaker maker();
}

Dagger2会自动为它生成实现类，实现的名字是具有Dagger的前缀加上接口的名称。通过使用builder方法获得实例。调用Builder方法配置依赖，调用build方法获得实例。

CoffeeShop coffeeShop = DaggerCoffeeShop.builder() .dripCoffeeModule(new DripCoffeeModule()) .build();