JavaBeans 與關聯式資料庫映射：利用反射實現通用資料存取層

核心問題

傳統 JDBC 代碼存在兩大痛點：

1. 硬編碼中繼資料：欄位名、型別寫死在代碼中，資料庫結構微調即須修改程式
2. RecordSet 非真正物件：結果集僅是游標，需手動逐欄取值填充物件，缺乏物件導向封裝

解決方案：JavaBeans + 反射 + DatabaseMetaData

核心洞見

關聯式資料表與 Java 類別結構同構：

• Table ↔ Class
• Row ↔ Object Instance
• Column ↔ Field/Property
• Primary Key ↔ Object Identity

若遵循「類別名 = 表名」、「屬性名 = 欄位名」慣例，即可利用反射自動映射。

關鍵技術實作

1. 動態實例化：Class.forName()

// 從資料庫取得表名，直接對應類別名
Class c = Class.forName("Person"); // 表名 Person
Person p = (Person) c.newInstance(); // 建立實例

優勢：原始碼無需 import 具體實體類別，新增表格只需對應新增類別檔。

2. 初始化策略：超級類別 + 初始化方法

因 newInstance() 僅呼叫無參建構子，需額外初始化方法：

public abstract class DBEntity {
    // 由子類實作或框架透過反射自動填充
    public abstract void initFromResultSet(ResultSet rs) throws SQLException;
}

3. 通用查詢邏輯（偽代碼）

// 初始化階段：快取所有表的主鍵/索引欄位
for (each table) {
    if (對應類別存在) {
        loadClass(tableName);
        cachePrimaryKeys(tableName, metaData.getPrimaryKeys());
        cacheIndexColumns(tableName, metaData.getIndexInfo());
    }
}

// 查詢階段：根據傳入的 (name,value) 對自動生成 SQL
Object query(Object criteria) {
    for (each table) {
        List matchedKeys = matchCriteriaWithKeys(criteria, table);
        if (matchedKeys not empty) {
            String sql = buildSelectSQL(table, matchedKeys);
            ResultSet rs = executeQuery(sql);
            while (rs.next()) {
                Object entity = createEntity(table);
                entity.initFromResultSet(rs);
                addToResults(entity);
            }
        }
    }
}

4. 反射驗證 Bean 與 Table 結構一致性

// 利用 Introspector 取得 Bean 所有屬性
BeanInfo info = Introspector.getBeanInfo(entityClass);
PropertyDescriptor[] props = info.getPropertyDescriptors();

// 利用 DatabaseMetaData 取得 Table 所有欄位
ResultSet columns = metaData.getColumns(null, null, tableName, null);

// 比對：屬性名、型別、可空性是否與欄位定義一致
// 發現不一致即拋出異常，部署階段即可攔截錯誤

JavaBeans 規範在映射中的角色

• 命名慣例：getter/setter 確保屬性可被反射標準化存取
• PropertyDescriptor：提供屬性型別、讀寫方法、屬性編輯器等中繼資料
• Introspector：框架核心，自動分析 Bean 結構，無需手寫映射配置

實際應用架構

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Client     │────▶│  GenericDAO  │────▶│  Database   │
│  (Criteria) │     │  (Reflection)│     │  (MetaData) │
└─────────────┘     └──────────────┘     └─────────────┘
       ▲                   │
       │                   ▼
       │            ┌──────────────┐
       └────────────│  Entity Bean │
                    │  (JavaBean)  │
                    └──────────────┘

優缺點評估

現代視角：從此演進到 ORM 框架

此思想直接催生了 Hibernate、JPA、MyBatis 等 ORM 框架：

• Hibernate：Session.load/get、Criteria API、HQL 即是通用查詢的進階形式
• JPA：@Entity、@Table、@Column 註解取代命名慣例，提供更靈活映射
• MyBatis：XML/SQL 映射檔保留 SQL 控制權，結果自動映射至 JavaBean

結語

JavaBeans 結合反射與 DatabaseMetaData，實現了「寫一次通用 DAO，服務所有資料表」的願景。雖然現代專案直接使用成熟 ORM 框架，但理解這層基礎原理，有助於：排查框架底層行為、設計客製化映射策略、在輕量級專案中自行實作簡易資料存取層。