hibernate使用原生SQL查询返回结果集的处理

 今天没事的时候，看到公司框架里有一个用原生SQL写的函数，说实在之前本身也干过这事，但很久都没有用，都忘得差很少了，如今基本都是用的hql语句来查询结果。hibernate中使用createSQLQuery拉来来实现SQL语句的查询，具体用法：session.createSQLQuery(sql),对于用SQL返回的结果集是一个什么样的结果集都毫无记忆。本身查了下，才知道，原来是返回一个Object类型数组的list集合，而其中Object类型的数组里的值则与sql语句中的查询项相对应，若是是select * from XXX ,则数组值就是按照XXX表中的全部字段来一一对应。其它很少说，在网上看到一篇文章里面讲得很细，就直接转过来了：
    在迁移原先用JDBC/SQL实现的系统，不免须要采用hibernat native sql支持。
1.使用SQLQuery
hibernate对原生SQL查询执行的控制是经过SQLQuery接口进行的.

1 Session.createSQLQuery();

1.1标量查询
最基本的SQL查询就是得到一个标量（数值）的列表。

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

将返回一个Object数组(Object[])组成的List，数组每一个元素都是CATS表的一个字段值。Hibernate会使用ResultSetMetadata来断定返回的标量值的实际顺序和类型。

若是要避免过多的使用ResultSetMetadata,或者只是为了更加明确的指名返回值，可使用addScalar()。

1 sess.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是使用*来查询的，可能得到超过列出的这三个字段，也仅仅会返回 这三个字段。

对所有或者部分的标量值不设置类型信息也是能够的。

1 sess.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()让原生查询返回实体对象。

1 sess.createSQLQuery("SELECT * FROM CATS").addEntity(Cat.class);
2 sess.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的例 子：

1 sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS").addEntity(Cat.class);

这样cat.getDog()就能正常运行。 
1.3 处理关联和集合类
经过提早抓取将Dog链接得到，而避免初始化proxy带来的额外开销也是可能的。这是经过addJoin()方法进行的，这个方法可让你将关联或集合链接进来。

1 sess.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");

上面这个例子中，返回的Cat对象，其dog属性被彻底初始化了，再也不须要数据库的额外操做。注意，咱们加了一个别名("cat")，以便指明join的目标属性路径。经过一样的提早链接也能够做用于集合类，例如，倘若Cat有一个指向Dog的一对多关联。

1 sess.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");

1.4 返回多个实体

到目前为止,结果集字段名被假定为和映射文件中指定的的字段名是一致的。倘若SQL查询链接了多个表，同一个字段名可能在多个表中出现屡次，这就会形成问题。

下面的查询中须要使用字段别名注射（这个例子自己会失败）：

1 sess.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"）不匹配，这就会形成失败。

下面的形式能够解决字段名重复：

1 sess.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子句中使用属性别名。

1 String 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
5 List 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管理的实体。

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

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

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

   转自：http://blog.csdn.net/yangqicong/article/details/6910740