JBuilder 7 + JBoss 3 + VSS 團隊開發 EJB 完整實戰指南

技術棧選型理由

商業組合 WebSphere + VisualAge 功能強大但造價高昂（~10 萬人民幣）。開源組合 JBuilder 7 + JBoss 3.0.4 + MS SQL Server 2000 + VSS 6.0 成本極低，功能覆蓋建模、版本控制、EJB 開發、Web 發布全生命週期，適合中小團隊。

一、基礎環境安裝與配置

1. JDK / J2EE 環境變數

JAVA_HOME=C:\j2sdk1.4.0
J2EE_HOME=C:\j2ee
CLASSPATH=.;%JAVA_HOME%\lib\tools.jar;%J2EE_HOME%\lib\j2ee.jar
PATH=%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;%J2EE_HOME%\bin

驗證：javac Test.java、j2ee -verbose + 瀏覽器 https://localhost:8000 見 J2EE 默認頁。

2. JBoss 3.0.4 + Tomcat 4.0.6 安裝

下載 jboss-3.0.4_tomcat-4.0.6.zip 解壓至 F:\jboss-3.0.4_tomcat-4.1.12。

3. MS SQL Server 2000 JDBC 驅動

微軟官網下載 SQL Server 2000 Driver for JDBC，安裝後取 msbase.jar、mssqlserver.jar、msutil.jar。

二、JBoss 數據源配置

1. 將三個 JAR 複製到 <JBoss>/server/default/lib。
2. 複製 docs/examples/jca/mssql-service.xml、mssql-xa-service.xml 到 server/default/deploy。
3. 修改 mssql-service.xml：

<config-property name="ConnectionURL">jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=Northwind</config-property>
<config-property name="UserName">sa</config-property>
<config-property name="Password">csdn</config-property>
<config-property name="DriverClass">com.microsoft.jdbc.sqlserver.SQLServerDriver</config-property>

mssql-xa-service.xml 同步修改 ServerName/DatabaseName。

三、JBuilder 整合配置

1. 數據庫驅動註冊： Tools → Enterprise Setup → Database Drivers → Add → 選擇三個 JAR。
2. 服務器配置： Tools → Configure Servers → JBoss 3.X → Enable
   Home: F:\jboss-3.0.4_tomcat-4.1.12
   Main Class: org.jboss.Main
   VM Params: -ms64m -mx64m -Dprogram.name=run.bat
   Custom → JBoss Installation Dir / Tomcat 4X JBuilder Installation Dir / Configuration: default
3. 庫文件： Tools → Configure Libraries → New → JBoss Libs → 加入 javax.servlet.jar、jboss-j2ee.jar。
4. Database Pilot 驗證： 新建連接，Driver: com.microsoft.jdbc.sqlserver.SQLServerDriver，URL 同 JBoss 配置，可瀏覽 Northwind 表。

四、EJB 開發全流程（CMP 2.0 + Session Facade）

1. 專案結構

• Project: JBossDemo → EJB Module: JBossDemoModule (EJB 2.0, XML)
• Required Libraries 加入 JBoss Libs，Server 綁定 JBoss 3.X。

2. 反向工程生成 CMP Entity Bean

1. DataSource 視圖 → Import Schema From Database → 選擇 Northwind 連接（JNDI: java:/MSSQLDS）。
2. 右鍵 Employees、Orders 表 → CMP 2.0 Entity Bean。
3. 建立關係：Employees (1) ↔ (N) Orders，自動生成 orders 集合字段。
4. JBossCMP-JDBC 頁籤設置：datasource=MSSQLDS、datasource-mapping=Hypersonic SQL（實際應改為 MS SQLSERVER2000，此處原文存疑）。

3. Session Facade: GetData

• Create EJB → Session Bean: GetData、Remote、方法 GetOrdersByEmployeesID(Integer) : Vector。
• 實現邏輯：JNDI 查找 EmployeesHome → findByPrimaryKey → 遍歷 getOrders() 收集 OrderID 返回。

4. Web 層：兩個 Servlet

• FormServlet (doGet) — 輸入 EmployeeID 表單提交到 ShowOrdersServlet。
• ShowOrdersServlet (doPost) — 參數 EmployeeID，JNDI 查找 GetDataHome → 調用業務方法 → 顯示訂單列表。

5. 打包部署

• WebApp 依賴設置 Exclude All，新建 EAR: JBossDemo.ear 包含 EJB Module + WebApp。
• Rebuild Project → Deploy EAR 到 JBoss server/default/deploy。
• 測試：https://localhost:8080/JBossDemo/formservlet 輸入 3 → 顯示該員工訂單。

五、VSS 6.0 團隊版本控制

1. 服務端搭建

• 安裝 VSS 6.0（VS 6.0 組件或獨立版），創建數據庫 D:\VSSDB，啟用項目安全性，配置用戶權限。
• 創建項目 daxt。

2. JBuilder 整合 VSS

1. Team → Select Project VCS → Visual SourceSafe。
2. Team → Place Project into VSS → 指定 VSS 安裝目錄/win32、數據庫路徑、Admin 帳號、選擇專案文件 → 完成上傳。

3. 團隊成員獲取專案

• 客戶端安裝 NETSETUP.EXE 或映射服務器 win32 目錄。
• JBuilder → Team → Pull Project from VSS → 映射數據庫路徑、輸入個人帳號、選擇項目、指定本地空目錄 → 完成下載。

4. 日常操作規範

• 修改前： 右鍵文件 → Visual SourceSafe → Check Out。
• 修改後： Check In，他人方可見更新。
• 新增文件： 右鍵 → Add to VSS。
• 刪除文件： Check Out → Delete；若 VSS 卡死，任務管理器結束 ss.exe 進程或用 VSS Explorer 清理。
• 獲取最新： Team → Commit Browser → 選擇變更 → Commit。

六、常見問題與避坑

• JBoss 版本差異大，嚴格對應版本（3.0.4 + Tomcat 4.0.6）。
• JDBC 驅動若 JBuilder 連不上庫，複製三個 JAR 到 JBuilder/lib。
• CMP 關係映射需在 EJB Extension Editor 配置 Finder SQL（EJB QL/Where Clause）。
• EAR 部署時 WebApp 依賴設置 Exclude All 避免重複打包 EJB 類。

結語

本文完整記錄了從零搭建 JBuilder+JBoss+SQL Server+VSS 開發環境、EJB 開發全流程到團隊協作規範的實戰經驗，旨在幫助團隊快速上手、避開配置陷阱。歡迎交流指正：peiwen_lin@163.net