数据查询与检索是Hibernate的一个亮点。Hibernate的数据查询方式最主要有3种,它们是:
Hibernate Query Language(HQL) Query By Criteria Native SQL
下面对这3种查询方式分别进行讲解。
Hibernate Query Language(HQL)
Hibernate Query Language(HQL)提供了十分强大的功能,推荐大家使用这种查询方式。HQL具有与SQL语言类似的语法规范,只不过SQL针对表中字段进行查询,而HQL针对持久化对象,它用来取得对象,而不进行update、delete和insert等操作。而且HQL是完全面向对象的,具备继承、多态和关联等特性。
1.from子句
from字句是最简单的HQL语句,例如 from Student,也可以写成select s from Student s。它简单地返回Student类的所有实例。
除了Java类和属性的名称外,HQL语句对大小写并不敏感,所以在上一句HQL语句中,from与FROM是相同的,但是Student与student就不同了,所以上述语句写成from student就会报错。下列程序演示如何通过执行from语句取得所有的Student对象。
Query query = session.createQuery(“from Student”); List list = query.list(); for (int i=0;i<list.size(); i++) { Student stu = (Student)list.get(i); System.out.println(stu.getName()); } |
如果执行HQL语句“from Student, Course”,并不简单地返回两个对象,而是返回这两个对象的的笛卡儿积,这类似于SQL语句中字段的全外连接。在实际应用中,像“from Student, Course”这样的语句几乎不会出现。
2.select子句
有时并不需要得到对象的所有属性,这时可以使用select子句进行属性查询,例如,select s.name from Student s。下面程序演示如何执行这个语句:
Query query = session.createQuery(“select s.name from Student s”); List list = query.list(); for (int i=0;i<list.size(); i++) { String name = (String)list.get(i); System.out.println(ame()); } |
如果要查询两个以上的属性,查询结果会以数组的方式返回,如下所示:
Query query = session.createQuery(“select s.name, s.sex from Student as s”); List list = query.list(); for (int i=0;i<list.size(); i++) { Object obj[] = (Object[])list.get(i); System.out.println(ame(obj[0] + “的性别是:” +obj[1])); } |
在使用属性查询时,由于使用对象数组,操作和理解都不太方便,如果将一个object[]中所有成员封装成一个对象就方便多了。下面的程序将查询结果进行了实例化:
Query query = session.createQuery(“select new Student(s.name, s.sex) from Student s”); List list = query.list(); for (int i=0;i<list.size(); i++) { Student stu = (Student)list.get(i); System.out.println(stu.getName()); } |
要正确运行以上程序,还需要在Student类中加入一个如下的构造函数:
public Student(String name, String sex) { this.name = name; this.sex = sex; } |
3.统计函数查询
可以在HQL中使用函数,经常使用的函数有:
count():统计记录条数 min():求最小值 max():求最大值 sum():求和 age():求平均值
例如,要取得Student实例的数量,可以编写如下HQL语句:
select count(*) from Student |
取得Student的平均年龄的HQL语句如下:
select avg(s.age) from Student as s |
可以使用distinct去除重复数据:
select distinct s.age from Student as s |
4.where子句
HQL也支持子查询,它通过where子句实现这一机制。where子句让用户缩小要返回的实例的列表范围,例如下面语句会返回所有名字为“Bill”的Student实例:
Query query = session.createQuery("from Student as s where s.name='Bill' "); |
where子句允许出现的表达式包括了SQL中可以使用的大多数情况: 数学操作:+,-,*,/ 真假比较操作:=,>=,<=,<>,!=,like 逻辑操作:and,or, not 字符串连接:|| SQL标量函数:例如upper()和lower()
如果子查询返回多条记录,可以用以下的关键字来量化:
all:表示所有的记录。 any:表示所有记录中的任意一条。 some:与any用法相同。 in:与any等价。 exists:表示子查询至少要返回一条记录。
例如,下面语句返回所有学生的年龄都大于22的班级对象:
from Group g where 22<all (select s.age from g.students s) |
下述语句返回在所有学生中有一个学生的年龄等于22的班级:
from Group g where 22=any (select s.age from g.students s) |
或者
from Group g where 22=some (select s.age from g.students s) |
或者
from Group g where 22 in (select s.age from g.students s) |
5.order by 子句
查询返回的列表可以按照任何返回的类或者组件的属性排序:
from Student s order by s.name asc |
asc和desc是可选的,分别代表升序或者降序。
6.连接查询
与SQL查询一样, HQL也支持连接查询,如内连接、外连接和交叉连接。
inner join: 内连接 left outer join:左外连接 right outer join:右外连接 full join: 全连接,但不常用
下面重点讲解内连接查询,左外连接和右外连接查询和内连接大同小异,而全连接几乎不怎么使用。
inner join可以简写为join,例如在查询得到Group对象时,内连接取得对应的Student对象,实现的程序如下。
……//打开Session,开启事务 Student stu = null; //声明Student实例 Group group = null; //声明Group实例 Query query = session.createQuery("from Group g join g.students"); List list = query.list(); Object obj[] = null; //声明对象数组 for(int i=0;i<list.size();i++) { obj = (Object[])list.get(i); //取得集合中的第i个数组 group = (Group)obj[0]; //group是数组中第一个对象 stu = (Student)obj[1]; //stu是数组中第二个对象 System.out.println(stu.getName() + "属于:" +group.getName() ); } ……//提交事务,关闭Session |
Query By Criteria(QBC)
当查询数据时,人们往往需要设置查询条件。在SQL或HQL语句中,查询条件常常放在where子句中。此外,Hibernate还支持Criteria查询(Criteria Query),这种查询方式把查询条件封装为一个Criteria对象。在实际应用中,使用Session的createCriteria()方法构建一个org.hibernate.Criteria实例,然后把具体的查询条件通过Criteria的add()方法加入到Criteria实例中。这样,程序员可以不使用SQL甚至HQL的情况下进行数据查询,如例程1-1所示。
例程1-1 Criteria应用实例
------------------------------------------------------------------------------------------ Criteria cr = session.createCriteria(Student.class); //生成一个Criteria对象 cr.add(Restrictions.eq("name", "Bill"));//等价于where name=’Bill’ List list = cr.list(); Student stu = (Student)list.get(0); System.out.println(stu.getName()); |
1.常用的查询限制方法
在例程1-1中,Restrictions.eq()方法表示equal,即等于的情况。Restrictions类提供了查询限制机制。它提供了许多方法,以实现查询限制。这些方法及其他一些criteria常用查询限制方法列于表1-1中。
表1-1 Criteria Query常用的查询限制方法
方 法 |
说 明 |
Restrictions.eq() |
equal,= |
Restrictions.allEq() |
参数为Map对象,使用key/value进行多个等于的对比,相当于多个Restrictions.eq()的效果 |
Restrictions.gt() |
greater-than, > |
Restrictions.lt() |
less-than, < |
Restrictions.le() |
less-equal, <= |
Restrictions.between() |
对应SQL的between子句 |
Restrictions.like() |
对应SQL的like子句 |
Restrictions.in() |
对应SQL的in子句 |
Restrictions.and() |
and关系 |
Restrictions.or() |
or关系 |
Restrictions.isNull() |
判断属性是否为空,为空返回true,否则返回false |
Restrictions.isNotNull() |
与Restrictions.isNull()相反 |
Order.asc() |
根据传入的字段进行升序排序 |
Order.desc() |
根据传入的字段进行降序排序 |
MatchMode.EXACT |
字符串精确匹配,相当于“like 'value'” |
MatchMode.ANYWHERE |
字符串在中间位置,相当于“like '%value%'” |
MatchMode.START |
字符串在最前面的位置,相当于“like 'value%'” |
MatchMode.END |
字符串在最后面的位置,相当于“like '%value'” |
例1:查询学生名字以t开头的所有Student对象。
Criteria cr = session.createCriteria(Student.class); cr.add(Restrictions.like(“name”, “t%”)) List list = cr.list(); Student stu = (Student)list.get(0); |
或者使用另一种方式:
Criteria cr = session.createCriteria(Student.class); cr.add(Restrictions.like(“name”, “t”, MatchMode.START)) List list = cr.list(); Student stu = (Student)list.get(0); |
例2:查询学生姓名在Bill, Jack和Tom之间的所有Student对象。
String[] names = {“Bill”, “Jack”, “Tom”} Criteria cr = session.createCriteria(Student.class); cr.add(Restrictions.in(“name”, names)) List list = cr.list(); Student stu = (Student)list.get(0); |
例3:查询学生的年龄age等于22或age为空(null)的所有Student对象。
Criteria cr = session.createCriteria(Student.class); cr.add(Restrictions.eq(“age”, new Integer(22)); cr.add(Restrictions.isNull(“age”)); List list = cr.list(); Student stu = (Student)list.get(0); |
例4:查询学生姓名以字母F开头的所有Student对象,并按姓名升序排序。
Criteria cr = session.createCriteria(Student.class); cr.add(Restrictions.like(“name”, “F%”); cr.addOrder(Order.asc(“name”)); List list = cr.list(); Student stu = (Student)list.get(0); |
调用Order.asc的方法应是Criteria的addOrder()方法。
2.连接限制
在Criteria 查询中使用FetchMode来实现连接限制。在HQL语句中,可以通过fetch关键字来表示预先抓取(Eager fetching),如下所示:
from Group g left join fetch g.students s where g.name like '%2005' |
可以使用Criteria的API完成同样的功能,如下所示:
Criteria cr = session.createCriteria(Group.class); cr.setFetchMode(“students”, FetchMode.EAGER); cr.add(Restrictions.like(“name”, “2005”, MatchMode.END)) List list = cr.list(); |
以上两种方式编写的代码,都使用相同的SQL语句完成它们的功能,如下所示:
select g.*, s.* from Group g left outer join Student s on g.id = s.group_id where g.name like '%2005' |
Native SQL查询
本地SQL查询(Native SQL Query)指的是直接使用本地数据库(如Oracle)的SQL语言进行查询。它能够扫清你把原来直接使用SQL/JDBC 的程序迁移到基于 Hibernate应用的道路上的障碍。
Hibernate3允许你使用手写的SQL来完成所有的create、update、delete和load操作(包括存储过程)。
1.创建一个基于SQL的Query
Native SQL查询是通过SQLQuery接口来控制的,它是通过调用Session.createSQLQuery()方法来获得的,例如:
String sql = "select {s.*} from t_student s where s.age>22"; SQLQuery slqQuery = session.createSQLQuery(sql); sqlQuery.addEntity("s", Student.class); List list = sqlQuery.list(); for (int i=0;list.size();i++) { Student stu = (Student)list.get(i); System.out.println(stu.getAge() +" "+ stu.getName()); } |
createSQLQuery(String sql)利用传入的SQL参数构造一个SQLQuery实例(SQLQuery是Query的子接口)。使用这个方法时,还需要传入查询的实体类,因此要配合SQLQuery的addEntity()方法一起使用。
addEntity()方法是将实体类别与别名联系在一起的方法,此方法的定义如下:
public SQLQuery addEntity(String alias, Class entityClass) |
{}号用来引用数据表的别名,例如以上代码中{s.*}表示使用s来作为t_student表的别名。
2.命名SQL查询
与HQL的命名查询相似,也可以将本地的SQL查询语句定义在映射文件中,然后像调用一个命名HQL查询一样直接调用命名SQL查询。
例如在Student.hbm.xml中定义一个命名SQL查询,如下所示:
<hibernate-mapping> <class name="Student" table="student" lazy="false"> …… </class> <sql-query name="QueryStudents"> <![CDATA[ select {s.*} from t_student s where s.age>22 ]]> <return alias="s" class="Student"/> </sql-query> </hibernate-mapping> |
<sql-query>元素是<hibernate-mapping>元素的一个子元素。利用<sql-query>元素的子元素<return>指定别名与实体类相关联。配合映射文件中的定义,编写如下代码来调用这个命名SQL查询:
Query query = session.getNamedQuery(“QueryStudents”); List list = query.list(); for (int i=0;list.size();i++) { Student stu = (Student)list.get(i); System.out.println(stu.getAge() + “ ”+ stu.getName()); } |
也可以在命名查询中设定查询参数,如下所示:
…… <sql-query name=”QueryStudents”> <![CDATA[ select {s.*} from t_student s where s.age>:age ]]> <return alias=”s” class=”Student”/> </sql-query> ….. |
编写如下代码来调用这个命名SQL查询,并且把查询中定义的参数传入:
Query query = session.getNamedQuery(“QueryStudents”); query.setInteger(“age”,22); List list = query.list(); for (int i=0;list.size();i++) { Student stu = (Student)list.get(i); System.out.println(stu.getAge() + “ ”+ stu.getName()); } |
3.自定义insert、update和delete语句
Hibernate3.x的映射文件中新添了<sql-insert>、<sql-update> 和<sql-delete>3个标记。可以使用这3个标记自定义自己的insert、update和delete语句,例如在Student.hbm.xml中定义这些语句如下:
<hibernate-mapping> <class name="Student" table="student" lazy="false"> <id name="id" unsaved-value="null" type="string" column="id"> <generator class="uuid.hex"/> <property name="name" type="string" /> <property name="age" type="int" /> <sql-insert> <!--insert语句--> insert into t_student(name, age, id) values(?,?,?) </sql-insert> <sql-update> <!--update语句--> update t_student set name=?, age=? where id=? </sql-update> <sql-delete> <!--delete语句--> delete from t_student where id=? </sql-delete> </class> </hibernate-mapping> |
对于上述文件中自定义的SQL语句,要注意以下几点。
insert和update语句中定义的字段必须和映射文件声明的属性相对应,一个都不能少。 在insert和update语句中,属性出现的顺序必须和映射文件中声明的顺序一致。 在insert语句中,主键id总是放在最后。
在程序中实现以上自定义的insert语句如下:
…… Student stu = new Student(); stu.setName(“Bill”); stu.setAge(22); session.save(stu); … |
运行上述程序,控制台显示的信息如下:
Hibernate: insert into t_student(name,age,id) values(?,?,?) |
如果不想在insert或update语句中包括所有属性,则可以在属性定义时,加上insert="false"或update="false",如下所示:
<property name=”name” type=”string” insert=”false” update=”false” /> <sql-insert> insert into t_student(age, id) values(?,?) </sql-insert> <sql-update> update t_student set age=? where id=? </sql-update> |