
設為首頁	加入收藏

首頁
編程語言: C語言|JAVA編程
 Python編程
網頁編程: ASP編程|PHP編程
 JSP編程
數據庫: MYSQL數據庫|SqlServer數據庫
 Oracle數據庫|DB2數據庫

您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

Hibernate 查詢結果自定義映射：List、Map、POJO 與 ResultTransformer 實戰

編輯：Java 綜合教學

Hibernate 查詢結果自定義映射：List、Map、POJO 與 ResultTransformer 實戰

Hibernate 查詢默認返回實體對象或 Object[]，但實際開發常需只選部分字段、多表連接、聚合統計等場景，需靈活控制結果結構。本文系統講解 HQL 中的 `new List`、`new Map`、構造函數注入、`ResultTransformer` 等高級映射技巧。

準備數據

mysql> SELECT * FROM p_dictionary;
+-----------------+----+---------+------+--------+--------+
| dictionary_type | id | version | code | forbid | value  |
+-----------------+----+---------+------+--------+--------+
| COUNTY          | 1  | 0       | 001  |        | 四川   |
| COUNTY          | 2  | 0       | 002  |        | 北京   |
| COUNTY          | 3  | 0       | 001  | NULL   | 四川   |
+-----------------+----+---------+------+--------+--------+

一、new List 投影

String hql = "SELECT NEW LIST(p.code, p.value) FROM Dictionary p";
List> list = session.createQuery(hql).list();
// 結果: [[001, 四川], [002, 北京], [001, 四川]]

每行結果為一個 `List
`，順序與 SELECT 列一致。
適用於字段數固定、不想定義 DTO 的簡單場景。

二、new Map 投影

1. 無別名（鍵為索引 0,1...）
```
String hql = "SELECT NEW MAP(p.code, p.value) FROM Dictionary p";
List> list = session.createQuery(hql).list();
// 結果: [{0=001, 1=四川}, {0=002, 1=北京}, {0=001, 1=四川}]
```
2. 指定別名（鍵為別名）
```
String hql = "SELECT NEW MAP(p.code AS code, p.value AS value) FROM Dictionary p";
List> list = session.createQuery(hql).list();
// 結果: [{code=001, value=四川}, {code=002, value=北京}, {code=001, value=四川}]
```
3. 部分別名
```
String hql = "SELECT NEW MAP(p.code AS code, p.value) FROM Dictionary p";
// 結果: [{code=001, 1=四川}, {code=002, 1=北京}, {code=001, 1=四川}]
```
三、構造函數表達式（DTO 直接映射）
```
// DTO 需提供對應構造函數
public class CountyDTO {
    private String code, value;
    public CountyDTO(String code, String value) { this.code = code; this.value = value; }
    // getter/setter
}

String hql = "SELECT NEW com.example.CountyDTO(p.code, p.value) FROM Dictionary p";
List list = session.createQuery(hql).list();
// 直接獲得類型安全的 DTO 列表，無需手動映射
```
優勢：編譯期檢查、類型安全、代碼可讀性高。要求：DTO 必須有全參構造函數，參數順序、類型與 SELECT 列嚴格對應。

四、ResultTransformer 進階映射

1. ALIAS_TO_ENTITY_MAP (舊 API)
```
Query q = session.createQuery("SELECT p.code AS code, p.value AS value FROM Dictionary p");
q.setResultTransformer(CriteriaSpecification.ALIAS_TO_ENTITY_MAP);
List> list = q.list();
// 等同於 NEW MAP(with alias)
```
2. Transformers.aliasToBean(DTO.class) (核心技巧：SQL 查詢直接映射 DTO)
```
// 適用於原生 SQL 查詢，多表連接結果直接映射到包含多表字段的 DTO
String sql = "SELECT u.username AS userName, p.title, p.add_time AS addTime " +
             "FROM user u JOIN post p ON u.id = p.user_id";

Query q = session.createSQLQuery(sql)
        .setResultTransformer(Transformers.aliasToBean(PostVO.class));
// PostVO 需包含 userName, title, addTime 屬性及無參構造函數
List list = q.list();
```
原理：Hibernate 根據 SQL 結果集列名（別名）與 DTO 屬性名匹配，利用反射賦值。關鍵：SQL 別名必須與 DTO 屬性名完全一致（駝峰對應）。

