|
|
51CTO旗下网站
|
|
移动端

EJB 3.0+Beehive开发客户反馈系统

本文通过一个实例,介绍了如何结合EJB3.0与Beehive快速开发J2EE应用。

作者:陈逸鹤来源:BEA|2006-09-21 11:58

设计目标

客户反馈系统作为公司与客户交流的平台,几乎为所有的企业所运用,最近,公司让我负责客户反馈系统的开发。由于,公司与国外客户的业务需要,该系统必须实现中,英,日三国语言的切换(国际化要求)。在接到任务之后,我便决定尝试使用目前开源社区比较流行的Apache Beehive(蜂巢)和下一代EJB,EJB3.0等技术来实现这个系统。

开发环境

选择平台,开发工具

为了支持EJB3.0和Beehive,我们选择JBoss4.0.3应用服务器作为运行平台,它也是目前唯一提供EJB3.0容器的应用服务器。

下载和安装JBoss4.0.3服务器及EJB3.0容器http://www.jboss.com/downloads/index

数据库选用MySql5.0,由于我们没有针对特定数据库编码,因此数据库的移植也是非常方便的。

下载MySql5.0 http://dev.mysql.com/downloads/mysql/5.0.html

由于要开发EJB3.0和Beehive应用,选择Ecllipse这个IDE,

下载Ecllipse SDK 3.1 http://eclipse.org/downloads/

为了支持EJB3.0的开发,下载Jboss Ecllipse IDE这个Ecllipse插件
http://www.jboss.com/products/jbosside/downloads

Pollinate是另一个Ecllipse插件,它也是目前唯一支持Beehive项目开发的IDE,虽然它远不及WebLogic的Workshop如此强大,但在拥有一定BEA Workshop开发经验的前提下,使用pollinate并不会有太大的问题。

下载并安装Pollinate插件 http://www.eclipse.org/pollinate/

Beehive简介

在系统设计之前,选择一个优秀的系统框架是非常重要的。Beehive是Apahce的开放源代码项目。自2004年5月份,BEA系统公司宣布将WebLogic Platform中一系列居于核心地位的运行时框架(Runtime Framework)开放源代码并贡献给Apache项目后,这个Beehive的框架就一直成为开源社区关注的焦点之一。

Beehive的目标是使J2EE开发更加简单,它是一个可扩展的Java应用程序框架,该框架具有针对Web服务,Web应用程序和资源访问的集成元数据驱动的编程模型。该框架利用了JDK1.5的最新创新,特别是JSR175元数据注解,可以减少开发人员的编码,从而提高开发效率。目前,Beehive项目包括Java控件,NetUI,Java Web服务元数据,能够帮助Java开发人员开发出基于组件和标准的JAVA应用。

EJB3.0简介

在客户反馈系统中,尝试使用最新的EJB3.0来实现持久层的开发。众所周知,由于EJB的复杂性使其在J2EE架构中的表现一直不是很好。EJB大概是J2EE架构中唯一一个没有兑现其能够简单开发并提高生产力的组件。而EJB3.0规范在这方面作出努力以减轻其开发的复杂性。EJB3.0取消或最小化了很多(以前这些是必须实现)回调方法的实现,并且降低了实体Bean及O/R映射模型的复杂性,从而大大减轻了开发人员进行底层开发的工作量。

EJB3.0中两个重要的改进分别是:使用了Java5中的元数据注解功能和基于Hibernate的O/R映射模型, 在EJB3.0中,任何类型的企业级Bean只是一个加了适当注释的简单Java对象(POJO)。注释可以用于定义bean的业务接口、O/R映射信息、资源引用信息,效果与在EJB2.1中定义部署描述符和接口是一样的。在EJB3.0中部署描述符不再是必须的了;home接口也没有了,你也不必实现业务接口(容器可以为你完成这些事情)。

EJB3.0的配置

JBoss EJB3.0建立在Hibernate 3.0之上。配置数据源,实体bean需要创建hibernate. Properties配置文件。在EJB3.0部署包下有一个默认的hibernate配置文件ejb3.deployer/META-INF/hibernate.properties。修改这个文件,使实体Bean使用MySql数据源,修改后的配置文件如下:

hibernate.transaction.manager_lookup_class=org.hibernate.transaction.JBossTransactionManagerLookup
hibernate.connection.release_mode=after_statement
hibernate.transaction.flush_before_completion=false
hibernate.transaction.auto_close_session=false
hibernate.query.factory_class=org.hibernate.hql.ast.ASTQueryTranslatorFactory

在SessionFactory创建后,自动输出schema创建语句到数据库,使用update可以创建和更新原来的schema,而不影响原来数据库中的数据

