Tin's Blog

Hibernate的透明持久化用起來非常舒服，有時甚至忘記了數(shù)據(jù)庫的存在。我身邊的朋友經(jīng)常會分不清save、saveOrUpdate、update的區(qū)別，lock、merge、replicate、refresh、evict甚至不知道是干什么用的。而且關(guān)于實體對象的生命周期也有很多概念不清，分不清transient、persistent、detached的區(qū)別，只是知道PO、VO這樣的通俗叫法。其實這些概念都很簡單，Hibernate的javadoc寫的都很清楚，只需看看就能明白。所以我花了些時間將Hibernate 3.1.2中session的javadoc部分翻譯了一下，旨在讓那些因為Hibernate的“透明”而忘記了它基本概念的人們停下來再看看這些概念

---

org.hibernate
Interface Session

All Superinterfaces:

Serializable

All Known Subinterfaces:

EventSource, Session

All Known Implementing Classes:

SessionImpl

---

public interface Session

extends Serializable

Java應(yīng)用程序與Hibernate之間的主要運行時接口。它是抽象了持久化服務(wù)概念的核心抽象API類。

Session的生命周期綁定在一個物理的事務(wù)（tansaction）上面。（長的事務(wù)可能跨越多個數(shù)據(jù)庫事物。）

Session的主要功能是提供對映射的實體類實例的創(chuàng)建，讀取和刪除操作。實例可能以下面三種狀態(tài)存在：

自由狀態(tài)（transient）: 不曾進行持久化，未與任何Session相關(guān)聯(lián)
持久化狀態(tài)（persistent）: 僅與一個Session相關(guān)聯(lián)
游離狀態(tài)（detached）: 已經(jīng)進行過持久化，但當(dāng)前未與任何Session相關(guān)聯(lián)

游離狀態(tài)的實例可以通過調(diào)用save()、persist()或者saveOrUpdate()方法進行持久化。持久化實例可以通過調(diào)用 delete()變成游離狀態(tài)。通過get()或load()方法得到的實例都是持久化狀態(tài)的。游離狀態(tài)的實例可以通過調(diào)用 update()、0saveOrUpdate()、lock()或者replicate()進行持久化。游離或者自由狀態(tài)下的實例可以通過調(diào)用merge()方法成為一個新的持久化實例。

save()和persist()將會引發(fā)SQL的INSERT，delete()會引發(fā)SQLDELETE，而update()或merge()會引發(fā)SQLUPDATE。對持久化（persistent）實例的修改在刷新提交的時候會被檢測到，它也會引起SQLUPDATE。saveOrUpdate()或者replicate()會引發(fā)SQLINSERT或者UPDATE。

其具體實現(xiàn)并不一定是線程安全的。每個線程/事務(wù)應(yīng)該從一個SessionFactory獲取自己的session實例。

如果其持久化對象類是可序列化的，則Session實例也是可序列化的。

一個典型的事務(wù)應(yīng)該使用下面的形式：

 Session sess = factory.openSession();
Transaction tx;
try {
tx = sess.beginTransaction();
//do some work
...
tx.commit();
}
catch (Exception e) {
if (tx!=null) tx.rollback();
throw e;
}
finally {
sess.close();
}

如果Session拋出了異常, 事務(wù)必須回滾而session會被廢棄。在異常發(fā)生后Session的內(nèi)部狀態(tài)可能會與數(shù)據(jù)庫失去同步。

 

 

Author:

Gavin King

See Also:

SessionFactory

---

