Hibernate提供异常强大的查询体系,使用Hibernat有多种查询方式可以选择:即可以使用Hibernate的HQL查询,也可以使用条件查询,甚至可以使用原生的SQL查询语句。不仅如此, Hibernate还提供了一种数据过滤功能,这些都用于筛选目标数据。
Hibernate是 Hibernate Query Language的缩写,HQL的语法很像SQL,但HQL是一种面向对象的查询语言。SQL的操作对象是数据表，列表数据库对象，而HQL的操作对象是类，实例，属性等。
HQL是完全面向对象查询语言，因此可以支持继承，多态等特性。
HQL查询依赖于Query类，每个Query实例对应一个查询对象。使用HQL查询按如下步骤进行：
(1)获取Hibernate Session对象。
(2)编写HQL语句。
(3)以HQL语句作为参数，调用Session的createQuery 方法创建查询对象。
(4)如果HQL语句包含参数,则调用Query的setXxx方法为参数赋值。
(5)调用Query对象的list()或uniqueResult()方法返回查询结果列表(持久化实体集)。
下面是一个用例:
Person和MyEvent两个类的代码及映射文件:
import java.util.HashSet;
import java.util.Set; public class Person {
// 定义标识属性
private Integer id;
// 定义Person实例的name属性
private String name;
// 定义Person实例的age属性
private Integer age;
// 定义Person和MyEvent之间的关联关系
private Set<MyEvent> myEvents = new HashSet<MyEvent>();
// 定义一个集合属性
private Set<String> emails = new HashSet<String>(); // 无参数的构造器
public Person() {
} // 初始化全部属性的构造器
public Person(Integer id, String name, Integer age) {
this.id = id;
this.name = name;
this.age = age;
} // id属性的setter和getter方法
public void setId(Integer id) {
this.id = id;
} public Integer getId() {
return this.id;
} // name属性的setter和getter方法
public void setName(String name) {
this.name = name;
} public String getName() {
return this.name;
} // age属性的setter和getter方法
public void setAge(int age) {
this.age = age;
} public Integer getAge() {
return this.age;
} // myEvents属性的setter和getter方法
public void setMyEvents(Set<MyEvent> myEvents) {
this.myEvents = myEvents;
} public Set<MyEvent> getMyEvents() {
return this.myEvents;
} // emails属性的setter和getter方法
public void setEmails(Set<String> emails) {
this.emails = emails;
} public Set<String> getEmails() {
return this.emails;
}
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.example.hql.pojo">
<class name="Person" table="person">
<id name="id" column="person_id">
<generator class="native" />
</id>
<property name="name" />
<property name="age" />
<!-- 映射和MyEvent实体的关联关系 -->
<set name="myEvents" table="person_event">
<!-- 映射连接表中参照此表主键的外键列的列名 -->
<key column="person_id" />
<many-to-many class="MyEvent" column="event_id" />
</set>
<!-- 映射集合属性 -->
<set name="emails" table="person_email">
<!-- 映射集合属性表中的外键列 -->
<key column="person_id" />
<!-- 映射集合元素，集合元素是字符串 -->
<element type="string" column="email" />
</set>
</class>
</hibernate-mapping>
import java.util.Date;
import java.util.HashSet;
import java.util.Set; public class MyEvent {
// 定义标识属性
private Integer id;
// 定义MyEvent对象的名称
private String title;
// 定义MyEvent对象的发生时间
private Date happenDate;
// 定义MyEvent对象和Person对象的关联
private Set<Person> actors = new HashSet<Person>(); // 无参数的构造器
public MyEvent() {
} // 初始化全部属性的构造器
public MyEvent(Integer id, String title, Date happenDate) {
this.id = id;
this.title = title;
this.happenDate = happenDate;
} // id属性的setter和getter方法
public void setId(Integer id) {
this.id = id;
} public Integer getId() {
return this.id;
} // title属性的setter和getter方法
public void setTitle(String title) {
this.title = title;
} public String getTitle() {
return this.title;
} // happenDate属性的setter和getter方法
public void setHappenDate(Date happenDate) {
this.happenDate = happenDate;
}
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.example.hql.pojo">
<class name="MyEvent" table="event">
<id name="id" column="event_id">
<generator class="native" />
</id>
<property name="title" />
<property name="happenDate" type="date" />
<set name="actors" table="person_event">
<key column="event_id" />
<many-to-many class="Person" column="person_id" />
</set>
</class>
</hibernate-mapping>
下面是查询代码
import java.text.SimpleDateFormat;
import java.util.Arrays;
import java.util.Date;
import java.util.Iterator;
import java.util.List; import org.hibernate.Session;
import org.hibernate.Transaction;
import org.junit.Test; import com.example.hql.pojo.Person;
import com.example.util.HibernateSessionFactory; @SuppressWarnings("unchecked")
public class HqlQuery {
@Test
public void findPerson() {
// 开启Session
Session session = HibernateSessionFactory.getSession();
// 开始事务
Transaction tx = session.beginTransaction();
// 以HQL语句创建Query对象
// 执行setString方法为HQL语句的参数赋值 List<Person> persons = (List<Person>) session
.createQuery(
"select distinct p from Person p join p.myEvents where title = :eventTitle")
.setString("eventTitle", "很普通的事情").list();
// 遍历查询结果
for (Iterator<Person> pit = persons.iterator(); pit.hasNext();) {
Person p = pit.next();
System.out.println(p.getName());
}
tx.commit();
session.close();
} @Test
public void findPersonByHappenDate() throws Exception {
Session session = HibernateSessionFactory.getSession();
Transaction tx = session.beginTransaction();
// 解析出Date对象
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-DD");
Date start = sdf.parse("2012-10-10");
System.out.println("系统开始通过日期查找人:" + start);
List<Person> persons = session
.createQuery(
"select distinct p from Person p inner join p.myEvents event where event.happenDate between :firstDate and :endDate")
.setDate("firstDate", start).setDate("endDate", new Date())
.list();
// 遍历查询结果
for (Person p : persons) {
System.out.println(p);
}
tx.commit();
session.close();
} @Test
public void findPersonProperty(){
Session session = HibernateSessionFactory.getSession();
Transaction tx = session.beginTransaction();
List<Object[]> datas = session.createQuery("select distinct p.id, p.name, p.age from Person p join p.myEvents").list();
for(Object[] data:datas){
System.out.println(Arrays.toString(data));
}
tx.commit();
session.close();
}
}
由上面HQL语句可以看出,执行HQL语句类似于用PreparedStatement执行SQL语句，因此HQL语句中可以使用占位符作为参数。HQL的占位符即可使用问号(?)，这与SQL语句中的占位符完全一样；也可以使用有名字的占位符，使用有名字的占位符时，应该在占位符名字前增加冒号(:),如上HQL所示。
编写完HQL语句之后，就可使用Session的createQuery(hql)方法创建Query,Query对象使用setXxx()方法为HQL语句的参数赋值。Query的所有setXxx()方法都有两个版本,分别用于根据参数索引赋值和根据参数名字赋值。
Query对象可以连续多次围HQL参数赋值，这得益于Hibernate Query的设计。通常的setXxx()方法返回值都是void，单Hibernate Query的setXxx()方法返回值是Query本身，采用了 链式 设计的思想。因此，程序通过Session创建Query后，直接多次调用setXxx()方法为HQL语句的参数赋值。
Query最后调用list()方法返回查询到的全部结果。
Query还包含如下两个方法。
》setFirstResult(int firstResult)：设置返回结果从第几条记录开始。
》setMaxResult(int maxResults): 设置本次查询返回的结果数目。
这两个方法用于HQL查询实现分页控制。
HQL语句本身是不区分大小写的。也就是说HQL语句的关键字，函数都不是区别大小写的。但HQL语句中所使用的包名，类名，实例名，属性名都区分大小写。