转载： Hibernate使用SQLQuery
下面的形式可以解决字段名重复：
sess.createSQLQuery("SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID") .addEntity("cat", Cat.class) .addEntity("mother", Cat.class)这个查询指明：
SQL查询语句，其中包含占位附来让Hibernate注射字段别名
查询返回的实体
上面使用的{cat.*}和{mother.*}标记是作为“所有属性”的简写形式出现的。当然你也 可以明确地罗列出字段名，但在这个例子里面我们让Hibernate来为每个属性注射SQL字段别名。字段别名的占位符是属性名加上表别名的前缀。在下面 的例子中，我们从另外一个表（cat_log）中通过映射元数据中的指定获取Cat和它的妈妈。注意，要是我们愿意，我们甚至可以在where子句中使用 属性别名。
String sql = "SELECT ID as {c.id}, NAME as {c.name}, " + "BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} " + "FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID"; List loggedCats = sess.createSQLQuery(sql) .addEntity("cat", Cat.class) .addEntity("mother", Cat.class).list()16.1.4.1. 别名和属性引用(Alias and property references)?
大多数情况下，都需要上面的属性注射，但在使用更加复杂的映射，比如复合属性、通过标识符构造继承 树，以及集合类等等情况下，也有一些特别的别名，来允许Hibernate注射合适的别名。
下表列出了使用别名注射参数的不同可能性。注意：下面结果中的别名只是示例，实用时每个别名需要唯一 并且不同的名字。
表 16.1. 别名注射(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.*}?16.1.5. 返回非受管实体(Returning non-managed entities)?
可以对原生sql 查询使用ResultTransformer。这会返回不受Hibernate管理的实体。
sess.createSQLQuery("SELECT NAME, BIRTHDATE FROM CATS") .setResultTransformer(Transformers.aliasToBean(CatDTO.class))这个查询指定：
SQL查询字符串
结果转换器(result transformer)
上面的查询将会返回CatDTO?的列表,它将被实例化并且将NAME和BIRTHDAY的值注射入对 应的属性或者字段。
16.1.6. 处理继承（Handling inheritance）?
原生SQL查询假若其查询结果实体是继承树中的一部分，它必须包含基类和所有子类的所有属性。
16.1.7. 参数（Parameters）?
原生查询支持位置参数和命名参数：
Query query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME like ?").addEntity(Cat.class); List pusList = query.setString(0, "Pus%").list(); query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME like :name").addEntity(Cat.class); List pusList = query.setString("name", "Pus%").list();16.2. 命名SQL查询?
可以在映射文档中定义查询的名字,然后就可以象调用一个命名的HQL查询一样直接调用命名SQL查 询.在这种情况下,我们addEntity()?方 法.
<sql-query > <return alias="person" 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>?元素中，这样就可以在多个命名查询间，或者通 过setResultSetMapping()?API 来访问。(此处原文即存疑。原文为：You can externalize the resultset mapping informations in a?<resultset>?element to either reuse them accross several named queries or through thesetResultSetMapping()?API.)
<resultset > <return alias="person" 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" 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><return-property>?也 可用于多个字段,它解决了使用{}?-语法不 能细粒度控制多个字段的限制
<sql-query > <return alias="emp" 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" 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?，这可能会效率更高，但这不是必需的。
16.3. 定制SQL用来create，update和delete?
Hibernate3能够使用定制的SQL语句来执行create,update和delete操 作。在Hibernate中，持久化的类和集合已经 包含了一套配置期产生的语句(insertsql, deletesql, updatesql等等)，这些映射标记?<sql-insert>?,?<sql-delete>?, and?<sql-update>?重 载了 这些语句。
<class > <id name="id"> <generator 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 > <id name="id"> <generator 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 BEGIN update PERSON set NAME = uname, where ID = uid; return SQL%ROWCOUNT; END updatePerson;
16.4. 定制装载SQL?
你可能需要声明你自己的SQL(或HQL)来装载实体
<sql-query > <return alias="pers" lock-mode="upgrade"/> SELECT NAME AS {pers.name}, ID AS {pers.id} FROM PERSON WHERE ID=? FOR UPDATE </sql-query>这只是一个前面讨论过的命名查询声明，你可以在类映射里引用这个命名查询。
<class > <id name="id"> <generator not-null="true"/> <loader query-ref="person"/> </class>
这也可以用于存储过程
你甚至可以定一个用于集合装载的查询:
<set inverse="true"> <key/> <one-to-many role="Person.employments"/> SELECT {emp.*} FROM EMPLOYMENT emp WHERE EMPLOYER = :id ORDER BY STARTDATE ASC, EMPLOYEE ASC </sql-query>你甚至还可以定义一个实体装载器，它通过连接抓取装载一个集合:
<sql-query > <return alias="pers" property="pers.employments"/> SELECT NAME AS {pers.*}, {emp.*} FROM PERSON pers LEFT OUTER JOIN EMPLOYMENT emp ON pers.ID = emp.PERSON_ID WHERE ID=? </sql-query>