HIBERNATE QUICKLY

I. Giới thiệu:
Persistence là nói đến khả năng một đối tượng duy trì sự tồn tại sau thời gian sống của chương trình tạo
ra nó. Nếu không có khả năng này, dữ liệu chỉ tồn tại trong bộ nhớ và sẽ mất đi khi bộ nhớ tắt hoặc
máy tính shutdown.

Có một vài loại persistence, ví dụ: khi bạn hiệu chỉnh một file source thì file đó sẽ được persist xuống
đĩa để lần sau rút trích và sử dụng. Các file được lưu trên đĩa là hình thức phổ biến nhất của
persistence. Trong ứng dụng, ví dụ như shopping cart thì persist dữ liệu trong một CSDL quan hệ.

CSDL quan hệ là một sự chọn lựa phổ biến để lưu dữ liệu vì dữ liệu dễ dàng được tạo và truy cập bằng
SQL. Mô hình được sử dụng bởi CSDL quan hệ được gọi là mô hình quan hệ, biểu diễn dữ liệu dưới
dạng bảng hai chiều. Các table có thể liên quan nhau thông qua việc sử dụng khóa chính và khóa ngoại.
Khóa chính đảm bảo không có hai record trong bảng có cùng giá trị. Khóa ngoại tham chiếu đến khóa
chính được lưu trong một bảng khác.

CSDL quan hệ được thiết kế để quản lý dữ liệu theo mô hình quan hệ. Tuy nhiên khi làm việc với các
ứng dụng hướng đối tượng, bạn có thể gặp một số vấn đề khi bạn cố gắng persist các đối tượng vào
trong mô hình quan hệ. Với sự khác biệt của hai mô hình, làm thế nào để chúng làm việc được với
nhau. Để giải quyết vấn đề này object/relational mapping (ORM) ra đời.

ORM là một cầu nối giữa hai mô hình, cho phép ứng dụng của bạn persist các đối tượng trực tiếp vào
CSDL quan hệ mà không cần chuyển đổi qua lại giữa object và relational. Có một vài ORM framework
yêu cầu các đối tượng kế thừa từ lớp cơ bản (base) hoặc yêu cầu xử lý bytecode. Trong khi đó,
Hibernate chỉ yêu cầu một số lượng nhỏ metadata cho mỗi đối tượng persistent. Nó cung cấp đầy đủ
ánh xạ đối tượng/quan hệ, nghĩa là hỗ trợ tất cả các đặc trưng hướng đối tượng mà CSDL quan hệ
thiếu.

II. Cơ bản về Hibernate:

1.Cấu hình:
Hibernate được cấu hình theo hai bước:
• Cấu hình service bao gồm: tham số kết nối CSDL, caching và tập các lớp persistent.
• Cung cấp cho Hibernate các thông tin về các lớp được persist.

Để giải quyết hai bước theo yêu cầu của Hibernate, chúng ta sẽ thảo luận từng vấn đề sau:
• Tạo file cấu hình hibernate.cfg.xml.
• Xây dựng các file định nghĩa ánh xạ để cung cấp cho Hibetnate các thông tin về các lớp
persistent.
• Các lớp được sử dụng để persist và rút trích các lớp.
• Cấu hình nâng cao bao gồm: object caching và quản lý giao dịch.

1.1. Cấu hình cơ bản:

Hibernate cung cấp 2 phương pháp cấu hình: file properties theo chuẩn của Java được gọi là
hibernate.properties và file có định dạng XML gọi là hibernate.cfg.xml. Chúng ta sẽ sử dụng file cấu
hình XML để cấu hình các service của Hibernate. Nếu cả hai file hibernate.properties và
hibernate.cfg.xml được tìm thấy trong classpath của ứng dụng thì hibernate.cfg.xml sẽ override lên các
thiết lập được tìm thấy trong hibernate.properties.

Trước khi cấu hình Hibernate, đầu tiên bạn nên xác định service giữ kết nối đến CSDL như thế nào.
Kết nối đến CSDL có thể được cung cấp bởi Hibernate hoặc từ JNDI DataSource. Một phương pháp
thứ ba là kết nối JDBC được cung cấp bởi người dùng.

a) Sử dụng kết nối JDBC được quản lý bởi Hibernate:

Sau đây là file cấu hình mẫu sử dụng loại kết nối JDBC được quản lý bởi Hibernate:

<?xml version="1.0"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<property name="connection.username">uid</property>
<property name="connection.password">pwd</property>
<property name="connection.url">
jdbc:mysql://localhost/db
</property>
<property name="connection.driver_class">
com.mysql.jdbc.Driver
</property>
<property name="dialect">
org.hibernate.dialect.MySQLDialect
</property>
<mapping resource="com/manning/hq/ch03/Event.hbm.xml"/>
<mapping resource="com/manning/hq/ch03/Location.hbm.xml"/>
<mapping resource="com/manning/hq/ch03/Speaker.hbm.xml"/>
<mapping resource="com/manning/hq/ch03/Attendee.hbm.xml"/>
</session-factory>
</hibernate-configuration>

Để sử dụng JDBC connection được cung cấp bởi Hibernate, file cấu hình yêu cầu 5 thuộc tính:
connection.driver_class, connection.url, connection.username, connection.password, dialect.

Thuộc tính dialect bảo cho Hibernate biết SQL dialect nào được sử dụng để thao tác. Nó được sử dụng
để đảm bảo các câu Hibernate Query Language (HQL) được chuyển đổi đúng với SQL dialect dưới
CSDL.

