16.2. 命名SQL查詢

可以在對映文件中定義查詢的名字,然後就可以象呼叫一個命名的HQL查詢一樣直接呼叫命名SQL查詢.在這種情況下,我們addEntity()方法.

<sql-query > <return alias="person" class="eg.Person"/> SELECT person.NAME AS {person.name}, person.AGE AS {person.age}, person.SEX AS {person.sex} FROM PERSON person WHERE person.NAME LIKE :namePattern </sql-query>

List people = sess.getNamedQuery("persons") .setString("namePattern", namePattern) .setMaxResults(50) .list();

<return-join>和 <load-collection> 元素是用來連線關聯以及將查詢定義為預先初始化各個集合的。

<sql-query > <return alias="person" class="eg.Person"/> <return-join alias="address" property="person.mailingAddress"/> SELECT person.NAME AS {person.name}, person.AGE AS {person.age}, person.SEX AS {person.sex}, adddress.STREET AS {address.street}, adddress.CITY AS {address.city}, adddress.STATE AS {address.state}, adddress.ZIP AS {address.zip} FROM PERSON person JOIN ADDRESS adddress ON person.ID = address.PERSON_ID AND address.TYPE='MAILING' WHERE person.NAME LIKE :namePattern </sql-query>

一個命名查詢可能會返回一個標量值.你必須使用<return-scalar>元素來指定欄位的別名和 Hibernate型別

<sql-query > <return-scalar column="name" type="string"/> <return-scalar column="age" type="long"/> SELECT p.NAME AS name, p.AGE AS age, FROM PERSON p WHERE p.NAME LIKE 'Hiber%' </sql-query>

你可以把結果集對映的資訊放在外部的<resultset>

<resultset > <return alias="person" class="eg.Person"/> <return-join alias="address" property="person.mailingAddress"/> </resultset> <sql-query name="personsWith" resultset-ref="personAddress"> SELECT person.NAME AS {person.name}, person.AGE AS {person.age}, person.SEX AS {person.sex}, adddress.STREET AS {address.street}, adddress.CITY AS {address.city}, adddress.STATE AS {address.state}, adddress.ZIP AS {address.zip} FROM PERSON person JOIN ADDRESS adddress ON person.ID = address.PERSON_ID AND address.TYPE='MAILING' WHERE person.NAME LIKE :namePattern </sql-query>

另外,你可以在java程式碼中直接使用hbm檔案中的結果集定義資訊。

List cats = sess.createSQLQuery( "select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id" ) .setResultSetMapping("catAndKitten") .list();

16.2.1. 使用return-property來明確地指定欄位/別名

使用<return-property>你可以明確的告訴Hibernate使用哪些欄位別名,這取代了使用{}-語法 來讓Hibernate注入它自己的別名.

<sql-query > <return alias="person" class="eg.Person"> <return-property name="name" column="myName"/> <return-property name="age" column="myAge"/> <return-property name="sex" column="mySex"/> </return> SELECT person.NAME AS myName, person.AGE AS myAge, person.SEX AS mySex, FROM PERSON person WHERE person.NAME LIKE :name </sql-query>

<sql-query > <return alias="emp" class="Employment"> <return-property name="salary"> <return-column name="VALUE"/> <return-column name="CURRENCY"/> </return-property> <return-property name="endDate" column="myEndDate"/> </return> SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer}, STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate}, REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY FROM EMPLOYMENT WHERE EMPLOYER = :id AND ENDDATE IS NULL ORDER BY STARTDATE ASC </sql-query>

注意在這個例子中,我們使用了<return-property>結合{}的注入語法. 允許使用者來選擇如何引用欄位以及屬性.

如果你對映一個識別器(discriminator),你必須使用<return-discriminator> 來指定識別器欄位

16.2.2. 使用儲存過程來查詢

Hibernate 3引入了對儲存過程查詢(stored procedure)和函式(function)的支援.以下的說明中，這二者一般都適用。 儲存過程/函式必須返回一個結果集,作為Hibernate能夠使用的第一個外部引數. 下面是一個Oracle9和更高版本的儲存過程例子.

CREATE OR REPLACE FUNCTION selectAllEmployments RETURN SYS_REFCURSOR AS st_cursor SYS_REFCURSOR; BEGIN OPEN st_cursor FOR SELECT EMPLOYEE, EMPLOYER, STARTDATE, ENDDATE, REGIONCODE, EID, VALUE, CURRENCY FROM EMPLOYMENT; RETURN st_cursor; END;

在Hibernate裡要要使用這個查詢,你需要通過命名查詢來對映它.

<sql-query callable="true"> <return alias="emp" class="Employment"> <return-property name="employee" column="EMPLOYEE"/> <return-property name="employer" column="EMPLOYER"/> <return-property name="startDate" column="STARTDATE"/> <return-property name="endDate" column="ENDDATE"/> <return-property name="regionCode" column="REGIONCODE"/> <return-property name="id" column="EID"/> <return-property name="salary"> <return-column name="VALUE"/> <return-column name="CURRENCY"/> </return-property> </return> { ? = call selectAllEmployments() } </sql-query>

注意儲存過程當前僅僅返回標量和實體.現在不支援<return-join>和<load-collection>

16.2.2.1. 使用儲存過程的規則和限制

為了在Hibernate中使用儲存過程,你必須遵循一些規則.不遵循這些規則的儲存過程將不可用.如果你仍然想要使用他們, 你必須通過session.connection()來執行他們.這些規則針對於不同的資料庫.因為資料庫 提供商有各種不同的儲存過程語法和語義.

對儲存過程進行的查詢無法使用setFirstResult()/setMaxResults()進行分頁。

建議採用的呼叫方式是標準SQL92: { ? = call functionName(<parameters>) } 或者 { ? = call procedureName(<parameters>}.原生呼叫語法不被支援。

對於Oracle有如下規則:

• 函式必須返回一個結果集。儲存過程的第一個引數必須是OUT，它返回一個結果集。這是通過Oracle 9或10的SYS_REFCURSOR型別來完成的。在Oracle中你需要定義一個REF CURSOR型別，參見Oracle的手冊。

對於Sybase或者MS SQL server有如下規則:

• 儲存過程必須返回一個結果集。.注意這些servers可能返回多個結果集以及更新的數目.Hibernate將取出第一條結果集作為它的返回值， 其他將被丟棄。

• 如果你能夠在儲存過程裡設定SET NOCOUNT ON，這可能會效率更高，但這不是必需的。