hibernate.hbm2ddl.auto=update
#hibernate.hbm2ddl.auto=create
hibernate.show_sql =true
hibernate.cache.provider_class=org.hibernate.cache.HashtableCacheProvider
# Clustered cache with TreeCache
#hibernate.cache.provider_class=org.jboss.ejb3.entity.TreeCacheProviderHook
#hibernate.treecache.mbean.object_name=jboss.cache:service=EJB3EntityTreeCache

修改蓝色字体部分使其默认数据源改为MySqlDS(JBOSS的数据源配置参考JBOSS相关文档)。

hibernate.connection.datasource=java:/MySqlDS
hibernate.dialect=org.hibernate.dialect.MySQLDialect

hibernate.jndi.java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
hibernate.jndi.java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces

持久层设计

创建Ejb3.0项目

首先使用Jboss IDE,创建一个EJB3.0项目,选择new->project->EJB3.0 project,

选择Next按钮,在project name中输入项目名称:feedback,点击next,

接着选择JBoss4.0.3 Server作为项目默认的服务器。单击完成按钮,这样就生成了一个EJB3.0的项目,其根目录下的jndi.property文件指明了JBoss服务器名称服务的一些配置。

数据持久层

使用EJB3.0的实体Bean来实现系统的数据持久层.EJB3.0的实体bean也是一个加了注释的简单Java对象(POJO)。一旦它被EntityManager访问它就成为了一个持久化对象,并且成为了持久化上下文(context)的一部分。一个持久化上下文与一个事务上下文是松耦合的;严格的讲,它隐含的与一个事务会话共存。 在EJB3.0中开发实体Bean非常简单,可以像开发一般的java bean一样编程,只需做少量的注释来定义实体关系,O/R映射等,而在EJB2.1中这些都要通过开发人员自己的设计模式或者其它技术来完成的(比如,自增长主键策略)。如下定义了一个Item实体bean表示客户发起的一个主题:

//声明该类为一个实体Bean对象,表示客户发起的一个主题

public class Item implements Serializable{
private static final long serialVersionUID = -3318132295818643572L;
private int itemId;
private Collection feedBacks;
private User user;
……
//此处定义了实体Bean的一对一关系
(optional = false)
(name = "userId", unique = false, nullable = false)
public User getUser() {
return user;
}
//声明实体Bean的主键及增长策略
(generate=GeneratorType.AUTO)
(name="itemId")
public int getItemId() {
return itemId;
}
//声明主题实体与反馈实体之间的的一对多关系,并且制定级联及获取方式等
(cascade=CascadeType.ALL,fetch=FetchType.LAZY,mappedBy="item")
(name="itemId")
public Collection getFeedBacks() {
return feedBacks;
}
public void setFeedBacks(Collection feedBacks) {
this.feedBacks = feedBacks;
}
……
}

上例中,蓝色部分便是JDK1.5的元数据注解功能,如 便指名该类是一个EJB3.0实体Bean,这样在编译后便产生了EJB3.0的实体Bean,在部署时,Jboss的EJB3.0容器能够识别EJB3.0的实体Bean,并将其映射到对应的数据库表中。具体请参考EJB3.0相关技术文档。

业务逻辑层

在客户反馈系统中使用无状态会话Bean来实现系统的业务逻辑层,在EJB3.0规范中,写一个无状态回话bean(SLSB)只需要一个简单的Java文件并在类层加上注释就可以了。这个bean可以扩展javax.ejb.SessionBean接口,但这些不是必须的。一个SLSB不再需要home接口,没有哪类EJB再需要它了。Bean类可以实现业务接口也可以不实现它。如果没有实现任何业务接口,业务接口会由任意public的方法产生。如果只有几个业务方法会被暴露在业务接口中,这些方法可以使用注释。缺省情况下所有产生的接口都是local(本地)接口,你也可以使用注释来声明这个接口为remote(远程)接口。

使用JBoss IDE创建会话Bean十分方便,选择new->others->EJB3.0->Session Bean,打开会话Bean创建向导,如图所示

Session Bean Type中选择Stateless,表明要创建一个无状态会bean。在Bean Name中输入要创建的Session Bean的名称,这里我们创建一个处理客户反馈的无状态会话Bean:FeedBacks。点击finish按钮后,分别产生了会话Bean的接口文件和实现文件:FeedBacks,无状态会话Bean的业务接口:

public interface FeedBacks{
public FeedBack addFeedBack(int itemId,String title,String content,int userId,Collection feedBackFiles);
public void deleteFeedBack(int feedBackId);
……
}

