Hibernate session的方法全集

文章转自 http://www.cnblogs.com/lukun/archive/2011/03/31/1968937.html

由于最近项目中有的是Hibernate,为了便于学习转发了此文章。感谢博主总结的方法

方法摘要
Transaction	beginTransaction () 开始一个工作单位，并返回值相关的事务对象。
Session.LockRequest	buildLockRequest ( LockOptions lockOptions) 建立一个LockRequest指定LockMode，悲观锁超时和锁的范围。
void	cancelQuery () 取消当前查询的执行。
void	clear () 彻底清除会话。
Connection	close () 结束释放JDBC连接。
Connection	connection () Deprecated.已过时。（去除率定于4.x的）。更换取决于需要;做直接使用JDBC的东西doWork(org.hibernate.jdbc.Work) ;开一个'临时方法'的使用（待定）。
boolean	contains ( Object object) 检查该实例与此相关的方法。
Criteria	createCriteria ( Class persistentClass) 创建一个新的标准的实体类的实例，对于给定的，或一个类的超类的一个实体。
Criteria	createCriteria ( Class persistentClass, String alias) 创建一个新的标准的实体类的实例，对于给定的，或一个类的超类的一个实体的别名，用给定的。
Criteria	createCriteria ( String entityName) 创建一个新的标准的实体名称的实例，对于给定。
Criteria	createCriteria ( String entityName, String alias) 创建一个新的标准的实体名称的实例，对于给定的别名，用给定的。
Query	createFilter ( Object collection, String queryString) 指定过滤器的字符串创建一个新的收集和查询的实例。
Query	createQuery ( String queryString) 创建一个查询字符串中给定的HQL 查询新的实例。
SQLQuery	createSQLQuery ( String queryString) 创建一个新的查询字符串给定的SQL实例SQLQuery的。
void	delete ( Object object) 从数据存储中删除持久化实例。
void	delete ( String entityName, Object object) 从数据存储中删除持久化实例。
void	disableFetchProfile ( String name) 禁用特定魂在本次方法概况。
void	disableFilter ( String filterName) 禁用命名为本类方法的过滤器。
Connection	disconnect () connection.断开连接会话从当前的JDBC。
void	doWork ( Work work) 控制器允许用户执行JDBC的相关工作，用本次常委会方法管理的连接。
void	enableFetchProfile ( String name) 启用魂在本类方法特别配置文件。
Filter	enableFilter ( String filterName) 本类方法启用此命名的过滤器。
void	evict ( Object object) 从会话中删除此缓存实例。
void	flush () 本次方法冲洗力。
Object	get ( Class clazz, Serializable id) 返回值具有给定给定的实体类的持久化实例标识符，则返回值null，如果不存在这样的持久化实例。
Object	get ( Class clazz, Serializable id, LockMode lockMode) Deprecated. *已过时。LockMode*** 参数应改为LockOptions
Object	get ( Class clazz, Serializable id, LockOptions lockOptions) 返回值具有给定给定的实体类的持久化实例标识符，则返回值null，如果不存在这样的持久化实例。
Object	get ( String entityName, Serializable id) 返回值给定的命名实体具有给定标识符或NULL，如果不存在这样的持久化实例的持久化实例。
Object	get ( String entityName, Serializable id, LockMode lockMode) *Deprecated.已过时。LockMode*** 参数应改为LockOptions
Object	get ( String entityName, Serializable id, LockOptions lockOptions) 返回值具有给定给定的实体类的持久化实例标识符，则返回值null，如果不存在这样的持久化实例。
CacheMode	getCacheMode () 获取当前缓存模式。
LockMode	getCurrentLockMode ( Object object) 确定给定对象当前的锁定模式。
Filter	getEnabledFilter ( String filterName) 目前检索启用筛选器的名称。
EntityMode	getEntityMode () 检索在本次方法的影响的实体模式。
String	getEntityName ( Object object) 返回值一个持久化实体的实体名称
FlushMode	getFlushMode () 获取此会话的当前flush模式。
Serializable	getIdentifier ( Object object) 返回值给定实体标识符值与此会话相关联。
Query	getNamedQuery ( String queryName) 获取一个字符串命名查询一个查询实例中定义的映射文件。
Session	getSession ( EntityMode entityMode) 启动一个给定实体的有效模式新的Session。
SessionFactory	getSessionFactory () 获取会话工厂，创造了这个方法。
SessionStatistics	getStatistics () 获得本次方法的统计资料。
Transaction	getTransaction () 交易实例获取与此相关的方法。
boolean	isConnected () 检查当前连接的会话。
boolean	isDefaultReadOnly () 将实体和所装载的代理到本次方法作出只读默认？要确定一个特定的实体或代理read-only/modifiable设置：
boolean	isDirty () 本次方法是否包含任何必须与数据库同步变化？换言之，任何DML操作会被执行，如果我们这次方法刷新？
boolean	isFetchProfileEnabled ( String name) 是一个特定的配置文件读取这个会话上启用？
boolean	isOpen () 检查会话仍然开启。
boolean	isReadOnly ( Object entityOrProxy) 是指定的单位或者代理只读？若要获取默认read-only/modifiable设置实体和所加载到会话代理使用：
Object	load ( Class theClass, Serializable id) 返回值给定的给定实体类的持久化实例的标识符，假设实例存在。
Object	load ( Class theClass, Serializable id, LockMode lockMode) *Deprecated.已过时。LockMode*** 参数应改为LockOptions
Object	load ( Class theClass, Serializable id, LockOptions lockOptions) 返回值给定的实体类的持久化实例与指定的标识符，获得指定的锁定模式，假设实例存在。
void	load ( Object object, Serializable id) 阅读与给定的持久状态到给定的瞬时实例标识符相关联。
Object	load ( String entityName, Serializable id) 返回值给定的给定实体类的持久化实例的标识符，假设实例存在。
Object	load ( String entityName, Serializable id, LockMode lockMode) Deprecated. *已过时。LockMode*** 参数应改为LockOptions
Object	load ( String entityName, Serializable id, LockOptions lockOptions) 返回值给定的实体类的持久化实例与指定的标识符，获得指定的锁定模式，假设实例存在。
void	lock ( Object object, LockMode lockMode) Deprecated. 已过时。改为调用buildLockRequest（LockMode）。锁（对象）
void	lock ( String entityName, Object object, LockMode lockMode) Deprecated.已过时。改为调用buildLockRequest（LockMode）。锁（entityName，对象）
Object	merge ( Object object) 复制到具有相同的持久对象给定对象的状态标识符。
Object	merge ( String entityName, Object object) 复制到具有相同的持久对象给定对象的状态标识符。
void	persist ( Object object) 做一个瞬态的实例持久化。
void	persist ( String entityName, Object object) 做一个瞬态的实例持久化。
void	reconnect () Deprecated.已过时。手动数据连接只需要在连接的情况下应用程序提供的，在这种情况下， reconnect(java.sql.Connection)为应使用。
void	reconnect ( Connection connection) 数据连接到给定的JDBC连接。
void	refresh ( Object object) 重读从基础数据库中的特定实例的状态。
void	refresh ( Object object, LockMode lockMode) *Deprecated.已过时。LockMode*** 参数应改为LockOptions
void	refresh ( Object object, LockOptions lockOptions) 重新阅读给定的数据库实例并从项目的根本，用给定的LockMode。
void	replicate ( Object object, ReplicationMode replicationMode) 坚持项目给定的实例分离，再利用当前标识值。
void	replicate ( String entityName, Object object, ReplicationMode replicationMode) 坚持项目给定的实例分离，再利用当前标识值。
Serializable	save ( Object object) 坚持给定的瞬态的实例，先分配一个生成的标识。
Serializable	save ( String entityName, Object object) 坚持给定的瞬态的实例，先分配一个生成的标识。
void	saveOrUpdate ( Object object) 无论是save(Object)或update(Object)给定的实例，检查不同值的未保存的决议后，（见检查手册未保存价值的讨论-）。
void	saveOrUpdate ( String entityName, Object object) 无论是save(String, Object)或update(String, Object)给定的实例，检查不同值的未保存的决议后，（见检查手册未保存价值的讨论-）。
void	setCacheMode ( CacheMode cacheMode) 设置缓存模式。
void	setDefaultReadOnly (boolean readOnly) 更改为实体，与这个方法装入修改为只读模式，或者从修改为只读模式代理默认。
void	setFlushMode ( FlushMode flushMode) 本类方法设置刷新模式。
void	setReadOnly ( Object entityOrProxy, boolean readOnly) 一个未经修改的持久化对象设置为只读模式，或只读对象修改的模式。
void	update ( Object object) 更新持久实例与给定分离实例标识符。
void	update ( String entityName, Object object) 更新持久实例与给定分离实例标识符。

