搜索

Google 开源的依赖注入库，比 Spring 更小更快！

开发者全社区

共 11600字，需浏览 24分钟

 ·

2021-02-05 21:21


作者：GinoBeFunny

来源：zhuanlan.zhihu.com/p/24924391

Guice是Google开源的一个依赖注入类库，相比于Spring IoC来说更小更快。Elasticsearch大量使用了Guice，本文简单的介绍下Guice的基本概念和使用方式。

学习目标

1、概述：了解Guice是什么，有什么特点；
2、快速开始：通过实例了解Guice；
3、核心概念：了解Guice涉及的核心概念，如绑定（Binding）、范围（Scope）和注入（Injection）；
4、最佳实践：官方推荐的最佳实践；

Guice概述

1、Guice是Google开源的依赖注入类库，通过Guice减少了对工厂方法和new的使用，使得代码更易交付、测试和重用；
2、Guice可以帮助我们更好地设计API，它是个轻量级非侵入式的类库；
3、Guice对开发友好，当有异常发生时能提供更多有用的信息用于分析；

快速开始

假设一个在线预订Pizza的网站，其有一个计费服务接口：

  1. publicinterfaceBillingService{

  3. /**
  4.   * 通过信用卡支付。无论支付成功与否都需要记录交易信息。
  5.   *
  6.   * @return 交易回执。支付成功时返回成功信息，否则记录失败原因。
  7.   */
  8. Receipt chargeOrder(PizzaOrder order, CreditCard creditCard);
  9. }

使用new的方式获取信用卡支付处理器和数据库交易日志记录器：

  1. publicclassRealBillingServiceimplementsBillingService{
  2. publicReceipt chargeOrder(PizzaOrder order, CreditCard creditCard) {
  3. CreditCardProcessor processor = newPaypalCreditCardProcessor();
  4. TransactionLog transactionLog = newDatabaseTransactionLog();

  6. try{
  7. ChargeResult result = processor.charge(creditCard, order.getAmount());
  8.       transactionLog.logChargeResult(result);

  10. return result.wasSuccessful()
  11. ? Receipt.forSuccessfulCharge(order.getAmount())
  12. : Receipt.forDeclinedCharge(result.getDeclineMessage());
  13. } catch(UnreachableException e) {
  14.       transactionLog.logConnectException(e);
  15. returnReceipt.forSystemFailure(e.getMessage());
  16. }
  17. }
  18. }

使用new的问题是使得代码耦合，不易维护和测试。比如在UT里不可能直接用真实的信用卡支付，需要Mock一个CreditCardProcessor。相比于new，更容易想到的改进是使用工厂方法，但是工厂方法在测试中仍存在问题（因为通常使用全局变量来保存实例，如果在用例中未重置可能会影响其他用例）

更好的方式是通过构造方法注入依赖：

  1. publicclassRealBillingServiceimplementsBillingService{
  2. privatefinalCreditCardProcessor processor;
  3. privatefinalTransactionLog transactionLog;

  5. publicRealBillingService(CreditCardProcessor processor, 
  6. TransactionLog transactionLog) {
  7. this.processor = processor;
  8. this.transactionLog = transactionLog;
  9. }

  11. publicReceipt chargeOrder(PizzaOrder order, CreditCard creditCard) {
  12. try{
  13. ChargeResult result = processor.charge(creditCard, order.getAmount());
  14.       transactionLog.logChargeResult(result);

  16. return result.wasSuccessful()
  17. ? Receipt.forSuccessfulCharge(order.getAmount())
  18. : Receipt.forDeclinedCharge(result.getDeclineMessage());
  19. } catch(UnreachableException e) {
  20.       transactionLog.logConnectException(e);
  21. returnReceipt.forSystemFailure(e.getMessage());
  22. }
  23. }
  24. }

