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)
更新带有标识符且是给定的处于脱管状态的实例的持久化实例。 |