Hibernate cũng cần biết vị trí (đường dẫn tương đối so với classpath của ứng dụng) và tên của các
mapping file - mô tả persistent classs.

b) Sử dụng JNDI DataSource:

Để sử dụng Hibernate với kết nối CSDL được cung cấp bởi JNDI DataSource, bạn cần thay đổi một vài
chỗ trong file cấu hình như sau:

<?xml version="1.0"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory
name="java:comp/env/hibernate/SessionFactory">
<property name="connection.datasource">
jdbc/myDataSource
</property>
<property name="dialect">
org.hibernate.dialect.MySQLDialect
</property>
<mapping resource="com/manning/hq/ch03/Event.hbm.xml"/>
<mapping resource="com/manning/hq/ch03/Location.hbm.xml"/>
<mapping resource="com/manning/hq/ch03/Speaker.hbm.xml"/>
<mapping resource="com/manning/hq/ch03/Attendee.hbm.xml"/>
</session-factory>
</hibernate-configuration>

Bạn chỉ sử dụng loại cấu hình này khi sử dụng Hibernate với application server: Jboss,
WebSphere...Thuộc tính connection.datasource phải có cùng giá trị với tên của JNDI DataSource trong
cấu hình application server.

1.2. Tạo định nghĩa ánh xạ:

Các định nghĩa ánh xạ được gọi là mapping document, được sử dụng để cung cấp cho Hibernate các
thông tin để lưu trữ các đối tượng đến CSDL quan hệ. Các file ánh xạ cung cấp các đặc tính như tạo
lược đồ CSDL từ tập hợp các file ánh xạ.

Các định nghĩa ánh xạ cho các đối tượng persistent có thể được lưu chung với nhau trong cùng một
file. Phương pháp thích hợp hơn là định nghĩa cho mỗi đối tượng được lưu trong một file.

Quy ước đặt tên cho các file ánh xạ là sử dụng tên của persistent class với phần mở rộng hbm.xml. Ví
dụ: File ánh xạ cho lớp Event có tên là Event.hbm.xml.

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.manning.hq.ch03">
<class name="Event" table="events">
<id name="id" column="uid" type="long" unsaved-value="null">
<generator class="native"/>
</id>
<property name="name" type="string" length="100"/>
<property name="startDate" column="start_date"
type="date"/>
<property name="duration" type="integer"/>
<many-to-one name="location" column="location_id"
class="Location"/>
<set name="speakers">
<key column="event_id"/>
 <one-to-many class="Speaker"/>
</set>
<set name="attendees">
<key column="event_id"/>
<one-to-many class="Attendee"/>
</set>
</class>
</hibernate-mapping>

File ánh xạ bắt đầu bằng hibernate-mapping element. Thuộc tính package thiết lập package mặc định
cho lớp. Thuộc tính set, bạn cần cung cấp tên của lớp persistent khác như: Speaker và Attendee.

Thẻ class bắt đầu định nghĩa ánh xạ cho lớp persistent xác định, thuộc tính table là tên của quan hệ
(relational) được sử dụng để lưu các đối tượng.

Element <id> mô tả khóa chính của persistent class - tự động được phát sinh. Thuộc tính name định
nghĩa các thuộc tính của persistent class sẽ được sử dụng để lưu giá trị của khóa chính.

Element <generate> được sử dụng để xác định tên của lớp phát sinh khóa chính cho record mới khi lưu
nó. Ở đây chúng ta sử dụng lớp native.

Sau đây là danh sách các generator phổ biến được sử dụng trong Hibernate:
• increment - phát sinh id (loại long, short hoặc int) là duy nhất chỉ khi không có tiến trình khác
chèn dữ liệu vào cùng bảng.
• identity - nó hỗ trợ cột id trong DB2, MySQL, MS SQL Server, Sybase và HypersonicSQL. Id
được trả về có loại long, short hoặc int.
• sequence - phát sinh sequence sử dụng một sequence trong DB2, PostgreSQL, Oracle, SAP DB,
McKoi hoặc Interbase. Id được trả về có loại long, short hoặc int.
• hilo - Bộ phát sinh hilo sử dụng thuật toán hilo để phát sinh id.
• native - Nó sẽ chọn id, sequence hoặc hilo phụ thuộc vào khả năng CSDL phía dưới.

Thuộc tính unsaved-value mô tả giá trị của thuộc tính id cho các thể hiện transient của lớp đó.

1.3. Các thuộc tính:

Element property của đối tượng Event thì tương tự như element id:
<property name="name" type="string" length="100"/>
<property name="startDate" column="start_date" type="date"/>
<property name="duration" type="integer"/>

Mỗi element property này tương ứng với một thuộc tính trong đối tượng Event. Thuộc tính name chứa
tên thuộc tính, thuộc tính type xác định loại đối tượng của thuộc tính. Column được sử dụng để lưu giá
trị của thuộc tính.

1.4. Element many-to-one:

Định nghĩa mối quan hệ với lớp Location. Mối quan hệ nhiều - một sử dụng khóa ngoại để duy trì mối
quan hệ giữa hai lớp persistent.

Từ hình bạn có thể suy diễn rằng: nhiều thể hiện của Event kết hợp với một thể hiện của Location. Mặc
dù hình không hiển thị nó nhưng mối quan hệ này thì không phải hai chiều nghĩa là bạn có thể định vị
đến Location từ Event nhưng không thể ngược lại. Ở điểm này chúng ta sẽ biểu diễn file ánh xạ của lớp
Location như sau:

