通过struts2-ejb3-plugin把Struts2与EJB3.0无缝整合起来

        本文是讲述使用struts2-ejb3-plugin这个插件将Struts2与EJB3.0进行整合开发。
你可以从Apache的Struts2的Plugin列表了解它： http://cwiki.apache.org/S2PLUGINS/home.html
也可直接进入主页了解它： http://cwiki.apache.org/S2PLUGINS/struts2-ejb3-plugin.html
或者从该Google代码： http://code.google.com/p/struts2-ejb3-plugin/
        Struts2是时下比较流行的JAVA EE框架，而EJB为JAVA企业平台标准规范并且是JAVA EE体系的核心技术，不过前几年由于EJB2.1的烦琐以及spring、hibernate等轻量级框架的推广流行，EJB2.1大有被取代的趋势。在这种情况下，吸取了spring、hibernate等框架的优点的EJB3.0也就顺理成章的诞生，不过经过了漫长的发布过程后，貌似天下已经是spring、hibernate等轻量级框架的了，在中国国内更是满国尽是SSH（我自己也觉得说得夸张了点^_^）。EJB3.0貌似在中国的关注度并不是很高，也好象并没有多少公司多少人使用它，这也造成了EJB3.0的中文资料比较少，而与像Struts2这样的优秀的框架整合的资料就更少了。曾经在一个项目中决定使用Struts2与EJB3.0，在Struts2的Action与Interceptor里使用context.lookup来查找EJB组件是多么的痛苦。四处寻找好的整合方案，却空手而回。Apache的Struts2的Plugin列表里有两个EJB3.0的Plugin，可以通过注解完成整合，不过因为引入了第三方类库与必须是写死的引用路径而最终放弃了。最后，写了一种模拟应用服务器的规则以及EJB组件生命周期的Plugin，struts2-ejb3-plugin就是这个Plugin。

 

上面废话了这么多-。-下面进入正题。

插件的安装：

struts2-ejb3-plugin的安装比较简单，拖Struts2优秀的Plugin机制的福，只需要将struts2-ejb3-plugin.jar放到 /WEB-INF/lib 目录中就可以了。 除了plugin本身的配置以外，还需要在 classpath 下创建名为 jndi.properties 的资源文件用做 jndi配置
，plugin 中使用到的jndi查找依赖于该配置。

 

代码示例：

 

先是几个SessionBean

 

@Remote
public interface DemoRemote extends Serializable {

	void remoteMethod();
}

  

@Local
public interface DemoLocal {

	void localMethod();
}

 

@Stateless(name = "ejb/demo1")
public class DemoBean implements DemoLocal, DemoRemote {

	private static final long serialVersionUID = -779739898907524857L;

	public void localMethod() {
		System.out.println("DemoBean本地方法。");
	}

	public void remoteMethod() {
		System.out.println("DemoBean远程方法。");
	}
}

 

@Stateless(name = "ejb/demo2")
public class DemoBean2 implements DemoLocal {

	public void localMethod() {
		System.out.println("DemoBean2本地方法。");
	}
}

 

@Remote
public interface DemoMethodInjectRemote extends Serializable{

	void method();
}

 

@Local
public interface DemoMethodInjectLocal {

	void method();
}

 

@Stateless
public class DemoMethodInjectBean implements DemoMethodInjectLocal,
		DemoMethodInjectRemote {

	private static final long serialVersionUID = 806301363823340506L;

	public void method() {
		System.out.println("DemoMethodInjectBean");
	}
}

 

 

下面是Interceptor

 

public class DemoInterceptor1 {

	@AroundInvoke
	public Object interceptorMethod(InvocationContext invocationContext) throws Exception {
		System.out.println("拦截器1。");
		return invocationContext.proceed();
	}
}

  

public class DemoInterceptor2 {

	@AroundInvoke
	public Object interceptorMethod(InvocationContext invocationContext) throws Exception {
		System.out.println("拦截器2。");
		return invocationContext.proceed();
	}
}

 

 

SessionBean 与 Interceptor 都会在执行到它们的时候打印出自己的信息。

 

 

下面是本文的重点，Struts2的Action

 

@Interceptors(DemoInterceptor1.class)
public class DemoAction extends ActionSupport {

	private static final long serialVersionUID = -472366623817152071L;

	@EJB
	private DemoRemote demoRemote;

