1. 程式人生 > >java輕量級IOC框架Guice

java輕量級IOC框架Guice

Guice是由Google大牛Bob lee開發的一款絕對輕量級的java IoC容器。其優勢在於:

  1. 速度快,號稱比spring快100倍。
  2. 無外部配置(如需要使用外部可以可以選用Guice的擴充套件包),完全基於annotation特性,支援重構,程式碼靜態檢查。
  3. 簡單,快速,基本沒有學習成本。

Guice和spring各有所長,Guice更適合與嵌入式或者高效能但專案簡單方案,如OSGI容器,spring更適合大型專案組織。

注入方式

在我們談到IOC框架,首先我們的話題將是構造,屬性以及函式注入方式,Guice的實現只需要在建構函式,欄位,或者注入函式上標註@Inject,如:

構造注入

public class OrderServiceImpl implements OrderService {
    private ItemService itemService;
    private PriceService priceService;

    @Inject
    public OrderServiceImpl(ItemService itemService, PriceService priceService) {
        this.itemService = itemService;
        this.priceService = priceService;
    }

    ...
}

屬性注入

public class OrderServiceImpl implements OrderService {
    private ItemService itemService;
    private PriceService priceService;

    @Inject
    public void init(ItemService itemService, PriceService priceService) {
        this.itemService = itemService;
        this.priceService = priceService;
    }

    ...
}

函式(setter)注入

public class OrderServiceImpl implements OrderService {
    private ItemService itemService;
    private PriceService priceService;

    @Inject
    public void setItemService(ItemService itemService) {
        this.itemService = itemService;
    }

    @Inject
    public void setPriceService(PriceService priceService) {
        this.priceService = priceService;
    } 

    ...
}

Module依賴註冊

Guice提供依賴配置類,需要繼承至AbstractModule,實現configure方法。在configure方法中我們可以用Binder配置依賴。

Binder利用鏈式形成一套獨具語義的DSL,如:

  • 基本配置:binder.bind(serviceClass).to(implClass).in(Scopes.[SINGLETON | NO_SCOPE]);
  • 無base類、介面配置:binder.bind(implClass).in(Scopes.[SINGLETON | NO_SCOPE]);
  • service例項配置:binder.bind(serviceClass).toInstance(servieInstance).in(Scopes.[SINGLETON | NO_SCOPE]);
  • 多個例項按名注入:binder.bind(serviceClass).annotatedWith(Names.named(“name”)).to(implClass).in(Scopes.[SINGLETON | NO_SCOPE]);
  • 執行時注入:利用@Provides標註注入方法,相當於spring的@Bean。
  • @ImplementedBy:或者在實現介面之上標註@ImplementedBy指定其實現類。這種方式有點反OO設計,抽象不該知道其實現類。

對於上面的配置在注入的方式僅僅需要@Inject標註,但對於按名注入需要在引數前邊加入@Named標註,如:

public void configure() {
    final Binder binder = binder();

    //TODO: bind named instance;
    binder.bind(NamedService.class).annotatedWith(Names.named("impl1")).to(NamedServiceImpl1.class);
    binder.bind(NamedService.class).annotatedWith(Names.named("impl2")).to(NamedServiceImpl2.class);
}

@Inject
public List<NamedService> getAllItemServices(@Named("impl1") NamedService nameService1,
                                                 @Named("impl2") NamedService nameService2) {
}

Guice也可以利用@Provides標註注入方法來執行時注入:如

   

   @Provides
   public List<NamedService> getAllItemServices(@Named("impl1") NamedService nameService1,
                                             @Named("impl2") NamedService nameService2) {
    final ArrayList<NamedService> list = new ArrayList<NamedService>();
    list.add(nameService1);
    list.add(nameService2);
    return list;
}

Guice例項

下面是一個Guice module的例項程式碼:包含大部分常用依賴配置方式。更多程式碼參見github .

package com.github.greengerong.app;

/**
 * ***************************************
 * *
 * Auth: green gerong                     *
 * Date: 2014                             *
 * blog: http://greengerong.github.io/    *
 * github: https://github.com/greengerong *
 * *
 * ****************************************
 */
public class AppModule extends AbstractModule {
    private static final Logger LOGGER = LoggerFactory.getLogger(AppModule.class);
    private final BundleContext bundleContext;

    public AppModule(BundleContext bundleContext) {
        this.bundleContext = bundleContext;
        LOGGER.info(String.format("enter app module with: %s", bundleContext));
    }

    @Override
    public void configure() {
        final Binder binder = binder();
        //TODO: bind interface
        binder.bind(ItemService.class).to(ItemServiceImpl.class).in(SINGLETON);
        binder.bind(OrderService.class).to(OrderServiceImpl.class).in(SINGLETON);
        //TODO: bind self class(without interface or base class)
        binder.bind(PriceService.class).in(Scopes.SINGLETON);


        //TODO: bind instance not class.
        binder.bind(RuntimeService.class).toInstance(new RuntimeService());

        //TODO: bind named instance;
        binder.bind(NamedService.class).annotatedWith(Names.named("impl1")).to(NamedServiceImpl1.class);
        binder.bind(NamedService.class).annotatedWith(Names.named("impl2")).to(NamedServiceImpl2.class);
    }

    @Provides
    public List<NamedService> getAllItemServices(@Named("impl1") NamedService nameService1,
                                                 @Named("impl2") NamedService nameService2) {
        final ArrayList<NamedService> list = new ArrayList<NamedService>();
        list.add(nameService1);
        list.add(nameService2);
        return list;
    }
}

Guice的使用

對於Guice的使用則比較簡單,利用利用Guice module初始化Guice建立其injector,如:

Injector injector = Guice.createInjector(new AppModule(bundleContext));

這裡可以傳入多個module,我們可以利用module分離領域依賴。

Guice api方法:

public static Injector createInjector(Module... modules) 

public static Injector createInjector(Iterable<? extends Module> modules) 

public static Injector createInjector(Stage stage, Module... modules)

public static Injector createInjector(Stage stage, Iterable<? extends Module> modules) 

Guice同時也支援不同Region配置,上面的State過載,state支援 TOOL,DEVELOPMENT,PRODUCTION選項;預設為DEVELOPMENT環境。

後續

本文Guice更全的demo程式碼請參見github .

Guice還有很多的擴充套件如AOP,同一個服務多個例項注入set,map,OSGI,UOW等擴充套件,請參見Guice wiki