org.hibernate
Interface Session<o:p></o:p>
All Superinterfaces: <o:p></o:p>
Serializable<o:p></o:p>
All Known Subinterfaces: <o:p></o:p>
EventSource, Session<o:p></o:p>
All Known Implementing Classes: <o:p></o:p>
SessionImpl<o:p></o:p>
public interface Session <o:p></o:p>
extends Serializable<o:p></o:p>
Java应用程序与Hibernate之间的主要运行时接口。它是抽象了持久化服务概念的核心抽象API类。
Session的生命周期绑定在一个物理的事务(tansaction)上面。(长的事务可能跨越多个数据库事物。)
Session的主要功能是提供对映射的实体类实例的创建,读取和删除操作。实例可能以下面三种状态存在:<o:p></o:p>
自由状态(transient): 不曾进行持久化,未与任何Session相关联
持久化状态(persistent): 仅与一个Session相关联
游离状态(detached): 已经进行过持久化,但当前未与任何Session相关联<o:p></o:p>
游离状态的实例可以通过调用save()、persist()或者saveOrUpdate()方法进行持久化。持久化实例可以通过调用 delete()变成游离状态。通过get()或load()方法得到的实例都是持久化状态的。游离状态的实例可以通过调用 update()、0saveOrUpdate()、lock()或者replicate()进行持久化。游离或者自由状态下的实例可以通过调用merge()方法成为一个新的持久化实例。
save()和persist()将会引发SQL的INSERT,delete()会引发SQLDELETE,而update()或merge()会引发SQLUPDATE。对持久化(persistent)实例的修改在刷新提交的时候会被检测到,它也会引起SQLUPDATE。saveOrUpdate()或者replicate()会引发SQLINSERT或者UPDATE。
其具体实现并不一定是线程安全的。每个线程/事务应该从一个SessionFactory获取自己的session实例。
如果其持久化对象类是可序列化的,则Session实例也是可序列化的。
一个典型的事务应该使用下面的形式: <o:p></o:p>
Session sess = factory.openSession();<o:p></o:p>
Transaction tx;<o:p></o:p>
try {<o:p></o:p>
tx = sess.beginTransaction();<o:p></o:p>
//do some work<o:p></o:p>
...<o:p></o:p>
tx.commit();<o:p></o:p>
}<o:p></o:p>
catch (Exception e) {<o:p></o:p>
if (tx!=null) tx.rollback();<o:p></o:p>
throw e;<o:p></o:p>
}<o:p></o:p>
finally {<o:p></o:p>
sess.close();<o:p></o:p>
}<o:p></o:p>
如果Session抛出了异常, 事务必须回滚而session会被废弃。在异常发生后Session的内部状态可能会与数据库失去同步。 <o:p></o:p>
Author: <o:p></o:p>
Gavin King <o:p></o:p>
See Also: <o:p></o:p>
SessionFactory<o:p></o:p>
Transaction<o:p></o:p> |
beginTransaction() |
void<o:p></o:p> |
cancelQuery() |
void<o:p></o:p> |
clear() |
Connection<o:p></o:p> |
close() |
Connection<o:p></o:p> |
connection() |
boolean<o:p></o:p> |
contains(Object object) |
Criteria<o:p></o:p> |
createCriteria(Class persistentClass) |
Criteria<o:p></o:p> |
createCriteria(Class persistentClass, String alias) |
Criteria<o:p></o:p> |
createCriteria(String entityName) |
Criteria<o:p></o:p> |
createCriteria(String entityName, String alias) |
Query<o:p></o:p> |
createFilter(Object collection, String queryString) |
Query<o:p></o:p> |
createQuery(String queryString) |
SQLQuery<o:p></o:p> |
createSQLQuery(String queryString) |
void<o:p></o:p> |
delete(Object object) |
void<o:p></o:p> |
delete(String entityName, Object object) |
void<o:p></o:p> |
disableFilter(String filterName) |
Connection<o:p></o:p> |
disconnect() |
Filter<o:p></o:p> |
enableFilter(String filterName) |
void<o:p></o:p> |
|
void<o:p></o:p> |
flush() |
Object<o:p></o:p> |
get(Class clazz, Serializable id) |
Object<o:p></o:p> |
get(Class clazz, Serializable id, LockMode lockMode) |