hibernate使用原生SQL查詢返回結果集的處理
今天沒事的時候，看到公司框架里有一個用原生SQL寫的函數，說實在以前自己也干過這事，但好久都沒有用，都忘得差不多了，現在基本都是用的hql語句來查詢結果。hibernate中使用createSQLQuery拉來來實現SQL語句的查詢，具體用法：session.createSQLQuery(sql),對於用SQL返回的結果集是一個什么樣的結果集都毫無記憶。自己查了下，才知道，原來是返回一個Object類型數組的list集合，而其中Object類型的數組里的值則與sql語句中的查詢項相對應，如果是select * from XXX ,則數組值就是按照XXX表中的所有字段來一一對應。其它不多說，在網上看到一篇文章里面講得很細，就直接轉過來了：
在遷移原先用JDBC/SQL實現的系統，難免需要采用hibernat native sql支持。
1.使用SQLQuery
hibernate對原生SQL查詢執行的控制是通過SQLQuery接口進行的.
1Session.createSQLQuery();
1.1標量查詢
最基本的SQL查詢就是獲得一個標量（數值）的列表。
1sess.createSQLQuery("SELECT * FROM CATS").list();
2sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS").list();
將返回一個Object數組(Object[])組成的List，數組每個元素都是CATS表的一個字段值。Hibernate會使用ResultSetMetadata來判定返回的標量值的實際順序和類型。
如果要避免過多的使用ResultSetMetadata,或者只是為了更加明確的指名返回值，可以使用addScalar()。
1sess.createSQLQuery("SELECT * FROM CATS")
2 .addScalar("ID", Hibernate.LONG)
3 .addScalar("NAME", Hibernate.STRING)
4 .addScalar("BIRTHDATE", Hibernate.DATE)
這個查詢指定了:SQL查詢字符串,要返回的字段和類型.它仍然會返回Object數組,但是此時不再使用ResultSetMetdata,而是明確的 將ID,NAME和BIRTHDATE按照Long, String和Short類型從resultset中取出。同時，也指明了就算query是使用*來查詢的，可能獲得超過列出的這三個字段，也僅僅會返回 這三個字段。
對全部或者部分的標量值不設置類型信息也是可以的。
1sess.createSQLQuery("SELECT * FROM CATS")
2 .addScalar("ID", Hibernate.LONG)
3 .addScalar("NAME")
4 .addScalar("BIRTHDATE")
基本上這和前面一個查詢相同,只是此時使用ResultSetMetaData來決定NAME和BIRTHDATE的類型，而ID的類型是明確指出的。
關於從ResultSetMetaData返回的java.sql.Types是如何映射到Hibernate類型，是由方言(Dialect)控制的。假若某個指定的類型沒有被映射，或者不是你所預期的類型，你可以通過Dialet的registerHibernateType調用自行定義.
1.2 實體查詢
上面的查詢都是返回標量值的，也就是從resultset中返回的“裸”數據。下面展示如何通過addEntity()讓原生查詢返回實體對象。
1sess.createSQLQuery("SELECT * FROM CATS").addEntity(Cat.class);
2sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS").addEntity(Cat.class);
這個查詢指定：SQL查詢字符串,要返回的實體.假設Cat被映射為擁有ID,NAME和BIRTHDATE三個字段的類，以上的兩個查詢都返回一個List，每個元素都是一個Cat實體。
假若實體在映射時有一個many-to-one的關聯指向另外一個實體，在查詢時必須也返回那個實體，否則會導致發生一個"column not found"的數據庫錯誤。這些附加的字段可以使用*標注來自動返回，但我們希望還是明確指明，看下面這個具有指向Dog的many-to-one的例 子：
1sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS").addEntity(Cat.class);
這樣cat.getDog()就能正常運行。
1.3 處理關聯和集合類
通過提前抓取將Dog連接獲得，而避免初始化proxy帶來的額外開銷也是可能的。這是通過addJoin()方法進行的，這個方法可以讓你將關聯或集合連接進來。
1sess.createSQLQuery("SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID")
2 .addEntity("cat", Cat.class)
3 .addJoin("cat.dog");
上面這個例子中，返回的Cat對象，其dog屬性被完全初始化了，不再需要數據庫的額外操作。注意，我們加了一個別名("cat")，以便指明join的目標屬性路徑。通過同樣的提前連接也可以作用於集合類，例如，假若Cat有一個指向Dog的一對多關聯。
1sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT_ID FROM CATS c, DOGS d WHERE c.ID = d.CAT_ID")
2 .addEntity("cat", Cat.class)
3 .addJoin("cat.dogs");
1.4 返回多個實體
到目前為止,結果集字段名被假定為和映射文件中指定的的字段名是一致的。假若SQL查詢連接了多個表，同一個字段名可能在多個表中出現多次，這就會造成問題。
下面的查詢中需要使用字段別名注射（這個例子本身會失敗）：
1sess.createSQLQuery("SELECT c.*, m.* FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID")
2 .addEntity("cat", Cat.class)
3 .addEntity("mother", Cat.class)
這個查詢的本意是希望每行返回兩個Cat實例，一個是cat,另一個是它的媽媽。但是因為它們的字段名被映射為相同的，而且在某些數據庫中，返回的字段別 名是“c.ID”,"c.NAME"這樣的形式，而它們和在映射文件中的名字（"ID"和"NAME"）不匹配，這就會造成失敗。
下面的形式可以解決字段名重復：
1sess.createSQLQuery("SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID")
2 .addEntity("cat", Cat.class)
3 .addEntity("mother", Cat.class)
這個查詢指明：SQL查詢語句，其中包含占位附來讓Hibernate注射字段別名,查詢返回的實體
上面使用的{cat.*}和{mother.*}標記是作為“所有屬性”的簡寫形式出現的。當然你也可以明確地羅列出字段名，但在這個例子里面我們讓 Hibernate來為每個屬性注射SQL字段別名。字段別名的占位符是屬性名加上表別名的前綴。在下面的例子中，我們從另外一個表（cat_log）中 通過映射元數據中的指定獲取Cat和它的媽媽。注意，要是我們願意，我們甚至可以在where子句中使用屬性別名。
1String sql = "SELECT ID as {c.id}, NAME as {c.name}, " +
2 "BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} " +
3 "FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID";
4
5List loggedCats = sess.createSQLQuery(sql)
6 .addEntity("cat", Cat.class)
7 .addEntity("mother", Cat.class).list();
1.4.1 別名和屬性引用
大多數情況下，都需要上面的屬性注射，但在使用更加復雜的映射，比如復合屬性、通過標識符構造繼承樹，以及集合類等等情況下，也有一些特別的別名，來允許Hibernate注射合適的別名。
下表列出了使用別名注射參數的不同可能性。注意：下面結果中的別名只是示例，實用時每個別名需要唯一並且不同的名字。
別名注射(alias injection names)
描述 語法 示例
簡單屬性 {[aliasname].[propertyname] A_NAME as {item.name}
復合屬性 {[aliasname].[componentname].[propertyname]} CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}
實體辨別器(Discriminator of an entity) {[aliasname].class} DISC as {item.class}
實體的所有屬性 {[aliasname].*} {item.*}
集合鍵(collection key) {[aliasname].key} ORGID as {coll.key}
集合id {[aliasname].id} EMPID as {coll.id}
集合元素 {[aliasname].element} XID as {coll.element}
集合元素的屬性 {[aliasname].element.[propertyname]} NAME as {coll.element.name}
集合元素的所有屬性 {[aliasname].element.*} {coll.element.*}
集合的所有屬性 {[aliasname].*} {coll.*}
1.5. 返回非受管實體
可以對原生sql 查詢使用ResultTransformer。這會返回不受Hibernate管理的實體。
1sess.createSQLQuery("SELECT NAME, BIRTHDATE FROM CATS")
2 .setResultTransformer(Transformers.aliasToBean(CatDTO.class))
這個查詢指定：SQL查詢字符串,結果轉換器(result transformer)
上面的查詢將會返回CatDTO的列表,它將被實例化並且將NAME和BIRTHDAY的值注射入對應的屬性或者字段。
轉自：http://blog.csdn.net/yangqicong/article/details/6910740