Query

Query

可以透過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/>標籤，並在& lt;![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();