入門 05 - 基本資料查詢

使用Hibernate進行資料查詢是一件簡單的事，Java程式設計人員可以使用物件操作的方式來進行資料查詢，查詢時使用一種類似SQL的HQL（Hibernate Query Language）來設定查詢的條件，與SQL不同的是，HQL是具備物件導向的繼承、多型等特性的語言。

　直接使用範例來看看如何使用Hibernate進行資料庫查詢，在這之前，請先照之前介紹過的主題在資料庫中新增幾筆資料：
在Hibernate中新增資料

　查詢資料時，我們所使用的是Session的find()方法，並在當中指定HQL設定查詢條件，查詢的結果會裝載在List物件中傳回，您所需要的是將它們一一取出，一個最簡單的例子如下：

HibernateTest.java

import onlyfun.caterpillar.*;
import net.sf.hibernate.*;
import net.sf.hibernate.cfg.*;
import java.util.*;

public class HibernateTest {
    public static void main(String[] args) throws HibernateException {
        SessionFactory sessionFactory = new Configuration().configure().buildSessionFactory();
        Session session = sessionFactory.openSession();
     
        List users = session.find("from User");

        session.close();
        sessionFactory.close();

        for (ListIterator iterator = users.listIterator(); iterator.hasNext(); ) {
            User user = (User) iterator.next();
            System.out.println(user.getName() +
                               "/n/tAge: " + user.getAge() +
                               "/n/tSex: " + user.getSex());
        }
    }
}

　find()中的"from User"即HQL，User指的是User類別，藉由映射文件，它將會查詢USER表格中的資料，相當於SQL中的SELECT * FROM USER，實際上我們的User類別是位於onlyfun.caterpillar下，Hibernate會自動看看import中的package名稱與類別名稱是否符合，您也可以直接指定package名稱，例如：

session.find("from onlyfun.caterpillar.User");

　這個程式的運行結果可能是這樣的：

log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).
log4j:WARN Please initialize the log4j system properly.
Hibernate: select user0_.user_id as user_id, user0_.name as name, user0_.sex as sex, user0_.age as age from USER user0_
caterpillar
   Age: 28
   Sex: M
momor
   Age: 25
   Sex: F
Bush
   Age: 25
   Sex: M
Becky
   Age: 35
   Sex: F

　上面所介紹的查詢是最簡單的，只是從資料表中查詢所有的資料，Hibernate所查詢得回的資料，是以物件的方式傳回，以符合程式中操作的需要，我們也可以限定一些查詢條件，並只傳回我們指定的欄位，例如：

List names = session.find("select user.name from User as user where age = 25");
for (ListIterator iterator = names.listIterator(); iterator.hasNext(); ) {
    String name = (String) iterator.next();
    System.out.println("name: " + name);
}

　在find()中的HQL示範了條件限定的查詢，User as user為User類別取了別名，所以我們就可以使用user.name來指定表格傳回欄位，where相當於SQL中的WHERE子句，我們限定查詢 age等於25的資料，這次查詢的資料只有一個欄位，而型態是String，所以傳回的List內容都是String物件，一個運行的例子如下：

log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).
log4j:WARN Please initialize the log4j system properly.
Hibernate: select user0_.name as x0_0_ from USER user0_ where (age=25 )
name: momor
name: Bush

　如果要傳回兩個以上的欄位，也不是什麼問題，直接來看個例子：

List results = session.find("select user.name, user.age from User as user where sex = 'F'");
for (ListIterator iterator = results.listIterator(); iterator.hasNext(); ) {
    Object[] rows = (Object[]) iterator.next();
    String name = (String) rows[0];
    Integer age = (Integer) rows[1];
    System.out.println("name: " + name + "/n/t" + age);
}

　從上面的程式中不難看出，傳回兩個以上欄位時，每一次ListIterator會以Object陣列的方式傳回一筆資料，我們只要指定陣列索引，並轉換為適當的型態，即可取得資料，一個查詢的結果如下：

log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).
log4j:WARN Please initialize the log4j system properly.
Hibernate: select user0_.name as x0_0_, user0_.age as x1_0_ from USER user0_ where (sex='F' )
name: momor
   25
name: Becky
   35

　您也可以在HQL中使用一些函數來進行結果統計，例如：

List results = session.find("select count(*), avg(user.age) from User as user");
ListIterator iterator = results.listIterator();
Object[] rows = (Object[]) iterator.next();
System.out.println("資料筆數: " + rows[0] + "/n平均年齡: " + rows[1]);

　一個查詢的結果如下所示：

log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).
log4j:WARN Please initialize the log4j system properly.
Hibernate: select count(*) as x0_0_, avg(user0_.age) as x1_0_ from USER user0_
資料筆數: 4
平均年齡: 28.25

　這邊我們先介紹的是一些簡單的查詢動作，將來有機會的話，再介紹一些進階的查詢，如果您有想要先認識一些HQL，可以看看參考手冊的第11章，當中對於HQL有詳細的說明。