<?xml version="1.0"?>
<hibernate-mapping package="com.manning.hq.ch03">
<class name="Location" table="locations">
<id name="id" column="uid" type="long">
<generator class="native"/>
</id>
<property name="name" type="string"/>
<property name="address" type="string"/>
</class>
</hibernate-mapping>

Ánh xạ của lớp này thì tương tự như Event mặc dù nó không có thuộc tính nhiều và thiếu mối quan hệ
với các đối tượng persistent khác.

Đối với Event, element many-to-one định nghĩa tham chiếu giữa các đối tượng persistent. Ánh xạ mối
quan hệ many-to-one như sau:

<many-to-one name="location" column="location_id" class="Location"/>

Thuộc tính name cung cấp tên của thuộc tính trong đối tượng và thuộc tính column xác định column
được sử dụng để lưu khóa ngoại đến bảng location. Thuộc tính class cung cấp tên của lớp persistent cần
quan hệ.

Một câu hỏi phổ biến được đặt ra là: làm thế nào để tạo mối quan hệ many-to-one lazy - nghĩa là đối
tượng được kết hợp với nó sẽ không được rút trích khi đối tượng cha được rút trích. Các giải quyết là
sử dụng proxied objects.

1.5. Proxy:
Object proxy là cách tránh rút trích một đối tượng cho đến khi cần đến nó. Định nghĩa nó bằng 2 cách:

1. Thêm thuộc tính proxy vào element class:

<class name="Location" proxy="com.manning.hq.ch03.Location"...>
...
</class>

2. Sử dụng thuộc tính lazy = "true" là cách ngắn nhất để định nghĩa lớp persistent như proxy:
<class name="Location" lazy="true"...>...</class>

Thuộc tính lazy là true mặc định trong Hibernate 3. Cách sử dụng thể hiện proxied Location:

Session session = factory.openSession();

Event ev = (Event) session.load(Event.class, myEventId);
Location loc = ev.getLocation();
String name = loc.getName();
session.close();
Trả về thể hiện của Location là proxy. Hibernate lấy thể hiện Location khi getName() được gọi.

1.6. Collections:
File ánh xạ định nghĩa các collection của Speakers và Attendees. Collection được định nghĩa là set -
nghĩa là Hibernate quản lý các collection với ngữ cảnh là java.util.Set.

<set name="speakers">
<key column="event_id"/>
<one-to-many class="Speaker"/>
</set>

Định nghĩa này khai báo rằng lớp Event có một thuộc tính tên là speakers và nó là một Set chứa các thể
hiện của lớp Speaker. Lớp Event có thuộc tính tương ứng như sau:

public class Event {

private Set speakers;
...
public void setSpeakers(Set speakers) {
This.speakers = speakers;
}
public Set getSpeakers() {
return this.speakers;
}
...
}

Element key định nghĩa khóa ngoại từ bảng collection đến bảng cha. Trong trường hợp này, bảng
speakers có một column event_id tham chiếu đến column id trong bảng events. Element one-to-many
định nghĩa mối quan hệ với lớp Speaker.

Ngoài Set Hibernate còn hỗ trợ Map và List.

1.7. Cascade:
Các thao tác lan truyền theo tầng trên một bảng (như delete) đến các bảng kết hợp. Giả sử, khi delete
Event, bạn cũng muốn delete các thể hiện Speaker kết hợp với Event. Thay vì code trong ứng dụng sẽ
thực hiện, Hibernate có thể quản lý nó thay cho bạn.

Các loại cascade: all, save-update, delete, delete-orphan.

Element cascade được thêm vào many-to-one hoặc element collection. Ví dụ cấu hình sau sẽ hướng
dẫn Hibernate delete các Speaker con khi Event cha bị delete:

<set name="speakers" cascade="delete">

<key column="event_id"/>
<one-to-many class="Speaker"/>
</set>

1.8. Duyệt các đối tượng kết hợp:

Bạn có thể rút trích các đối tượng kết hợp sử dụng outer join hoặc bằng câu lệnh SELECT. Thuộc tính
fetch cho phép bạn xác định các phương thức để sử dụng:

<many-to-one name="location" class="Location" fetch="join"/>

Khi thể hiện Event được load thì đối tượng Location kết hợp cũng sẽ được load bằng outer join. Nếu
muốn sử dụng câu lệnh select thì sẽ sử dụng như sau:

<many-to-one name="location" class="Location" fetch="select"/>

1.9. Xây dựng SessionFactory:

Giao tiếp SessionFactory của Hibernate cung cấp các thể hiện của lớp Session để biểu diễn các kết nối
đến CSDL. Thể hiện của SessionFactory là thread-safe và chia sẽ suốt ứng dụng. Các thể hiện Session
không phải là thread-safe và chỉ nên được sử dụng cho một transaction hoặc đơn vị làm vị trong ứng
dụng.

1.9.1. Cấu hình SessionFactory:

a) Lớp Configuration:
Lớp này là sự mở đầu runtime của Hibernate. Nó được sử dụng để load các file ánh xạ và tạo
SessionFactory cho các file ánh xạ này. Mỗi lần 2 chức năng này hoàn tất, lớp Configuration có bị vứt
bỏ. Tạo một thể hiện của Configuration và Session thì đơn giản nhưng bạn có một vài tùy chọn. Có 3
cách để tạo và khởi tạo đối tượng Configuration.