Method Detail 方法详细

getEntityMode

EntityMode getEntityMode ()

检索在本次方法的影响的实体模式。

Returns: 返回值

本类方法的实体模式。

getSession

Session getSession ( EntityMode entityMode)

启动一个给定实体的有效模式新的Session。这二次方法继承了连接，事务，并从主方法的其他方面的信息。它不需要被刷新，或由开发商关闭。

Parameters: 参数：

entityMode -实体模式来使用新的会话。

Returns: 返回值：

新的会话

flush

void flush ()

抛出异常HibernateException本次方法冲洗。必须在工作结束时调用的一个单位，然后提交事务和闭幕方法（上取决于flush-mode ， Transaction.commit()调用此方法）。法拉盛是记忆过程中同步举行的底层持久化状态的持久存储。

Throws: 抛出异常：

HibernateException -指示问题的方法或谈话冲洗到数据库。

setFlushMode

void setFlushMode ( FlushMode flushMode)

本类方法设置刷新模式。刷新模式决定了该点，刷新会话。 法拉盛是记忆过程中同步举行的底层持久化状态的持久存储。对于一个逻辑上“只读”方法，这是合理的设置会话的flush模式FlushMode.MANUAL在方法开始的（为了实现一些额外的性能）。

Parameters: 参数：

