Hibernate的查询语言之HQL(一)——快速入门

　　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语句中所使用的包名，类名，实例名，属性名都区分大小写。