在所有的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。