Đoạn mã sau sẽ load các file property và mapping được định nghĩa trong hibernate.cfg.xml và tạo
SessionFactory:

Configuration cfg = new Configuration();

SessionFactory factory = cfg.configure().buildSessionFactory();

Phương thức configure() bảo Hibernate load file hibernate.cfg.xml. Nếu như nó không tồn tại thì chỉ
hibernate.properties được load từ classpath. Lớp Configuration cũng có thể load mapping document:

Configuration cfg = new Configuration();

cfg.addFile("com/manning/hq/ch03/Event.hbm.xml");
Một phương pháp khác để Hibernate load mapping document là dựa vào lớp persistent. Ví dụ, code
sau sẽ khiến cho Hibernate tìm file có tên là com/manning/hq/Event.hbm.xml trong classpath và load
các lớp kết hợp:

Configuration cfg = new Configuration();

cfg.addClass(com.manning.hq.ch03.Event.class);

Nếu ứng dụng có 10 hoặc 100 mapping definitions. Bạn có thể tạo file JAR (ví dụ như
application.jar) chứa tất cả file class và mapping definitions. Sau đó cập nhật file hibernate.cfg.xml:

<mapping jar="application.jar"/>

Và bạn cũng có thể làm điều này với phương thức addJar của lớp Configuration:

Configuration.addJar(new java.io.File("application.jar"));
 Cả 4 phương pháp này đều được sử dụng để xác định mapping definition phụ thuộc vào các yêu cầu
của project. Tuy nhiên mỗi khi bạn tạo SessionFactory từ thể hiện Configuration, thì bất kỳ file
mapping nào được thêm đến thể hiện của Configuration sẽ không ảnh hưởng trong SessionFactory.
Nghĩa là bạn không thể thêm một lớp persistent mới một cách tự động.

Bạn có thể sử dụng thể hiện của SessionFactory để tạo thể các thể hiện của Session:
Session session = factory.openSession();

Các thể hiện của lớp Session là giao tiếp chính của Hiberante framework. Chúng cho phép bạn
persist các đối tượng, truy vấn các đối tượng persistent và làm cho các đối tượng transient trở thành
persistent.

1. 10. Persistent các đối tượng:

Persist đối tượng transient (tạm thời) với Hibernate thì đơn giản - lưu nó với thể hiện Session:

Event event = new Event();

// populate the event
Session session = factory.openSession();
session.save(event);
session.flush();

Gọi phương thức save(....) cho thể hiện Event sẽ gán cho nó một giá trị id được phát sinh và sau đó
là persist nó. Phương thức flush() ép các đối tượng persistent được giữ trong bộ nhớ được đồng bộ
xuống CSDL. Session không lập tức ghi liền xuống CSDL khi đối tượng được lưu. Thay vào đó,
Session sẽ sắp xếp các lần ghi để tăng tốc độ thực thi.

Nếu bạn muốn cập nhật một đối tượng đã được persistent, phương thức update() thì có sẵn. Sự khác
biệt của phương thức update() so với phương thức save() là nó không gán giá trị id cho đối tượng. Bởi
vì sự khác biệt này nên giao diện Session cung cấp phương thức saveOrUpdate() để xác định thao tác
đúng để thực thi trên đối tượng.

Sau đây là đoạn mã để persist thể hiện Event:

Configuration cfg = new Configuration();

SessionFactory factory = cfg.buildSessionFactory();
Event event = new Event();
// populate the Event instance
Session session = factory.openSession();
session.saveOrUpdate(event);
session.flush();
session.close();

Hai dòng đầu tạo SessionFactory sau đó load file cấu hình từ classpath. Sau khi thể hiện Event được
tạo và rút trích, thể hiện Session được cung cấp bởi SessionFactory sẽ persist Event này. Session được
flush và close (đóng kết nối JDBC và dọn dẹp bên trong). Đó là tất cả những gì phải làm để persist các
đối tượng.

1.11. Rút trích đối tượng:

Event event = (Event) session.load(Event.class, eventId);
=> trả về thể hiện của Event với id bằng với eventId.

Query query = session.createQuery("from Event");

List events = query.list();
=> trả về toàn bộ các đối tượng từ CSDL.

Sử dụng PreparedStatement cho câu truy vấn:

Query query = session.createQuery("from Event where name = ?",
"Opening Presentation");
query.setParameter(0, "Opening Presentation", Hibernate.STRING);
List events = query.list();

1.12. Ánh xạ kế thừa:

Giả sử bạn có Event với hai lớp con ConferenceEvent và NetworkingEvent. Định nghĩa ánh xạ như
sau:
<class name="Event" table="events" discriminator-value="EVENT">
<id name="id" type="long">
<generator class="native"/>
</id>
<discriminator column="event_type" type="string" length="15"/>
...
<subclass name="ConferenceEvent" discriminator-value="CONF_EVENT">
<property name="numberOfSeats" column="num_seats"/>
...
</subclass>
<subclass name="NetworkingEvent" discriminator-value="NET_EVENT">
<property name="foodProvided" column="food_provided"/>
...
</subclass>
</class>

1.13. Session cache:

Một cách dễ dàng để cải tiến tốc độ thực thi là cache các đối tượng. Bằng cách caching trong bộ nhớ,
Hibernate sẽ tránh chi phí rút trích chúng từ database mỗi lần được yêu cầu. Cache cũng ảnh hưởng đến
việc lưu và cập nhật các đối tượng:

