Bag


Bag是集合，與Set不同的是，Bag允許重複的元素，在Java的標準API中並沒有提供Bag集合，Hibernate提供自己的Bag實現，允許 您將Collection的實作映射為Bag。

您可以如下定義User類別，其中的Collection成員將被用作Bag來使用，而不管物件在集合中的順序：
  • User.java
package onlyfun.caterpillar;

import java.util.Collection;

public class User {
    private Long id;
    private String name;
    private Collection items;

    // 必須要有一個預設的建構方法
    // 以使得Hibernate可以使用Constructor.newInstance()建立物件
    public User() {}

    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 Collection getItems() {
        return items;
    }

    public void setItems(Collection items) {
        this.items = items;
    }

    public void addItem(String item) {
        items.add(item);
    }
 
    public void removeItem(String name) {
        items.remove(name);
    }
}

最簡單的Bag映射是使用<bag>標籤，在這之前，假設您如下建立表格：
create table item (
    id bigint not null,
    name varchar(255)
)

create table user (
    id bigint not null auto_increment,
    name varchar(255),
    primary key (id)
)

alter table item
    add index id (id),
    add constraint id
    foreign key (id)
    references user (id)

接著定義映射文件，如下所示：
  • 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"> 
            <generator class="native"/> 
        </id> 

        <property name="name" column="name"/> 
 
        <bag name="items" table="item"> 
            <key column="id" foreign-key="id"/> 
            <element column="name" type="string"/> 
        </bag> 
 
    </class> 

</hibernate-mapping>

假設您如下儲存物件：
User user1 = new User();
user1.setItems(new ArrayList());
user1.setName("caterpillar");
user1.addItem("Java Gossip");
user1.addItem("Java Gossip");
user1.addItem("Caxxx A80");
       
User user2 = new User();
user2.setItems(new ArrayList());
user2.setName("momor");
user2.addItem("Snoppy world");       
       
Session session = HibernateUtil.getSessionFactory().openSession();
Transaction tx = session.beginTransaction();
session.save(user1);
session.save(user2);
tx.commit();
session.close();

則資料庫中會有如下的資料：
mysql> select * from user;
+----+-------------+
| id    | name        |
+----+-------------+
|  1    | caterpillar |
|  2    | momor       |
+----+-------------+
2 rows in set (0.00 sec)

mysql> select * from item;
+----+--------------------+
| id    | name                 |
+----+-------------------+
|  1    | Java Gossip     |
|  1    | Java Gossip     |
|  1    | Caxxx A80        |
|  2    | Snoppy world |
+----+-------------------+
4 rows in set (0.00 sec)

您可以如下更新資料：
Session session = HibernateUtil.getSessionFactory().openSession();
Transaction tx = session.beginTransaction();
User user = (User) session.load(User.class, new Long(1));
user.removeItem("Java Gossip");
tx.commit();
session.close();

然而注意觀察在更新資料時所使用的SQL：
Hibernate:
    delete
    from
        item
    where
        id=?
Hibernate:
    insert
    into
        item
        (id, name)
    values
        (?, ?)
Hibernate:
    insert
    into
        item
        (id, name)
    values
        (?, ?)

由於Bag的資料允許重複，當必須更新資料時，無法確定要更新的是哪一筆資料，因而採取的方式是刪除集合物件對應的所有資料，然後重新將集合物件中的資料 寫入資料庫，顯然的這種作法相當的沒有效率。

作為Bag的一種擴充，Hibernate提供idbag，藉由在定義Bag映射時加上"collection-id"，讓Hibernate可以直接確 定所要更新的資料，提高資料庫操作的效率，您可以先如下建立表格：
create table item (
    id bigint not null,
    name varchar(255),
    cid varchar(255) not null,
    primary key (cid)
)

create table user (
    id bigint not null auto_increment,
    name varchar(255),
    primary key (id)
)

alter table item
    add index id (id),
    add constraint id
    foreign key (id)
    references user (id)

其中item表格的cid就用於資料更新時定位之用，接著在映射文件中使用<idbag>標籤加以定義：
  • 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"> 
            <generator class="native"/> 
        </id> 

        <property name="name" column="name"/> 
 
        <idbag name="items" table="item"> 
            <collection-id column="cid" type="string">
                <generator class="uuid.hex"/>
            </collection-id>
            <key column="id" foreign-key="id"/> 
            <element column="name" type="string"/> 
        </idbag> 
 
    </class> 

</hibernate-mapping>

使用上面用過的程式片段來儲存物件的話，資料庫中會有如下的資料：
mysql> select * from user;
+----+-------------+
| id    | name        |
+----+-------------+
|  1    | caterpillar |
|  2    | momor      |
+----+-------------+
2 rows in set (0.00 sec)

mysql> select * from item;
+------------------------------------------------+----+--------------------+
| cid                                                            | id   | name                  |
+------------------------------------------------+----+--------------------+
| 297eba61056726030105672605df0001 |  1   | Java Gossip      |
| 297eba61056726030105672605df0002 |  1   | Java Gossip      |
| 297eba61056726030105672605df0003 |  1   | Caxxx A80         |
| 297eba61056726030105672605df0004 |  2   | Snoppy world  |
+------------------------------------------------+----+-------------------+
4 rows in set (0.00 sec)

如果使用上面提到過的程式片段來更新物件的話，則實際上Hibernate會使用以下的SQL來進行更新：
Hibernate:
    delete
    from
        item
    where
        cid=?

這一次並不是整個刪除集合中的資料，而是直接藉由cid來確定所要更新的資料，比起只使用Bag，idbag的效率好了許多。