对于真实的网站应用可以注入真正的业务处理服务类：

  1. publicstaticvoid main(String[] args) {
  2. CreditCardProcessor processor = newPaypalCreditCardProcessor();
  3. TransactionLog transactionLog = newDatabaseTransactionLog();
  4. BillingService billingService
  5. = newRealBillingService(processor, transactionLog);
  6. ...
  7.  }

而在测试用例中可以注入Mock类：

  1. publicclassRealBillingServiceTestextendsTestCase{

  3. privatefinalPizzaOrder order = newPizzaOrder(100);
  4. privatefinalCreditCard creditCard = newCreditCard("1234", 11, 2010);

  6. privatefinalInMemoryTransactionLog transactionLog = newInMemoryTransactionLog();
  7. privatefinalFakeCreditCardProcessor processor = newFakeCreditCardProcessor();

  9. publicvoid testSuccessfulCharge() {
  10. RealBillingService billingService
  11. = newRealBillingService(processor, transactionLog);
  12. Receipt receipt = billingService.chargeOrder(order, creditCard);

  14.     assertTrue(receipt.hasSuccessfulCharge());
  15.     assertEquals(100, receipt.getAmountOfCharge());
  16.     assertEquals(creditCard, processor.getCardOfOnlyCharge());
  17.     assertEquals(100, processor.getAmountOfOnlyCharge());
  18.     assertTrue(transactionLog.wasSuccessLogged());
  19. }
  20. }

那通过Guice怎么实现依赖注入呢？首先我们需要告诉Guice如果找到接口对应的实现类，这个可以通过模块来实现：

  1. publicclassBillingModuleextendsAbstractModule{
  2. @Override
  3. protectedvoid configure() {
  4.     bind(TransactionLog.class).to(DatabaseTransactionLog.class);
  5.     bind(CreditCardProcessor.class).to(PaypalCreditCardProcessor.class);
  6.     bind(BillingService.class).to(RealBillingService.class);
  7. }
  8. }

这里的模块只需要实现Module接口或继承自AbstractModule，然后在configure方法中设置绑定（后面会继续介绍）即可。

在公众号互联网架构师后台回复“2T”，获取Java面试题和答案惊喜礼包。

然后只需在原有的构造方法中增加@Inject注解即可注入：

  1. publicclassRealBillingServiceimplementsBillingService{
  2. privatefinalCreditCardProcessor processor;
  3. privatefinalTransactionLog transactionLog;

  5. @Inject
  6. publicRealBillingService(CreditCardProcessor processor,
  7. TransactionLog transactionLog) {
  8. this.processor = processor;
  9. this.transactionLog = transactionLog;
  10. }

  12. publicReceipt chargeOrder(PizzaOrder order, CreditCard creditCard) {
  13. try{
  14. ChargeResult result = processor.charge(creditCard, order.getAmount());
  15.       transactionLog.logChargeResult(result);

  17. return result.wasSuccessful()
  18. ? Receipt.forSuccessfulCharge(order.getAmount())
  19. : Receipt.forDeclinedCharge(result.getDeclineMessage());
  20. } catch(UnreachableException e) {
  21.       transactionLog.logConnectException(e);
  22. returnReceipt.forSystemFailure(e.getMessage());
  23. }
  24. }
  25. }

最后，再看看main方法中是如何调用的：

  1. publicstaticvoid main(String[] args) {
  2. Injector injector = Guice.createInjector(newBillingModule());
  3. BillingService billingService = injector.getInstance(BillingService.class);
  4. ...
  5. }

绑定

连接绑定

连接绑定是最常用的绑定方式，它将一个类型和它的实现进行映射。下面的例子中将TransactionLog接口映射到它的实现类DatabaseTransactionLog。

  1. publicclassBillingModuleextendsAbstractModule{
  2. @Override
  3. protectedvoid configure() {
  4.     bind(TransactionLog.class).to(DatabaseTransactionLog.class);
  5. }
  6. }