3. 自定義 ResultTransformer
```
public class VOResultTransformer implements ResultTransformer {
    private final Class targetClass;
    public VOResultTransformer(Class clazz) { this.targetClass = clazz; }

    @Override public Object transformTuple(Object[] tuple, String[] aliases) {
        try {
            Object obj = targetClass.getDeclaredConstructor().newInstance();
            for (int i = 0; i < aliases.length; i++) {
                Field f = targetClass.getDeclaredField(aliases[i]);
                f.setAccessible(true);
                f.set(obj, tuple[i]);
            }
            return obj;
        } catch (Exception e) { throw new RuntimeException(e); }
    }
    @Override public List transformList(List collection) { return collection; }
}

// 使用
q.setResultTransformer(new VOResultTransformer(PostVO.class));
```
五、原生 SQL 查詢返回實體映射
```
 list = session.createSQLQuery("SELECT code, value FROM p_dictionary")
        .addScalar("code", StandardBasicTypes.STRING)
        .addScalar("value", StandardBasicTypes.STRING)
        .list();
```
六、最佳實踐建議
1. 優先使用構造函數表達式 (NEW DTO)：類型安全、編譯期檢查、性能最優（避免反射開銷）。
2. 多表連接/複雜聚合用 aliasToBean：配合原生 SQL，將寬表結果直接映射到寬 DTO。
3. 動態報表/不定列用 Map/List：前端驅動的動態查詢場景。
4. 避免濫用 ResultTransformer：反射性能開銷大，熱點路徑請用構造函數表達式。
5. 分頁查詢：`query.setFirstResult(offset).setMaxResults(pageSize)`，配合上述映射方式均可。
掌握 Hibernate 多樣化結果映射，能讓數據訪問層代碼既簡潔又高效，完美適配各種業務查詢場景。
1. 上一篇文章： Spring MVC + Maven 在 IntelliJ IDEA 中從零搭建完整教程
2. 下一篇文章： JDBC 入門：Statement 實現數據插入完整示例與資源管理規範
Java 綜合教學

 Hibernate 核心：Java 對象三大狀態（瞬時/持久/游離）與轉換圖解
Hibernate 核心：Java 對象三大狀態（瞬時/持久

 Java Swing 佈局管理器實戰（一）：絕對佈局與坐標定位詳細指南
絕對佈局核心概念絕對佈局（Absolute Layout

Java 整合 Redis 實戰指南：Jedis 連接池與五大數據類型操作
Redis 核心數據類型與應用場景類型底層結構典型命令應

 MyBatis 動態 SQL 完全指南：if/choose/trim/foreach/bind 實戰與最佳實踐
告別字符串拼接 SQL：掌握 MyBatis 強大的動態 S

Java 類與物件實戰：Print 類別計算水仙花數 (Narcissistic Number) Java 設計模式：適配器模式通俗講解（電源適配器實例 + 雙向適配代碼實現） Servlet 服務器性能優化：數據庫請求頻率控制策略 Java 連接 Oracle 與 MySQL 數據庫核心代碼範本 Linux 内核基数树深度解析：原理、实现与两大核心应用场景 Spring RMI 完整實例：服務端暴露與客戶端調用配置詳解 IntelliJ IDEA 配置 Maven 並設定阿里雲鏡像與本地倉庫路徑

欄目導航

Java 程式設計入門

Java 相關知識

J2EE

J2SE

J2ME

Java 綜合教學

Copyright © 程式碼之家 All Rights Reserved