��译的Hibernate的Session的javadoc

博客java — Fri, 07 Apr 2006 14:04:00 GMT

Hibernate的透明持久化用��h��非常舒服�Q�有时甚臛_��C��数据库的存在。我�w�边的朋友经�怼�分不清save、saveOrUpdate、update的区别，lock、merge、replicate、refresh、evict甚至不知道是�q�什么用的。而且关于实体对象的生命周期也有很多概念不清，分不清transient、persistent、detached的区别，只是知道PO、VO�q�样的通俗叫法。其实这些概念都很简单，Hibernate的javadoc写的都很清楚�Q�只需看看��p��明白。所以我�׃��些时间将Hibernate 3.1.2中session的javadoc部分��译了一下，旨在让那些因为Hibernate的“透明”而忘��C��它基本概�늚��Z��停下来再看看�q�些概念

org.hibernate
Interface Session

All Superinterfaces:: Serializable

All Known Subinterfaces:: EventSource, Session

All Known Implementing Classes:: SessionImpl

public interface Session
extends Serializable

Java应用�E�序与Hibernate之间的主要运行时接口。它是抽象了持久化服务概�늚�核心抽象API�c�R�?br />
Session的生命周期绑定在一个物理的事务�Q�tansaction�Q�上面。（长的事务可能跨越多个数据库事物。）

Session的主要功能是提供�Ҏ��的实体�c�d��例的创徏�Q�读取和删除操作。实例可能以下面三种状态存在：

自由状态（transient�Q? 不曾�q�行持久化，未与��M��Session相关�?br />持久化状态（persistent�Q? 仅与一�?tt>Session相关�?br />游离状态（detached�Q? 已经�q�行�q�持久化�Q�但当前未与��M��Session相关�?br />
游离状态的实例可以通过调用save()�?tt>persist()或�?tt>saveOrUpdate()�Ҏ��q�行持久化。持久化实例可以通过调用 delete()变成游离状态。通过get()�?tt>load()�Ҏ��得到的实例都是持久化状态的。游��ȝ��态的实例可以通过调用 update()�?saveOrUpdate()�?tt>lock()或�?tt>replicate()�q�行持久化。游��L��者自��q��态下的实例可以通过调用merge()�Ҏ��成�ؓ一个新的持久化实例�?br />
save()�?tt>persist()��会引发SQL�?tt>INSERT�Q?tt>delete()会引发SQLDELETE�Q��?tt>update()�?tt>merge()会引发SQLUPDATE。对持久化（persistent�Q?/i>实例的修改在��h��提交的时候会被检��到�Q�它也会引�vSQLUPDATE�?tt>saveOrUpdate()或�?tt>replicate()会引发SQLINSERT或�?tt>UPDATE�?br />
其具体实现�ƈ不一定是�U�程安全的。每个线�E?事务应该从一�?tt>SessionFactory获取自己的session实例�?br />
如果其持久化对象�c�L��可序列化的，�?tt>Session实例也是可序列化的�?br />
一个典型的事务应该使用下面的�Ş式：

 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会被废弃。在异常发生�?tt>Session的内部状态可能会与数据库失去同步�?
Author:
Gavin King
See Also:
SessionFactory

Method Summary
Transaction beginTransaction()
          开始一个工作单元�ƈ且返回相兌��?tt>事务�Q�Transaction�Q?/tt>对象�?
void cancelQuery()
          �l�止执行当前查询�?/td>
void clear()
          完整的清除这个session�?/td>
Connection close()
          停止�q�个Session�Q�通过中断JDBC�q�接�q�且清空�Q�cleaning up�Q�它�?/td>
Connection connection()
          获取�q�个Session的JDBC�q�接�?br />
