Session 用于获取与数据库的物理连接。 Session 对象是轻量级的,并且设计为在每次需要与数据库进行交互时被实例化。持久态对象被保存,并通过 Session 对象检索找回。
该 Session 对象不应该长时间保持开放状态,因为它们通常不能保证线程安全,而应该根据需求被创建和销毁。Session 的主要功能是为映射实体类的实例提供创建,读取和删除操作。这些实例可能在给定时间点时存在于以下三种状态之一:
若 Session 实例的持久态类别是序列化的,则该 Session 实例是序列化的。一个典型的事务应该使用以下语法:
Session session = factory.openSession(); Transaction tx = null; try { tx = session.beginTransaction(); // do some work ... tx.commit(); } catch (Exception e) { if (tx!=null) tx.rollback(); e.printStackTrace(); }finally { session.close(); }
如果 Session 引发异常,则事务必须被回滚,该 session 必须被丢弃。
Session 接口提供了很多方法,但在以下讲解中我将仅列出几个我们会在本教程中应用的重要方法。您可以查看 Hibernate 文件,查询与 Session 及 SessionFactory 相关的完整方法目录。
序号 | Session 方法及说明 |
---|---|
1 |
Transaction beginTransaction() 开始工作单位,并返回关联事务对象。 |
2 |
void cancelQuery() 取消当前的查询执行。 |
3 |
void clear() 完全清除该会话。 |
4 |
Connection close() 通过释放和清理 JDBC 连接以结束该会话。 |
5 |
Criteria createCriteria(Class persistentClass) 为给定的实体类或实体类的超类创建一个新的 Criteria 实例。 |
6 |
Criteria createCriteria(String entityName) 为给定的实体名称创建一个新的 Criteria 实例。 |
7 |
Serializable getIdentifier(Object object) 返回与给定实体相关联的会话的标识符值。 |
8 |
Query createFilter(Object collection, String queryString) 为给定的集合和过滤字符创建查询的新实例。 |
9 |
Query createQuery(String queryString) 为给定的 HQL 查询字符创建查询的新实例。 |
10 |
SQLQuery createSQLQuery(String queryString) 为给定的 SQL 查询字符串创建 SQLQuery 的新实例。 |
11 |
void delete(Object object) 从数据存储中删除持久化实例。 |
12 |
void delete(String entityName, Object object) 从数据存储中删除持久化实例。 |
13 |
Session get(String entityName, Serializable id) 返回给定命名的且带有给定标识符或 null 的持久化实例(若无该种持久化实例)。 |
14 |
SessionFactory getSessionFactory() 获取创建该会话的 session 工厂。 |
15 |
void refresh(Object object) 从基本数据库中重新读取给定实例的状态。 |
16 |
Transaction getTransaction() 获取与该 session 关联的事务实例。 |
17 |
boolean isConnected() 检查当前 session 是否连接。 |
18 |
boolean isDirty() 该 session 中是否包含必须与数据库同步的变化? |
19 |
boolean isOpen() 检查该 session 是否仍处于开启状态。 |
20 |
Serializable save(Object object) 先分配一个生成的标识,以保持给定的瞬时状态实例。 |
21 |
void saveOrUpdate(Object object) 保存(对象)或更新(对象)给定的实例。 |
22 |
void update(Object object) 更新带有标识符且是给定的处于脱管状态的实例的持久化实例。 |
23 |
void update(String entityName, Object object) 更新带有标识符且是给定的处于脱管状态的实例的持久化实例。 |