翻译的Hibernate的Session的javadoc

阅读更多

org.hibernate
Interface Session

All Superinterfaces:

Serializable

All Known Subinterfaces:

EventSource, Session

All Known Implementing Classes:

SessionImpl

---

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:

SessionFactory

---

Method Summary
Transaction	beginTransaction() 开始一个工作单元并且返回相关联的事务（Transaction）对象。
void	cancelQuery() 终止执行当前查询。
void	clear() 完整的清除这个session。
Connection	close() 停止这个Session，通过中断JDBC连接并且清空（cleaning up）它。
Connection	connection() 获取这个Session的JDBC连接。 如果这个session使用了积极的collection释放策略（如CMT-容器控制事务的环境下），关闭这个调用的连接的职责应该由当前应用程序负责。
boolean	contains(Objectobject) 检查这个对象实例是否与当前的Session关联（即是否为Persistent状态）。
Criteria	createCriteria(ClasspersistentClass) 为给定的实体类或它的超类创建一个新的Criteria实例。
Criteria	createCriteria(ClasspersistentClass, Stringalias) 根据给定的实体类或者它的超类创建一个新的Criteria实例，并赋予它（实体类）一个别名。
Criteria	createCriteria(StringentityName) 根据给定的实体的名称（name），创建一个新的Criteria实例。
Criteria	createCriteria(StringentityName, Stringalias) 根据给定的实体的名称（name），创建一个新的Criteria实例，并赋予它（实体类）一个别名
Query	createFilter(Objectcollection, StringqueryString) 根据给定的collection和过滤字符串（查询条件）创建一个新的Query实例。
Query	createQuery(StringqueryString) 根据给定的HQL查询条件创建一个新的Query实例。
SQLQuery	createSQLQuery(StringqueryString) 根据给定的SQL查询条件创建一个新的SQLQuery实例。
void	delete(Objectobject) 从数据库中移除持久化（persistent）对象的实例。
void	delete(StringentityName, Objectobject) 从数据库中移除持久化（persistent）对象的实例。
void	disableFilter(StringfilterName) 禁用当前session的名称过滤器。
Connection	disconnect() 断开Session与当前的JDBC连接。
Filter	enableFilter(StringfilterName) 打开当前session的名称过滤器。
void	evict(Objectobject) 将当前对象实例从session缓存中清除。
void	flush() 强制提交刷新（flush）Session。
Object	get(Classclazz, Serializableid) 根据给定标识和实体类返回持久化对象的实例，如果没有符合条件的持久化对象实例则返回null。
Object	get(Classclazz, Serializableid, LockModelockMode) 根据给定标识和实体类返回持久化对象的实例，如果没有符合条件的持久化对象实例则返回null。
Object	get(StringentityName, Serializableid) 返回与给定的实体命名和标识匹配的持久化实例，如果没有对应的持久化实例则返回null。
Object	get(StringentityName, Serializableid, LockModelockMode) 返回与给定的实体类和标识所匹配的持久化实例，如果没有对应的持久化实例则返回null。
CacheMode	getCacheMode() 得到当前的缓存模式。
LockMode	getCurrentLockMode(Objectobject) 检测给定对象当前的锁定级别。
Filter	getEnabledFilter(StringfilterName) 根据名称获取一个当前允许的过滤器（filter）。
EntityMode	getEntityMode() 获取这个session有效的实体模式。
String	getEntityName(Objectobject) 返回一个持久化对象的实体名称。
FlushMode	getFlushMode() 获得当前的刷新提交（flush）模式。
Serializable	getIdentifier(Objectobject) 获取给定的实体对象实例在Session的缓存中的标识，如果该实例是自由状态（Transient）的或者与其它Session关联则抛出一个异常。
Query	getNamedQuery(StringqueryName) 从映射文件中根据给定的查询的名称字符串获取一个Query（查询）实例。
Session	getSession(EntityModeentityMode) 根据给定的实体模式（Entity Mode）开始一个新的有效的Session。
SessionFactory	getSessionFactory() 获取创建这个session的SessionFactory实例。
SessionStatistics	getStatistics() 获取这个session的统计信息。
Transaction	getTransaction() 获取与这个EN-U Global site tag (gtag.js) - Google Analytics