Method Summary
Transaction	beginTransaction()           開始一個工作單元并且返回相關(guān)聯(lián)的事務(wù)（Transaction）對象。
void	cancelQuery()           終止執(zhí)行當(dāng)前查詢。
void	clear()           完整的清除這個session。
Connection	close()           停止這個Session，通過中斷JDBC連接并且清空（cleaning up）它。
Connection	connection()           獲取這個Session的JDBC連接。 如果這個session使用了積極的collection釋放策略（如CMT-容器控制事務(wù)的環(huán)境下），關(guān)閉這個調(diào)用的連接的職責(zé)應(yīng)該由當(dāng)前應(yīng)用程序負責(zé)。
boolean	contains(Object object)           檢查這個對象實例是否與當(dāng)前的Session關(guān)聯(lián)（即是否為Persistent狀態(tài)）。
Criteria	createCriteria(Class persistentClass)           為給定的實體類或它的超類創(chuàng)建一個新的Criteria實例。
Criteria	createCriteria(Class persistentClass, String alias)           根據(jù)給定的實體類或者它的超類創(chuàng)建一個新的Criteria實例，并賦予它（實體類）一個別名。
Criteria	createCriteria(String entityName)           根據(jù)給定的實體的名稱（name），創(chuàng)建一個新的Criteria實例。
Criteria	createCriteria(String entityName, String alias)           根據(jù)給定的實體的名稱（name），創(chuàng)建一個新的Criteria實例，并賦予它（實體類）一個別名
Query	createFilter(Object collection, String queryString)           根據(jù)給定的collection和過濾字符串（查詢條件）創(chuàng)建一個新的Query實例。
Query	createQuery(String queryString)           根據(jù)給定的HQL查詢條件創(chuàng)建一個新的Query實例。
SQLQuery	createSQLQuery(String queryString)           根據(jù)給定的SQL查詢條件創(chuàng)建一個新的SQLQuery實例。
void	delete(Object object)           從數(shù)據(jù)庫中移除持久化（persistent）對象的實例。
void	delete(String entityName, Object object)           從數(shù)據(jù)庫中移除持久化（persistent）對象的實例。
void	disableFilter(String filterName)           禁用當(dāng)前session的名稱過濾器。
Connection	disconnect()           斷開Session與當(dāng)前的JDBC連接。
Filter	enableFilter(String filterName)           打開當(dāng)前session的名稱過濾器。
void	evict(Object object)           將當(dāng)前對象實例從session緩存中清除。
void	flush()           強制提交清理（flush）Session。
Object	get(Class clazz, Serializable id)           根據(jù)給定標(biāo)識和實體類返回持久化對象的實例，如果沒有符合條件的持久化對象實例則返回null。
Object	get(Class clazz, Serializable id, LockMode lockMode)           根據(jù)給定標(biāo)識和實體類返回持久化對象的實例，如果沒有符合條件的持久化對象實例則返回null。
Object	get(String entityName, Serializable id)           返回與給定的實體命名和標(biāo)識匹配的持久化實例，如果沒有對應(yīng)的持久化實例則返回null。
Object	get(String entityName, Serializable id, LockMode lockMode)           返回與給定的實體類和標(biāo)識所匹配的持久化實例，如果沒有對應(yīng)的持久化實例則返回null。
CacheMode	getCacheMode()           得到當(dāng)前的緩存模式。
LockMode	getCurrentLockMode(Object object)           檢測給定對象當(dāng)前的鎖定級別。
Filter	getEnabledFilter(String filterName)           根據(jù)名稱獲取一個當(dāng)前允許的過濾器（filter）。
EntityMode	getEntityMode()           獲取這個session有效的實體模式。
String	getEntityName(Object object)           返回一個持久化對象的實體名稱。
FlushMode	getFlushMode()           獲得當(dāng)前的刷新提交（flush）模式。
Serializable	getIdentifier(Object object)           獲取給定的實體對象實例在Session的緩存中的標(biāo)識，如果該實例是自由狀態(tài)（Transient）的或者與其它Session關(guān)聯(lián)則拋出一個異常。
Query	getNamedQuery(String queryName)           從映射文件中根據(jù)給定的查詢的名稱字符串獲取一個Query（查詢）實例。
Session	getSession(EntityMode entityMode)           根據(jù)給定的實體模式（Entity Mode）開始一個新的有效的Session。
SessionFactory	getSessionFactory()           獲取創(chuàng)建這個session的SessionFactory實例。
SessionStatistics	getStatistics()           獲取這個session的統(tǒng)計信息。
Transaction	getTransaction()           獲取與這個session關(guān)聯(lián)的Transaction（事務(wù)）實例。 instance associated with this session.
boolean	isConnected()           檢查當(dāng)前Session是否處于連接狀態(tài)。
boolean	isDirty()           當(dāng)前Session是否包含需要與數(shù)據(jù)庫同步的（數(shù)據(jù)狀態(tài)）變化 ？如果我們刷新提交（flush）這個session是否會有SQL執(zhí)行？
boolean	isOpen()           檢查當(dāng)前Session是否仍然打開。
Object	load(Class theClass, Serializable id)           在符合條件的實例存在的情況下，根據(jù)給定的實體類和標(biāo)識返回持久化狀態(tài)的實例。
Object	load(Class theClass, Serializable id, LockMode lockMode)           在符合條件的實例存在的情況下，根據(jù)給定的實體類、標(biāo)識及指定的鎖定等級返回持久化狀態(tài)的實例。
void	load(Object object, Serializable id)           將與給定的標(biāo)示對應(yīng)的持久化狀態(tài)（值）復(fù)制到給定的自由狀態(tài)（trasient）實例上。
Object	load(String entityName, Serializable id)           在符合條件的實例存在的情況下，根據(jù)給定的實體類和標(biāo)識返回持久化狀態(tài)的實例。
Object	load(String entityName, Serializable id, LockMode lockMode)           在符合條件的實例存在的情況下，根據(jù)給定的實體類、標(biāo)識及指定的鎖定等級返回持久化狀態(tài)的實例。
void	lock(Object object, LockMode lockMode)           從給定的對象上獲取指定的鎖定級別。
void	lock(String entityName, Object object, LockMode lockMode)           從給定的對象上獲取指定的鎖定級別。
Object	merge(Object object)           將給定的對象的狀態(tài)復(fù)制到具有相同標(biāo)識的持久化對象上。
Object	merge(String entityName, Object object)           將給定的對象的狀態(tài)復(fù)制到具有相同標(biāo)識的持久化對象上。
void	persist(Object object)           將一個自由狀態(tài)（transient）的實例持久化。
void	persist(String entityName, Object object)           將一個自由狀態(tài)（transient）的實例持久化。
void	reconnect()           不推薦的。 手工的重新連接只應(yīng)用于應(yīng)用程序提供連接的情況，在這種情況下或許應(yīng)該使用reconnect(java.sql.Connection)。
void	reconnect(Connection connection)           重新連接到給定的JDBC連接。
void	refresh(Object object)           從數(shù)據(jù)庫中重新讀取給定實例的狀態(tài)。
void	refresh(Object object, LockMode lockMode)           根據(jù)指定的鎖定模式（LockMode），從數(shù)據(jù)庫中重新讀取給定實例的狀態(tài)。
void	replicate(Object object, ReplicationMode replicationMode)           使用當(dāng)前的標(biāo)識值持久化給定的游離狀態(tài)（Transient）的實體。
void	replicate(String entityName, Object object, ReplicationMode replicationMode)           使用當(dāng)前的標(biāo)識值持久化給定的游離狀態(tài)（Transient）的實體。
Serializable	save(Object object)           首先為給定的自由狀態(tài)（Transient）的對象（根據(jù)配置）生成一個標(biāo)識并賦值，然后將其持久化。
Serializable	save(String entityName, Object object)           首先為給定的自由狀態(tài)（Transient）的對象（根據(jù)配置）生成一個標(biāo)識并賦值，然后將其持久化。
void	saveOrUpdate(Object object)           根據(jù)給定的實例的標(biāo)識屬性的值（注：可以指定unsaved-value。一般默認null。）來決定執(zhí)行 save() 或update()操作。
void	saveOrUpdate(String entityName, Object object)           根據(jù)給定的實例的標(biāo)識屬性的值（注：可以指定unsaved-value。一般默認null。）來決定執(zhí)行 save() 或update()操作。
void	setCacheMode(CacheMode cacheMode)           設(shè)置刷新提交模式。
void	setFlushMode(FlushMode flushMode)           設(shè)置刷新提交模式。
void	setReadOnly(Object entity, boolean readOnly)           將一個未經(jīng)更改的持久化對象設(shè)置為只讀模式，或者將一個只讀對象標(biāo)記為可以修改的模式。
void	update(Object object)           根據(jù)給定的detached（游離狀態(tài)）對象實例的標(biāo)識更新對應(yīng)的持久化實例。
void	update(String entityName, Object object)           根據(jù)給定的detached（游離狀態(tài)）對象實例的標(biāo)識更新對應(yīng)的持久化實例。