Session 用于获取与数据库的物理连接。 Session 对象是轻量级的,并且设计为在每次需要与数据库进行交互时被实例化。持久态对象被保存,并通过 Session 对象检索找回。
该 Session 对象不应该长时间保持开放状态,因为它们通常不能保证线程安全,而应该根据需求被创建和销毁。Session 的主要功能是为映射实体类的实例提供创建,读取和删除操作。这些实例可能在给定时间点时存在于以下三种状态之一:
- 瞬时状态: 一种新的持久性实例,被 Hibernate 认为是瞬时的,它不与 Session 相关联,在数据库中没有与之关联的记录且无标识符值。
- 持久状态:可以将一个瞬时状态实例通过与一个 Session 关联的方式将其转化为持久状态实例。持久状态实例在数据库中没有与之关联的记录,有标识符值,并与一个 Session 关联。
- 脱管状态:一旦关闭 Hibernate Session,持久状态实例将会成为脱管状态实例。
瞬时状态就是刚new出来一个对象,还没有被保存到数据库中,持久化状态就是已经被保存到数据库中,离线状态就是数据库中有,但是session中不存在该对象。若 Session 实例的持久态类别是序列化的,则该 Session 实例是序列化的。如果 Session 引发异常,则事务必须被回滚,该 session 必须被丢弃。
Session接口常用方法
- Transaction beginTransaction()
开始工作单位,并返回关联事务对象。
- void cancelQuery()
取消当前的查询执行。
- void clear()
完全清除该会话。
- Connection close()
通过释放和清理 JDBC 连接以结束该会话。
- Criteria createCriteria(Class persistentClass)
为给定的实体类或实体类的超类创建一个新的 Criteria 实例。
- Criteria createCriteria(String entityName)
为给定的实体名称创建一个新的 Criteria 实例。
- Serializable getIdentifier(Object object)
返回与给定实体相关联的会话的标识符值。
- 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)
从数据存储中删除持久化实例。
- Session get(String entityName, Serializable id)
返回给定命名的且带有给定标识符或 null 的持久化实例(若无该种持久化实例)。
- SessionFactory getSessionFactory()
获取创建该会话的 session 工厂。
- void refresh(Object object)
从基本数据库中重新读取给定实例的状态。
- Transaction getTransaction()
获取与该 session 关联的事务实例。
- boolean isConnected()
检查当前 session 是否连接。
- boolean isDirty()
该 session 中是否包含必须与数据库同步的变化?
- boolean isOpen()
检查该 session 是否仍处于开启状态。
- Serializable save(Object object)
先分配一个生成的标识,以保持给定的瞬时状态实例。
- void saveOrUpdate(Object object)
保存(对象)或更新(对象)给定的实例。
- void update(Object object)
更新带有标识符且是给定的处于脱管状态的实例的持久化实例。
- void update(String entityName, Object object)
更新带有标识符且是给定的处于脱管状态的实例的持久化实例。