JBoss 3.2.1 部署 J2EE 應用實戰指南：資料源、日誌與 EJB 調優

前言

JBoss 憑藉免安裝、JMX 架構、熱部署、EJB 開發效率高等特性，深受開發者喜愛。但文檔較少，掌握起來頗費周折。本文結合實戰經驗，梳理 JBoss 3.2.1 (default 配置) 的核心配置要點，內容大體適用於各版本 JBoss。

一、 資料源配置：讓應用連上資料庫

1. 選擇範本並部署

JBoss 自帶主流資料庫範本，位於 docs/examples/jca/。以 SQL Server 2000 為例：

• 本地事務：複製 mssql-ds.xml 到 server/default/deploy/
• 全域事務：複製 mssql-xa-ds.xml

2. 修改關鍵屬性

<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>

3. EJB 專用資料源映射 (CMP)

編輯 server/default/conf/standardjbosscmp-jdbc.xml：

<jbosscmp-jdbc>
  <defaults>
    <datasource>java:/VSSDB</datasource>
    <datasource-mapping>MS SQLSERVER2000</datasource-mapping>
    <create-table>true</create-table>
    <remove-table>false</remove-table>
    ...
  </defaults>
</jbosscmp-jdbc>

注意：java:/ 前綴表示該 JNDI 名稱僅在 JBoss 內部可見，外部應用無法直接使用。

二、 日誌輸出詳細度調節：Log4j 機制

JBoss 3.2.1 採用擴展版 Log4j，配置檔在 server/default/conf/log4j.xml。

調整 Console 輸出等級為 DEBUG

<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
  <param name="Threshold" value="DEBUG"/>  <!-- 改這裡：INFO → DEBUG -->
  <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%d{ABSOLUTE} %-5p [%c{1}] %m%n"/>
  </layout>
</appender>

開啟 Entity Bean JDBC 細節日誌

同目錄下 standardjboss.xml，找到 Standard CMP 2.x EntityBean 區塊：

<container-configuration>
  <container-name>Standard CMP 2.x EntityBean</container-name>
  <call-logging>true</call-logging>  <!-- 改為 true -->
  ...
</container-configuration>

完成後，主控台將輸出 Entity Bean 發出的每一條 JDBC 語句，極利於 SQL 調優。

三、 避坑提醒

• 安裝路徑不可包含空格，否則啟動腳本易出錯。
• JBoss 3.2.1 為過渡版本，與 3.0.x、4.x 差異較大，配置時以對應版本文檔為準。
• 生產環境務必調整連線池大小、移除預設範例應用、啟用安全認證。