Google Guice 4
本章节继续讨论依赖注入的其他话题,包括作用域(scope,这里有一个与线程绑定的作用域例子)、立即初始化(Eagerly Loading Bindings)、运行阶段(Stage)、选项注入(Optional Injection)等等。
1.3.5 Scope(作用域)
在1.1章节中我们初步了解了对象的单例模式,在Guice中提供了一些常见的作用域,比如对于单例模式有下面两个作用域。
????com.google.inject.Scopes.SINGLETON
????com.google.inject.Scopes.NO_SCOPE
在使用上,可以使用Module的bind来实现,看下面的例子。
?1?????public?class?ScopeDemo?{
?2?????????public?static?void?main(String[]?args)?{
?3?
?4?????????????Service?service?=?Guice.createInjector(new?Module()?{
?5?????????????????@Override
?6?????????????????public?void?configure(Binder?binder)?{
?7?????????????????????binder.bind(Service.class).to(WwwService.class).in(Scopes.SINGLETON);
?8?????????????????}
?9?????????????}).getInstance(Service.class);
10?????????????service.execute();
11?????????}
12?????}
13?
14?
当然单例模式还可以似乎用@Singleton注解。
在com.google.inject.binder.ScopedBindingBuilder.in(Scope)方法中,一个Scope除了可以使上面的SINGLETION和NO_SCOPE外,还可以是自己定义的Scope。下面的例子演示了一个与线程绑定的Scope例子。
?1?/**?2??*?$Id:?ThreadScopeDemo.java?90?2009-12-25?08:12:21Z?xylz?$
?3??*?xylz?study?project?(www.imxylz.cn)
?4??*/
?5?package?cn.imxylz.study.guice.inject.more;
?6?
?7?import?com.google.inject.Binder;
?8?import?com.google.inject.Guice;
?9?import?com.google.inject.Injector;
10?import?com.google.inject.Key;
11?import?com.google.inject.Module;
12?import?com.google.inject.Provider;
13?import?com.google.inject.Scope;
14?
15?/**?a?demo?with?thread-scope
16??*?@author?xylz?(www.imxylz.cn)
17??*?@version?$Rev:?90?$
18??*/
19?public?class?ThreadScopeDemo?{
20?
21?????static?class?ThreadServiceScope?implements?Scope?{
22?
23?????????static?ThreadLocal<Object>?threadLocal?=?new?ThreadLocal<Object>();
24?
25?????????@Override
26?????????public?<T>?Provider<T>?scope(final?Key<T>?key,?final?Provider<T>?unscoped)?{
27?????????????return?new?Provider<T>()?{
28?????????????????@Override
29?????????????????public?T?get()?{
30?????????????????????T?instance?=?(T)?threadLocal.get();
31?????????????????????if?(instance?==?null)?{
32?????????????????????????instance?=?unscoped.get();
33?????????????????????????threadLocal.set(instance);
34?????????????????????}
35?????????????????????return?instance;
36?????????????????}
37?????????????};
38?????????}
39?
40?????????@Override
41?????????public?String?toString()?{
42?????????????return?"Scopes.ThreadServiceScope";
43?????????}
44?????}
45?????
46?????public?static?void?main(String[]?args)?{
47?????????final?Injector?inj=Guice.createInjector(new?Module()?{
48?????????????@Override
49?????????????public?void?configure(Binder?binder)?{
50?????????????????binder.bind(Service.class).to(WwwService.class).in(new?ThreadServiceScope());
51?????????????}
52?????????});
53?????????for(int?i=0;i<3;i++)?{
54?????????????new?Thread("Thread-"+i)?{
55?????????????????public?void?run()?{
56?????????????????????for(int?m=0;m<3;m++)?{
57?????????????????????????System.out.println(String.format("%s-%d:%d",//
58?????????????????????????????????getName()//
59?????????????????????????????????,m//
60?????????????????????????????????,inj.getInstance(Service.class).hashCode()));
61?????????????????????????try?{
62?????????????????????????????Thread.sleep(50L);
63?????????????????????????}?catch?(Exception?e)?{
64?????????????????????????}
65?????????????????????}
66?????????????????}
67?????????????}.start();
68?????????}
69?????}
70?}
71?
?
注意,这里用到了《Google Guice 入门教程03 - 依赖注入》的中的两个类Service和WwwService。在本例中ThreadServiceScope类是一个与线程绑定的作用域(利用ThreadLocal特性),当当前线程中没有构造一个对象的时候先构造一个出来,然后放入线程上下文中,以后每次都从线程中获取对象。第50行是将WwwService服务以ThreadServiceScope的作用域绑定到Service服务上。第57-60行输出当前对象的hashCode,如果此类是同一对象的话就应该输出相同的hashCode。为了看到效果,我们使用3个线程,每个线程输出三次来看结果。
Thread-0-0:18303751Thread-1-0:23473608
Thread-2-0:21480956
Thread-1-1:23473608
Thread-0-1:18303751
Thread-2-1:21480956
Thread-1-2:23473608
Thread-2-2:21480956
Thread-0-2:18303751
?
我们看到对于同一个线程(比如说Thread-0)的三次都输出了相同的对象(hashCode为18303751),而与线程2和线程3的hashCode不同。
(特别说明:如果两个线程输出了同一个hashCode不必惊慌,那是因为可能前一个线程生成的对象的地址空间被GC释放了,结果下一个线程使用了上一个线程的相同空间,所以这里使用Thread.sleep来降低这种可能性)
事实上在guice-servlet-2.0.jar中有与request和session绑定的scope。
com.google.inject.servlet.ServletScopes.REQUESTcom.google.inject.servlet.ServletScopes.SESSION
?
1.3.6 Eagerly Loading Bindings (立即初始化)
除了可以绑定scope外,对象默认在第一次调用时被创建,也即所谓的延时加载,Guice也允许对象在注入到Guice容器中时就被创建出来(显然这是针对单例模式才有效)。
?1?public?class?EagerSingletonDemo?{?2?
?3?????public?EagerSingletonDemo()?{
?4?????????System.out.println("?constuctor:"+System.nanoTime());
?5?????}
?6?????void?doit()?{
?7?????????System.out.println("???????doit:"+System.nanoTime());
?8?????}
?9?????public?static?void?main(String[]?args)?throws?Exception{
10?????????Injector?inj?=?Guice.createInjector(new?Module()?{
11?????????????@Override
12?????????????public?void?configure(Binder?binder)?{
13?????????????????binder.bind(EagerSingletonDemo.class).asEagerSingleton();
14?????????????}
15?????????});
16?????????System.out.println("before?call:"+System.nanoTime());
17?????????Thread.sleep(100L);
18?????????inj.getInstance(EagerSingletonDemo.class).doit();
19?????}
20?}
?
结果输出如下:
?constuctor:26996967388652before?call:26996967713635
???????doit:26997069993702
?
可以看到我们的对象在调用getInstance之前就已经被构造出来了。
1.3.7 Stages (运行阶段)
Guice还有一个特效,可以指定Guice运行模式来控制Guice的加载速度。在com.google.inject.Stage枚举中提供了TOOL,DEVELOPMENT,PRODUCTION三种模式。
TOOL描述的是带有IDE等插件的运行模式;DEVELOPMENT是指在开发阶段只加载自己需要的功能(对于非立即初始化单例对象采用延后加载),这样来降低加载不需要功能的时间;而PRODUCTION模式是指完全加载所有功能(对于单例对象采用立即加载方式),这样可以更早的发现问题,免得等需要某些功能的时候才发现问题(要知道我们某些功能可能需要特定的条件才能触发)。
其实只有比较多的单例对象,并且单例对象构造比较耗时的情况下才能有用。大部分情况下这点性能可能都忽略不计了。
默认情况下Guice采用DEVELOPMENT模式。
?
1.3.8 Optional Injection (选项注入 )
选项注入描述的是如果不能从Guice容器中注入一个对象,那么可以使用一个默认的对象。看下面的例子。
?1?public?class?OptionalInjectionDemo?{?2?????@Inject(optional=true)
?3?????Service?service?=?new?WwwService();
?4?????public?static?void?main(String[]?args)?{
?5?????????Guice.createInjector(new?Module()?{
?6?????????????public?void?configure(Binder?binder)?{
?7?????????????????//binder.bind(Service.class).to(HomeService.class);
?8?????????????}
?9?????????}).getInstance(OptionalInjectionDemo.class).service.execute();
10?????}
11?}
?
上述例子中第2行描述的是选项注入,如果不能从Guice容器中获取一个Service服务那么就使用默认的WwwService,否则就是用获取的服务。如果将第7行注释去掉我们就可以看到实际上调用的是HomeService服务了。
?
到此为止,Guice依赖注入的基本教程就学习完了,下面的章节我们进入经典的AOP教程学习。