在Guice中,注入方式有如下几种:
一、构造器注入(Constructor Injection)
使用构造器注入只要在构造方法上添加一个@Inject
注解,该构造方法接收一些依赖参数,大多数的构造方法将这些参数赋值给final
字段。
public class RealBillingService implements BillingService {
private final CreditCardProcessor processorProvider;
private final TransactionLog transactionLogProvider;
@Inject
public RealBillingService(CreditCardProcessor processorProvider,
TransactionLog transactionLogProvider) {
this.processorProvider = processorProvider;
this.transactionLogProvider = transactionLogProvider;
}
}
如果有一个类没有添加了@Inject
注解的构造方法,那么Guice使用一个public
的、没有参数的构造方法,如果该构造方法存在的话。
构造器依赖易于单元测试,如果你类在一个唯一的构造方法中接收所有参数,这样你就不会忘记去设置依赖。当一个新的依赖产生了,所有的调用代码很容易修改,更正掉编译错误你就完事大吉了。
二、方法注入(Method Injection)
Guice可以通过冠以@Inject
注解的访求进行注入。依赖采用参数的形式,在调用方法之前注入器会解析依赖。被注入方法可以有任意多的参数,并且方法名称不会影响注入。
public class PayPalCreditCardProcessor implements CreditCardProcessor {
private static final String DEFAULT_API_KEY = "development-use-only";
private String apiKey = DEFAULT_API_KEY;
@Inject
public void setApiKey(@Named("PayPal API key") String apiKey) {//该方法会被Guice调用并注入值
this.apiKey = apiKey;
}
}
三、字段注入(Field Injection)
Guice可以通过冠以@Inject
注解的字段进行注入,这是最简洁的注入方式,但是却最不利于测试。示例:
public class DatabaseTransactionLogProvider implements Provider<TransactionLog> {
@Inject Connection connection;
public TransactionLog get() {
return new DatabaseTransactionLog(connection);
}
}
四、可选注入(Optional Injections)
有的时候需要一个依赖对象存在则进行注入,如果不存在则不进行注入,这样是比较方便的。方法与字段注入可以是可选的,这样当依赖对象不可用的时候Guice就会忽略这些注入。要使用可能的注入,使用@Inject(optional=true)
注解。
public class PayPalCreditCardProcessor implements CreditCardProcessor {
private static final String SANDBOX_API_KEY = "development-use-only";
private String apiKey = SANDBOX_API_KEY;
@Inject(optional=true)
public void setApiKey(@Named("PayPal API key") String apiKey) {
this.apiKey = apiKey;
}
}
当可选注入与及时绑定混在一起时,你可能会得到一个让你意外的结果。例如,如下字段总是会进行注入即使Date
对象没有显示地进行绑定。但是Date
类有一个公开的无参数构造方法,这就符合及时绑定条件。
@Inject(optional=true) Date launchDate;//launchDate依赖会进行注入
五、请求式注入(On-demand Injection)
方法与字段注入可以用于初始化实例对象,使用Injector.injectMembers
:
public static void main(String[] args) {
Injector injector = Guice.createInjector(...);
CreditCardProcessor creditCardProcessor = new PayPalCreditCardProcessor();//手动创建而不是从容器中获取
injector.injectMembers(creditCardProcessor);//会为creditCardProcessor中需要注入的成员进行注入
}
六、静态注入
当一个应用从静态工厂迁移到Guice上来时,静态注入就是一有效手段。在Module
类中使用requestStaticInjection()
方法,这样就可能对类中冠以@Inject
注解的静态字段进行注入。
@Override public void configure() {
requestStaticInjection(ProcessorFactory.class);
...
}
class ProcessorFactory {
@Inject static Provider<Processor> processorProvider;
/**
* @deprecated prefer to inject your processor instead.
*/
@Deprecated
public static Processor getInstance() {
return processorProvider.get();
}
}
文档中说静态成员在使用实例注入(instance-injection)时无效,但经本人测试实例注正常,不论是静态成员还是实例成员。
但这个API已经不被建议使用,因为它存在很多静态工厂类似问题:难于测试,使依赖透明化,依赖于全局状态等。
七、自动注入(Automatic Injection)
以下情形Guice会进行自动注入:
a. 传递给toInstance()
语句的实例
b. 传递toProvider()
语句的Provider
对象,这些对象会在注入器创建时进行注入
-------------------------------- END -------------------------------
及时获取更多精彩文章,请关注公众号《Java精讲》。