BEA AquaLogic Data Services Platform 實戰入門：基於 MySQL 建立邏輯資料服務

BEA AquaLogic DSP (Data Services Platform) 是 SOA 架構中「資料存取層」的關鍵中介，負責整合異構資料源、提供統一 XML/關聯視圖並發布為服務。本文以 MySQL 為後端，手把手示範從安裝配置到建立邏輯資料服務的完整流程。

環境準備

• WebLogic 8.1.6 + DSP 2.5 (需 ≥ 512MB 記憶體，建議 1GB+)
• MySQL 建立 Schema VLS 及三張表：emailTemplate、emailTemplatePack、emailTemplateBridge (多對多橋接)
• MySQL Connector/J 放入 WL_HOME/server/lib 並加入 commEnv.cmd 的 WEBLOGIC_CLASSPATH

Workshop 專案建立步驟

1. 新建 Data Service Application → 命名 VLS，自動產生 dataservices 專案
2. 右鍵 Application → New Project → Data Service Project → 命名 EmailTemplate
3. 專案下建立兩資料夾：DS (物理資料服務)、Model (邏輯模型)

導入物理資料服務 (Import Source Metadata)

1. 右鍵 DS → Import Source Metadata
2. 啟動內嵌 WebLogic Server (等待 "server started in running mode")
3. 新建 Data Source：選擇 com.mysql.jdbc.Driver，URL 格式 jdbc:mysql://:3306/VLS
4. 勾選三張表完成導入，產生 emailTemplate.ds、emailTemplatePack.ds、emailTemplateBridge.ds

建立邏輯模型與 XML Schema

1. Model 資料夾新增 Model Diagram (EmailTemplate.md)，拖入三個 DS 觀察關聯
2. 右鍵 Diagram 空白處 → Create XML Type → 產生 emailTemplateList.xsd
3. 編輯 XSD：根元素 emailtemplatelist 包含 emailTemplatePackID、emailTemplatePackName、巢狀 EmailTemplateList/emailTemplate* (含 ID、TriggerName、SendMode、Subject、Text、DaysThreshold、CC/BCC Address)

編寫 XQuery 邏輯服務函數

1. 右鍵 emailTemplateList.ds → 新增函數 getEmailTemplatePack()
2. 進入 XQuery Editor，依序拖入三個物理 DS 函數：emailTemplatePack()、emailTemplate()、emailTemplateBridge()
3. 建立關聯映射：
   • emailTemplatePack.emailTemplatePackID = emailTemplateBridge.emailTemplatePackID
   • emailTemplateBridge.emailTemplateID = emailTemplate.emailTemplateID
4. 切換 Source View 微調產生的 XQuery，確保命名空間宣告正確

declare namespace ns15="ld:EmailTemplate/emailtemplatepack";
declare namespace ns17="ld:EmailTemplate/emailtemplatebridge";
declare namespace ns16="ld:EmailTemplate/emailtemplate";
import schema namespace ns11="ld:EmailTemplate/emailtemplatelist" at "ld:EmailTemplate/schemas/emailtemplatelist.xsd";

declare function ns14:getEmailTemplatePack() as element(ns11:emailtemplatelist)*
{
  for $pack in ns15:emailtemplatepack()
  return
    
      {fn:data($pack/emailTemplatePackID)}
      {fn:data($pack/emailTemplatePackName)}
      
        {
          for $bridge in ns17:emailtemplatebridge()
          where $pack/emailTemplatePackID = $bridge/emailTemplatePackID
          for $tmpl in ns16:emailtemplate()
          where $bridge/emailTemplateID = $tmpl/emailTemplateID
          return
            
              {fn:data($tmpl/emailTemplateID)}
              {fn:data($tmpl/emailTemplateTriggerName)}
              {fn:data($tmpl/emailTemplateSendMode)}
              {fn:data($tmpl/emailTemplateSubject)}
              {fn:data($tmpl/emailTemplateText)}
              {fn:data($tmpl/emailTemplateDaysThreshold)}
              {fn:data($tmpl/emailTemplateCCAddress)}
              {fn:data($tmpl/emailTemplateBCCAddress)}
            
        }
      
    
};

測試與驗證

1. 切換至 Test View，點擊 Execute
2. 結果呈現：每個 emailTemplatePack 依橋接表聚合其所有 emailTemplate，輸出符合 XSD 的 XML

關鍵收穫

• DSP 以 物理 DS (直連 DB) + 邏輯 DS (XQuery 組合) 分層，實現資料虛擬化
• Model Diagram 視覺化關聯，降低複雜度
• XQuery 處理巢狀聚合極為直觀，符合 XML 導向 SOA 需求
• MySQL 驅動部署是常見坑點，務必加入 Classpath 並重啟 Server

完成此 Demo，你已掌握 DSP 核心開發流程，可進一步探索快取、更新圖、安全性等進階特性。