在会话Bean的业务接口中,添加会话Bean的接口。其中声明该Bean实现会话Bean的Remote接口

无状态会话Bean的实现:

public  class FeedBacksBean implements FeedBacks {
public FeedBack addFeedBack(int itemId,String title,String content,int userId,Collection feedBackFiles)
{
//此处添加实现代码
……
}
……
}

在实现中完成。 

在实现中完成所有的业务逻辑编码。其中声明该Bean是一个无状态会话Bean。

WEB层设计

创建Beehive项目

首先创建一个Beehive项目,选择new->project->Beehive project,打开Beehive Project创建向导,如图所示:

在name中输入,应用的名称:feedbackApp。下一步中可以选择以定义的应用模板。完成上述步骤后,便生成了一个beehive project,新生成的项目已经添加了所有需要的Beehive资源。接着就可以开发页面流和Java控件了。

利用Java Control在Beehive中使用 Ejb3.0

Beehive提供了EJB Control用于获取EJB实例,但不支持EJB3.0,因此在客户反馈系统中考虑使用Java Control技术编写一个由EJB3.0实例的JNDI名称来获取EJB实例的控件。

Java控件(Control)架构是一个基于JavaBeans的轻量级组件架构,它公开了用于访问各种J2EE资源类型简单而一致的客户机模型。该框架提供了大量的函数,其中包括:基于JSR-175元数据和外部配置数据的配置,自动资源管理,上下文服务和用于创建新控件类型的可扩展设计模型。

开发Java控件,首先将EJB 3.0项目引入当前beehive项目中,可以在project->property->build path中设置。接着编写一个名为EjbFinder的Java Control来实现Ejb3.0实列的获取。

Java Control的开发分为两个步骤,首先要定义Java Control的接口如下所示:

// 指明该接口是控件EjbFinder的接口部分

public interface EjbFinder {
public Object getEjb(String ejbName);
}

然后定义Java Control的实现部分,
// 指明该类是控件EjbFinder的实现部分

public class EjbFinderImpl implements EjbFinder, java.io.Serializable {
//实现业务接口中的方法
public Object getEjb(String ejbName) {
try{
Context context = new InitialContext();
//根据JNDI名称获取ejb3.0实例,并返回该实例
return(context.lookup(ejbName));
}catch(NamingException e){
e.printStackTrace();   
return null;
}
}
}

Java 控件是一种可以在平台应用程序中的任何位置使用的可重用组件。上面的java control 用于由ejb实例的JNDI名称,在整个Context中查找,并返回该ejb实例。接着我们便可以在Beehive Web 应用中的PageFlow(页面流)中使用这个Java控件来获取ejb3.0实例了:

在需要使用ejb3.0实例的PageFlow页面流控制文件中添加如下代码,声明使用该控件

.apache.beehive.controls.api.bean.Control()
protected EjbFinder _ejbFinderControl;

接着我们便可以使用这个EjbFinder控件来获取所需的ejb3.0实例了

feedbacksBean= (FeedBacks) _ejbFinderControl.getEjb(FeedBacks.class.getName());

由于Pollinate中尚不提供控件的视图,为了说明Java Control与Pageflow(页面流)之间的关系,可以参照上面这张Bea Workshop中java control的参考视图,图中的主体是一个pageflow(页面流),而右侧users就是在该页面流中使用的一个名为users的java控件。

开发NetUI页面流

NetUI Page Flow(页面流)是一个基于Apache Sruts的Web应用程序框架,具有易于使用,基于JSR-175元数据的单文件编程模型。该页面流构建在模型/视图/控制器元素的核心Struts分离的基础之上,比如自动状态管理和与控件,XMLBeans和JavaServerFaces的一流集成。

页面流使用一种专门设计的批注和方法控制 Web 应用程序行为的 Java 类,称为“控制器 (controller)”类。在包含控制器类的目录中,也包含了页面流中使用的Java Server Page (JSP)。一个JSP 要成为页面流的一部分,它必须位于页面流目录中。JSP文件使用的特殊标记有助于绑定到数据和业务逻辑操作。控制器文件中的操作方法所实现的代码可以导致站点导航、数据传递或通过控件调用后端业务逻辑。而且控制器类中的业务逻辑与 JSP 文件中定义的表示代码相互独立,使得整个Web应用的开发和维护更加清晰高效。

在Pollinate中创建页面流,选择new->other->Page Flow Wizard如图所示:

单击next,在弹出框中输入页面流的名称。这里我们创建一个处理客户反馈主题的页面流topics,点击完成之后,便生成了一个基础的页面流,打开页面流所在的文件夹,双击页面流的控制文件Controller.java,点击flow页打开页面流设计视图,如下所示:

