部署基于JBoss 的 J2EE应用程序

　　JBoss，作为J2EE应用服务器，以其EJB容器卓越的性能、技术的潮流性、开发部署J2EE应用的方便性赢得了很多J2EE开发者的信赖。其中，免安装、基于JMX构架、热部署（Hot Deploy）、快速开发EJB应用等几项特征与其他商用服务器相比，显得有些得意忘形的样子。尽管其本身没有重大的缺陷，但毕竟是Open Source的开发模式，文档很少，因此要很好的掌握、精通开发基于JBoss的应用还是显得有些力不从心。
　　
　　本文结合作者的开发经验，给出在JBoss 3.2.1下开发J2EE的一些很实用的相关的注意事项和规则。其中，读者一定要知道JBoss 3.2.1作为JBoss的过渡产品（与JBoss 3.0.x、JBoss 4.x相比），自然有些东西和JBoss 3.0.x、JBoss 4.x有很大差别。但是，一般情况下，本文介绍的内容，大体上都适合JBoss各个版本。
　　
　　下载完JBoss 3.2.1后，解压到一个没有空格的目录路径下面就可以运行JBoss，所以很方便，但前提是目标机器安装了Java 2 Standard Edition。一切就绪后，我们就开始吧。（假设JBoss 3.2.1安装在：C:\jboss-3.2.1_tomcat-4.1.24，本使用default配置）
　　
　　一、相关配置文件的设置
　　
　　为开发J2EE应用，操作数据库成了必不可少的内容；调节日志输出的详细程度成了调试J2EE应用的关键；EJB应用的调优过程是J2EE应用的核心。
　　
　　1. 数据源的配置：
　　
　　在JBoss 3.2.1中，配置数据源的步骤很简单，JBoss 3.2.1本身带了主流数据库的配置实例，于目录下：C:\jboss-3.2.1_tomcat-4.1.24\docs\examples\jca。具体使用哪个配置文件取决于目标用户的数据库。如果是SQL Server 2000，则需要使用mssql-ds.xml文件（支持本地事务）或者mssql-xa-ds.xml文件（支持全局事务）；如果是Oracle 9i数据库，则需要使用oracle-ds.xml文件或者oracle-xa-ds.xml文件等。这里以SQL Server 2000为例。
　　
　　首先将mssql-ds.xml文件拷贝到目录：C:\jboss-3.2.1_tomcat-4.1.24\server\default\deploy下。然后打开文件，并作如下修改：
　　
　　<datasources>
　　<local-tx-datasource>
　　<jndi-name>VSSDB</jndi-name>
　　<connection-url>jdbc:microsoft:sqlserver://125.16.45.158:1433;DatabaseName=DDD
　　</connection-url>
　　<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>
　　<user-name>sa</user-name>
　　<password>sa</password>
　　<min-pool-size>50</min-pool-size>
　　<max-pool-size>200</max-pool-size>
　　</local-tx-datasource>
　　</datasources>
　　
　　如果目标J2EE应用只需要本地事务，则上述过程已经完成了Datasource的配置，同时这个配置将用于JDBC以及EJB通过JNDI使用。如果要实现EJB使用Datasource，则还需要修改位于目录：C:\jboss-3.2.1_tomcat-4.1.24\server\default\conf下的standardjbosscmp-jdbc.xml文件。比如：
　　
　　<jbosscmp-jdbc>
　　
　　<defaults>
　　<datasource>java:/VSSDB1</datasource>
　　<datasource-mapping>MS SQLSERVER2000</datasource-mapping>
　　
　　<create-table>true</create-table>
　　<remove-table>false</remove-table>
　　<read-only>false</read-only>
　　<time-out>300</time-out>
　　<pk-constraint>true</pk-constraint>
　　<fk-constraint>false</fk-constraint>
　　
　　其中，java:/VSSDB中的VSSDB就是mssql-ds.xml配置的数据源；而“java:/”前缀表明该命名空间只是对JBoss本身可见，即运行于JBoss外的应用是不能够使用这里定义的数据源，这一点希望注意。
　　
　　其次，MS SQLSERVER2000中的MS SQLSERVER2000可以在该文件的其他地方找到。（如果是其他数据库，情况都是类似的）
　　
　　2. 日志的输出详细程度配置：
　　
　　由于JBoss 3.2.1开发采用了Log4j管理其日志信息（严格地讲，它扩展了Log4j），因此了解Log4j的机理，有助于理解JBoss 3.2.1管理日志的方式。JBoss 3.2.1采用JMX架构的同时，且以.xml文件类型为配置文件，因此可以找到位于目录：C:\jboss-3.2.1_tomcat-4.1.24\server\default\conf下的log4j.xml文件。比如，其中一段配置示例如下：
　　
　　<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
　　<param name="Target" value="System.out"/>
　　<param name="Threshold" value="INFO"/>
　　
　　<layout class="org.apache.log4j.PatternLayout">
　　<!-- The default pattern: Date Priority [Category] Message\n -->
　　<param name="ConversionPattern" value="%d{ABSOLUTE} %-5p [%c{1}] %m%n"/>
　　</layout>
　　</appender>
　　
　　比如，为了调节JBoss 3.2.1控制台日志输出的详细程度（调整为DEBUG级别），我们需要修改value=”INFO”，将INFO改为DEBUG。 如果开发Entity Beans，可以调节位于与log4j.xml文件同一目录下的standardjboss.xml文件（该文件主要是提供修改EJB相关的调试、运行、调优、部署参数）。如果Entity Beans采用的为Standard CMP 2.x EntityBean，则将其中的属性的取值改为true。
　　
　　<container-configuration>
　　<container-name>Standard CMP 2.x EntityBean</container-name>
　　<call-logging>false</call-logging>
　　<invoker-proxy-binding-name>entity-rmi-invoker</invoker-proxy-binding-name>
　　<sync-on-commit-only>false</sync-on-commit-only>
　　
　　完成上述两步后，在调试Entity Beans时通过控制台，可以看到Entity Beans发出的JDBC调用细节。
　　
　　3. Tomcat容器相关参数的配置：
　　
　　如果使用JBoss 3.2.1与Tomcat 4.1.24的集成版本，则可以通过调节分别位于目录：C:\jboss-3.2.1_tomcat-4.1.24\server\default\deploy\jbossweb-tomcat.sar下的web.xml和目录：C:\jboss-3.2.1_tomcat-4.1.24\server\default\deploy\jbossweb-tomcat.sar\META-INF下的jboss-service.xml文件来达到目标读者特定需求。比如，如果想将HTTP服务端口改为80，则可以修改jboss-service.xml文件；如果想使目标J2EE应用处理更多的文件类型，可以修改web.xml文件。
　　
　　4. 相关类库的放置：
　　
　　如果应用涉及到第三方类库，比如JDBC Driver，则可以将这些JDBC Driver存放到目录下：C:\jboss-3.2.1_tomcat-4.1.24\server\default\lib。注意，不是目录：C:\jboss-3.2.1_tomcat-4.1.24\lib下。
　　
　　如果是与目标J2EE应用相关，则可以存放到目标.war（或者.ear）里面，或者xxx.war目录中的WEB-INFO\lib下。无论那种情形，都需要遵循J2EE规范。当然，JBoss 3.2.1的配置文件有很多，比如还有提供邮件服务的mail-service.xml文件等。
　　
　　二、开发EJB应用
　　
　　如果开发EJB应用，建议采用JBoss作为开发服务器，因为开发、调试、部署速度快。如果采用其他商用服务器，由于实现机理的不同，其编译的速度很慢。如果采用Entity Beans技术，则您需要知道这几点。第一，您目标系统的数据源有多少个操作入口，即是否存在Entity Beans之外的方式来操作数据库。如果有，则需要调节相应的提交策略以及策略。
　　
　　比如，JBoss 3.2.1采用的方式有4种：A、B、C、D。当然，如果除了Entity Beans访问数据库外，别无它出，采用A是很理智的。如果有，则需要取决于具体的情况使用方式。同时，方式的选择与策略有关系。能够采用的Entity Beans或Entity Beans Methods，则尽量采用，这样会减少或消除死锁发生的可能性。尽量采用1:n的关系来操作n方的数据表结构，这样能够提高EJB Container的效率。
　　
　　一般情况下，J2EE应用服务器支持JDBC事务、JTA事务、容器管理事务。同时，最好不要在程序中同时使用上述三种事务类型，比如在JTA事务中嵌套JDBC事务；第二方面，事务要在尽可能短的时间内完成，不要在不同方法中实现事务的使用。比如，下面给出了回滚JDBC事务的代码示例：
　　
　　public void processT(String orders) {
　　Context initCtx = new InitialContext();
　　javax.sql.DataSource ds = javax.sql.DataSource)initCtx.lookup
　　(“java:comp/env/jdbc/OrdersDB”);
　　java.sql.Connection conn = ds.getConnection();
　　try{
　　conn.setAutoCommit( false ); //更改JDBC事务的默认提交方式
　　orderNo = createOrder( orders );
　　updateOrderStatus(orderNo, “orders created”);
　　conn.commit();//提交JDBC事务
　　}catch( Exception e ){
　　try{
　　conn.rollback();//回滚sJDBC事务
　　throw new EJBException(“事务回滚： “ + e.getMessage());
　　}catch( SQLException sqle ){
　　throw new EJBException(“出现SQL操作错误： “ + sqle.getMessage());
　　}
　　}
　　}
　　
　　下面给出了JTA事务代码示例：
　　
　　public void processOrder(String orderMessage) {
　　UserTransaction transaction = mySessionContext.getUserTransaction();//获得JTA事务
　　try{
　　transaction.begin();//开始JTA事务
　　orderNo = sendOrder(orderMessage);
　　updateOrderStatus(orderNo, “order sent”);
　　transaction.commit();//提交JTA事务
　　}catch(Exception e){
　　try{
　　transactio