第 17 章 Native SQL查询

SQL查询是通过SQLQuery接口来控制的，它是通过调用Session.createSQLQuery()方法来获得

List cats = sess.createSQLQuery("select {cat.*} from cats cat").addEntity("cat", Cat.class);.setMaxResults(50);.list();

这个查询指定了:

addEntity()方法将SQL表的别名和实体类联系起来，并且确定查询结果集的形态。

addJoin()方法可以被用于载入其他的实体和集合的关联，TODO:examples!

原生的SQL查询可能返回一个简单的标量值或者一个标量和实体的结合体。

Double max = (Double) sess.createSQLQuery("select max(cat.weight) as maxWeight from cats cat").addScalar("maxWeight", Hibernate.DOUBLE);.uniqueResult();

上面使用的{cat.*}标记是 "所有属性" 的简写.你可以显式地列出需要的字段,但是你必须让Hibernate 为每一个属性注入字段的别名.这些字段的站位符是以字段别名为前导,再加上属性名.在下面的例子里,我们从一个其他的表(cat_log) 中获取Cat对象,而非Cat对象原本在映射元数据中声明的表.注意我们甚至在where子句中也可以使用属性别名. 对于命名查询,{}语法并不是必需的.你可以在第 17.3 节 “命名SQL查询”得到更多的细节.

String sql = "select cat.originalId as {cat.id}, " +"cat.mateid as {cat.mate}, cat.sex as {cat.sex}, " +"cat.weight*10 as {cat.weight}, cat.name as {cat.name} " +"from cat_log cat where {cat.mate} = :catId"List loggedCats = sess.createSQLQuery(sql).addEntity("cat", Cat.class).setLong("catId", catId).list();

注意:如果你明确地列出了每个属性,你必须包含这个类和它的子类的属性! and its subclasses!

可以在映射文档中定义查询的名字,然后就可以象调用一个命名的HQL查询一样直接调用命名SQL查询.在这种情况下,我们不 需要调用addEntity()方法.

<sql-query name="mySqlQuery"><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 'Hiber%'
</sql-query>

List people = sess.getNamedQuery("mySqlQuery").setMaxResults(50).list();

一个命名查询可能会返回一个标量值.你必须使用<return-scalar>元素来指定字段的别名和 Hibernate类型

<sql-query name="mySqlQuery"><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>

<return-join>和<load-collection>元素分别用作 外连接和定义那些初始化集合的查询

<sql-query name="mySqlQuery"><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 name="organizationCurrentEmployments"><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, CURRENCYFROM EMPLOYMENTWHERE EMPLOYER = :id AND ENDDATE IS NULLORDER BY STARTDATE ASC
</sql-query>

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;

<sql-query name="selectAllEmployees_SP" 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>

Hibernate3能够使用定制的SQL语句来执行create,update和delete操作。在Hibernate中，持久化的类和集合已经 包含了一套配置期产生的语句(insertsql, deletesql, updatesql等等)，这些映射标记 <sql-insert>, <sql-delete>, and <sql-update>重载了 这些语句。

<class name="Person"><id name="id"><generator class="increment"/></id><property name="name" not-null="true"/><sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert><sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update><sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>
</class>

这些SQL直接在你的数据库里执行，所以你可以自由的使用你喜欢的任意语法。但如果你使用数据库特定的语法， 这当然会降低你映射的可移植性。

如果设定callable，则能够支持存储过程了。

<class name="Person"><id name="id"><generator class="increment"/></id><property name="name" not-null="true"/><sql-insert callable="true">{call createPerson (?, ?)}</sql-insert><sql-delete callable="true">{? = call deletePerson (?)}</sql-delete><sql-update callable="true">{? = call updatePerson (?, ?)}</sql-update>
</class>

参数的位置顺序是非常重要的，他们必须和Hibernate所期待的顺序相同。

你能够通过设定日志调试级别为org.hiberante.persister.entity,来查看Hibernate所期待的顺序。在这个级别下， Hibernate将会打印出create,update和delete实体的静态SQL。如果想看到预想中的顺序。记得不要将定制SQL包含在映射文件里， 因为他们会重载Hibernate生成的静态SQL。

在大多数情况下(最好这么做)，存储过程需要返回插入/更新/删除的行数，因为Hibernate对语句的成功执行有些运行时的检查。 Hibernate常会把进行CUD操作的语句的第一个参数注册为一个数值型输出参数。

CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)RETURN NUMBER IS
BEGINupdate PERSONsetNAME = uname,whereID = uid;return SQL%ROWCOUNT;END updatePerson;

你可能需要声明你自己的SQL(或HQL)来装载实体

<sql-query name="person"><return alias="p" class="Person" lock-mode="upgrade"/>SELECT NAME AS {p.name}, ID AS {p.id} FROM PERSON WHERE ID=? FOR UPDATE
</sql-query>

这只是一个前面讨论过的命名查询声明，你可以在类映射里引用这个命名查询。

<class name="Person"><id name="id"><generator class="increment"/></id><property name="name" not-null="true"/><loader query-ref="person"/>
</class>

这也可以用于存储过程

TODO: 未完成的例子

<sql-query name="organizationEmployments"><load-collection alias="empcol" role="Organization.employments"/>SELECT {empcol.*}FROM EMPLOYMENT empcolWHERE EMPLOYER = :idORDER BY STARTDATE ASC, EMPLOYEE ASC
</sql-query><sql-query name="organizationCurrentEmployments"><return alias="emp" class="Employment"/><synchronize table="EMPLOYMENT"/>SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},REGIONCODE as {emp.regionCode}, ID AS {emp.id}FROM EMPLOYMENTWHERE EMPLOYER = :id AND ENDDATE IS NULLORDER BY STARTDATE ASC
</sql-query>