EJB3.0学习笔记

3.2 EJB实例分析

该实例是运行在JBOSS5.1与SQLServer2005下。

（1）  会话BEAN

对于会话Bean的开发，相对简单如图：

图3.4 会话Bean接口声明

声明接口即与使用此EJB的用户签定了契约。用户可以使用接口提供的功能。当然要为接口实现此功能如图：

图3.5 会话Bean服务实现类

对于接口服务的实现，EJB3中使用了更为方便的标签方式，声明这个Bean并为其指定接口。完成之后，即可以向外提供服务，需要组织成构件，如图：

 

图3.6 jar文件

当这个jar文件部署到服务器中时，服务器解析此为一个EJB的实体Bean，并向外提供服务。

图3.7 调用EJB服务代码

 

图3.8 调用结果显示

（2）  实体BEAN

由于实体BEAN的开发就要涉及与数据库的关联，所以要配置数据源

对于JBOSS数据源的配置做简单的介绍。

对于JBOSS5.1数据源的配置，在目录docs/example/jca中已经包含了相关的数据源配置的xml例子文件，如图：

图3.9 数据源配置xml文档

首先复制一份文件，并修改

<?xml version="1.0"encoding="UTF-8"?><datasources> <local-tx-datasource>   <jndi-name>MSSQLDS</jndi-name>//这是设置jndi名称以供在程序能够找到这个数据源   <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=MBOOK</connection-url>   <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>   <user-name>sa</user-name>   <password>123456</password>     <metadata>        <type-mapping>MS SQLSERVER2005</type-mapping>     </metadata> </local-tx-datasource></datasources>

 

 

修改好这个文件，同时需要把SQLServer2005所用的jdbc驱动包拷贝到jboss-5.1.0.GA\server\default\lib目录下，如图：

图3.10 数据驱动jar包

然后将文件移动到目录jboss-5.1.0.GA\server\default\deploy发布。如果此时你的jboss已经是启动状态，则会看到控制台打印：

图3.11 数据源加载成功

表示数据源加载成功。

接下来可以写你的EJB应用：

需要注意的是在实体Bean中，（注意实体bean中，get方法才有ejb的标签。另要确保实体bean有一个默认的的构造函数）需要包含一个persistence.xml文件，此文件在导出jar包的时候也要包含。此文件可以为此EJB对象指定数据源。即上面已经配置好的并加载进JBOSS中的。

<persistencexmlns="http://java.sun.com/xml/ns/persistence"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://java.sun.com/xml/ns/persistence        http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"    version="1.0">     <!--持久化单元 transaction-type事物的类型。一个是全局事物JTA，一个是本地事物 -->    <persistence-unitname="sql"transaction-type="JTA">       <jta-data-source>java:MSSQLDS</jta-data-source>       <!--当数据源发布到jboss的时候，他的jndi名称默认是在java：的命名空间里 , 需要加上，jndi默认是在全局上找的 -->       <properties>//注意如如果下面方言不配置，有时是会报错的。           <propertyname="hibernate.dialect"value="org.hibernate.dialect.SQLServerDialect"/>           <propertyname="hibernate.show_sql"value="true"/>           <propertyname="hibernate.format_sql"value="true"/>           <propertyname="hibernate.jdbc.fetch_size"value="50"/>       </properties>    </persistence-unit></persistence>

 

 

 

而jndi.properties文件在测试时和应用EJB时是必不可少的。

java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory

java.naming.provider.url=localhost:1099

 

发布到jboss-5.1.0.GA-jdk6\jboss-5.1.0.GA\server\default\deploy目录下：

图3.12 发布EJB

如上图，已经成功发布了EntityBeanTest的EJB,该EJB是以jar文件形式存在的。并且还指出了beanName为PersonServiceBean，以及接口名IPersonService.

测试如下：

publicclass PersonServiceTest {     privatestatic IPersonServicepersonService;     @BeforeClass         publicstaticvoid setUpBeforeClass()throws Exception {              try {                 InitialContextic =new InitialContext( );                 personService = (IPersonService)ic.lookup("PersonServiceBean/remote");             } catch (Exception e){                e.printStackTrace();             }          }      @Test    publicvoid testSave() {       personService.save(newPerson("sunquan"));      }}

 

执行成功，由于在persistence.xml中showSql为true，控制台显示了相应的sql语句。

图3.13 SQL语句

查看数据库：

图3.14 数据添加成功

收到对应结果。

1.  有几点需要注意，在数据库的设计过程中，id必须设为主键，且自增长。

2.  导入jboss/client的所有jar包。由于持久化操作，所以需要hibernate.jar包。

 

这样对于一个实体的bean，对应数据库中的一张表，并且包括对于数据的相应操作，就都包含在这个EJB对象当中。

（3）  消息驱动BEAN

消息驱动BEAN的特性有如异步调用，无状态特性，以及无本地远程接口等。

对于一个消息驱动BEAN，即当客户端发送一条消息时，该BEAN能够自动响应这条消息。能过客户端的消息来驱动该BEAN的调用、执行。

那么首先要存在这样一个所谓消息BEAN，并且他能够监听特定的消息。