它由一个begin Action和一个index.jsp页面组成。左侧是设计组件,包括Action,Page,添加所需的页面和Action到页面流中。

在页面流控制文件中添加动作处理代码:

//页面流的控制文件,声明流转的目标
.Controller(multipartHandler = Jpf.MultipartHandler.memory, forwards = {
.Forward(name = "showTopics", path = "topicList.jsp"),
.Forward(name = "addTopicAccessories", path = "accessories.jsp"),
.Forward(name = "showLinkmen", path = "linkmanList.jsp"),
.Forward(name = "detailTopic", path = "detailTopic.jsp"),
.Forward(name = "newTopic", path = "newTopic.jsp") })
public class Controller extends PageFlowController {
//在页面流中声明使用的控件
.apache.beehive.controls.api.bean.Control()
protected EjbFinder _ejbFinderControl;
.apache.beehive.controls.api.bean.Control()
protected FileControl _fileControl;

……

//每个Action都对应一次页面流转的动作,以下action对应一个添加反馈主题的动作
.Action()
public Forward addTopic() {
this.topicForm = null;
this.topicForm = new TopicForm();
topicForm.setFileList(new ArrayList());
this.loadLinkman();
return new Forward("newTopic");
}
……

在页面文件中可以使用netui标记,实现绑定数据,资源声明,模板使用等功能,这样在页面文件中可以最大限度的减少java编码,使得页面更容易维护和管理。以下是一个显示主题列表的页面 topicList.jsp:

<netui-template:template templatePage="../web/template/template.jsp">
<netui-template:section name="leftCol" >
<jsp:include page="newTopicNav.jsp" />
</netui-template:section>
<netui-template:section name="centerCol" >
<ejar-ui:window width="70%" title="">
<netui:form action="/newTopic">
<% file="../web/template/errors.jspf"%>
<table>
<tr>
<td>
<netui:span value=""></netui:span>
</td>
<td>
<netui:select dataSource="pageFlow.topicForm.receiverName" optionsDataSource=""></netui:select>
</td>
</tr>
<tr>
<td>
<netui:span value=""></netui:span>
</td>
<td>
<netui:textBox dataSource="pageFlow.topicForm.title"></netui:textBox>
</td>
</tr>
<tr>
<td>
<netui:span value=""></netui:span>

</td>
<td>
<netui:textBox dataSource="pageFlow.topicForm.deadline"></netui:textBox>
<netui:span value=""></netui:span>
</td>

</tr>
<tr>
<td>
<netui:span value=""></netui:span>
</td>      
<td>
<netui-data:repeater dataSource="pageFlow.topicForm.fileList">
<netui-data:repeaterItem>
<netui:image src="../resources/images/i.p.attach.gif"></netui:image>
<netui:span value="  "/>

</netui-data:repeaterItem>            
</netui-data:repeater>
</td>
</tr>
<tr>
<td>
<netui:span value=""></netui:span>
</td>       
<td>

<netui:textArea dataSource="pageFlow.topicForm.content" cols="50" rows="10"></netui:textArea>
</td>
</tr>      
<tr>
<td colspan="2" height="40">
<netui:button value="" type="submit" action="/saveTopicForm"></netui:button>

<netui:button type="submit" value=""></netui:button>                                 
</td>
</tr>      
</table>
</netui:form>
<br>

</ejar-ui:window>
</netui-template:section>
</netui-template:template>

最终的页面流文件在Pollinate中对应的设计视图如下所示:

在对整个工程进行Build之后,页面流控制文件被编译为一个class文件和一个对应的配置文件WEB-INF.pageflow-struts-generated jpf-struts-config-[页面流名称].xml,该配置文件定义了一系列控制文件中注释所对应的配置,如下为其中一部分:

<struts-config>
<form-beans>
<form-beanname="uploadFileForm" type="org.form.UploadFileForm"
className="org.apache.beehive.netui.pageflow.config.PageFlowActionFormBean">
<set-property property="actualType" value="org.form.UploadFileForm"/>
</form-bean>
</form-beans>
<global-exceptions/>
<global-forwards>
<forward name="showTopics" path="/topicList.jsp"/>
<forward name="addFeedBackAccessories" path="/feedBackAccessories.jsp"/>   
</global-forwards>
<action-mappings>
<actionpath="/addAccessories" name="uploadFileForm"
type="org.apache.beehive.netui.pageflow.internal.FlowControllerAction" input="addTopicAccessories" parameter="topics.Controller" scope="request" validate="true">
<forward name="newTopic" path="/newTopic.jsp"/>
<!--forward "addTopicAccessories" (validationErrorForward)-->
<forward name="addTopicAccessories" path="/accessories.jsp"/>
</action>   
……
<message-resources key="_defaultValidationMessages"
parameter="org.apache.beehive.netui.pageflow.validation.defaultMessages" null="true"/>
</struts-config>

由于篇幅所限,无法详细阐述pollinate的使用,读者可以参考相关文章:用Pollinate可视化开发页面流(JPF)http://dev2dev.bea.com.cn/techdoc/200504503.html

实现国际化

由于要实现中英日文的显示,采取以下步骤:

开发和编译代码时指定字符集为UTF-8。Eclipse可以在项目属性中设置。使用过滤器,如果所有请求都经过一个Servlet控制分配器,那么使用Servlet的filter执行语句,将所有来自浏览器的请求(request)转换为UTF-8,因为浏览器发过来的请求包根据浏览器所在的操作系统编码,可能是各种形式编码。request.setCharacterEncoding("UTF-8")。需要配置web.xml 激活该Filter。在JSP头部声明:

<%@ page contentType="text/html;charset= UTF-8" %>

在Jsp的html代码中,声明UTF-8:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

设定数据库连接方式是UTF-8。例如连接MYSQL时配置URL如下:

jdbc:mysql://localhost:3306/feedback_db?useUnicode=true&characterEncoding=UTF-8

其他和外界交互时能够设定编码时就设定UTF-8,例如读取文件,操作XML等。

不同时区时间显示

由于客户端可能处于不同的时区,因此应该显示不同服务器时间。由于与客户端有关,因此需利用一段javaScript代码,从客户端获取其所在的时区偏移量。该偏移量是针对GMT时间而言的,也就是格林威治时间,以分钟为单位。

function getTimezone()
{
 var d = new Date();
document[getNetuiTagName("loginForm", this)][getNetuiTagName("timezone", this)].value=
d.getTimezoneOffset();  
}

获取之后将他传回服务器端并保存在session中。显示时间时根据这个偏移量来计算显示的时间。

总结

技术

EJB3.0基于Hibernate3.0,大大简化了开发的难度与复杂度,使得开发人员能够快速高效的进行开发,Beehive作为Apache的开源项目,获得了Bea的大力支持,使开发人员实现基于JAVA组件的开发,是开源项目中构建SOA的理想选择。

工具

Eclipse Pollinate作为唯一支持Beehive开发的工具,可以快速创建Beehive项目,但是开发过程中,代码与设计视图的同步对应仍然存在一些问题,比如在.Controller中定义的.Forward,在设计视图中就不能被识别。因此与BEA的Workshop相比,Pollinate仍然任重而道远。因此对于大型应用的开发来说,Bea Workshop仍然是不二选择,对于那些初学者来说,也可以先使用BEA的Workshop并结合其自带帮助系统,来学习pageflow,java control,java webservice,包括门户,集成应用等高级技术。在对这些技术有了一定的理解之后,学习Beehive的开发会更加快速有效。

本文通过一个实例,介绍了如何结合EJB3.0与Beehive快速开发J2EE应用。由于采用了一些新的技术,因此文中难免有疏漏及错误之处,欢迎大家加以纠正。同时非常感谢Kevin Kevman在技术方面的帮助。

(责任编辑 火凤凰 sunsj@51cto.com  TEL:(010)68476636-8007)


点赞 0
分享:
大家都在看
猜你喜欢

订阅专栏+更多

我的运维日志系统构建之路

我的运维日志系统构建之路

数据驱动运维
共18章 | 我叫于小炳

192人订阅学习

CentOS文件服务的最佳实战

CentOS文件服务的最佳实战

涨薪跳槽必备技能
共15章 | 追风蚂蚁

88人订阅学习

小白网工宝典

小白网工宝典

一次搞定思科华为
共15章 | 思科小牛

456人订阅学习

视频课程+更多

数据中心之基础设施层技术(VXLAN等)

数据中心之基础设施层技术(VXLAN等)

讲师:郝旺7475人学习过

Java多线程与并发实战视频课程

Java多线程与并发实战视频课程

讲师:齐毅53743人学习过

Mapgis6.7基础视频教程

Mapgis6.7基础视频教程

讲师:郭明春17475人学习过

读 书 +更多

PHP5与MySQL5 Web开发技术详解

本书是目前中文版本第一个真正介绍PHP 5及MySQL 5新增语法与功能的权威宝典! 本书本着精、全、要三宗旨,从理论中延伸,从实践中深入,详...

订阅51CTO邮刊

点击这里查看样刊

订阅51CTO邮刊

51CTO服务号

51CTO播客