flushMode -新的刷新模式

See Also: 另见：

FlushMode

getFlushMode

FlushMode getFlushMode ()

获取此会话的当前flush模式。

Returns: 返回值：

刷新模式

setCacheMode

void setCacheMode ( CacheMode cacheMode)

设置缓存模式。缓存模式决定了以何种方式在本次方法能够互动与第二级缓存。

Parameters: 参数：

cacheMode -新的缓存模式。

getCacheMode

CacheMode getCacheMode ()

获取当前缓存模式。

Returns: 返回值：

当前缓存模式。

getSessionFactory

SessionFactory getSessionFactory ()

获取会话工厂，创造了这个方法。

Returns: 返回值：

会话工厂。

另见：

SessionFactory

connection

Connection connection ()

抛出异常HibernateException已过时。（ 去除率定于4.x的）更换取决于需要;做直接使用JDBC的东西doWork(org.hibernate.jdbc.Work) ;开一个'临时方法'的使用（待定）。

获得本次方法的JDBC连接。如果会话是使用积极收集发布（如在CMT环境），它是应用程序的责任，关闭这个调用返回值的连接。否则，应用程序不应该关闭连接。

Returns: 返回值：

在使用JDBC连接的会话

Throws: 抛出异常：

HibernateException -如果会话被中断

close

Connection close ()

抛出异常HibernateException结束释放JDBC连接和清理了方法。它没有必要关闭会话，但您至少要disconnect()它。

Returns: 返回值：

所提供的连接应用程序或空。

Throws: 抛出异常：

HibernateException -指示问题的清理。

cancelQuery

void cancelQuery ()

抛出异常HibernateException 取消当前查询的执行。这是对方法的唯一方法，可以安全地从另一个线程调用。

Throws: 抛出异常：

HibernateException -有一个问题，取消查询

isOpen

boolean isOpen ()

检查会话仍然开启。

Returns: 返回值：

boolean

isConnected

boolean isConnected ()

检查当前连接的会话。

Returns: 返回值：

boolean

isDirty

boolean isDirty ()

抛出异常HibernateException 本次方法是否包含任何必须与数据库同步变化？换言之，任何DML操作会被执行，如果我们这次方法刷新？

Returns: 返回值：

如果该区段包含挂起的更改，否则为false。

Throws: 抛出异常：

HibernateException -无法执行弄污检查

isDefaultReadOnly

boolean isDefaultReadOnly ()

将实体和所装载的代理到本次方法作出只读默认？要确定一个特定的实体或代理read-only/modifiable设置：

Returns: 返回值：

true, loaded entities/proxies真正的，装实体/代理将在只读默认为false，加载实体/代理默认情况下，将作出修改。

另见：

isReadOnly(Object)

setDefaultReadOnly

void setDefaultReadOnly (boolean readOnly)

更改为实体，与这个方法装入修改为只读模式，或者从修改为只读模式代理默认。只读实体不脏，检查和持久状态的快照不能维持。只读实体可以修改，但改变不会被持久化。当代理初始化，加载的实体将拥有相同的read-only/modifiable设置为未初始化的代理有，不管会话的当前设置。要更改某个实体或代理，已经在本类方法read-only/modifiable设置：

Parameters: 参数：

readOnly - true，代理默认加载的实体/是只读的，假的，代理默认加载的实体/是可以修改的

另见：

To override this session's read-only/modifiable setting for entities and proxies loaded by a Query: , Query.setReadOnly(boolean) To override this session's read-only/modifiable setting for entities and proxies loaded by a Query: ， Query.setReadOnly(boolean)

getIdentifier

Serializable getIdentifier ( Object object) 序列化抛出异常HibernateException 返回值给定实体标识符值与此会话相关联。抛出异常一个异常如果给定的实体实例是短暂的，或就本次方法脱落。

Parameters: 参数：

object -一个持久化实例

Returns: 返回值：

标识符

Throws: 抛出异常：

TransientObjectException -如果实例是瞬时或会话与一个不同