	// /////
	// 为 glassfish2时，要将本地接口的注入注释掉，glassfish不支持本地接口在web层调用，如果不注释掉会在部署时报错。
	@EJB
	private DemoLocal demoLocal;
	// /////

	private DemoMethodInjectRemote demoMethodInjectRemote;

	@EJB(beanName = "ejb/demo1")
	private DemoRemote demo1;

	@EJB(beanName = "ejb/demo1")
	private DemoRemote demo2;

	@EJB
	public void setDemoMethodInjectRemote(
			DemoMethodInjectRemote demoMethodInjectRemote) {
		this.demoMethodInjectRemote = demoMethodInjectRemote;
	}

	@PostConstruct
	@Interceptors(DemoInterceptor2.class)
	@ExcludeClassInterceptors()
	public void init() {
		System.out.println("初始化。");
	}

	@Interceptors( { DemoInterceptor2.class, DemoInterceptor1.class })
	@Override
	public String execute() throws Exception {
		demoRemote.remoteMethod();
		demoLocal.localMethod();
		demoMethodInjectRemote.method();
		demo1.remoteMethod();
		demo2.remoteMethod();
		return SUCCESS;
	}

}

 

 Action中通过EJB的注解注入前面的SessionBean，并且支持除全局默认拦截器注解外的拦截器相关注解。对于生命周期注解，目前只支持@PostConstruct。struts2-ejb3-plugin的好处是通过模拟应用服务器规则与模拟EJB组件生命周期完成整合，无须引入第三方类库。

 

对于Struts2自带的拦截器，struts2-ejb3-plugin也能够像Action一样正常工作。在Action的execute(或者自定义的名称)方法中同时使用struts2的Interceptor和@Interceptors 时，@Interceptors会在Interceptor之前开始，在Interceptor之后结束。

 

下面看个 Struts2的Interceptor

 

 

public class DemoStrutsInterceptor implements Interceptor {

	private static final long serialVersionUID = 3525334943511726314L;

	@EJB
	private DemoRemote demoRemote;
	
	public void destroy() {

	}

	public void init() {
		System.out.println("struts拦截器初始化。");
	}
	
	@PostConstruct
	@Interceptors(DemoInterceptor1.class)
	public void pluginInit(){
		System.out.println("struts2-ejb3-plugin初始化。");
	}

	@Interceptors(DemoInterceptor2.class)
	public String intercept(ActionInvocation arg0) throws Exception {
		System.out.println("Struts拦截器");
		demoRemote.remoteMethod();
		return arg0.invoke();
	}

}

 可以看出，对Struts2的拦截器不仅可以使用注入，还可以对它使用生命周期以及拦截器的注解（拦截器的拦截器。。。恩，有点绞。。^_^）。

 

 

 

 

 

对配置文件的一些说明

plugin的默认配置，该配置为 cn/agrael/struts/plugin/ejb3/default-struts-ejb3-plugin.properties中的配置。配置信息如下：

 

#ENC的默认名
ENCPath=java:comp/env/
#应用服务器的具体实现类，该类是 cn.agrael.struts.plugin.ejb3.ApplicationServer的实现类
ejbContainer=cn.agrael.struts.plugin.ejb3.JbossApplicationServer
#是否解析@Resource的标志 true 为解析，false 为不解析
isParseResource=false
#是否解析@EJB的标志 true 为解析，false 为不解析
isParseEJB=true
#ear的路径名，如果没有则为空字符串
earFileBaseName=
#为远程Bean时的JNDI路径
remote=remote
#为本地Bean时的JNDI路径
local=local

 如果要修改默认的配置，需要在 classpath 下建立为 struts-ejb3-plugin.properties
的资源文件覆盖默认的配置。

 

目前的版本暂时不支持@PreDestroy。 现阶段只有 jboss与glassfish2.x 应用服务器的实现，在以后的版本中会陆续增加如 weblogic 等应用服务器的实现。如果现在需要 jboss与glassfish2.x之外的实现，可实现 cn.agrael.struts.plugin.ejb3.ApplicationServer 接口或者继承cn.agrael.struts.plugin.ejb3.AbstractApplicationServer类，并使用 struts-ejb3-plugin.properties 修改 ejbContainer 为实现类。

 

关于Struts2与EJB3.0的整合就写到这里了，附件里有完整的DEMO，因为比较简单，所以没写注释，希望大家见谅。

因为本人经验及水平有限，如有疏漏或者是错误的地方，希望大家多多拍砖^_^。