[转]Hibernate SQLQuery 原生SQL 查询及返回结果集处置

在迁移原先用JDBC/SQL实现的系统，难免需要采用hibernat native sql支持。
1.使用SQLQuery
hibernate对原生SQL查询执行的控制是通过SQLQuery接口进行的.

1Session.createSQLQuery();

1sess.createSQLQuery("SELECT * FROM CATS").list();
2sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS").list();

如果要避免过多的使用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);

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");

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");

到目前为止,结果集字段名被假定为和映射文件中指定的的字段名是一致的。假若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();

大多数情况下，都需要上面的属性注射，但在使用更加复杂的映射，比如复合属性、通过标识符构造继承树，以及集合类等等情况下，也有一些特别的别名，来允许Hibernate注射合适的别名。

下表列出了使用别名注射参数的不同可能性。注意：下面结果中的别名只是示例，实用时每个别名需要唯一并且不同的名字。

1sess.createSQLQuery("SELECT NAME, BIRTHDATE FROM CATS")
2???????? .setResultTransformer(Transformers.aliasToBean(CatDTO.class))

这个查询指定：SQL查询字符串,结果转换器(result transformer)

上面的查询将会返回CatDTO的列表,它将被实例化并且将NAME和BIRTHDAY的值注射入对应的属性或者字段。

1.
返回List，
.setResultTransformer(
?????Transformers.ALIAS_TO_ENTITY_MAP);将结果转为Map，存放到list中，即list中为若干map对象；
获取可按此方法：

?