Hibernat 原生SQL運行結果集處理方法
hibernate對原生SQL查詢執行的控制是通過SQLQuery接口進行的.
如果要避免過多的使用ResultSetMetadata,或者只是為了更加明確的指名返回值,可以使用addScalar()。
1sess.createSQLQuery("SELECT * FROM CATS")2
3 .addScalar("NAME", Hibernate.STRING)
4 .addScalar("BIRTHDATE", Hibernate.DATE)
這個查詢指定了:SQL查詢字符串,要返回的字段和類型.它仍然會返回Object數組,但是此時不再使用ResultSetMetdata,而是明確的將ID,NAME和BIRTHDATE按照Long, String和Short類型從resultset中取出。同時,也指明了就算query是使用*來查詢的,可能獲得超過列出的這三個字段,也僅僅會返回這三個字段。
對全部或者部分的標量值不設置類型信息也是可以的。
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()方法進行的,這個方法可以讓你將關聯或集合連接進來。
2 .addEntity("cat", Cat.class)
3 .addJoin("cat.dog");
上面這個例子中,返回的Cat對象,其dog屬性被完全初始化了,不再需要數據庫的額外操作。註意,我們加了一個別名("cat"),以便指明join的目標屬性路徑。通過同樣的提前連接也可以作用於集合類,例如,假若Cat有一個指向Dog的一對多關聯。
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管理的實體。
2 .setResultTransformer(Transformers.aliasToBean(CatDTO.class))
這個查詢指定:SQL查詢字符串,結果轉換器(result transformer)
上面的查詢將會返回CatDTO的列表,它將被實例化並且將NAME和BIRTHDAY的值註射入對應的屬性或者字段。
Hibernat 原生SQL運行結果集處理方法