Session session = factory.openSession();

Event e = (Event) session.load(Event.class, myEventId);
e.setName("New Event Name");
session.saveOrUpdate(e);
// later, with the same Session instance
Event e = (Event) session.load(Event.class, myEventId);
e.setDuration(180);
session.saveOrUpdate(e);
session.flush();

Code này lần đầu sẽ rút thể hiện Event, Session sẽ cache bên trong. Sau đó nó cập nhật tên Event, save
hoặc update thể hiện Event, rút trích cùng thể hiện Event (được lưu trong Session cache), update
duration của Event và save hoặc update thể hiện Event. Cuối cùng flush Session - tất cả các lần cập
nhật được kết hợp vào chỉ một cập nhật khi bạn flush Session.

Một vấn đề phổ biến đối với developer mới là run hai thể hiện của cùng một đối tượng trong cùng một
thể hiện Session, kết quả là NonUniqueObjectException. Code sau sẽ phát sinh exception này:

Session session = factory.openSession();

Event firstEvent = (Event) session.load(Event.class, myEventId);
// ... perform some operation on firstEvent
Event secondEvent = new Event();
secondEvent.setId(myEventId);
session.save(secondEvent);

Code này mở thể hiện Session, load thể hiện Event với id xác định, tạo thể hiện Event thứ hai với cùng
id và sau đó cố gắng save thể hiện Event thứ hai, kết quả là NonUniqueObjectException.

Bất kỳ thời điểm nào, nếu đối tượng đi qua thể hiện Session, nó sẽ được thêm vào cache của Session.
Để xem đối tượng được chứa trong cache, hãy gọi phương thức Session.contains(). Các đối tượng có
thể bị đẩy ra khỏi cache bằng cách gọi phương thức Session.evict(). Chúng ta hãy xem lại code trước,
lần này đẩy thể hiện Event thứ nhất ra khỏi cache:

Session session = factory.openSession();

Event firstEvent = (Event) session.load(Event.class, myEventId);
// ... perform some operation on firstEvent
if (session.contains(firstEvent)) {
session.evict(firstEvent);
}
Event secondEvent = new Event();
secondEvent.setId(myEventId);
session.save(secondEvent);

Code này đầu tiên sẽ mở thể hiện Session và load thể hiện Event với id xác định trước. Kế tiếp nó xác
định xem đối tượng này có được chứa trong cache của Session hay chưa và đẩy nó ra nếu cần thiết.
Code sau đó tạo thể hiện Event thứ hai với cùng id và sau nó thành công.

Nếu bạn muốn hủy tất cả các đối tượng từ Session cache, bạn có thể gọi chỉ một phương thức là
Session.clear().

1.14. Cấu hình nâng cao:

a) Connection pool:
Connection pool là cách phổ biến để cải tiến tốc độ thực thi của ứng dụng. Thay vì mở từng
connection đến CSDL cho mỗi yêu cầu, connection pool sẽ duy trì một tập hợp các connection được
mở để tái sử dụng lại. Application server thường cung cấp connection pool riêng sử dụng JNDI
DataSource.

Nếu bạn chạy một ứng dụng hông hỗ trợ connection pool thì nên sử dụng service connecton pool mà
Hibernate hỗ trợ: C3PO, Apache’s DBCP library, và Proxool.

Khi chọn một service connection pool, bạn phải cấu hình nó cho môi trường của bạn. Hibernate hỗ
trợ cấu hình connection pool trong file hibernate.cfg.xml. Thuộc tính connection.provider_class thiết
lập cài đặt pooling như sau:

<property name="connection.provider_class">
org.hibernate.connection.C3P0ConnectionProvider
</property>

Mỗi khi provider class được thiết lập, các thuộc tính khác của pooling service cũng phải được cấu
hình:

<property name="c3p0.minPoolSize">
5
</property>
...
<property name="c3p0.timeout">
1000
</property>

1.15. Transaction:
Transaction nhóm nhiều thao tác vào trong một đơn vị làm việc. Nếu bất kỳ thao tác trong nhóm thất
bại thì tất cả các thao tác trước đều bị roll back và đơn vị làm việc đó sẽ dừng lại.

Hibernate có một lớp Transaction được truy cập từ giao tiếp Session như sau:
Session session = factory.openSession();
Transaction tx = session.beginTransaction();
Event event = new Event();
// ... populate the Event instance
session.saveOrUpdate(event);
tx.commit();

Trong ví dụ này, factory là một thể hiện SessionFactory được khởi tạo. Code này tạo một thể hiện
của lớp org.hibernate.Transaction và sau đó ủy nhiệm thể hiện của Transaction này.

Ghi chú: bạn không cần gọi session.flush(). Ủy nhiệm transaction sẽ tự động flush đối tượng
Session. Thể hiện Event được persist vào CSDL khi transaction được ủy nhiệm.

2. Association và Component trong Hibernate:

2.1. Association:
Giả sử trong ứng dụng của bạn, mỗi Event được tổ chức ở chỉ một Location. Cách mà biểu diễn điều
này trong Java là đối tượng Event có một trường Location. Khi bạn rút trích Event, bạn muốn cả
Location nữa. Vì thế bạn phải liên kết Event và Location với nhau sử dụng quan hệ many-to-one.

Định nghĩa các lớp Event và Location như sau:

