EJB3.0开发指南之无状态会话Bean
在所有的EJB3.0规范中定义的EJB,都不必实现Home接口。
一个会话Bean必须有一个业务接口,这个接口由会话Bean来实现,或者也可以由会话Bean来产生。这样,你可以只写一个文件,就可以生成业务逻辑实现类、远程接口、本地接口等。
…
@Remote
@Local
@Stateless
public class CounterBean
{
……
}
在目前jboss的实现中,必须要有一个独立的业务接口。
这个接口不必实现EJBObject或者EJBLocalObject。
一个无状态会话Bean 必须使用Stateless注释,以表明它是一个无状态的会话Bean。EJB容器将根据这个注释来判定它的类型。或者实现javax.ejb.SessionBean接口。
一个无状态的会话Bean可以实现setSessionContext方法,也可以不实现。
一个无状态的会话Bean可以实现ejbCreate/ejbRemove方法。
一个无状态的会话Bean可以通过依赖注入(Dependency Injection)也就是现在吵得挺火的IOC获取容器的资源和环境属性。详细介绍请看后面的章节。
在Eclipse中导入本文提供的例子Stateless。
这个例子是一个计数器的例子,它实现了两个业务方法add和getNumber,add方法就是给计数器加上一个整数值,getNumber方法将得到计数器的当前值。
这个例子主要有5个文件:
Counter.java:业务接口。
CounterBean.java:业务实现类。将来我们开发的EJB也都是这样命名(在接口名上加上Bean)。
Client.java:测试EJB的客户端类。
jndi.properties:jndi属性文件,提供访问jdni的基本配置属性。
Build.xml:ant 配置文件,用以编译、发布、测试、清除EJB。
下面针对每个文件的内容做一个介绍。
Counter.java
package com.kuaff.ejb3.stateless;
import javax.ejb.Remote;
@Remote
public interface Counter
{
public int add(int i);
public int getNumber();
}
这个接口很简单,定义了上面介绍的两个业务方法,同时,我们为这个接口加上了Remote注释,这样我们的远程客户端就可以通过JNDI名称查找到它,并调用它的业务方法。
它的JNDI名称怎么配置呢?
你不必配置它的JNDI名称,也不必写它的配置文件。在JBOSS实现的EJB3.0中,你不必写任何的EJB部署文件和jboss部署文件。JBOSS默认使用接口的全称作为它的JNDI名。在上面的例子中,它的全称就是:
com.kuaff.ejb3.stateless.Counter,你也可以通过Counter.class.forName()得到。
CounterBean.java
package com.kuaff.ejb3.stateless;
import javax.ejb.Stateless;
@Stateless
public class CounterBean implements Counter
{
private int number = 0;
//给计数器加上i
public int add(int i)
{
number += i;
return number;
}
//得到当前的计数
public int getNumber()
{
return number;
}
}
这个是计数器的实现类。注意这个类使用Stateless做了注释,这是必须的。
Client.java
package com.kuaff.ejb3.stateless;
import javax.naming.InitialContext;
import javax.naming.NamingException;
public class Client
{
public static void main(String[] args)
{
InitialContext ctx;
try
ctx = new InitialContext();
Counter counter = (Counter) ctx.lookup(Counter.class.getName());
counter.add(10);
System.out.println("当前的number:" + counter.getNumber());
counter.add(10);
System.out.println("当前的number:" + counter.getNumber());
Counter counter2 = (Counter) ctx.lookup(Counter.class.getName());
counter2.add(10);
System.out.println("当前的number:" + counter2.getNumber());
catch (NamingException e)
{
e.printStackTrace();
}
}
}
这个类用来测试我们发布的计数器EJB。首先通过ctx = new InitialContext();得到上下文,然后通过lookup查找计数器,然后给计数器加10,显示当前的计数器信息。
jndi.properties
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
java.naming.provider.url=localhost
这个文件配置了JNDI操作所需的属性,因为我们是测试本机的EJB服务,所以不必修改上面的属性。
Build.xml
<project name="kuaff_ejb3_tutorial" default="ejbjar" basedir=".">
<property environment="env"/>
<property name="src.dir" value="${basedir}/src"/>
<property name="jboss.home" value="${env.JBOSS_HOME}"/>
<property name="build.dir" value="${basedir}/build"/>
<property name="build.classes.dir" value="${build.dir}/classes"/>
<path id="classpath">
<fileset dir="${jboss.home}/lib">
<include name="**/*.jar"/>
</fileset>
<fileset dir="${jboss.home}/server/all/lib">
<include name="**/*.jar"/>
</fileset>
<fileset dir="${jboss.home}/server/all/deploy/ejb3.deployer">
<include name="*.jar"/>
</fileset>
<fileset dir="${jboss.home}/server/all/deploy/jboss-aop.deployer">
<include name="*.jar"/>
</fileset>
<pathelement location="${build.classes.dir}"/>
<pathelement location="${basedir}"/>
</path>
<property name="build.classpath" refid="classpath"/>
<target name="prepare">
<mkdir dir="${build.dir}"/>
<mkdir dir="${build.classes.dir}"/>
</target>
<target name="compile" depends="prepare">
<javac srcdir="${src.dir}"
destdir="${build.classes.dir}"
debug="on"
deprecation="on"
optimize="off"
includes="**">
<classpath refid="classpath"/>
</javac>
</target>
<target name="ejbjar" depends="compile">
<jar jarfile="build/StatelessSample.ejb3">
<fileset dir="${build.classes.dir}">
<include name="**/*.class"/>
</fileset>
</jar>
<copy file="build/StatelessSample.ejb3" todir="${jboss.home}/server/all/deploy"/>
</target>
<target name="run" depends="ejbjar">
<java classname="com.kuaff.ejb3.stateless.Client" fork="yes" dir=".">
<classpath refid="classpath"/>
</java>
</target>
<target name="clean.db">
<delete dir="${jboss.home}/server/all/data/hypersonic"/>
</target>
<target name="clean">
<delete dir="${build.dir}"/>
<delete file="${jboss.home}/server/all/deploy/StatelessSample.ejb3"/>
</target>
</project>
请运行{$JBOSS_HOME}/bin目录下的run.bat: run –c all,启动JBOSS。
在Eclipse的Ant视图中执行ejbjar target。或者在命令行下,进入到此工程目录下,执行ant ejbjar,将编译打包发布此EJB。
在Eclipse的Ant视图中执行run target。或者在命令行下,进入到此工程目录下,执行ant run,测试这个EJB。