连接绑定还支持链式，比如下面的例子最终将TransactionLog接口映射到实现类MySqlDatabaseTransactionLog。

  1. publicclassBillingModuleextendsAbstractModule{
  2. @Override
  3. protectedvoid configure() {
  4.     bind(TransactionLog.class).to(DatabaseTransactionLog.class);
  5.     bind(DatabaseTransactionLog.class).to(MySqlDatabaseTransactionLog.class);
  6. }
  7. }

注解绑定

通过一个类型可能存在多个实现，比如在信用卡支付处理器中存在PayPal的支付和Google支付，这样通过连接绑定就搞不定。这时我们可以通过注解绑定来实现：

  1. @BindingAnnotation
  2. @Target({ FIELD, PARAMETER, METHOD }) 
  3. @Retention(RUNTIME)
  4. public@interfacePayPal{}

  6. publicclassRealBillingServiceimplementsBillingService{

  8. @Inject
  9. publicRealBillingService(@PayPalCreditCardProcessor processor,
  10. TransactionLog transactionLog) {
  11. ...
  12. }
  13. }

  15. // 当注入的方法参数存在@PayPal注解时注入PayPalCreditCardProcessor实现
  16. bind(CreditCardProcessor.class).annotatedWith(PayPal.class).to(PayPalCreditCardProcessor.class);

可以看到在模块的绑定时用annotatedWith方法指定具体的注解来进行绑定，这种方式有一个问题就是我们必须增加自定义的注解来绑定，基于此Guice内置了一个@Named注解满足该场景：

  1. publicclassRealBillingServiceimplementsBillingService{

  3. @Inject
  4. publicRealBillingService(@Named("Checkout") CreditCardProcessor processor,
  5. TransactionLog transactionLog) {
  6. ...
  7. }
  8. }

  10. // 当注入的方法参数存在@Named注解且值为Checkout时注入CheckoutCreditCardProcessor实现
  11. bind(CreditCardProcessor.class).annotatedWith(Names.named("Checkout")).to(CheckoutCreditCardProcessor.class);

实例绑定

将一个类型绑定到一个具体的实例而非实现类，这个通过是在无依赖的对象（比如值对象）中使用。如果toInstance包含复杂的逻辑会导致启动速度，此时应该通过@Provides方法绑定。

  1. bind(String.class).annotatedWith(Names.named("JDBC URL")).toInstance("jdbc:mysql://localhost/pizza");
  2. bind(Integer.class).annotatedWith(Names.named("login timeout seconds")).toInstance(10);

@Provides方法绑定

模块中定义的、带有@Provides注解的、方法返回值即为绑定映射的类型。

  1. publicclassBillingModuleextendsAbstractModule{
  2. @Override
  3. protectedvoid configure() {
  4. ...
  5. }

  7. @Provides
  8. TransactionLog provideTransactionLog() {
  9. DatabaseTransactionLog transactionLog = newDatabaseTransactionLog();
  10.     transactionLog.setJdbcUrl("jdbc:mysql://localhost/pizza");
  11.     transactionLog.setThreadPoolSize(30);
  12. return transactionLog;
  13. }

  15. @Provides@PayPal
  16. CreditCardProcessor providePayPalCreditCardProcessor(@Named("PayPal API key") String apiKey) {
  17. PayPalCreditCardProcessor processor = newPayPalCreditCardProcessor();
  18.     processor.setApiKey(apiKey);
  19. return processor;
  20. }
  21. }

Provider绑定

如果使用@Provides方法绑定逻辑越来越复杂时就可以通过Provider绑定（一个实现了Provider接口的实现类）来实现。