package com.manning.hq.ch04;
import java.io.Serializable;
import java.util.Date;
import com.manning.hq.ch04.Location;
public class Event implements Serializable {
 private Long id;
private int duration;
private String name;
private Date startDate;
private Location location;
public Event() { }
public Event(String name) {
this.name = name;
}
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 Date getStartDate() { return startDate; }
public void setStartDate(Date startDate) {
this.startDate = startDate;
}
public int getDuration() { return duration; }
public void setDuration(int duration) {
this.duration = duration;
}
public Location getLocation() { return location; }
public void setLocation(Location location) {
this.location = location;
}
}

package com.manning.hq.ch04;
import java.io.Serializable;
public class Location implements Serializable {
private Long id;
private String name;
private String address;
public Location() { }
public Location(String name) {
this.name = name;
}
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 String getAddress() { return address; }
public void setAddress(String address) {
this.address = address;
}
}

Như bạn thấy cả hai lớp này đều theo đặc tả JavaBean. Ghi chú là lớp Event có một trường location
để liên kết nó với đối tượng Location.

Mỗi lớp này sẽ cần một file ánh xạ tương ứng, trong trường hợp này là Event.hbm.xml và
Location.hbm.xml để định nghĩa các trường persistent và mối quan hệ giữa hai file này. Đặt các file
này cùng thư mục với Event.java và Location.java. Sau đây là hai file ánh xạ này:

Location.hbm.xml
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.manning.hq.ch04">
<class name="Location" table="locations">
<id name="id" column="uid" type="long">
<generator class="native"/>
</id>
<property name="name" type="string"/>
<property name="address" type="string"/>
</class>
</hibernate-mapping>

Event.hbm.xml <?xml version="1.0"?>

<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.manning.hq.ch04">
<class name="Event" table="events">
<id name="id" column="uid" type="long">
<generator class="native"/>
</id>
<property name="name" type="string"/>
<property name="startDate" column="start_date"
type="date"/>
<property name="duration" type="integer"/>
<many-to-one name="location" column="location_id" class="Location" />
</class>
</hibernate-mapping>

2.1.1. Location cascading:

Cascading có nghĩa là khi bạn save, update, delete một đối tượng, thì các mối quan hệ với nó cũng
chịu ảnh hưởng. Trong trường hợp này bạn muốn Location được lưu khi bạn lưu hoặc cập nhật
Event. Thêm một thuộc tính mới cho element <many-to-one> trong Event.hbm.xml file như sau:
<many-to-one name="location" column="location_id" class="Location" cascade="save-update" />

Khi đó bạn thể sử dụng:

session.save(event);
// session.save(location);
=> tiết kiệm được một dòng code :D.

2.2. Component:
Component hông phải là một thực thể, nó giống như một đối tượng được chứa trong một đối tượng
cha khác. Nó hông có id và chỉ tồn tại khi thực thể cha tồn tại.Component cho phép bạn nhóm một
vài cột vào trong một đối tượng.

Ví dụ:

Chúng ta có một trường address trong Location. Do thiết kế hông tốt nên chúng ta sẽ chia nhỏ địa
chỉ thành 4 cột: street, city, state và zip code. Và khi đó đối tượng Location sẽ như thế này:

public class Location implements Serializable {

private Long id;
private String name;
private String streetAddress;
private String city;
private String state;
private String zipCode;
// getters and setter omitted
}

Cách thiết kế này làm việc được nhưng hông được tốt cho lắm, chúng ta sẽ rút trích một vài trường
cho vào một đối tượng Address và để Hibernate điều khiển nó như một component:

public class Location implements Serializable{

private Long id;
private String name;
private Address address = new Address();
// Other getter/setters omitted
public Address getAddress() { return address; }
public void setAddress(Address address) {
this.address = address;
}
}

Và điều cuối cùng cần làm là ánh xạ một số cột từ bảng location cho đối tượng Address:

<hibernate-mapping package="com.manning.hq.ch04">
<class name="Location" table="locations">
<id name="id" column="uid" type="long">
<generator class="native"/>
 </id>
<property name="name" type="string"/>
<component name="address" class="Address" >
<property name="streetAddress"
column="street_address" type="string"/>
<property name="city" type="string"/>
<property name="state" type="string"/>
<property name="zipCode"
column="zip_code" type="string"/>
</component>
</class>
</hibernate-mapping>

Bây giờ bạn có thể chèn dữ liệu vào đối tượng Location như sau:

Location location = new Location();

location.setName("Hilton Convention Center");
location.getAddress().setStreetAddress("950 North Stafford St.");
location.getAddress().setCity("Arlington");
location.getAddress().setState("VA");
location.getAddress().setZipCode("22204");
Event event = new Event();

3. Collection in Hibernate:
3.1. Mapping Collection:
3.1.1 Quan hệ 1 - nhiều:
Quan hệ này tạo liên kết giữa một thể hiện của lớp cha với nhiều thể hiện của lớp con.

Ví dụ: Chúng ta sẽ định nghĩa một set attendees tương tự one-to-many - nghĩa là một thể hiện Event
sẽ kết hợp với nhiều thể hiện Attendee.

<hibernate-mapping package="com.manning.hq">
<class name="Event" table="events">
…
<set name="speakers">
<key column="event_id"/>
<one-to-many class="Speaker"/>
</set>
<set name="attendees">
<key column="event_id"/>
<one-to-many class="Attendee"/>
</set>
…
</class>
</hibernate-mapping>

