HQL查询——HQL查询的基本用法

HQL查询——HQL查询的基本用法

1.HQL语法类似于SQL语法，但是需要注意的是，HQL是一种完全面向对象的查询语言。SQL语言操作的对象是数据表、列等数据库对象，而HQL语言的操作对象是类、实例、属性等。

2.由于HQL语言是面向对象的查询语言，所以他具有面向对象的特征，即支持继承和多态。

3.HQL查询依赖于Hibernate提供的Query类，每个Query类实例对应一个查询对象。

4.使用HQL查询的步骤如下：

（1）获取Hibernate Session对象；

（2）编写HQL语句；

（3）如果以HQL语句作为参数，调用Session的createQuery()方法创建查询对象；

（4）如果HQL语句包含参数，则调用Query的setXxx()方法为参数赋值；

（5）调用Query对象的list()方法或者uniqueResult()方法返回查询结果列表（持久化实体集）。

5.执行HQL查询的例子：

 import java.text.SimpleDateFormat;
 import java.util.Arrays;
 import java.util.Date;
 import java.util.List;

 import org.hibernate.Session;
 import org.hibernate.Transaction;

 /**
  * @author admin
  *    使用HQL查询的例子
  */
 public class HqlQuery {
     public static void main(String[] args)throws Exception {
         HqlQuery mgr = new HqlQuery();
         //调用第一个查询方法
         mgr.findPersons();
         //调用第二个查询方法
         mgr.findPersonsByHappenDate();
         //调用第三个查询方法
         mgr.findPersonProperty();
     }
     //第一个查询方法
     private void findPersons(){
         //获得Hibernate Session对象
         Session session = HibernateUtil.currentSession();
         //开始事务
         Transaction tx = session.beginTransaction();
         //使用HQL语句创建Query对象
         List pl = session.createQuery("select distinct p from Person p join p.myEvents where title = :eventTitl")
                 //执行setString方法为HQL语句中的参数赋值
                 .setString("eventTile", "普通事情")
                 //使用Query实例的list()方法获取查询的全部实例
                 .list();
         //遍历查询的全部结果
         for(Object ele : pl){
             Person p = (Person)ele;
             System.out.println(p.getName());
         }
         //提交事务
         tx.commit();
         //关闭Session
         HibernateUtil.closeSession();
     }
     //第二个查询方法
     private void findPersonsByHappenDate()throws Exception{
         //获取Hibernate Session对象
         Session session = HibernateUtil.currentSession();
         //开始事务
         Transaction tx = session.beginTransaction();
         //解析出Date对象
         SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
         Date start = new Date("2017-01-03");
         //通过Session对象的createQuery()方法创建Query对象
         List pl = session.createQuery("select distinct p from Person p inner join p.myEvents evebt "
                 + "where event.happenDate"
                 + "between:firstDate and :endDate").
                 //设置参数
                 setDate("firstDate", start).
                 setDate("endDate", new Date()).
                 //返回结果
                 list();
         //遍历结果集
         for(Object ele:pl){
             Person p = (Person)ele;
             System.out.println(p.getName());
         }
         //提交事务
         tx.commit();
         //关闭Session
         HibernateUtil.closeSession();
     }
     //第三个查询方法：属性的查询
     private void findPersonProperty(){
         //获得Session对象
         Session session = HibernateUtil.currentSession();
         //开始事务
         Transaction tx = session.beginTransaction();
         //使用HQL创建Query对象
         List pl = session.createQuery("select distinct p.id,p.name,p.age"
                 + "from Person p join p.myEvents")
                 //Query调用list()方法查询得到的全部属性
                 .list();
         //遍历查询的全部结果
         for(Object ele:pl){
             Object[] objs = (Object[])ele;
             System.out.println(Arrays.toString(objs));
         }
         //提交事务
         tx.commit();
         //关闭Session对象
         HibernateUtil.closeSession();
     }
 }

6.HQL语句中可以使用占位符作为参数。HQL中的占位符既可以使用英文问号+索引的形式（?N）；也可以使用有名字的占位符，使用有名字的占位符时，应该在占位符名字前增加英文冒号（：）。

7.成功编写了HQL语句以后就可以使用Session对象的createQuery(hql)方法创建一个Query，Query对象使用setXxx()方法为HQL语句的参数赋值。Query的所有setXxx()方法都有两个版本，分别用于根据参数索引赋值和根据参数名字赋值。

8.Query对象可以连续为多次的参数赋值，因为Query对象的setXxx()方法返回的依然是一个Query对象本身，在最后使用Query对象的list()方法来获取查询到的全部结果。

9.注意：HQL语句本身是不区分大小写的。即HQL语句的关键字、函数都是不区分大小写的。但是HQL语句中的所使用的包名、类名、实例名、属性名都是区分大小写的。