在公众号互联网架构师回复“2T”，获取惊喜礼包。

  1. publicinterfaceProvider {
  2.   T get();
  3. }

  5. publicclassDatabaseTransactionLogProviderimplementsProvider<TransactionLog> {
  6. privatefinalConnection connection;

  8. @Inject
  9. publicDatabaseTransactionLogProvider(Connection connection) {
  10. this.connection = connection;
  11. }

  13. publicTransactionLogget() {
  14. DatabaseTransactionLog transactionLog = newDatabaseTransactionLog();
  15.     transactionLog.setConnection(connection);
  16. return transactionLog;
  17. }
  18. }

  20. publicclassBillingModuleextendsAbstractModule{
  21. @Override
  22. protectedvoid configure() {
  23.     bind(TransactionLog.class).toProvider(DatabaseTransactionLogProvider.class);
  24. }
  25. }

无目标绑定

当我们想提供对一个具体的类给注入器时就可以采用无目标绑定。

  1. bind(MyConcreteClass.class);
  2. bind(AnotherConcreteClass.class).in(Singleton.class);

构造器绑定

3.0新增的绑定，适用于第三方提供的类或者是有多个构造器参与依赖注入。通过@Provides方法可以显式调用构造器，但是这种方式有一个限制：无法给这些实例应用AOP。

  1. publicclassBillingModuleextendsAbstractModule{
  2. @Override
  3. protectedvoid configure() {
  4. try{
  5.       bind(TransactionLog.class).toConstructor(DatabaseTransactionLog.class.getConstructor(DatabaseConnection.class));
  6. } catch(NoSuchMethodException e) {
  7.       addError(e);
  8. }
  9. }
  10. }

范围

默认情况下，Guice每次都会返回一个新的实例，这个可以通过范围（Scope）来配置。常见的范围有单例（@Singleton）、会话（@SessionScoped）和请求（@RequestScoped），另外还可以通过自定义的范围来扩展。

范围的注解可以应该在实现类、@Provides方法中，或在绑定的时候指定（优先级最高）：

  1. @Singleton
  2. publicclassInMemoryTransactionLogimplementsTransactionLog{
  3. /* everything here should be threadsafe! */
  4. }

  6. // scopes apply to the binding source, not the binding target
  7. bind(TransactionLog.class).to(InMemoryTransactionLog.class).in(Singleton.class);

  9. @Provides@Singleton
  10. TransactionLog provideTransactionLog() {
  11. ...
  12. }

另外，Guice还有一种特殊的单例模式叫饥饿单例（相对于懒加载单例来说）：

  1. // Eager singletons reveal initialization problems sooner,
  2. // and ensure end-users get a consistent, snappy experience.
  3. bind(TransactionLog.class).to(InMemoryTransactionLog.class).asEagerSingleton();

注入

依赖注入的要求就是将行为和依赖分离，它建议将依赖注入而非通过工厂类的方法去查找。注入的方式通常有构造器注入、方法注入、属性注入等。

  1. // 构造器注入
  2. publicclassRealBillingServiceimplementsBillingService{
  3. privatefinalCreditCardProcessor processorProvider;
  4. privatefinalTransactionLog transactionLogProvider;

  6. @Inject
  7. publicRealBillingService(CreditCardProcessor processorProvider,
  8. TransactionLog transactionLogProvider) {
  9. this.processorProvider = processorProvider;
  10. this.transactionLogProvider = transactionLogProvider;
  11. }
  12. }

  14. // 方法注入
  15. publicclassPayPalCreditCardProcessorimplementsCreditCardProcessor{
  16. privatestaticfinalString DEFAULT_API_KEY = "development-use-only";
  17. privateString apiKey = DEFAULT_API_KEY;

  19. @Inject
  20. publicvoid setApiKey(@Named("PayPal API key") String apiKey) {
  21. this.apiKey = apiKey;
  22. }
  23. }

  25. // 属性注入
  26. publicclassDatabaseTransactionLogProviderimplementsProvider<TransactionLog> {
  27. @InjectConnection connection;

  29. publicTransactionLogget() {
  30. returnnewDatabaseTransactionLog(connection);
  31. }
  32. }

  34. // 可选注入：当找不到映射时不报错
  35. publicclassPayPalCreditCardProcessorimplementsCreditCardProcessor{
  36. privatestaticfinalString SANDBOX_API_KEY = "development-use-only";
  37. privateString apiKey = SANDBOX_API_KEY;

  39. @Inject(optional=true)
  40. publicvoid setApiKey(@Named("PayPal API key") String apiKey) {
  41. this.apiKey = apiKey;
  42. }
  43. }