Lớp Event tương ứng như sau:

public class Event {

 private Set speakers;
private Set attendees;
public void setSpeakers(Set speakers) {
this.speakers = speakers;
}
public Set getSpeakers() {
return this.speakers;
}
public void setAttendees(Set attendees) {
this.attendees = attendees;
}
public Set getAttendees () {
return this.attendees;
}
…
}

=> element <key> với thuộc tính column - tên của cột lưu khóa ngoại của lớp đang chứa.

3.1.2. Quan hệ nhiều-nhiều:

Quan hệ này khá hấp dẫn hơn quan hệ 1-nhiều. Thay vì các bảng liên kết với nhau thông qua khóa
ngoại, thì mối quan hệ nhiều-nhiều yêu cầu một bảng collection lưu tập hợp các đối tượng tham
chiếu. Giả sử Attendees có thể tham dự nhiều hơn một Event. Ánh xạ many-to-many cho tập hợp
các Attendees như sau:

<set name="attendees" table="event_attendees">

<key column="event_id"/>
<many-to-many column="attendee_id" class="Attendee"/>
</set>

3.2. Lazy collection:

Lazy collection sẽ được rút trích theo yêu cầu. Theo yêu cầu nghĩa là tập hợp các thực thể hoặc các giá
trị được rút trích chỉ khi ứng dụng truy cập collection.

Tại sao có lazy collection: Một collection các đối tượng có thể chứa hàng trăm hoặc hàng ngàn các đối
tượng và ứng dụng có thể không cần truy cập collection ngay lập tức hoặc tất cả. Load hàng trăm đối
tượng không có lý do sẽ làm giảm tốc độ của ứng dụng. Tốt hơn nên rút trích các persistent collection
chỉ khi nó cần dùng.

Rút trích lazy collection (cụ thể là attendees) như sau:

Session session = factory.openSession();
Event event = session.get(Event.class, eventId);
Set attendees = event.getAttendees();
session.close();

Persistent collection được lazy mặc định bởi Hibernate 3. Để làm cho collection hông lazy, bạn phải
khai báo rõ ràng như sau: lazy="false" trong mapping file:

<set name="attendees" lazy="false">

 <key column="event_id"/>
<one-to-many class="Attendee"/>
</set>

3.3 Sorted collection:

Một yêu cầu phổ biến khi giải quyết với collection là sắp xếp chúng theo một vài tiêu chí. Nếu bạn
muốn collection trả về theo một thứ tự, bạn có thể thêm thuộc tính order-by vào element <set>.

Ví dụ:
Trả về tất cả các Attendees của Event theo thứ tự của last name, mapping definition của chúng ta sẽ
như sau:

<set name="attendees" order-by="last_name">

<key column="event_id"/>
<one-to-many class="Attendee"/>
</set>

3.4. Ánh xạ quan hệ hai chiều:

Lớp Event cho phép bạn định vị từ thể hiện Event cha đến thể hiện Attendee con. Tuy nhiên giả sử bạn
muốn tại mối quan hệ hai chiều, cho phép một Attendee định vị đến Event cha của nó. Để thực hiện
được điều này, đầu tiên bạn phải xác định thuộc tính Event trong lớp Attendee và cung cấp định nghĩa
many-to-one trong file ánh xạ Attendee. Kế tiếp định nghĩa inverse trong Event - thiết lập thuộc tính
inverse="true" để thông báo cho Hibernate runtime mối quan hệ hai chiều này.

Các bước được thực hiện như sau:

public class Attendee {

private Event event;
…
public void setEvent(Event event) {
this.event = event;
}
public Event getEvent() {
return this.event;
}
}
File ánh xạ của Attendee:

<hibernate-mapping package="com.manning.hq">
<class name="Attendee" table="attendees">
…
<many-to-one column="event_id" class="Event"/>
…
</class>
</hibernate-mapping>

Thêm thuộc tính inverse="true" trong file ánh xạ của Event như sau:

<set name="attendees" inverse="true">

<key column="event_id"/>
<one-to-many class="Attendee"/>
</set>

3.5. Cascading collecion:

Giả sử bạn tạo một đối tượng mới Event, và thêm speakers vào nó:

Event event = new Event();

Set speakers = new HashSet();
speakers.add(new Speaker());
speakers.add(new Speaker());
speakers.add(new Speaker());
event.setSpeakers(speakers);

Khi bạn cố gắng lưu thể hiện này, bạn sẽ gặp lỗi bởi vì Event tham chiếu đến thể hiện transient của lớp
Speaker. Để khắc phục cần cập nhật mapping file như sau:

Thêm thuộc tính cascade xác định thao tác save-update để khi thực hiện đối tượng cha thì nó sẽ ảnh
hưởng đến Speaker. Cách này Hibernate sẽ điều khiển việc tạo Speaker chính xác và lưu chúng vào
CSDL.

4. Hibernate Query Language:

HQL (Hibernate Query Language) cung cấp một mức trừu tượng giữa ứng dụng và CSDL. SQL được
thiết kế để làm việc với CSDL quan hệ, trong khi đó HQL được dùng để truy vấn các đối tượng.

4.1. Sử dụng HQL:

Các câu truy vấn của Hibernate thì có cấu trúc tương tự như SQL với mệnh đề SELECT, FORM và
WHERE. HQL cũng hỗ trợ subselect nếu chúng được hỗ trợ bởi CSDL.

