org.hibernate
Interface Session
All Superinterfaces:
All Known Subinterfaces:
All Known Implementing Classes:
public interface Session
extends Serializable
Java应用程序与Hibernate之间的主要运行时接口。它是抽象了持久化服务概念的核心抽象API类。
Session的生命周期绑定在一个物理的事务(tansaction)上面。(长的事务可能跨越多个数据库事物。)
Session的主要功能是提供对映射的实体类实例的创建,读取和删除操作。实例可能以下面三种状态存在:
自由状态(transient): 不曾进行持久化,未与任何Session相关联
持久化状态(persistent): 仅与一个Session相关联
游离状态(detached): 已经进行过持久化,但当前未与任何Session相关联
游离状态的实例可以通过调用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实例也是可序列化的。
一个典型的事务应该使用下面的形式:
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抛出了异常, 事务必须回滚而session会被废弃。在异常发生后Session的内部状态可能会与数据库失去同步。
Author:
Gavin King
See Also:
beginTransaction() |
|
void |
cancelQuery() |
void |
clear() |
close() |
|
connection() |
|
boolean |
contains(Object object) |
createCriteria(Class persistentClass) |
|
createCriteria(Class persistentClass, String alias) |
|
createCriteria(String entityName) |
|
createCriteria(String entityName, String alias) |
|
createFilter(Object collection, String queryString) |
|
createQuery(String queryString) |
|
createSQLQuery(String queryString) |
|
void |
|
void |
delete(String entityName, Object object) |
void |
disableFilter(String filterName) |
disconnect() |
|
enableFilter(String filterName) |
|
void |
|
void |
flush() |
get(Class clazz, Serializable id) |
|
get(Class clazz, Serializable id, LockMode lockMode) |
|
get(String entityName, Serializable id) |
|
get(String entityName, Serializable id, LockMode lockMode) |
|
getCacheMode() |
|
getCurrentLockMode(Object object) |
|
getEnabledFilter(String filterName) |
|
getEntityMode() |
|
getEntityName(Object object) |
|
getFlushMode() |
|
getIdentifier(Object object) |
|
getNamedQuery(String queryName) |
|
getSession(EntityMode entityMode) |
|
getSessionFactory() |
|
getStatistics() |
|
getTransaction() |
|
boolean |
isConnected() |
boolean |
isDirty() |
boolean |
isOpen() |
load(Class theClass, Serializable id) |
|
load(Class theClass, Serializable id, LockMode lockMode) |
|
void |
load(Object object, Serializable id) |
load(String entityName, Serializable id) |
|
load(String entityName, Serializable id, LockMode lockMode) |
|
void |
|
void |
lock(String entityName, Object object, LockMode lockMode) |
merge(String entityName, Object object) |
|
void |
|
void |
persist(String entityName, Object object) |
void |
reconnect() |
void |
reconnect(Connection connection) |
void |
|
void |
refresh(Object object, LockMode lockMode) |
void |
replicate(Object object, ReplicationMode replicationMode) |
void |
replicate(String entityName, Object object, ReplicationMode replicationMode) |
save(Object object) |
|
save(String entityName, Object object) |
|
void |
saveOrUpdate(Object object) |
void |
saveOrUpdate(String entityName, Object object) |
void |
setCacheMode(CacheMode cacheMode) |
void |
setFlushMode(FlushMode flushMode) |
void |
setReadOnly(Object entity, boolean readOnly) |
void |
|
void |
update(String entityName, Object object) |