入門 11 - Set 映射

這個主題介紹如果在物件中包括集合物件，像是使用HashSet來包括其它物件時，該如何進行物件與資料表的映射，像Set這樣的集合，可以包括所有的Java物件，這邊先介紹當Set中包括的物件沒有實體（Entiy）時的映射方式。

　（簡單的說，也就是所包括的物件沒有物件識別（identity）值，沒有資料庫層次上的識別值之表格與之對應的物件，只是純綷的值型態（value type）物件，關於Entity與value type的說明，可以看看參考手冊5.2.1或是Hibernate in Action的第六章。）

　假設我們有一個User類別，當中除了名稱屬性之外，另一個就是使用者的電子郵件位址，同一個使用者可能有多個不同的郵件地址，所以我們在 User類別中使用Set物件來加以記錄，在這邊我們使用String來記錄每一筆郵件位址，為了不允許重複的郵件位址記錄，所以我們使用Set物件，我們的User類別如下：

User.java

package onlyfun.caterpillar;

import java.util.HashSet;
import java.util.Set;

public class User {
    private long id;
    private String name;
    private Set addrs = new HashSet();
   
   public Set getAddrs() {
      return addrs;
   }
   public void setAddrs(Set addrs) {
      this.addrs = addrs;
   }
   public long getId() {
      return id;
   }
   public void setId(long id) {
      this.id = id;
   }
   public String getName() {
      return name;
   }
   public void setName(String name) {
      this.name = name;
   }
   
    public void addAddress(String addr) {
        addrs.add(addr);
    }
}

　addAddress()方法是為了加入一筆一筆的郵件位址而另外增加的，我們也可以在外部設定好Set物件，再使用setAddrs()方法設定給User物件，在映射文件上，為了進行Set的映射，我們使用<set>標籤來進行設定，如下所示：

User.hbm.xml

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping
    PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
    "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">

<hibernate-mapping>

    <class name="onlyfun.caterpillar.User" table="USER">

        <id name="id" type="long" unsaved-value="null">
            <column name="USER_ID"/>
            <generator class="increment"/>
        </id>

        <property name="name" type="string" not-null="true">
            <column name="NAME" length="16" not-null="true"/>
        </property>
       
        <set name="addrs" table="ADDRS">
            <key column="USER_ID"/>
            <element type="string" column="ADDRESS" not-null="true"/>
        </set>
    </class>

</hibernate-mapping>

　從映射文件中我們可以看到，我們使用另一個表格ADDRS來記錄Set中真正記錄的物件，為了表明ADDRS中的每一筆資料是屬於哪一個USER 的，我們透過ADDRS的外鍵USER_ID參考至USER的USER_ID，ADDRS的USER_ID與USER_ID的內容將會是相同的，而 <element>中設定Set所包括的物件之型態，以及它將記錄在哪一個欄位中。

　假設我們使用下面的程式來儲存User的資料：

User user1 = new User();
        user1.setName("caterpillar");
        user1.addAddress("caterpillar@caterpillar.onlyfun.net");
        user1.addAddress("justin@caterpillar.onlyfun.net");
        user1.addAddress("justin@fake.com");
       
        User user2 = new User();
        user2.setName("momor");
        user2.addAddress("momor@caterpillar.onlyfun.net");
        user2.addAddress("momor@fake.com");
       
        Session session = sessionFactory.openSession();
        Transaction tx= session.beginTransaction();
        session.save(user1);
        session.save(user2);
        tx.commit();
        session.close();

　實際上在資料庫中的USER與ADDRS表格的內容將如下：

mysql> select * from user;
+---------+-------------+
| USER_ID | NAME        |
+---------+-------------+
|       1 | caterpillar |
|       2 | momor       |
+---------+-------------+
2 rows in set (0.00 sec)

mysql> select * from addrs;
+---------+-------------------------------------+
| USER_ID | ADDRESS                             |
+---------+-------------------------------------+
|       1 | caterpillar@caterpillar.onlyfun.net |
|       1 | justin@caterpillar.onlyfun.net      |
|       1 | justin@fake.com                     |
|       2 | momor@caterpillar.onlyfun.net       |
|       2 | momor@fake.com                      |
+---------+-------------------------------------+
5 rows in set (0.00 sec)

　下面的程式則簡單的示範如何取出資料：

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());
            Object[] addrs = user.getAddrs().toArray();
            for(int i = 0; i < addrs.length; i++) {
                System.out.println("/taddress " + (i+1) + ": " + addrs[i]);   
            }
        }