Ví dụ:
from Event => trả về tất cả các thể hiện của Event trong CSDL, cùng các đối tượng có quan hệ và non-
lazy collection.

4.1.1. session.find():
Trong Hibernate2, giao tiếp Session có 3 phương thức overload find(), 2 phương thức hỗ trợ binding
tham số. Mỗi phương thức trả về một java.util.List với kết quả của câu truy vấn. Ví dụ, chúng ta thực
thi câu truy vấn sau:

List results = session.find("from Event");

4.1.2. Giao tiếp Query:

Các thể hiện của giao tiếp Query được tạo bởi Session. Giao tiếp Query cho phép bạn điều khiển các
đối tượng được trả về nhiều hơn như giới hạnh số đối tượng được trả về, thiết lập timeout cho câu truy
vấn.

Ví dụ:
Chúng ta hãy thực thi câu truy vấn trước sử dụng giao tiếp Query:
Query q = session.createQuery("from Event");
List results = q.list();
 Nếu bạn muốn thiết lập giới hạn số đối tượng Event được trả về, thì bạn sẽ phải thiết lập thuộc tính
maxResults:
Query q = session.createQuery("from Event");
q.setMaxResults(15);
List results = q.list();

a) Posistion parameter:
Thì tương tự như Prepared-Statement. Chỉ có sự khác biệt là vị trí index bắt đầu từ 0 thay vì 1.

Giả sử bạn muốn trả về tất cả thể hiện Event có tên được xác định trước. Sử dụng positional
parameter như sau:
Query q = session.createQuery("from Event where name = ? ");
q.setParameter(0, "Opening Plenary");
List results = q.list();

Lưu ý rằng bạn không cần thiết lập loại tham số, đối tượng Query sẽ cố gắng xác định loại của nó.
Nó cũng có thể thiết lập tham số có loại xác định sử dụng lớp org.hibernate.Hibernate:
q.setParameter(0, "Opening Plenary", Hibernate.STRING);

b) Named parameters:
Cách dễ dàng nhất để giải thích named parameters là sử dụng một ví dụ cụ thể:
from Event where name = :name

Thay vì ? để ghi nhận một tham số, bạn có thể sử dụng :name để rút trích câu truy vấn:
Query q = session.createQuery("from Event where name = :name");
q.setParameter("name", "Opening Plenary");
List results = q.list();

Với named parameter bạn không cần biết vị trí index của mỗi tham số.

c) Named queries:
Nó được nhúng trong mapping definition. Bạn phải đặt tất cả các câu truy vấn vào trong cùng file
với đối tượng cần được truy vấn. Named queries được đặt ở dưới cùng của file mapping definition:
<query name="Event.byName">
<![CDATA[from Event where name=?]]>
</query>

Truy cập named queries như sau:

Query q = session.getNamedQuery("Event.byName");
…
List results = q.list();

4.2. Show SQL:

Để debug HQL, bạn cần xem SQL được phát sinh để đảm bảo câu truy vấn đang làm những gì mà bạn
mong đợi. Thiết lập thuộc tính show_sql là true sẽ phát sinh ra SQL trên console.

Thiết lập thuộc tính này trong hibenate.cfg.xml:

<property name="show_sql">true</property>
4.3. Joins:
from Event e join e.attendees a where a.id=314 => rút trích các thể hiện của Event với id xác định của
Attendee.

Có 4 loại joins:
• left join - lấy tất cả các thể hiện bên trái của mệnh đề join, nếu đối tượng bên trái của join
không có đối tượng phù hợp bên phải thì nó vẫn trả về.
• right join thì tương tự như left nhưng ở bên phải.
• full join - trả về các đối tượng hai bên của mệnh đề join bất chấp đối tượng có phù hợp bên kia
hay không.
• inner join fetch - rút trích các đối tượng có quan hệ hoặc collection các đối tượng của outer-
join hoặc thuộc tính lazy trong mối quan hệ.

from Event e inner join fetch e.speakers => trả về các đối tượng của Event với collection các speaker.

from Event e join e.location l where l.name = :name => join thể hiện của Location với Event để cho
phép truy vấn trên các thuộc tính của Location.

4.4. Sử dụng hàm:

Hàm là các lệnh đặc biệt trả về giá trị đã được tính toán. Hibernate hỗ trợ 5 hàm sau: avg, min, max và
sum.
• avg(expression) - tính giá trị trung bình của biểu thức.
• count(expression) - đếm số dòng được trả về bởi biểu thức.
• max(expression) - trả về giá trị lớn nhất trong biểu thức.
• min(expression) - trả về giá trị nhỏ nhất trong biểu thức.
• sum(expression) - trả về tổng các giá trị trong biểu thức.

Ví dụ:
select count(e) from Event e => trả về số đối tượng Event được persist trong CSDL.

4.5. Criteria:
Criteria API cung cấp phương pháp khác để truy vấn các đối tượng persistent. Nó cho phép xâu dựng
các câu truy vấn động. Criteria được sử dụng khi có nhiều tham số cho chức năng search.

Ví dụ:
Bạn có màn hình search nâng cao, cho phép người dùng chọn nhiều trường để tìm kiếm.

Criteria criteria = session.createCriteria(Event.class);

criteria.add(Restrictions.between("duration", new Integer(60), new Integer(90) );
criteria.add( Restrictions.like("name", "Presen%") );
criteria.addOrder( Order.asc("name") );
List results = criteria.list();