軟體版本與安裝路徑
| 元件 | 版本 | 安裝路徑 |
| JDK | 1.4.2_06 | D:\j2sdk1.4.2_06 |
| JBoss | 4.0.1 RC1 | D:\jboss4.0 |
| Oracle | 9i | (客戶端/伺服器均已安裝) |
| JBuilder | 2005 | (IDE 安裝路徑) |
環境變數設定
JAVA_HOME = D:\j2sdk1.4.2_06
JBOSS_HOME = D:\jboss4.0
PATH += %JAVA_HOME%\bin;%JBOSS_HOME%\bin
JBuilder 整合 JBoss
- Tools → Config Servers
- 選擇 JBoss 3+
- 勾選 Enable Server
- Home Directory 指向
D:\jboss4.0
- 確定 → JBuilder 即可在「伺服器」視圖啟動/停止/除錯 JBoss
JBoss 配置 Oracle 9i 資料源 (XA 交易型)
- 複製 Oracle JDBC 驅動至 JBoss 類路徑:
copy classes111.zip classes12.zip → %JBOSS_HOME%\server\default\lib\
- 複製 XA 資料源範本:
copy %JBOSS_HOME%\docs\examples\jca\oracle-xa-ds.xml
→ %JBOSS_HOME%\server\default\deploy\
- 修改
oracle-xa-ds.xml 關鍵屬性:
<datasources>
<xa-datasource>
<jndi-name>OracleDS</jndi-name>
<track-connection-by-tx/>
<xa-datasource-class>oracle.jdbc.xa.client.OracleXADataSource</xa-datasource-class>
<xa-datasource-property name="URL">jdbc:oracle:thin:@localhost:1521:oradb</xa-datasource-property>
<xa-datasource-property name="User">hrms</xa-datasource-property>
<xa-datasource-property name="Password">hrms</xa-datasource-property>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>Oracle9i</type-mapping>
</metadata>
</xa-datasource>
</datasources>
- 若非 XA 需求,改用
oracle-ds.xml (LocalTxDataSource)
驗證資料源連線 (JSP 測試頁)
%JBOSS_HOME%\server\default\deploy\ 新建 db_test.war 資料夾
- 建立
index.jsp:
<%@ page import="java.sql.*, javax.sql.DataSource, javax.naming.InitialContext" %>
<h3>測試 JBoss 連接 Oracle 9i</h3>
<%
InitialContext ctx = new InitialContext();
DataSource ds = (DataSource) ctx.lookup("java:/OracleDS");
Connection conn = ds.getConnection();
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT TO_CHAR(SYSDATE,'YYYY-MM-DD HH24:MI:SS') FROM DUAL");
while (rs.next()) out.println(rs.getString(1) + "<br/>");
conn.close();
%>
- 建立
WEB-INF/web.xml、WEB-INF/jboss-web.xml (標準最小配置)
- 瀏覽器開啟
https://localhost:8080/db_test → 顯示資料庫時間即成功
架構圖解
JBuilder 2005 (IDE/除錯)
↓ 控制
JBoss 4.0 (應用伺服器/EJB 容器)
↓ JNDI 查找 DataSource
Oracle 9i (資料庫)
↑ JDBC Thin Driver (classes12.zip)
常見問題
NameNotFoundException: OracleDS not bound → 檢查 oracle-xa-ds.xml 是否在 deploy 目錄、JNDI 名稱拼寫
ClassNotFoundException: oracle.jdbc.xa.client.OracleXADataSource → 驅動 jar 未放入 server/default/lib
- 連線逾時 → 檢查 Oracle 監聽器、防火牆、
tnsnames.ora、URL 格式