Query - OpenSource Project

可以透過org.hibernate.Query介面的實例來進行查詢，透過Query介面，您可以先設定查詢參數，之後透過setXXX()等方法，將指定的參數值填入，而不用每次都撰寫完整的HQL，直接來看個例子：

Session session = sessionFactory.openSession();
Query query = session.createQuery("select user.name from User as user where user.age > ?"); 
query.setInteger(0, 25);

List names = query.list();
Iterator iterator =  names.iterator();
while(iterator.hasNext()) {
    System.out.println(iterator.next());
}

session.close();

在設定參數值時，必須依照 ? 所設定的順序，並使用對應型態的setXXX()方法，一個執行的例子如下：

Hibernate: select user0_.name as col_0_0_ from user user0_ where user0_.age>?
momor
caterpillar
bush

您可以使用命名參數（Named Parameter）來取代這個方法，這可以不用依照特定的順序來設定參數值，並擁有較好的可讀性，直接來看個例子：

Session session = sessionFactory.openSession();
Query query = session.createQuery("select user.name from User as user where user.age > :minAge"); 
query.setInteger(":minAge", 25);

List names = query.list();
Iterator iterator =  names.iterator();
while(iterator.hasNext()) {
    System.out.println(iterator.next());
}

session.close();

設定命名參數時，在建立Query時先使用:後跟著參數名，之後就可以在setXXX()方法中直接指定參數名來設定參數值，而不用依照特定的順序。

也可以將HQL撰寫在程式之外，以避免硬編碼（Hard code）在程式之中，在需要修改HQL時就很方便，在*.hbm.xml中使用<query/>標籤，並在<![CDATA[與]] >之間撰寫HQL，撰寫的位置是在</hibernate-mapping>之前，例如：

User.hbm.xml

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-mapping     
  PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"     
  "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
  <hibernate-mapping>
    <class name="onlyfun.caterpillar.User" table="user">
      <id name="id" column="id" type="java.lang.Integer">
        <generator class="native"/>
      </id>
      <property name="name" column="name" type="java.lang.String"/>
      <property name="age" column="age" type="java.lang.Integer"/>
    </class>
    <query name="onlyfun.caterpillar.QueryUser">
      <![CDATA[             
        select user.name from User as user where user.age >  :minAge        
      ]]>     
    </query>
  </hibernate-mapping>

<query>的name屬性用來設定查詢外部HQL時的名稱依據，使用的例子如下：

Session session = sessionFactory.openSession();
Query query = session.getNamedQuery("onlyfun.caterpillar.QueryUser"); 
query.setInteger("minAge", 25);

List names = query.list();
Iterator iterator =  names.iterator();
while(iterator.hasNext()) {
    System.out.println(iterator.next());
}

session.close();