packagecn.sunquan.MessageBean;importjavax.ejb.ActivationConfigProperty;importjavax.ejb.EJBException;importjavax.ejb.MessageDriven;importjavax.ejb.MessageDrivenBean;importjavax.ejb.MessageDrivenContext;importjavax.jms.JMSException;import javax.jms.Message;import javax.jms.MessageListener;importjavax.jms.TextMessage;@MessageDriven(mappedName="MyMessageDrivenBean",activationConfig = {              @ActivationConfigProperty(propertyName ="destinationType", propertyValue ="javax.jms.Queue"),       @ActivationConfigProperty(propertyName ="destination", propertyValue ="queue/itmQueue")})//关于上述标签的解释：destination指明要去监听容器通道的名字，destinationType指//明要去监听容器通道的类型。mappedName非必须的。publicclassMyMessageDrivenBeanimplements MessageDrivenBean, MessageListener {    privatestaticfinallongserialVersionUID = 1L;    publicMyMessageDrivenBean() {       //TODO Auto-generated constructor stub    }    @Override    publicvoid onMessage(Messagemessage) {       TextMessagemsg = (TextMessage) message;       try {           System.out.println(msg.getText());       } catch (JMSException e) {           e.printStackTrace();       }    }    @Override    publicvoid ejbRemove()throws EJBException {    }    @Override    publicvoidsetMessageDrivenContext(MessageDrivenContext arg0)           throws EJBException {       }}

 

 

下面这个xml文件就是声明上述那个通道，打在jar包和单独发布到deploy目录下效果一样。

<?xmlversion="1.0"encoding="UTF-8"?> <server>   <mbeancode="org.jboss.mq.server.jmx.Queue"          name="jboss.mq.destination:server=Queue,name=itmQueue">             <attributename="JNDIName">queue/itmQueue</attribute>             <dependsoptional-attribute-name="DestinationManager">jboss.mq:service=DestinationManager</depends>   </mbean>  <!--  <mbeancode="org.jboss.mq.server.jmx.Topic"         name="jboss.mq.destination:service=Topic,name=itmTopic">       <attributename="JNDIName">topic/itmTopic</attribute>     <dependsoptional-attribute-name="DestinationManager">jboss.mq:service=DestinationManager</depends>     </mbean>     --> </server>

 

 

 

测试发现在bean打成jar包后，如果不包含上述这个xml的文件(xxx-service.xml)时，这个消息驱动bean是bound不成功的。为什么呢？

图3.15 绑定不成功

既然JBOSS已经发现了一个叫做itemQueue类型的消息，服务器此时只能从bean中的标签中发现itemQueue，至此服务器已经知道有一个bean，

他是处理itemQueue类型的。当一个itemQueue消息发送过来的时候，服务器应该是可以把这条消息交给指定bean处理的，或者是这个bean一直在等待，类似监听这类消息，一旦有就处理。(仅是猜测)

那么EJB消息驱动Bean是哪种处理方法的呢？

很明显，由于异步的需要，是采用的第二种，BEAN一直在监听。那么JBOSS就要为这个BEAN开辟一条通道，让BEAN在这条通道上监听，发送对应类型的消息时，也发送到这个通道上。那么我们就需要为JBOSS指定这个通道，然后把BEAN绑定到这条通道上。

（同时联想到bean中的一个属性名是destination,目的地，bean是消息处理的终点，怎么还有目的地，哈哈，此处的意思是去容器的一个目的通道上监听。）

而上面我们只声明了BEAN，JBOSS中确不存在这条通道，而你的bean又要去这里监听，那么JBOSS服务器会显示指定的通道没有绑定。

 

所以有理由相信，所以要通过上面xml文件使用容器创建一个通道（该文件可以打包在jar文件中，也可以只直接以xml文件的方式发布在deploy目录下，其效果是一样的）：

 

 

图3.16 绑定成功

 

接下来就是处理发送消息：

package cn.sunquan.send;import java.util.Properties;import javax.jms.Queue;importjavax.jms.QueueConnection;import javax.jms.QueueConnectionFactory;import javax.jms.QueueSession;import javax.jms.TextMessage;import javax.naming.InitialContext;publicclass QueueSender {    publicstaticvoid main(String[]args){        try {          Properties props = new Properties();           props.setProperty("java.naming.factory.initial","org.jnp.interfaces.NamingContextFactory");           props.setProperty("java.naming.provider.url","localhost:1099");           props.setProperty("java.naming.factory.url.pkgs","org.jboss.naming");           InitialContext ctx = new InitialContext(props);                     //查找 QUeue类型的连接工厂。             QueueConnectionFactory factory = (QueueConnectionFactory)ctx                    .lookup("ConnectionFactory");                     QueueConnection conn=factory.createQueueConnection();                     //创建一个到该地址的会话，第二个参数：消息的确认模式，这里用自动的确认模式。             QueueSession session = conn.createQueueSession(false,                      QueueSession.AUTO_ACKNOWLEDGE);                  Queue queue = (Queue) ctx              .lookup("queue/itmQueue");                          TextMessage msg =session.createTextMessage("您好，这是我的第一个消息驱动Bean");           javax.jms.QueueSender sender=session.createSender(queue);           sender.send(msg);           session.close();              conn.close();          } catch (Exception e) {             e.printStackTrace();         }      }  }

 

可以看到lookup时是找的queue/itmQueue

图3.17 绑定成功

 

即在bean中指定的destination.

图3.18 显示结果

 

 

（注：上面的xxx-service.xml既然可以放在jar包中，那么实体bean中的dataSource.xml声明是否也可以放在实体bean的jar包中……）

 

 

下载：

HelloWorldEJB

EntityBeanTest

MessageBeanTest