EJB3.0开发指南之无状态会话Bean
在所有的EJB3.0规范中定义的EJB,都不必实现Home接口。
一个会话Bean必须有一个业务接口,这个接口由会话Bean来实现,或者也可以由会话Bean来产生。这样,你可以只写一个文件,就可以生成业务逻辑实现类、远程接口、本地接口等。
…
@Remote
@Local
@Stateless
publicclassCounterBean
{
……
}
在目前jboss的实现中,必须要有一个独立的业务接口。
这个接口不必实现EJBObject或者EJBLocalObject。
一个无状态会话Bean必须使用Stateless注释,以表明它是一个无状态的会话Bean。EJB容器将根据这个注释来判定它的类型。或者实现javax.ejb.SessionBean接口。
一个无状态的会话Bean可以实现setSessionContext方法,也可以不实现。
一个无状态的会话Bean可以实现ejbCreate/ejbRemove方法。
一个无状态的会话Bean可以通过依赖注入(DependencyInjection)也就是现在吵得挺火的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
packagecom.kuaff.ejb3.stateless;
importjavax.ejb.Remote;
@Remote
publicinterfaceCounter
{
publicintadd(inti);
publicintgetNumber();
}
这个接口很简单,定义了上面介绍的两个业务方法,同时,我们为这个接口加上了Remote注释,这样我们的远程客户端就可以通过JNDI名称查找到它,并调用它的业务方法。
它的JNDI名称怎么配置呢?
你不必配置它的JNDI名称,也不必写它的配置文件。在JBOSS实现的EJB3.0中,你不必写任何的EJB部署文件和jboss部署文件。JBOSS默认使用接口的全称作为它的JNDI名。在上面的例子中,它的全称就是:
com.kuaff.ejb3.stateless.Counter,你也可以通过Counter.class.forName()得到。
CounterBean.java
packagecom.kuaff.ejb3.stateless;
importjavax.ejb.Stateless;
@Stateless
publicclassCounterBeanimplementsCounter
{
privateintnumber=0;
//给计数器加上i
publicintadd(inti)
{
number+=i;
returnnumber;
}
//得到当前的计数
publicintgetNumber()
{
returnnumber;
}
}
这个是计数器的实现类。注意这个类使用Stateless做了注释,这是必须的。
Client.java
packagecom.kuaff.ejb3.stateless;
importjavax.naming.InitialContext;
importjavax.naming.NamingException;
publicclassClient
{
publicstaticvoidmain(String[]args)
{
InitialContextctx;
try
ctx=newInitialContext();
Countercounter=(Counter)ctx.lookup(Counter.class.getName());
counter.add(10);
System.out.println("当前的number:"+counter.getNumber());
counter.add(10);
System.out.println("当前的number:"+counter.getNumber());
Countercounter2=(Counter)ctx.lookup(Counter.class.getName());
counter2.add(10);
System.out.println("当前的number:"+counter2.getNumber());
catch(NamingExceptione)
{
e.printStackTrace();
}
}
}
这个类用来测试我们发布的计数器EJB。首先通过ctx=newInitialContext();得到上下文,然后通过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
<projectname="kuaff_ejb3_tutorial"default="ejbjar"basedir=".">
<propertyenvironment="env"/>
<propertyname="src.dir"value="${basedir}/src"/>
<propertyname="jboss.home"value="${env.JBOSS_HOME}"/>
<propertyname="build.dir"value="${basedir}/build"/>
<propertyname="build.classes.dir"value="${build.dir}/classes"/>
<pathid="classpath">
<filesetdir="${jboss.home}/lib">
<includename="**/*.jar"/>
</fileset>
<filesetdir="${jboss.home}/server/all/lib">
<includename="**/*.jar"/>
</fileset>
<filesetdir="${jboss.home}/server/all/deploy/ejb3.deployer">
<includename="*.jar"/>
</fileset>
<filesetdir="${jboss.home}/server/all/deploy/jboss-aop.deployer">
<includename="*.jar"/>
</fileset>
<pathelementlocation="${build.classes.dir}"/>
<pathelementlocation="${basedir}"/>
</path>
<propertyname="build.classpath"refid="classpath"/>
<targetname="prepare">
<mkdirdir="${build.dir}"/>
<mkdirdir="${build.classes.dir}"/>
</target>
<targetname="compile"depends="prepare">
<javacsrcdir="${src.dir}"
destdir="${build.classes.dir}"
debug="on"
deprecation="on"
optimize="off"
includes="**">
<classpathrefid="classpath"/>
</javac>
</target>
<targetname="ejbjar"depends="compile">
<jarjarfile="build/StatelessSample.ejb3">
<filesetdir="${build.classes.dir}">
<includename="**/*.class"/>
</fileset>
</jar>
<copyfile="build/StatelessSample.ejb3"todir="${jboss.home}/server/all/deploy"/>
</target>
<targetname="run"depends="ejbjar">
<javaclassname="com.kuaff.ejb3.stateless.Client"fork="yes"dir=".">
<classpathrefid="classpath"/>
</java>
</target>
<targetname="clean.db">
<deletedir="${jboss.home}/server/all/data/hypersonic"/>
</target>
<targetname="clean">
<deletedir="${build.dir}"/>
<deletefile="${jboss.home}/server/all/deploy/StatelessSample.ejb3"/>
</target>
</project>
请运行{$JBOSS_HOME}/bin目录下的run.bat:run–call,启动JBOSS。
在Eclipse的Ant视图中执行ejbjartarget。或者在命令行下,进入到此工程目录下,执行antejbjar,将编译打包发布此EJB。
在Eclipse的Ant视图中执行runtarget。或者在命令行下,进入到此工程目录下,执行antrun,测试这个EJB。