EJB3.0学习之路 让第一个Stateless Session Bean跑起来

随着Spring的兴起，EJB2.0被彻底击败，但是EJB3.0却痛定思痛，总结经验教训以一个崭新的面貌问世，而他究竟怎么，能否以流行的敏捷性开发框架抗衡，这里我们可以先了解一下他，然后再来下定论，下面就开始吧：
软件环境：
IDE:Eclipse 3.2
jdk1.5.0
Application Server:jboss-4.2.0.CR1
JBoss Eclipse IDE: JBossIDE-2.0.0.Beta2-ALL.zip
EJB3.0

后三项都可以在 http://www.jboss.com/downloads/index 中下载。下载完成后，下面就开始吧：
（一）环境设置
1. 将jboss-4.2.0.CR1解压释放，我的目录是D:\Java\jboss-4.2.0.CR1
2. 环境变量添加 JBOSS_HOME，指向该目录
3. 解压释放JBossIDE-2.0.0.Beta2-ALL.zip，将plugins和features目录下的文件拷贝到eclipse的
目录下，删除原始eclipse\configuration的文件全部删除（除了config.ini文件），重新启动eclipse，
点击Window-->Preferences,如果能够看到图一，和图二中的东东，那么JBoss Eclipse IDE，就安装成
功了。图二蓝色标注的部分是JBoss Rule的东西，不是本文讨论的内容，所以不用管他。
4. 点击图二红色标注的部分，New-->New Server-->JBoss Inc-->JBoss AS 4.0, 点击Next, 点击Home按钮指向JBoss的安装目录，这里我的是D:\Java\jboss-4.2.0.CR1，然后为这个server取一个名字
jboss-4.2.0.CR1，Configuration选择default，点击default，名字还是叫做jboss-4.2.0.CR1，然后点击finish。到此为止全部环境已经设置好了。
（二）建立工程
1. File-->New-->Other-->EJB3.0-->EJB3.0 Project,取一个名字Ejb3Tutorial，点击Next按钮，选择刚才安装JBoss AS jboss-4.2.0.CR1，点击Finish。这时一个EJB3.0的工程就建好了。但是发现有一个错误，打开Window-->Show view-->Problems,打开透视图以后发现这个错误
Project Ejb3Tutorial is missing required library: 'D:\Java\jboss-4.2.0.CR1\server\default\deploy\ejb3.deployer\jboss-ejb3x.jar'
这时右键打开工程属性，Properties-->Java Build Path-->Libraries,打开JBoss EJB3 Libraries[default],
发现确实有一个librariy有警告，错误信息很明显，就是missing 。这时在%JBOSS_HOME%\client可以找到这个librariy，把他拷贝到D:\Java\jboss-4.2.0.CR1\server\default\deploy目录下，然后refresh一下，此时错误信息就没有了，一切准备就绪。
2. 我们的这一个例子以JBoss提供的教程来实现，一共3个接口，一个实现类，还有一个cilent。代码如下：

public interface Calculator {
	int add(int x, int y);

	int subtract(int x, int y);
}

@Local
public interface CalculatorLocal extends Calculator
{
}

@Remote
public interface CalculatorRemote extends Calculator
{
}

@Stateless
public class CalculatorBean implements CalculatorRemote, CalculatorLocal {
	public int add(int x, int y) {
		return x + y;
	}

	public int subtract(int x, int y) {
		return x - y;
	}
}

public class Client {
	public static void main(String[] args) throws Exception {
		InitialContext ctx = new InitialContext();
		Calculator calculator = (Calculator) ctx.lookup("CalculatorBean/remote");
		System.out.println("1 + 1 = " + calculator.add(1, 1));
		System.out.println("1 - 1 = " + calculator.subtract(1, 1));
	}
}

很简单是吧？哦，也许吧。
第一种方式：也就是上述代码那样，CalculatorLocal被@Local标注，以说明他是一个本地接口而CalculatorRemote被@Remote标注，说明他是一个远程接口。而CalculatorBean被@Stateless标注，并实现了上述接口，说明他是实现了上述接口的无状态会话bean。这种做法是JBoss推荐的，也是我个人比较喜欢的，从接口一眼就可以看出这个接口是为本地还是远程所提供服务的。

第二种方式：分别删除这两个接口的@Local和@Remote标注，然后在CalculatorBean加注@Local
({CalculatorLocal.class})和@Remote ({CalculatorRemote.class})。

第三种方式：和以前的EJB，删除全部标注，写部署文件ejb-jar.xml。

哈哈，真是萝卜白菜各有所爱嘛。
这里顺便提及一下JNDI绑定的问题：
The Calculator bean will have two JNDI bindings for the remote and Local interface. By default, JBoss will use ejbName/local and ejbName/remote for the local and remote interfaces, respectively.
从Client的代码可以看出，Client就正是采用了JBoss这种默认的绑定方法，而我们也可以实现自己的绑定，这也很简单，用@LocalBinding和@RemoteBinding这两个标注就可以了。如上，如果我们在Calculator bean上标注@LocalBinding(jndiBinding="myFirst/Local")和@RemoteBinding(jndiBinding="myFirst/Remote")的话，那么客户端调用就应该相应的改为ctx.lookup("myFirst/Local")和ctx.lookup("myFirst/Remote")了。
（三）. 编译，运行
好了，到此所有工作都已经完成了，编译运行吧。这里由于JBoss 可以热部署EJB3.0,所以先启动服务。这里可以到%JBOSS_HOME%\bin 下执行run命令，也可以在eclipse中，Window-->Show view-->Servers, 选中我们建立的jboss-4.2.0.CR1，然后右键start启动JBoss AS.
在这个例子中，有一个build.xml文件，我们进入这个项目的文件路径下，我的是D:\workspace\Ejb3Tutorial，然后执行ant run命令，可以成功看到：
run:
     [java] 1 + 1 = 2
     [java] 1 - 1 = 0
这就算成功了，因为ant run命令首先将我们的代码编译并打包到%JBOSS_HOME%\server\default\deploy目录下，然后执行Client的调用。当然我们也可以在eclipse中执行，右键选中build.xml,Run As --> External Tools,选中targets这里构上run，ejbjar，后者是打包的deploy目录，而前者是执行Client，但是依赖后者，所以之间选择run就可以了。然后点击run按钮，可以在Console透视图可以看到：
Buildfile: D:\workspace\Ejb3Tutorial\build.xml
prepare:
compile:
ejbjar:
run:
     [java] 1 + 1 = 2
     [java] 1 - 1 = 0
BUILD SUCCESSFUL
Total time: 2 seconds

好了，到这里我们的第一个无状态会话bean就开发完成，别且看到了正确的结果。可以看到EJB3.0消除了home接口，和一些其他的东东，而采用Annotation来设计实现，这样的无侵入架构真的让人对他很有期待，等着看吧。^_^