本文力求简洁,希望通过一个简单的demo应用讲解EasyJWeb与Guice容器的集成。
通过EasyJWeb提供的超级IoC容器,你可以非常轻松的把Guice容器集成进来,让Guice来管理业务层的依赖关系,EasyJWeb只负责表现。我们看下面的配置:
<?
xml version="1.0" encoding="utf-8"
?>
< easyjf-web >
< modules inject ="auto" >
< module name ="guice" path ="/guice" form ="" scope ="request" action ="com.easyjf.demo.action.GuiceAction" defaultPage ="index" >
< page name ="index" url ="/guice.html" type ="template" />
</ module >
</ modules >
< beans >
< bean name ="GuiceContainer" class ="com.easyjf.container.impl.GuiceContainer" scope ="singleton" >
< property name ="modules" >
< list >
< value > com.easyjf.demo.module.GuiceModule </ value >
</ list >
</ property >
< property name ="stage" >
< value > DEVELOPMENT </ value >
</ property >
</ bean >
</ beans >
</ easyjf-web >
< easyjf-web >
< modules inject ="auto" >
< module name ="guice" path ="/guice" form ="" scope ="request" action ="com.easyjf.demo.action.GuiceAction" defaultPage ="index" >
< page name ="index" url ="/guice.html" type ="template" />
</ module >
</ modules >
< beans >
< bean name ="GuiceContainer" class ="com.easyjf.container.impl.GuiceContainer" scope ="singleton" >
< property name ="modules" >
< list >
< value > com.easyjf.demo.module.GuiceModule </ value >
</ list >
</ property >
< property name ="stage" >
< value > DEVELOPMENT </ value >
</ property >
</ bean >
</ beans >
</ easyjf-web >
熟悉EasyJWeb的朋友都知道,上面的配置通过/guice.ejf便可以访问GuiceAction业务。特别之处在于我们在这里配置了一个“GuiceContainer”的bean,该bean负责集成EasyJWeb与Guice。属性modules的每个类都要继承Guice的AbstractModule类,以实现客户化的装配逻辑;stage属性代表Guice容器的运行环境,既生产环境或开发环境。下面我们看一下上面配置文件中GuiceModule的实现:
/** */
/**
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceModule.java, 2007-4-23 上午03:31:33 Tony Exp $
*/
public class GuiceModule extends AbstractModule {
/**//*
* @see com.google.inject.AbstractModule#configure()
*/
@Override
protected void configure() {
this.bindInterceptor(any(), annotatedWith(Logging.class), new LoggingInterceptor());
}
}
至于这个类的具体装配逻辑我在此不详细描述,读者只要知道是绑定拦截器就可以了,有兴趣的可以参阅Guice的文档。在configure方法中,你可以随心所欲的实现任何客户化的装配逻辑。接下来我们再看一下上面GuiceAction的实现:
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceModule.java, 2007-4-23 上午03:31:33 Tony Exp $
*/
public class GuiceModule extends AbstractModule {
/**//*
* @see com.google.inject.AbstractModule#configure()
*/
@Override
protected void configure() {
this.bindInterceptor(any(), annotatedWith(Logging.class), new LoggingInterceptor());
}
}
/** */
/**
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceAction.java, 2007-4-23 上午03:15:47 Tony Exp $
*/
@SessionScoped
public class GuiceAction implements IWebAction {
@Inject
private GuiceService guiceService;
private int count = 0;
/**//*
* @see com.easyjf.web.IWebAction#execute(com.easyjf.web.WebForm, com.easyjf.web.Module)
*/
@Logging
public Page execute(WebForm form, Module module) throws Exception {
count++;
form.addResult("message", guiceService.sayHelloToGuice());
form.addResult("count", count);
return module.findPage("index");
}
}
注意到上面的代码中,GuiceAction实现了EasyJWeb的IWebAction接口,不同的地方是这个类中多了几个Annotation:@SessionScoped,@Inject和@Logging,:@SessionScoped代表该类的作用域;@Inject代表该类引用了Guice容器中的一个bean[GuiceService];@Logging代表这个方法需要记录日志,就是通过刚才的拦截器实现的。下面给出GuiceService极其实现类:
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceAction.java, 2007-4-23 上午03:15:47 Tony Exp $
*/
@SessionScoped
public class GuiceAction implements IWebAction {
@Inject
private GuiceService guiceService;
private int count = 0;
/**//*
* @see com.easyjf.web.IWebAction#execute(com.easyjf.web.WebForm, com.easyjf.web.Module)
*/
@Logging
public Page execute(WebForm form, Module module) throws Exception {
count++;
form.addResult("message", guiceService.sayHelloToGuice());
form.addResult("count", count);
return module.findPage("index");
}
}
/** */
/**
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceService.java, 2007-4-23 上午03:16:20 Tony Exp $
*/
@ImplementedBy(GuiceServiceImpl. class )
public interface GuiceService {
public String sayHelloToGuice();
}
实现:
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceService.java, 2007-4-23 上午03:16:20 Tony Exp $
*/
@ImplementedBy(GuiceServiceImpl. class )
public interface GuiceService {
public String sayHelloToGuice();
}
/** */
/**
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceServiceImpl.java, 2007-4-23 上午03:17:24 Tony Exp $
*/
@Singleton
public class GuiceServiceImpl implements GuiceService {
/**//*
* @see com.easyjf.demo.GuiceService#sayHelloToGuice()
*/
@Logging
public String sayHelloToGuice() {
System.out.println("Execute GuiceServiceImpl#sayHelloToGuice()");
return "Hello, Guice!";
}
}
这两个类中都使用了Guice的Annotation来声明装配原则,具体含义请参考Guice文档。
*
* @author ecsoftcn@hotmail.com
*
* @version $Id: GuiceServiceImpl.java, 2007-4-23 上午03:17:24 Tony Exp $
*/
@Singleton
public class GuiceServiceImpl implements GuiceService {
/**//*
* @see com.easyjf.demo.GuiceService#sayHelloToGuice()
*/
@Logging
public String sayHelloToGuice() {
System.out.println("Execute GuiceServiceImpl#sayHelloToGuice()");
return "Hello, Guice!";
}
}
到此为止,一个简单的Demo就算介绍完了,欢迎交流。