WebSphere Application Server V7 整合 IBM solidDB V6.3 與 OpenJPA 實戰指南

隨著企業對高性能數據處理需求的增長，內存數據庫成為關鍵選擇。IBM solidDB 作為高速內存關係型數據庫，配合 Apache OpenJPA 持久化提供者，可在 WebSphere Application Server V7 環境下構建極具性能優勢的 Java EE 應用。本文將通過一個 CTI（計算機電話集成）示例應用，詳細演示從環境搭建到部署運行的完整流程。

技術背景與架構優勢

JPA 標準化優勢： Java Persistence API (JPA) 作為 EJB 3.0 規範核心部分，統一了 Hibernate、TopLink、JDO 等框架精華，讓開發者針對標準 API 編碼，避免廠商鎖定。IBM 的 JPA 實現基於 Apache OpenJPA，提供企業級支援。

solidDB 核心特性：

• 純內存架構，讀寫性能最高達傳統磁盤數據庫 10 倍
• 支援 JDBC 2.0 標準，Type 4 純 Java 驅動，跨平台部署
• 高可用性與故障轉移機制，適合性能關鍵型場景
• 可作獨立數據庫或傳統數據庫（DB2/Oracle/SQL Server）緩存層

示例應用：CTI 系統領域模型

模擬呼叫中心場景，核心組件包括：

• Message Facade (MDB)：接收 PBX/ACD 異步消息，轉換為 Value Object 分發
• Session Facade (SLSB)：提供實體 CRUD 操作，如 createCaller、updateAgent
• Value Object (POJO)：攜帶座席/呼叫者屬性，支援 XML 序列化
• Data Access Object：封裝 JPA 持久化邏輯，操作 solidDB 存儲實體

系統通過 JMS 接收狀態變更，利用 solidDB 內存特性實時緩存座席與呼叫者狀態，保障智能路由決策的數據一致性。

開發環境構建步驟

1. Rational Application Developer V7.5 配置

• 關閉自動構建：Project → Build Automatically 取消勾選
• 導入 Project Interchange 文件：File → Import → Other → Project Interchange
• 設置類路徑變量 WAS_HOME 指向 WebSphere 安裝目錄（如 d:\IBM\SDP75\runtimes\base_v7）
• 添加字符串替換變量 WAS_HOME 同樣指向安裝目錄
• 修改 CTIServices/build.properties 中 was.home 屬性
• 執行 Project → Clean 全量構建，確保無錯誤

2. solidDB 獨立數據庫部署

# 1. 安裝 solidDB 6.3，假設安裝目錄 d:\IBM\SolidDB
# 2. 創建數據庫實例
.\bin\solid -c eval_kit\standalone
# 提示輸入系統目錄、用戶名、密碼，均可設為 "dba"

# 3. 執行建表腳本
.\bin\solsql "tcp localhost 1315" dba dba ^\CTIEntities\dml\createTablesSolid.ddl

# 4. 導入測試數據
.\bin\solsql "tcp localhost 1315" dba dba ^\CTIEntities\dml\createDataSolid.sql

<WS> 為 RAD 工作空間路徑（如 d:\workspaces\usingjpawithsoliddb）。

3. WebSphere 測試環境配置

• 創建 Server：Window → Show View → Servers → New → WebSphere Application Server V7.0
• 啟動驗證無錯誤
• 獲取 Bootstrap Address 端口：管理控制台 → Application servers → server1 → Ports，記錄 BOOTSTRAP_ADDRESS 值
• 修改 CTIServices/ejbModule/jndi.properties 中端口號匹配實際值

應用部署與運行驗證

1. 將 CTIApplication 添加至 Server 部署列表
2. 監控控制台輸出，確認 WSVR0221I: Application started: CTIApplication
3. 運行 JUnit 測試：StateManagerTest.java → Run As → Run Configurations
4. 類路徑添加 CTIServices_withStubs.jar 以支援遠程 EJB 調用
5. 驗證三個測試用例全部通過

關鍵持久化配置：persistence.xml 解析

文件位於 META-INF/persistence.xml，核心屬性配置如下：

<persistence version="1.0" xmlns="https://java.sun.com/xml/ns/persistence">
    <persistence-unit name="CTIPU">
        <properties>
            <property name="openjpa.ConnectionDriverName" value="solid.jdbc.SolidDriver" />
            <property name="openjpa.ConnectionURL" value="jdbc:solid://localhost:2315/dba/dba" />
            <property name="openjpa.ConnectionUserName" value="dba" />
            <property name="openjpa.ConnectionPassword" value="dba" />
            <!-- 可選：solidDB 專用詞典，若無則回退通用 JDBC 詞典 -->
            <property name="openjpa.jdbc.DBDictionary" value="org.apache.openjpa.jdbc.sql.SolidDBDictionary" />
        </properties>
    </persistence-unit>
</persistence>

注意： 因 solidDB 非 OpenJPA 內建支援數據庫，若未提供專用 DBDictionary，將使用通用 JDBC 詞典，功能受限但本示例測試無問題。生產環境建議貢獻或使用社區實現的 SolidDBDictionary。

總結與展望

本文完整演示了在 WAS V7 上整合 solidDB 6.3 與 OpenJPA 的全流程：環境準備、數據庫部署、應用配置、部署驗證。該方案充分發揮內存數據庫極致性能，適用於實時決策、高頻交易、緩存加速等場景。IBM 已將 solidDB 正式支援納入 OpenJPA 需求清單，未來版本將提供原生詞典支援，進一步釋放性能潛力。

完整源碼下載：usingjpawithsoliddb.zip