辅助注入

辅助注入（Assisted Inject）属于Guice扩展的一部分，它通过@Assisted注解自动生成工厂来加强非注入参数的使用。

  1. // RealPayment中有两个参数startDate和amount无法直接注入
  2. publicclassRealPaymentimplementsPayment{
  3. publicRealPayment(
  4. CreditService creditService,  // from the Injector
  5. AuthService authService,  // from the Injector
  6. Date startDate, // from the instance's creator
  7. Money amount); // from the instance's creator
  8. }
  9. ...
  10. }

  12. // 一种方式是增加一个工厂来构造
  13. publicinterfacePaymentFactory{
  14. publicPayment create(Date startDate, Money amount);
  15. }

  17. publicclassRealPaymentFactoryimplementsPaymentFactory{
  18. privatefinalProvider<CreditService> creditServiceProvider;
  19. privatefinalProvider<AuthService> authServiceProvider;

  21. @Inject
  22. publicRealPaymentFactory(Provider<CreditService> creditServiceProvider,
  23. Provider<AuthService> authServiceProvider) {
  24. this.creditServiceProvider = creditServiceProvider;
  25. this.authServiceProvider = authServiceProvider;
  26. }

  28. publicPayment create(Date startDate, Money amount) {
  29. returnnewRealPayment(creditServiceProvider.get(),
  30.       authServiceProvider.get(), startDate, amount);
  31. }
  32. }

  34. bind(PaymentFactory.class).to(RealPaymentFactory.class);

  36. // 通过@Assisted注解可以减少RealPaymentFactory
  37. publicclassRealPaymentimplementsPayment{
  38. @Inject
  39. publicRealPayment(
  40. CreditService creditService,
  41. AuthService authService,
  42. @AssistedDate startDate,
  43. @AssistedMoney amount);
  44. }
  45. ...
  46. }

  48. // Guice 2.0
  49. //bind(PaymentFactory.class).toProvider(FactoryProvider.newFactory(PaymentFactory.class, RealPayment.class));
  50. // Guice 3.0
  51. install(newFactoryModuleBuilder().implement(Payment.class, RealPayment.class).build(PaymentFactory.class));



PS：如果觉得我的分享不错，欢迎大家随手点赞、在看。

大家一起在评论区聊聊呗~

浏览 12
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
Google 开源的依赖注入库，比 Spring 更小更快！
猿天地
0
Google 开源的依赖注入库，比 Spring 更小更快！
JAVA葵花宝典
0
Google 开源的依赖注入库，比 Spring 更小更快！
程序员的成长之路
0
Google 开源的依赖注入库，比 Spring 更小更快！
Java后端编程
0
Google 开源的依赖注入库，比 Spring 更小更快！
Java中文社群
0
Google 开源的依赖注入库，比 Spring 更小更快！
小哈学Java
0
WallarooC++依赖注入库
Wallaroo是一个C++的依赖注入库，您可以使用字符串来创建对象，你也可以从配置文件中加载“对象图”。示例代码：#include "wallaroo/catalog.h"using namespa
autumnframeworkC++依赖注入库
AutumnFramework项目是用C++实现依赖注入。它支持属性setter注入和构造器注入。它可以在多个平台上编译。它支持POCO（普通的C++对象）并且对你创建类无约束。它不会入侵你的代码。
WallarooC++依赖注入库
Wallaroo 是一个C++的依赖注入库，您可以使用字符串来创建对象，你也可以从配置文件中加载“对
autumnframeworkC++依赖注入库
Autumn Framework 项目是用C++实现依赖注入。它支持属性setter注入和构造器注入
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报