文章中应用大量专业术语，所以在阅读前，您应有一定的基础知识，如java language、jsp、servlet、j2ee、ejb、ejb-ql、structs(MVC)、jboss、ant等。为了帮助大家更好的阅读，把相关知识链接列在下面。
1．JBoss Application Server :
或者
2．Java Language Specification
或者
3．JDK
4．J2EE
5．ANT
6．Structs
7．JSP
8．Servlet
9．EJB
10．EJB-QL
安装和配置JBoss Application Server
今天的工作主要是安装JBoss。下面在介绍JBoss之后重点讲解配置JBoss Application Server后我总结出的经验。
为什么要选择JBoss作应用服务器？
JBoss是一个符合标准的开放源码的J2EE应用服务器套件的名称，当前最新版本为3.0。JAS套件包括JBossServer EJB v2.0 Container 和server, JBossMQ JMS 1.0 implemetation, JBossNS JNDI implemetation,JBossCMP advanced O/R mapper和JDBC data object storage implemetation以及JAAS-based JBossSX security frameeork。所有的JBoss应用程序都是100%纯java应用程序。
JBoss 3.0包括最新的微型JMX内核、完整的HTTP Server(Jetty或Tomcat)、JCA、EJB2.0，是一个完整的、丰富的基于J2EE规范的应用服务器。
JBoss3.0遵循EJB1.1规范和部分EJB2.0规范。在这方面，它类似Sun's 'J2SDK Enterprise Edition' (J2EE)，但JBoss服务器内核仅支持EJB服务器。JBoss内核不包括支持Severlet/JSP的WEB包容器，尽管它捆扎了Tomcat或Jetty。最小内核需要是指JBoss要求的最小内存和磁盘空间。JBoss可以运行在内存为64MRAM的机器上，要求很少的磁盘空间（包括源代码）。Sun's J2EE要求最少128MRAM、31M磁盘空间。由于要求较小内存方面的原因，JBoss启动比Sun J2EE快10倍并自带了一个数据库服务器(Hypersonic SQL Server)，在JBoss启动时数据库服务器自动启动（Sun's J2EE也自带了一个CloudScape SQL server，但CloudScape SQL server必须同Sun's J2EE分开启动）。
JBoss完美的功能之一是它支持“热”部署。这个意思是部署一个Bean就是拷贝JAR文件到部署目录那么简单。如果你正在Bean已经部署的情况下进行这个操作，JBoss自动卸载Bean，再部署新版本的Bean。JBoss是基于LGPL的分发，也就是说它是完全免费的。
(编译自：)
安装JAS3.0
首先在Windows下安装JAS，安装成功后，再将JAS移植到Linux服务器上。
·安装JDK1.3，在安装JAS之前，必须在JAS服务器上安装JDK。
·下载JAS3.0的安装程序
首先去JBoss站点下载JAS3.0的安装程序,文件名jboss-3.0.0_tomcat-4.0.31.zip
下载地址1:
下载地址2:
·释放安装程序
下载后，使用压缩工具WinRAR，把jboss-3.0.0_tomcat-4.0.31.zip释放到c:\，释放之后，在c：下出现jboss-3.0.0_tomcat-4.0.3目录，它就是JAS的主目录。
·运行JAS
JAS的主目录下有一个bin目录，它是JAS的运行入口，run.bat是JAS的windows版运行程序，ruh.sh是JAS的unix版（包括linux、solaris等操作系统）运行程序。双击run.bat文件，弹出运行窗口。
图片1 刚开始运行JAS的窗口
图片2 运行中的JAS窗口
JAS运行成功后，8080端口被Tomcat的Servlet引擎占用，8082端口被JBoss的代理管理占用。Tomcat占用的8080端口可以被修改的，下面将会介绍到。
JAS的目录及其描述
约定说明：在下面，我将JAS中的一些目录进行说明和描述。
JAS的主目录描述为${jboss.home}
·JAS的bin目录名称为bin，描述为${jboss.bin}，它用来存放JAS的启动程序和运行时的包，在Windows下JAS的启动程序为run.bat，在Unix下JAS的启动程序为run.sh。
·JAS的client目录名称为client，描述为${jboss.client}，它用来存放JAS所用的一些包。
·J2EE Application 所在目录名称描述为${jboss.configuration}，JAS在缺省状态下的名称为default，可以通过在运行启动程序时加上参数“-c”来指定名称。例如：
·JAS的库目录描述为${jboss.home}/server/${jboss.configuration}/lib，在JAS启动时，JAS会自动加载此目录下所有的库文件（扩展名为JAR的压缩文件）。
·JAS的部署目录描述为${jboss.home}/server/${jboss.configuration}/deploy，此目录存放J2EE Application、EJB和一些配置文件，如mysql-service.xml、mail-service.xml、tomcat4-service.xml、jms-service.xml等。
·JAS的配置目录描述为${jboss.home}/server/${jboss.configuration}/conf，此目录存放JAS的配置文件，如jboss-service.xml、log4j.xml、standardjaws.xml、standardjboss.xml、standardjbosscmp-jdbc.xml等。
·JAS日志目录描述为${jboss.home}/server/${jboss.configuration}/log，JAS在缺省状态下的日志文件名为server.log。，可以通过在修改log4j.xml来指定日志文件名，如下所示：
|
"org.jboss.logging.appender.DailyRollingFileAppender">
…
|
图片3 修改log4j.xml指定日志文件
·JAS的Tomcat目录描述为${jboss.home}/catalina，它用来提供Servlet/JSP引擎。
·下面是一个简单的JBoss目录结构图：
|
\
|--bin
|--client
|--server
|--${jboss.configuration}
|--conf
|--deploy
|--log
…
… |
让JBoss和自带的Tomcat同时运行
JAS3.0自带了一个Tomcat Web包容器，但初装时，Tomcat是不能单独启动的，必须在JAS内运行。通过如下配置可以让Tomcat单独运行。
·修改JAS下的tomcat4-service.xml文件，将Tomcat的Http端口设为9090，下面是tomcat4-service.xml的部分代码：
|
"org.apache.catalina.connector.http.HttpConnector"
port = "9090" minProcessors = "3" maxProcessors = "10"
enableLookups = "true"
acceptCount = "10" debug = "0" connectionTimeout = "60000"/> |
图片4 修改Tomcat的Http端口
· 拷贝${jboss.home}/lib目录下的两个JAR文件jaxp.jar、crimson.jar到${jboss.home}/catalina/common/lib目录。
· 分别启动Tomcat和JBoss。在${jboss.home}/catalina/bin目录下输入startup.bat。tomcat运行了，它占用了8080端口。在${jboss.home}/bin目录下输入run.bat，JBoss也运行了，它的HTTP 引擎占用了9090端口。
到此JAS已经可以用了，下面来配置JAS连接数据库。
连接数据库
说明：项目要求的数据库为Mysql数据库，故必须将JAS和mysql数据库服务器连接起来。
下载mysql的jdbc驱动程序
由于用jdbc连接mysql要使用org.gjt.mm.mysql.Driver驱动程序，故先下载mysql的jdbc驱动程序，按下面的地址将文件mm.mysql-2.0.13-you-must-unjar-me.jar下载下来。
下载地址：
释放驱动程序
上面下载的驱动程序包括了mm.mysql-2.0.13-bin.jar、开放的源代码和一个LICENSE，用WinRAR释放压缩文件，其中mm.mysql-2.0.13-bin.jar就是mysql的jdbc驱动程序，驱动程序文件名中的2.0.13是驱动程序的版本号。
配置驱动程序
·方法一：（推荐使用此方法）
将mm.mysql-2.0.13-bin.jar拷贝到JAS的库目录即${jboss.home}/server/${jboss.configuration}/lib
·方法二：
在系统变量中加入JBOSS_CLASSPATH，值为mm.mysql-2.0.13-bin.jar的位置：
例如：
|
在Windows操作系统下
set JBOSS_CLASSPATH= c:\J2EE\jdbc\mm.mysql-2.0.13\mm.mysql-2.0.13-bin.jar |
图片5 设置系统变量JBOSS_CLASSPATH
|
在Unix操作系统下
setenv JBOSS_CLASSPATH /usr/local/jdbc/mm.mysql-2.0.13-bin.jar |
|
在Linux操作系统下
JBOSS_CLASSPATH=/usr/local/jdbc/mm.mysql-2.0.13-bin.jar
export JBOSS_CLASSPATH |
安装Mysql服务
${jboss.home}\docs\examples\jca目录存放着JAS提供的数据库映射服务配置文件，包括Oracle、DB2、Informix、MsSQL、Mysql、Hypersonic SQL、Postgres SQL等很多期望的数据库。将mysql-service.xml文件拷贝到${jboss.home}/server/${jboss.configuration}/deploy目录。
配置mysql-service.xml
在mysql-service.xml中修改以下几项的值，其它项是否要改根据情况而定。
·JndiName
·ConnectionURL
·DriverClass
·UserName
·Password
|
name="jboss.jca:service=LocalTxDS,name=MySqlDS">
jdbc:mysql://192.168.0.6/myProject
type="java.lang.String">org.gjt.mm.mysql.Driver
type="java.lang.String">test
type="java.lang.String">test
jboss.jca:service=RARDeployment,name=JBoss LocalTransaction JDBC Wrapper
|
源代码：立即下载
到此，所有的准备工作都做好了，现在只需运行JAS，看一看这台连接Mysql数据库的JAS是否配好了。
如果JAS在Windows下运行正常，就把JAS移植到Linux服务器上。在Linux 服务器上运行JAS要用run.sh来启动。开发前的约定（1）
今天进入可开发前的准备阶段。在开发项目前，要求每位开发小组成员都必须先阅读以下约定，严格按以下约定来进行开发。
系统框架
·系统总框架采用SUN J2EE框架，使用JAVA/XML技术和组件技术， 基于Application server开发。
·项目中的程序必须严格按J2EE1.3规范来编码，EJB建议采用2.0规范编码，尽可能多使用EJB 模式设计，参考技术文档如下：
1.
2.《JBoss 3.0Quick Start Guide》
3. 开发环境
·测试用Application server采用JAS，JAS 配置于Linux OS下，IP地址：192.168.0.6。登录用户名：J2EEOA，密码：J2EEOA。登录ftp工具建议使用SSH Secure Shell或LeapFTP，ftp地址为192.168.0.6:22。
·项目开发源码目录为/home/local/jboss/applications/J2EEOA/src，项目开发文档目录为/home/product/J2EEOA/。
· 数据库服务器IP为192.168.0.222，数据库采用Mysql，管理工具为phpadmin，登录数据库的用户名为test，密码为test。
源代码目录规范
每位开发小组成员一定要绝对遵守以下创建源代码目录的规范。
项目开发目录结构简图：
|
\
|--apps
|--J2EEOA
|--admin
|--components
|--a component
|--modules
|--a module
|--lib
|--ant
|--build.properties |
图片6 项目开发目录结构图
项目开发目录结构说明：
|
\ (说明：根目录)
|--apps (说明：此目录下放应用程序的代码)
|--J2EEOA (说明：此目录为放J2EEOA应用程序的代码)
|--admin (说明：此目录为放项目的admin应用程序的代码)
|--components (说明：此目录下放应用程序组件的代码)
|--a component (说明：此目录为放一个组件的代码)
|--modules (说明：此目录下放应用程序模块的代码)
|--a module (说明：此目录为放一个模块的代码)
|--lib (说明：此目录下放项目开发工具)
|--ant (说明：Ant工具，包括bin和lin目录)
|--build.properties
(说明：此文件定义项目开发共用的环境变量，
如jboss.home、jboss.configuration、servlet-lib.path等) |
模块、组件开发目录结构简图：
|
\
|--build
|--etc
|--multi-langs
|--lib
|--docs
|--ejb
|-- META-INF
|--j2ee
|--META-INF
|--web
|--WEB-INF
|--src
|--ejb
|--javabean
|--servlet
|--web
|--build.bat
|--build.sh
|--build.xml |
图片7 模块、组件目录结构图
说明：src、etc目录和build.bat、build.sh、build.xml为开发人员建立的目录，build和lib目录为由ant工具生成的目录。
模块、组件开发目录结构说明
|
\ (说明：一个模块或一个组件的根目录)
|--build (说明：保存由ant工具生成的扩展名为jar、war、ear等文件)
|--etc
(说明：存放部署文件，如web.xml、ejb-jar.xml、application.xml、
jaws.xml、jbosscmp-jdbc.xml等)
|--multi-langs (说明：存放多语言资源文件，扩展名为properties，)
|--lib (说明：保存由ant工具生成的API文件、class文件等)
|--docs
|--api
|--ejb
|-- META-INF
|--j2ee
|--META-INF
|--web
|--WEB-INF
|--src (说明：存放源代码，包括java和jsp代码，下面有四个目录。)
|--ejb (说明：采用EJB进行开发，存放EJB和Helper Classes源代码。)
|--javabean (说明：采用Javabean进行开发，存放Javabean和Helper Classes源代码。)
|--servlet (说明：存放Servlet源代码。)
|--web (说明：存放JSP源代码。)
|--build.bat (说明：在Window OS下，进行build的文件。)
|--build.sh (说明：在Unix OS下，进行build的文件。)
|--build.xml (说明：Ant工具要build的目标文件。) |
应用程序开发目录结构简图：
|
\
|--build
|--etc
|--lib
|--docs
|--ejb
|-- META-INF
|--j2ee
|--META-INF
|--web
|--WEB-INF
|--team
|--a member
|--ejb
|--javabean
|--web
|--build.bat
|--build.sh
|--build.xml
|--build.properties |
图片8 应用程序目录结构图
应用程序开发目录结构
1. 由于项目由多个程序员一起来进行编码，所以应用程序开发目录结构和模块、组件开发目录结构的不一样。
2. 应用程序开发目录结构没有src目录，但多了一个team目录，此目录存放所有程序员的classes和Jsp代码。
3. 应用程序开发目录结构下build.xml和模块、组件开发目录结构下的build.xml有很大不同。
4. 由项目组长负责管理etc目录、build.xml、build.bat、build.sh、build.properties，程序员分别管理team目录下的属于自己的目录，如程序员tom管理team/tom目录。
开发前的约定（2）
编码规范
· 项目中的JAVA源代码必须按《JAVA开发规范》。
·项目中的JSP代码必须按《JSP开发规范》。
· 每位开发小组成员在开发项目时都严格按此规范来进行编写程序，让项目中所有的文档都看起来像一个人写的，增加可读性，减少项目组中因为换人而带来的损失。
· 每位开发小组成员一定要绝对遵守这个规范。当实际应用与下面的规范相抵触时，记录下原因、潜在后果，以及符合规范需要的条件，但必须是在让程序有良好的可读性的前提下。
功能模块
在做业务逻辑模块前，先把一些准备工作做出来：
建立一些公用的bean（项目中称为系统控制器controller），包名为com.cwap.oa.controller.*，提供给系统各模块使用。包括对时间、字符的操作，调试器，软件国际化，多语言版本，系统的WEB外壳，MVC模式的Servlet和Action，对WEB页面显示的控制如树结构、路径结构；等等。
建立一个序列发生器，包名为com.cwap.oa.sequencegenerator.*，提供给bean使用，它用来产生一个唯一的ID，而且也可用来计数，也就是把它当成计数器使用。介绍如何取id的方法的文字要写在bean的代码内，以便生成API后供其它开发人员参阅。
建立一个ServerFacade，它为EJB Home提供统一的接口。ServerFacade为程序要用到的所有EJB的home handle提供缓存，提高访问效率。以后查找JNDI Name的方法都应写在接口里，调用时直接从接口调用。
建立一个翻页控制器，包名为com.cwap.oa.controller.web.page*，用来进行分页显示的管理，以后页面中的分页都由翻页控制器管理。
异常处理和日志
· 程序中所有的异常处理使用统一的调试器，bean的名称为com.cwap.oa.controller.util.Debug，用法见项目API。
· 程序中所有的日志使用Jakarta-log4j管理，包的名称为log4j-1.2.5.jar
官方URL：
Session
· 放在session中的变量统一放在一个bean里存储，不直接把session变量名称放在JSP、Servlet或Bean内，存储session变量名称的bean为com.cwap.oa.controller.web.util.WebKeys，取session变量名的方法为getXX()。
· 取session变量的值的方法统一放在一个bean里，bean的名称为com.cwap.oa.controller.web.util.JSPUtil，取session变量值的方法为getXX()，之后要取session变量值就调用JSPUtil中对应的方法。
· 当前系统中已知的session变量名有"userid"、"userName"、"locale"、"skin"等，userid为用户标识，userName为用户名称，locale为用户选择的地域，skin为用户选择的界面风格。
DAO
使用DAO封装SQL语言对数据库的直接操作，DAO采用Factory模式编写。
组件
所有的业务逻辑使用组件技术。每个组件内同时提供EJB版本和DAO版本两种的方法,不推荐直接使用EJB版本和DAO版本的方法。
多语言版本
· Bean、Servlet、JSP中的多语言文字采用分离技术，将多语言文字放在资源文件中，保存目录为/WEB-INF/classes/multi-langs或其它目录。
· 当前支持的语言有三种：简体中文（zh_CN）、繁体中文（zh_HK）、英文（en_US）。
· 多语言管理器的名称为com.cwap.oa.controller.util.MultiLangsString，使用方法见本项目API。
WEB外壳
· JSP页面中的图片、CSS、JS等文件都应放在统一目录，目录为/skin/skinName/skinLanguage，其中skinName为外壳名称，skinLanguage为外壳语言版本，例如/skin/green/zh_CN
· 图片放在images目录里，CSS文件放在css目录里，JS脚本放在js目录里，其它资源(如声音、视频、Flash文件等)存放方法见项目API。
· 外壳管理器为com.cwap.oa.controller.web.skin.WebSkin，调用方法统一接口为com.cwap.oa.controller.web.util.JSPUtil。
在线帮助
· 在线帮助管理器为com.cwap.oa.help.*，调用方法统一接口为com.cwap.oa.help.client.HelpClientHelper。
· 每一个JSP页面中提供一个在线帮助链接，用户点击它直接进入到在线帮助中心。
用户管理
· 建立一个取用户名称的页面，功能包括只取一个用户和取多个用户。
· 打开取用户名称页面的方法，使用页面脚本，"javascript:return openWinToGetEmployee(frame,id,name,num)"，当num为0，代表可以取多个用户，否则，只能取1个用户。
权限管理
· 调用方法统一接口为com.cwap.oa.controller.web.util.JSPUtil，检查用户是否有权限的方法为JSPUtil.isPermission(userid, permissions)
· JSP中检验用户身份采用include方式，include的文件为checkUser.jsp
检验用户身份是否是一般用户，调用方法为
检验用户身份是否是管理员，调用方法为
检验用户身份是否是超级管理员，调用方法为
如何完成多语言和多界面风格
今天在开发过程中遇到了些小麻烦：在需求分析中，有这样一个功能“网页风格个性化功能：用户可以选择网页的风格、颜色等”。为了实现此功能，系统中设计了一个外壳管理器。用户选择外壳和语言后，把参数保存在session中，外壳管理器定位JSP页面中图片等资源的路径。美工在设计Demo时，将页面设计成若干界面风格，如包括天蓝色、银白色、翡翠绿、粉红色、紫罗兰、金属、古典、现代等。
系统如何支持多语言版本呢？多语言资源包括文字、标点符号、日期、货币符号、包含文字的图片、声音、视频、图形等。
1.文字、标点符号、日期、货币符号等资源放入资源文件中，由多语言管理器进行统一管理。
2.包含文字的图片、声音、视频、图形等资源放在WEB外壳中，由外壳管理器进行管理。
由外壳管理的资源也可采用多语言管理器来管理。这里采用外壳管理器管理的原因，主要是考虑到WEB页面风格的因素以及WEB的易维护性。
这里以显示多语言文字做一个简单的示例：
|
import com.cwap.oa.controller.util.MultiLangsString;
import com.cwap.oa.controller.util.MultiLangsUtil;
public class MultiLangsDemo{
public static void main(String argv[]){
MultiLangsString multiLangs;
if(argv.length>0){
multiLangs = new MultiLangsString("main",argv[0]);
}else{
multiLangs = new MultiLangsString("main","en_US");
}
if(multiLangs != null){
System.out.println(multiLangs.getStringWithConvert("MAIN_SYSTEM_BUSILY"));
}
}
} |
运行结果画面：
显示多语言文字的Demo程序
源代码：立即下载
这里以在JSP文件中显示多语言图片做一个简单的示例：
|
<%@ page language="java"%>
<%@ page contentType="text/html;charset=GB2312"%>
<%@ page import="com.cwap.oa.controller.web.skin.WebSkin" %>
<%@ page import="com.cwap.oa.controller.web.skin.WebSkinUtil" %>
<%
WebSkin webSkin = new WebSkin("a","zh_CN");
if( webSkin != null )
{
out.print("简体版本:![]()
src=\""+request.getContextPath()+webSkin.getImagesDir()+"/title.jpg\"
border=0>
");
}
WebSkin webSkin_en_US =new WebSkin("a","en_US");
if( webSkin_en_US != null )
{
out.print("英文版本:![]()
src=\""+request.getContextPath()+webSkin_en_US.getImagesDir()+"/title.jpg\"
border=0>
");
}
WebSkin webSkin_zh_HK = new WebSkin("a","zh_HK");
if( webSkin_zh_HK != null )
{
out.print("繁体版本:![]()
src=\""+request.getContextPath()+webSkin_zh_HK.getImagesDir()+"/title.jpg\"
border=0>
");
}
%> |
运行结果画面：
显示多语言图片的例子
源代码：立即下载
下面是将用户喜爱的外壳放在session中，JSP文件中动态显示多语言图片：
|
<%@ page language="java"%>
<%@ page contentType="text/html;charset=GB2312"%>
<%@ page import="com.cwap.oa.controller.web.skin.WebSkin" %>
<%@ page import="com.cwap.oa.controller.web.skin.WebSkinUtil" %>
<%
String skin = (String) session.getAttribute("SKIN");//取用户自定义的外壳
if( skin == null )
{
skin = "a_zh_CN";
}
WebSkin webSkin = WebSkinUtil.getWebSkinFromString(skin);
if( webSkin != null )
{
out.print("![]()
src=\""+request.getContextPath()+webSkin.getImagesDir()+"/title.jpg\"
border=0>");
}
%> |
一个CMP型EJB的例子
在我接手的这个项目中有大量的实体Bean，大部分都采用CMP2.X规范来写的，写多后觉得有总结一下的必要。
下面我就以一个CMP2.X版本的序列发生器的为例，详细讲解编写实体Bean。序列发生器用来提供一个唯一的ID，也可做为一个计数器来使用。
序列发生器实体的分析
实体描述
|
实体 |
描述 |
|
[SequenceGenerator] |
序列发生器用来提供一个唯一的ID，也可做为一个计数器来使用。 |
属性描述
|
属性 |
名称 |
属性描述 |
数据类型 |
SPM（bytes） |
|
|--name |
名称 |
序列发生器的名称 |
字符串 |
25 |
|
|--count |
序列值 |
序列发生器中当前的序列值 |
正整数 |
21 |
序列发生器的设计
下面分别创建序列发生器的一个Bean实体、一个Home接口、一个远程接口、一个Helper类。
Bean实体(the bean implementation)
类
|
类 |
SequenceGeneratorEJB |
|
声明 |
public abstract class |
|
描述 |
序列发生器用来提供一个唯一的ID，也可做为一个计数器来使用。实体如果有自动增加的主键，可通过此类获得唯一的ID。调用时要借助一个Helper类，通过SequenceGeneratorClientHelper.getNextID()方法。 |
|
超类 |
javax.ejb.EntityBean |
|
执行 |
|
构造器
|
构造器 |
构造器描述 |
|
[SequenceGeneratorEJB] |
|
|
|--SequenceGeneratorEJB() |
初始化一个序列发生器实体 |
|
|
|
|
|
方法
|
方法 |
方法描述 |
返回值 |
|
[SequenceGeneratorEJB] |
|
|
|
|--getName() |
获得序列发生器的名称 |
public abstract String |
|
|--setName(String name) |
设置序列发生器的名称 |
|
|
|--getCount() |
获得序列发生器的序列值 |
public abstract long |
|
|--setCount(long count) |
获得序列发生器的序列值 |
public abstract void |
|
|--ejbCreate(String name) |
创建一个序列发生器，创建时的序列值为0 |
public String |
下面是必须定义的方法
|
|--ejbLoad()
|--ejbStore()
|--ejbActivate()
|--ejbPassivate()
|--ejbRemove()
|--setEntityContext(EntityContext context)
|--unsetEntityContext() |
Home接口(the home interface)
·接口
接口：SequenceGeneratorHome
声明：public interface
描述：这是SequenceGeneratorEJB的Home接口。
超类：javax.ejb.EJBHome
执行
·方法
|
方法 |
方法描述 |
返回值 |
|
[SequenceGeneratorHome] |
|
|
|
|--create(String name) |
创建一个序列发生器 |
public abstract SequenceGenerator |
|
|-- findByPrimaryKey(String name) |
通过主键查找一个Remote接口 |
public abstract SequenceGenerator |
远程接口(the remote interface)
·接口
|
接口 |
SequenceGenerator |
|
声明 |
public interface |
|
描述 |
这是SequenceGeneratorEJB的Remote接口 |
|
超类 |
javax/ejb.EJBObiect |
|
执行 |
|
·方法
|
方法 |
方法描述 |
返回值 |
|
[SequenceGenerator] |
|
|
|
|--getName() |
获得序列发生器的名称 |
public abstract String |
|
|--getCount() |
获得序列发生器的序列值 |
public abstract long |
|
|--setCount(long count) |
设置序列发生器的序列值 |
public abstract void |
Helper类
Helper类可以用Session Bean实现，也可以用JavaBean实现，这里使用JavaBean来实现。
·类
|
类 |
SequenceGeneratorClientHelper |
|
声明 |
public class |
|
描述 |
通过SequenceGeneratorClientHelper.getNextID(String name)方法可以获得一个唯一的ID。 |
|
超类 |
|
|
执行 |
java.io.Serializable |
·构造器
|
构造器 |
构造器描述 |
|
[SequenceGeneratorClientHelper] |
|
|
|-- SequenceGeneratorClientHelper () |
初始化Bean，获得Home接口。 |
·方法
|
方法 |
方法描述 |
返回值 |
|
[SequenceGeneratorClientHelper] |
|
|
|
|--getSequenceGeneratorHome |
获得Home接口 |
private static SequenceGeneratorHome |
|
|--getSequenceGenerator (String name) |
获得Remote接口 |
private static SequenceGenerator |
|
|--getNextID(String name) |
获得一个唯一的ID |
public static long |
序列发生器的编码
在编码过程中为序列发生器定义了其它辅助类，如JNDINames.java用来保存序列发生器的Home对象的JNDI名称、SequenceGeneratorClientException.java用来捕捉SequenceGeneratorClientHelper.getNextID(String name)的异常。
写完EJB后，必须为EJB建立部署文件，ejb-jar.xml，关于ejb-jar.xml的编写规范请参照文件
在JAS中部署，必须建立如下部署文件，jboss.xml和jaws.xml或jbosscmp-jdbc.xml, ，关于jboss.xml、jaws.xml和jbosscmp-jdbc.xml的编写规范请分别参照文件、和。
序列发生器组件的源代码
·SequenceGeneratorEJB.java
·SequenceGeneratorHome.java
·SequenceGenerator.java
·SequenceGeneratorClientHelper.java
·SequenceGeneratorClientException.java
·JNDINames.java
·ejb-jar.xml
·jboss.xml
·jasw.xml
源代码：序列发生器的源代码 序列发生器的调用
下面是一个序列发生器的源代码在Servlet中调用的示例，只列出部分代码：
|
…
//导入类SequenceGeneratorClientHelper
import com.cwap.oa.sequencegenerator.client.SequenceGeneratorClientHelper;
…
public void doCreateProcess(HttpServletRequest request, HttpServletResponse
response) throws IOException, ServletException {
…
//获得一个唯一的ID，第一次调用的值为1，之后自动加1
Long lonTmp = new Long(SequenceGeneratorClientHelper.getNextID("meeting"));
meetingModel.setId(lonTmp.toString());
…
} |
提高EJB性能的十大技巧
项目进行到这里，开始出现新的问题。EJB调用是耗时、费力的。怎么提高EJB的性能？我们为解决这一问题，开始边写边讨论。等到完成了，我才发现，我们所应用的技巧总结一下，竟有十条。把提高EJB性能的这些技巧总结一下，为以后的项目做参考。
1.用一个Session Bean封装多个Entity Bean，将原来的多个Entity Bean的Remote调用和Local调用封装在一个Session Bean中。所以建立一个ServerFacade，它为多个对象提供统一获取EJB Home和获取对象的接口。ServerFacade为程序要用到的所有EJB的home handle提供缓存，提高访问JNDI Name的时间，达到提高访问效率的目的。以后查找JNDI Name的方法都应写在接口里，调用时直接从接口调用。
2.在EJB的Remote接口中使用粗粒度的方法，不推荐使用细粒度方法。
3.如果EJB的Remote接口获取成功，应不再使用Remote接口，而是将Remote接口构造成一个一般的JAVA对象，通过调用一般的JAVA对象的方法来达到减少对网络的访问。
4.如果你部署EJB客户端和EJB在相同的JVM上，建设使用EJB2.0规范的Local接口代替Remote接口。
5.用"transient"关键字声明不必要的数据变量，替代以前的"public"、"private"等，避免不必要的数据变量占用网络资源。示例：
|
public class DemoCMP implements EntityBean {
transient EntityContext entCtx;
transient InitialContext initCtx;
public String id;
public String description;
…
} |
6.在ejb-jar.xml部署文件中，对Session Bean中非事务的方法，将trans-attribute属性赋为"NotSupported"或"Never"
|
…
abookesessionBean
*
NotSupported
|
7. 设置事务的超时时间，在JBoss中，要修改${jboss.home}/server/${jboss.configuration}/conf/jboss-service.xml ，如下所示：
|
…
name="jboss:service=TransactionManager">
…
|
8.当事务锁定数据库的行记录时，事务应跨越可能的最小的时间。
9.调整EJB 服务器的各种参数，如线程数、EJB池大小、连接池参数等。以在JBoss修改连接池参数为示例，进行说明。如果JBoss和Mysql相连，配置${jboss.home}/server/${jboss.configuration}/deploy/mysql-service.xml，来修改连接池参数，包括MinSize、MaxSize、BlockingTimeoutMillis、IdleTimeoutMinutes、Criteria等，各参数的含义如下所示：
i.MinSize ：连接池保持的最小连接数。
ii. MaxSize ：连接池保持的最大连接数。
iii. BlockingTimeoutMillis ：抛出异常前最大的等待连接时间。
iv. IdleTimeoutMinutes ：关闭连接前连接空闲的最大时间。
v. Criteria ：有ByContainerAndApplication、ByContainer、ByApplication和ByNothing等值。
下面是一个例子：
|
name="jboss.jca:service=LocalTxPool,name=MySqlDS">
|
10.对于数据库事务，应选择较低成本的事务等级，避免造成坏数据。递增成本的事务等级包括：
|
TRANSACTION_READ_UNCOMMITED,
TRANSACTION_READ_COMMITED,
TRANSACTION_REPEATABLE_READ,
TRANSACTION_SERIALIZABLE |
如何解决EJB-QL的功能不足
我们在这个项目中使用了EJB-QL。在使用中，发现它有很多SQL语法不能用，例如执行一个计数运算，如下面这段示例：
1.这是我在CMP型ABook EJB的部署文件ejb-jar.xml中的一段EJB-QL，它已经被我注释掉了。
2.这是我在CMP型ABook EJB的Home接口中的一段，也被我注释掉了。
|
/**
* Note : This method has been deprecated.
* Reason : The EJB-QL isn't support the following syntax
* select count(*) from ABook a where a.bookId = ?1
public int findCountByBookId(String bookId)
throws RemoteException,FinderException;
*/ |
由于EJB-QL语法不是很丰富，像上面简单的的计数计算都不能做，使我在开发中遇到很多的麻烦。我不得不用其它途径来解决问题，下面是解决CMP型EJB的计数计算的解决办法：
1． 通过Home接口将要计数的记录全部取到，放入Collection对象，然后用进行一些判断，如果Collection为空，count=0，否则，count=Collection.size()
2． 使用DAO来计数，使用Factary模式建立ABookDAOImpl.java，在类中建立getCountOfABookByBookId()方法，代码如下：
|
public int getCountOfABookByBookId(String bookId)
throws ABookDAOSysException {
Connection con = null;
PreparedStatement pstmt = null;
ResultSet rs = null;
Page ret = null;
String strSql="";
try {
con = getDataSource().getConnection();
// Count.
strSql="select COUNT(*) "
+"from "+DatabaseNames.ABOOK_TABLE+" "
+"where bookId = ?";
pstmt=con.prepareStatement(strSql,ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_READ_ONLY);
pstmt.setString(1, bookId);
rs = pstmt.executeQuery();
rs.first();
int total = rs.getInt(1);
rs.close();
pstmt.close();
con.close();
return total;
}catch (SQLException se) {
//throw new ABookDAOSysException("SQLException: "
// + se.getMessage() + " "
// + "SQL = "+strSql+" ");
return 0;
}
} |
3． 使用BMP型EJB来计数，BMP型EJB中应采用DAO技术实现，所以BMP型EJB中的方法基本和上面用DAO中的方法差不多，这里就不写了。
注：在JBoss中，我曾试着用jaws.xml中的finder方法来解决问题，但也失败了。
在EJB-QL中还存在其它问题，如无法进行排序查询的问题等。一旦你在EJB中采用了DAO技术，用EJB-QL不能做的是现在都可以做了。如何用EJB进行关键字搜索？以前我想尽办法，都无法实现得很好，在采用DAO技术后，问题一下子就解决了。随着EJB-QL功能的加强，以后像计数、求和、关键字搜索等问题都会解决，但写CMP型EJB时一定要给出DAO版本的逻辑方法，以保证程序向上兼容。
用env-entry建立可维护系统
EJB的ejb-jar.xml中为开发人员提供了一个“env-entry”元素。用它开发出来的系统可维护性好、可移植性强。当然我们也可以不使用ejb-jar.xml，而是自定义XML文件。我在开发时，利用它定义一些系统缺省的常量，例如系统的缺省用户为guest、系统的缺省用户的职位为employee等。下面是我在做借阅管理时的一个文件ejb-jar.xml的部分代码：
|
param/Qualification/DefaultMaxNumber
java.lang.String
3
param/Qualification/DefaultMaxDay
java.lang.String
60
|
