DODS 學習日記（二）：DOML 文件結構與代碼生成入口詳解

DOML 定義

DOML (Database Object Modeling Language) 是 DODS 的核心輸入文件，基於 XML 定義資料庫模型、業務對象、關係、衍生屬性等元數據。DODS 讀取 DOML 生成持久化類、DAO、資料庫腳本、文檔等產出物。

最小 DOML 範例

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE DOML SYSTEM "doml.dtd">
<DOML>
    <AUTHOR>EnhydraTeam</AUTHOR>
    <PROJECTNAME>JSPPhoneBook</PROJECTNAME>
    <!-- 此處續接 DATABASE、TABLE、RELATIONSHIP、DERIVED 等元素 -->
</DOML>

核心元素預覽

• <DATABASE>：資料庫連接參數、類型（Oracle/MySQL/PostgreSQL...）。
• <TABLE>：表名、列定義（名稱、類型、主鍵、可空、預設值）。
• <RELATIONSHIP>：表間關聯（1:1、1:N、N:M）、外鍵、級聯規則。
• <DERIVED>：衍生屬性計算邏輯（SQL 片段、Java 代碼片段）。
• <QUERY>：預定義查詢（命名、參數、SQL/HQL）。

生成流程

1. 編寫/維護 project.doml。
2. 運行 DODS 產生器（Ant 任務、命令列、IDE 外掛）。
3. 產出：Java 持久化類、DAO 介面/實現、建表 SQL、HTML 文檔、PTL 模板等。
4. 開發者基於生成代碼編寫業務邏輯，不直接修改生成代碼（遵循「生成一次，擴展多次」原則）。

版本演進

DOML 3.1 → 5.0 → 5.1 結構有變化，DODS 提供遷移工具（Olddonl_2_donl51、Doml31_2_conf51）自動升級舊文件。