如果�q�个session使用了积极的collection释放�{�略�Q�如CMT-容器控制事务的环境下�Q�，关闭�q�个调用的连接的职责应该由当前应用程序负责�?
boolean contains(Object object)
          ��查这个对象实例是否与当前�?tt>Session兌��Q�即是否为Persistent状态）�?/td>
Criteria createCriteria(Class persistentClass)
          为给定的实体�c�L��它的��类创徏一个新�?tt>Criteria实例�?/td>
Criteria createCriteria(Class persistentClass, String alias)
          �Ҏ��l�定的实体类或者它的超�c�d��Z��个新�?tt>Criteria实例�Q��ƈ赋予它（实体�c�）一个别名�?/td>
Criteria createCriteria(String entityName)
          �Ҏ��l�定的实体的名称�Q�name�Q�，创徏一个新�?tt>Criteria实例�?/td>
Criteria createCriteria(String entityName, String alias)
          �Ҏ��l�定的实体的名称�Q�name�Q�，创徏一个新�?tt>Criteria实例�Q��ƈ赋予它（实体�c�）一个别�?/td>
Query createFilter(Object collection, String queryString)
          �Ҏ��l�定的collection和过滤字�W�串�Q�查询条�Ӟ��创徏一个新�?tt>Query实例�?/td>
Query createQuery(String queryString)
          �Ҏ��l�定的HQL查询条�g创徏一个新�?tt>Query实例�?/td>
SQLQuery createSQLQuery(String queryString)
          �Ҏ��l�定的SQL查询条�g创徏一个新�?tt>SQLQuery实例�?/td>
void delete(Object object)
          从数据库中移除持久化�Q�persistent�Q�对象的实例�?/td>
void delete(String entityName, Object object)
          从数据库中移除持久化�Q�persistent�Q�对象的实例�?/td>
void disableFilter(String filterName)
          ��用当前session的名�U�过滤器�?/td>
Connection disconnect()
          断开Session与当前的JDBC�q�接�?/td>
Filter enableFilter(String filterName)
          打开当前session的名�U�过滤器�?/td>
void evict(Object object)
          ��当前对象实例从session�~�存中清除�?/td>
void flush()
          强制提交��h��Q�flush�Q?tt>Session�?/td>
Object get(Class clazz, Serializable id)
          �Ҏ��l�定标识和实体类�q�回持久化对象的实例�Q�如果没有符合条件的持久化对象实例则�q�回null�?/td>
Object get(Class clazz, Serializable id, LockMode lockMode)
          �Ҏ��l�定标识和实体类�q�回持久化对象的实例�Q�如果没有符合条件的持久化对象实例则�q�回null�?/td>
Object get(String entityName, Serializable id)
          �q�回与给定的实体命名和标识匹配的持久化实例，如果没有对应的持久化实例则返回null�?/td>
Object get(String entityName, Serializable id, LockMode lockMode)
          �q�回与给定的实体�c�d��标识所匚w��的持久化实例�Q�如果没有对应的持久化实例则�q�回null�?/td>
CacheMode getCacheMode()
          得到当前的缓存模式�?/td>
LockMode getCurrentLockMode(Object object)
          ��给定对象当前的锁定�U�别�?/td>
Filter getEnabledFilter(String filterName)
          �Ҏ��名称获取一个当前允许的�q��o器（filter�Q��?/td>
EntityMode getEntityMode()
          获取�q�个session有效的实体模式�?/td>
String getEntityName(Object object)
          �q�回一个持久化对象的实体名�U��?/td>
FlushMode getFlushMode()
          获得当前的刷新提交（flush�Q�模式�?/td>
Serializable getIdentifier(Object object)
          获取�l�定的实体对象实例在Session的缓存中的标识，如果该实例是自由状态（Transient�Q�的或者与其它Session兌��则抛��Z��个异常�?/td>
Query getNamedQuery(String queryName)
          从映��文件中�Ҏ��l�定的查询的名称字符串获取一�?tt>Query�Q�查询）实例�?/td>
Session getSession(EntityMode entityMode)
          �Ҏ��l�定的实体模式（Entity Mode�Q�开始一个新的有效的Session�?/td>
SessionFactory getSessionFactory()
          获取创徏�q�个session�?tt>SessionFactory实例�?
SessionStatistics getStatistics()
          获取�q�个session的统计信息�?/td>
Transaction getTransaction()
          获取与这个session兌��?tt>Transaction�Q�事务）实例�?instance associated with this session.
boolean isConnected()
          ��查当�?tt>Session是否处于�q�接状态�?/td>
boolean isDirty()
          当前Session是否包含需要与数据库同步的�Q�数据状态）变化 �Q�如果我们刷新提交（flush�Q�这个session是否会有SQL执行�Q?/td>
boolean isOpen()
          ��查当�?tt>Session是否仍然打开�?/td>
Object load(Class theClass, Serializable id)
          在符合条件的实例存在的情况下�Q�根据给定的实体�c�d��标识�q�回持久化状态的实例�?/td>
Object load(Class theClass, Serializable id, LockMode lockMode)
          在符合条件的实例存在的情况下�Q�根据给定的实体�c�R��标识及指定的锁定等�U�返回持久化状态的实例�?/td>
void load(Object object, Serializable id)
          ��与�l�定的标�C�对应的持久化状态（��|��复制到给定的自由状态（trasient�Q�实例上�?/td>
Object load(String entityName, Serializable id)
          在符合条件的实例存在的情况下�Q�根据给定的实体�c�d��标识�q�回持久化状态的实例�?/td>
Object load(String entityName, Serializable id, LockMode lockMode)
          在符合条件的实例存在的情况下�Q�根据给定的实体�c�R��标识及指定的锁定等�U�返回持久化状态的实例�?/td>
void lock(Object object, LockMode lockMode)
          从给定的对象上获取指定的锁定�U�别�?/td>
void lock(String entityName, Object object, LockMode lockMode)
          从给定的对象上获取指定的锁定�U�别�?/td>
Object merge(Object object)
          ��给定的对象的状态复制到��h��相同标识的持久化对象上�?/td>
Object merge(String entityName, Object object)
          ��给定的对象的状态复制到��h��相同标识的持久化对象上�?/td>
void persist(Object object)
          ��一个自��q��态（transient�Q�的实例持久化�?/td>
void persist(String entityName, Object object)
          ��一个自��q��态（transient�Q�的实例持久化�?/td>
void reconnect()
          不推荐的�?/b> 手工的重新连接只应用于应用程序提供连接的情况�Q�在�q�种情况下或许应该��?a href="/org/hibernate/Session.html#reconnect(java.sql.Connection)">reconnect(java.sql.Connection)�?/i>
void reconnect(Connection connection)
          重新�q�接到给定的JDBC�q�接�?/td>
void refresh(Object object)
          从数据库中重新读取给定实例的状态�?/td>
void refresh(Object object, LockMode lockMode)
          �Ҏ��指定�?tt>锁定模式�Q�LockMode�Q?/tt>�Q�从数据库中重新��d��l�定实例的状态�?/td>
void replicate(Object object, ReplicationMode replicationMode)
          使用当前的标识值持久化�l�定的游��ȝ��态（Transient�Q�的实体�?/td>
void replicate(String entityName, Object object, ReplicationMode replicationMode)
          使用当前的标识值持久化�l�定的游��ȝ��态（Transient�Q�的实体�?/td>
Serializable save(Object object)
          首先为给定的自由状态（Transient�Q�的对象�Q�根据配�|�）生成一个标识�ƈ赋��|��然后��其持久化�?/td>
Serializable save(String entityName, Object object)
          首先为给定的自由状态（Transient�Q�的对象�Q�根据配�|�）生成一个标识�ƈ赋��|��然后��其持久化�?/td>
void saveOrUpdate(Object object)
          �Ҏ��l�定的实例的标识属性的��|��注：可以指定unsaved-value。一般默认null。）来决定执�?save() �?tt>update()操作�?/td>
void saveOrUpdate(String entityName, Object object)
          �Ҏ��l�定的实例的标识属性的��|��注：可以指定unsaved-value。一般默认null。）来决定执�?save() �?tt>update()操作�?/td>
void setCacheMode(CacheMode cacheMode)
          讄��h��提交模式�?/td>
void setFlushMode(FlushMode flushMode)
          讄��h��提交模式�?/td>
void setReadOnly(Object entity, boolean readOnly)
          ��一个未�l�更改的持久化对象设�|��ؓ只读模式�Q�或者将一个只��d��象标��Cؓ可以修改的模式�?/td>
void update(Object object)
          �Ҏ��l�定的detached�Q�游��ȝ��态）对象实例的标识更新对应的持久化实例�?/td>
void update(String entityName, Object object)
          �Ҏ��l�定的detached�Q�游��ȝ��态）对象实例的标识更新对应的持久化实例�?/td>

from:http://www.aygfsteel.com/iamtin/archive/2006/03/06/33910.html

博客java 2006-04-07 22:04 发表评论

Method Summary
`Transaction`	`beginTransaction()` 开始一个工作单元�ƈ且返回相兌��?tt>事务�Q�Transaction�Q?/tt>对象�?
`void`	`cancelQuery()` �l�止执行当前查询�?/td>
`void`	`clear()` 完整的清除这个session�?/td>
`Connection`	`close()` 停止�q�个`Session`�Q�通过中断JDBC�q�接�q�且清空�Q�cleaning up�Q�它�?/td>
`Connection`	`connection()` 获取�q�个Session的JDBC�q�接�?br /> 如果�q�个session使用了积极的collection释放�{�略�Q�如CMT-容器控制事务的环境下�Q�，关闭�q�个调用的连接的职责应该由当前应用程序负责�?
`boolean`	`contains(Object object)` ��查这个对象实例是否与当前�?tt>Session兌��Q�即是否为Persistent状态）�?/td>
`Criteria`	`createCriteria(Class persistentClass)` 为给定的实体�c�L��它的��类创徏一个新�?tt>Criteria实例�?/td>
`Criteria`	`createCriteria(Class persistentClass, String alias)` �Ҏ��l�定的实体类或者它的超�c�d��Z��个新�?tt>Criteria实例�Q��ƈ赋予它（实体�c�）一个别名�?/td>
`Criteria`	`createCriteria(String entityName)` �Ҏ��l�定的实体的名称�Q�name�Q�，创徏一个新�?tt>Criteria实例�?/td>
`Criteria`	`createCriteria(String entityName, String alias)` �Ҏ��l�定的实体的名称�Q�name�Q�，创徏一个新�?tt>Criteria实例�Q��ƈ赋予它（实体�c�）一个别�?/td>
`Query`	`createFilter(Object collection, String queryString)` �Ҏ��l�定的collection和过滤字�W�串�Q�查询条�Ӟ��创徏一个新�?tt>Query实例�?/td>
`Query`	`createQuery(String queryString)` �Ҏ��l�定的HQL查询条�g创徏一个新�?tt>Query实例�?/td>
`SQLQuery`	`createSQLQuery(String queryString)` �Ҏ��l�定的SQL查询条�g创徏一个新�?tt>SQLQuery实例�?/td>
`void`	`delete(Object object)` 从数据库中移除持久化�Q�persistent�Q�对象的实例�?/td>
`void`	`delete(String entityName, Object object)` 从数据库中移除持久化�Q�persistent�Q�对象的实例�?/td>
`void`	`disableFilter(String filterName)` ��用当前session的名�U�过滤器�?/td>
`Connection`	`disconnect()` 断开`Session`与当前的JDBC�q�接�?/td>
`Filter`	`enableFilter(String filterName)` 打开当前session的名�U�过滤器�?/td>
`void`	`evict(Object object)` ��当前对象实例从session�~�存中清除�?/td>
`void`	`flush()` 强制提交��h��Q�flush�Q?tt>Session�?/td>
`Object`	`get(Class clazz, Serializable id)` �Ҏ��l�定标识和实体类�q�回持久化对象的实例�Q�如果没有符合条件的持久化对象实例则�q�回null�?/td>
`Object`	`get(Class clazz, Serializable id, LockMode lockMode)` �Ҏ��l�定标识和实体类�q�回持久化对象的实例�Q�如果没有符合条件的持久化对象实例则�q�回null�?/td>
`Object`	`get(String entityName, Serializable id)` �q�回与给定的实体命名和标识匹配的持久化实例，如果没有对应的持久化实例则返回null�?/td>
`Object`	`get(String entityName, Serializable id, LockMode lockMode)` �q�回与给定的实体�c�d��标识所匚w��的持久化实例�Q�如果没有对应的持久化实例则�q�回null�?/td>
`CacheMode`	`getCacheMode()` 得到当前的缓存模式�?/td>
`LockMode`	`getCurrentLockMode(Object object)` ��给定对象当前的锁定�U�别�?/td>
`Filter`	`getEnabledFilter(String filterName)` �Ҏ��名称获取一个当前允许的�q��o器（filter�Q��?/td>
`EntityMode`	`getEntityMode()` 获取�q�个session有效的实体模式�?/td>
`String`	`getEntityName(Object object)` �q�回一个持久化对象的实体名�U��?/td>
`FlushMode`	`getFlushMode()` 获得当前的刷新提交（flush�Q�模式�?/td>
`Serializable`	`getIdentifier(Object object)` 获取�l�定的实体对象实例在`Session`的缓存中的标识，如果该实例是自由状态（Transient�Q�的或者与其它`Session`兌��则抛��Z��个异常�?/td>
`Query`	`getNamedQuery(String queryName)` 从映��文件中�Ҏ��l�定的查询的名称字符串获取一�?tt>Query�Q�查询）实例�?/td>
`Session`	`getSession(EntityMode entityMode)` �Ҏ��l�定的实体模式（Entity Mode�Q�开始一个新的有效的Session�?/td>
`SessionFactory`	`getSessionFactory()` 获取创徏�q�个session�?tt>SessionFactory实例�?
`SessionStatistics`	`getStatistics()` 获取�q�个session的统计信息�?/td>
`Transaction`	`getTransaction()` 获取与这个session兌��?tt>Transaction�Q�事务）实例�?instance associated with this session.
`boolean`	`isConnected()` ��查当�?tt>Session是否处于�q�接状态�?/td>
`boolean`	`isDirty()` 当前`Session`是否包含需要与数据库同步的�Q�数据状态）变化 �Q�如果我们刷新提交（flush�Q�这个session是否会有SQL执行�Q?/td>
`boolean`	`isOpen()` ��查当�?tt>Session是否仍然打开�?/td>
`Object`	`load(Class theClass, Serializable id)` 在符合条件的实例存在的情况下�Q�根据给定的实体�c�d��标识�q�回持久化状态的实例�?/td>
`Object`	`load(Class theClass, Serializable id, LockMode lockMode)` 在符合条件的实例存在的情况下�Q�根据给定的实体�c�R��标识及指定的锁定等�U�返回持久化状态的实例�?/td>
`void`	`load(Object object, Serializable id)` ��与�l�定的标�C�对应的持久化状态（��\|��复制到给定的自由状态（trasient�Q�实例上�?/td>
`Object`	`load(String entityName, Serializable id)` 在符合条件的实例存在的情况下�Q�根据给定的实体�c�d��标识�q�回持久化状态的实例�?/td>
`Object`	`load(String entityName, Serializable id, LockMode lockMode)` 在符合条件的实例存在的情况下�Q�根据给定的实体�c�R��标识及指定的锁定等�U�返回持久化状态的实例�?/td>
`void`	`lock(Object object, LockMode lockMode)` 从给定的对象上获取指定的锁定�U�别�?/td>
`void`	`lock(String entityName, Object object, LockMode lockMode)` 从给定的对象上获取指定的锁定�U�别�?/td>
`Object`	`merge(Object object)` ��给定的对象的状态复制到��h��相同标识的持久化对象上�?/td>
`Object`	`merge(String entityName, Object object)` ��给定的对象的状态复制到��h��相同标识的持久化对象上�?/td>
`void`	`persist(Object object)` ��一个自��q��态（transient�Q�的实例持久化�?/td>
`void`	`persist(String entityName, Object object)` ��一个自��q��态（transient�Q�的实例持久化�?/td>
`void`	`reconnect()` 不推荐的�?/b> 手工的重新连接只应用于应用程序提供连接的情况�Q�在�q�种情况下或许应该��?a href="/org/hibernate/Session.html#reconnect(java.sql.Connection)">`reconnect(java.sql.Connection)`�?/i>
`void`	`reconnect(Connection connection)` 重新�q�接到给定的JDBC�q�接�?/td>
`void`	`refresh(Object object)` 从数据库中重新读取给定实例的状态�?/td>
`void`	`refresh(Object object, LockMode lockMode)` �Ҏ��指定�?tt>锁定模式�Q�LockMode�Q?/tt>�Q�从数据库中重新��d��l�定实例的状态�?/td>
`void`	`replicate(Object object, ReplicationMode replicationMode)` 使用当前的标识值持久化�l�定的游��ȝ��态（Transient�Q�的实体�?/td>
`void`	`replicate(String entityName, Object object, ReplicationMode replicationMode)` 使用当前的标识值持久化�l�定的游��ȝ��态（Transient�Q�的实体�?/td>
`Serializable`	`save(Object object)` 首先为给定的自由状态（Transient�Q�的对象�Q�根据配�\|�）生成一个标识�ƈ赋��\|��然后��其持久化�?/td>
`Serializable`	`save(String entityName, Object object)` 首先为给定的自由状态（Transient�Q�的对象�Q�根据配�\|�）生成一个标识�ƈ赋��\|��然后��其持久化�?/td>
`void`	`saveOrUpdate(Object object)` �Ҏ��l�定的实例的标识属性的��\|��注：可以指定unsaved-value。一般默认null。）来决定执�?`save()` �?tt>update()操作�?/td>
`void`	`saveOrUpdate(String entityName, Object object)` �Ҏ��l�定的实例的标识属性的��\|��注：可以指定unsaved-value。一般默认null。）来决定执�?`save()` �?tt>update()操作�?/td>
`void`	`setCacheMode(CacheMode cacheMode)` 讄��h��提交模式�?/td>
`void`	`setFlushMode(FlushMode flushMode)` 讄��h��提交模式�?/td>
`void`	`setReadOnly(Object entity, boolean readOnly)` ��一个未�l�更改的持久化对象设�\|��ؓ只读模式�Q�或者将一个只��d��象标��Cؓ可以修改的模式�?/td>
`void`	`update(Object object)` �Ҏ��l�定的detached�Q�游��ȝ��态）对象实例的标识更新对应的持久化实例�?/td>
`void`	`update(String entityName, Object object)` �Ҏ��l�定的detached�Q�游��ȝ��态）对象实例的标识更新对应的持久化实例�?/td>

国产69精品久久久久99,亚洲人成免费网站,国产理论电影在线观看

���译的Hibernate的Session的javadoc

org.hibernateInterface Session

��译的Hibernate的Session的javadoc

org.hibernate
Interface Session