在Guice中,注入方式有如下几种:
一、构造器注入(Constructor Injection)
使用构造器注入只要在构造方法上添加一个
@Inject
注解,该构造方法接收一些依赖参数,大多数的构造方法将这些参数赋值给
final
字段。
public class RealBillingService implements BillingService {private final CreditCardProcessor processorProvider;private final TransactionLog transactionLogProvider;@Injectpublic 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;@Injectpublic 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.*/@Deprecatedpublic static Processor getInstance() {return processorProvider.get();}}
文档中说静态成员在使用实例注入(instance-injection)时无效,但经本人测试实例注正常,不论是静态成员还是实例成员。
但这个API已经不被建议使用,因为它存在很多静态工厂类似问题:难于测试,使依赖透明化,依赖于全局状态等。
七、自动注入(Automatic Injection)
以下情形Guice会进行自动注入:
a. 传递给
toInstance()
语句的实例
b. 传递
toProvider()
语句的
Provider
对象,这些对象会在注入器创建时进行注入
——————————– END ——————————-
及时获取更多精彩文章,请关注公众号《Java精讲》。