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.24docsexamplesjca。具體使用哪個配置文件取決於目標用戶的數據庫。如果是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.24serverdefaultdeploy下。然後打開文件,並作如下修改:
<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調用細節。