ColdFusion + DB2 UDB：快速構建企業級 Web 應用的實戰指南

案例背景：用戶界面圖形庫（UIGR）

IBM 多倫多實驗室開發的 UIGR Web 應用，供設計、開發、文檔、人因工程師檢索超萬張軟件界面截圖。技術棧：

• DB2 UDB V8.2 (JDK 1.4.1)
• Macromedia ColdFusion MX Standard
• Apache 2.0.48 Web Server
• OS：Windows Server 2003 / Linux

架構與工作流

Apache 接收請求 → 轉發 .cfm/.cfc 給 ColdFusion 處理 → ColdFusion 按需讀寫 DB2 → 返回解析後 HTML → Apache 響應瀏覽器。

安裝順序建議：Apache → DB2 → ColdFusion，以便自動配置連接器與驅動。

DB2 數據源配置（兩種方式）

方式一：DB2 Configuration Assistant

1. 啟動 CA → Add Database Using Wizard。
2. 協議選 Local（本地安裝）。
3. 選擇實例與數據庫，設置別名（ColdFusion 將引用此別名）。
4. 註冊為 ODBC Data Source 供 ColdFusion 使用。

方式二：Windows ODBC Data Source Administrator

1. Control Panel → Administrative Tools → Data Sources (ODBC) → Add。
2. 選擇 DB2 驅動，填入上述別名。

ColdFusion Administrator 配置數據源

1. 登錄 CF Admin → Data Sources。
2. Data Source Name 輸入 CF 專用名（如 CF_TEST2），Driver 選 DB2 (JDBC/ODBC)。
3. 點擊創建後，在屬性頁選擇剛註冊的 ODBC DSN，填入 DB2 用戶/密碼，勾選 Verify All Connections 測試。

Apache httpd.conf 關鍵修改

確保 DirectoryIndex 包含 index.cfm，並載入 JRun 模塊映射 CF 擴展名：

DirectoryIndex index.html index.html.var index.cfm
# JRun Settings
LoadModule jrun_module "D:/CFusionMX/runtime/lib/wsconfig/1/mod_jrun20.so"
<IfModule mod_jrun20.c>
  JRunConfig Verbose false
  JRunConfig Apialloc false
  JRunConfig Ssl false
  JRunConfig Ignoresuffixmap false
  JRunConfig Serverstore "D:/CFusionMX/runtime/lib/wsconfig/1/jrunserver.store"
  JRunConfig Bootstrap 127.0.0.1:XXXXX
  AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc
</IfModule>

CFML 核心標簽實戰

Application.cml：全局設置

<cfapplication name="DB2_UIGR" sessionmanagement="yes">
<cfset DSN = "CF_TEST2">
<cfset timeOut = 20*60>
<cfset schemaName = "Administrator">

• cfapplication 定義應用名與會話管理。
• cfset DSN 集中管理數據源名，便於切換環境。
• schemaName 變量化 Schema，避免硬編碼。

查詢與輸出：<cfquery> + <cfoutput>

<cfquery name="getBrand" datasource="#DSN#">
  SELECT brand_id, brandname FROM UIGR_Brand ORDER BY brandname
</cfquery>
<cfquery name="getUIgraphictype" datasource="#DSN#">
  SELECT uigt_id, uigtname FROM UIGR_uigraphictype ORDER BY uigtname
</cfquery>
<form action="results1.cfm" method="get">
  <select name="Brand" size="7">
    <cfoutput query="getBrand">
      <option value="#brandname#">#brandname#</option>
    </cfoutput>
  </select>
</form>

• cfquery 的 name 作為結果集標識，datasource 引用全局 #DSN#。
• SQL 直接寫在標簽體中，DB2 執行並返回結果集。
• cfoutput query="getBrand" 迭代結果集，每行生成一個 <option>，變量以 #var# 形式引用。

結語

ColdFusion 的標簽式語法極大降低了 Web 應用開發門檻，配合 DB2 UDB 的穩健性能與開放標準支持，構建企業級應用既快速又可靠。掌握 cfquery/cfoutput 核心模式，即可覆蓋 80% 的數據交互場景。