Hibernate_2 Session及Session API

Session 介绍

• Session 接口是 Hibernate 向应用程序提供的操纵数据库的最主要的接口, 它提供了基本的保存, 更新, 删除和加载 Java 对象的方法.

• Session 具有一个缓存, 位于缓存中的对象称为持久化对象, 它和数据库中的相关记录对应. Session 能够在某些时间点, 按照缓存中对象的变化来执行相关的 SQL 语句, 来同步更新数据库, 这一过程被称为刷新缓存(flush)

• 站在持久化的角度, Hibernate 把对象分为 4 种状态:

  • 持久化状态
  • 临时状态
  • 游离状态
  • 删除状态

  Session 的特定方法能使对象从一个状态转换到另一个状态.

Session 缓存

• 在 Session 接口的实现中包含一系列的 Java 集合, 这些 Java 集合构成了 Session 缓存. 只要 Session 实例没有结束生命周期, 且没有清理缓存，则存放在它缓存中的对象也不会结束生命周期
• Session 缓存可减少 Hibernate 应用程序访问数据库的频率

flush 缓存

• flush：Session 按照缓存中对象的属性变化来同步更新数据库
• 默认情况下 Session 在以下时间点刷新缓存：
  • 显式调用 Session 的 flush() 方法
  • 当应用程序调用 Transaction 的 commit（）方法的时, 该方法先 flush ，然后在向数据库提交事务
  • 当应用程序执行一些查询(HQL, Criteria)操作时，如果缓存中持久化对象的属性已经发生了变化，会先 flush 缓存，以保证查询结果能够反映持久化对象的最新状态
• flush 缓存的例外情况: 如果对象使用 native 生成器生成 OID, 那么当调用 Session 的 save() 方法保存对象时, 会立即执行向数据库插入该实体的 insert 语句.
• commit() 和 flush() 方法的区别：flush 执行一系列 sql 语句，但不提交事务；commit 方法先调用flush() 方法，然后提交事务. 意味着提交事务意味着对数据库操作永久保存下来。

设定刷新缓存的时间点

若希望改变 flush 的默认时间点, 可以通过 Session 的 setFlushMode() 方法显式设定 flush 的时间点

清理缓存的模式	各种查询方法	Transaction 的 commit() 方法	Session 的 flush() 方法
FlushMode.AUTO(默认模式)	清理	清理	清理
FlushMode.COMMIT	不清理	清理	清理
FlushMode.NEVER	不清理	不清理	清理

refresh()

会强制发送 SELECT 语句, 以使 Session 缓存中对象的状态和数据表中对应的记录保持一致!

@Test
public void testRefresh() {
    Student student = session.get(Student.class, 1);
    System.out.println(student);
    //在此处断点， 然后修改数据库中数据，向下执行
    session.refresh(student);
    System.out.println(student);
}

持久化对象的状态

• 临时对象（Transient）:
  • 在使用代理主键的情况下, OID 通常为 null
  • 不处于 Session 的缓存中
  • 在数据库中没有对应的记录
• 持久化对象(也叫”托管”)（Persist）：
  • OID 不为 null
  • 位于 Session 缓存中
  • 若在数据库中已经有和其对应的记录, 持久化对象和数据库中的相关记录对应
  • Session 在 flush 缓存时, 会根据持久化对象的属性变化, 来同步更新数据库
  • 在同一个 Session 实例的缓存中, 数据库表中的每条记录只对应唯一的持久化对象
• 删除对象(Removed)
  • 在数据库中没有和其 OID 对应的记录
  • 不再处于 Session 缓存中
  • 一般情况下, 应用程序不该再使用被删除的对象
• 游离对象(也叫”脱管”) （Detached）：
  • OID 不为 null
  • 不再处于 Session 缓存中
  • 一般情况需下, 游离对象是由持久化对象转变过来的, 因此在数据库中可能还存在与它对应的记录

• 对象的状态转换图

  
  对象的状态转换图

Session API 使用

Save() 方法

• Session 的 save() 方法使一个临时对象转变为持久化对象
• Session 的 save() 方法完成以下操作:
  • 把映射对象加入到 Session 缓存中, 使它进入持久化状态
  • 选用映射文件指定的标识符生成器, 为持久化对象分配唯一的 OID. 在使用代理主键的情况下, setId() 方法为映射对象设置 OID 是无效的.
  • 计划执行一条 insert 语句：在 flush 缓存的时候
• Hibernate 通过持久化对象的 OID 来维持它和数据库相关记录的对应关系. 当映射对象处于持久化状态时, 不允许程序随意修改它的 ID
• persist() 和 save() 区别：
  • 当对一个 OID 不为 Null 的对象执行 save() 方法时, 会把该对象以一个新的 oid 保存到数据库中; 但执行 persist() 方法时会抛出一个异常.

/**
 * 1. save() 方法
 * 1). 使一个临时对象变为持久化对象
 * 2). 为对象分配 ID.
 * 3). 在 flush 缓存时会发送一条 INSERT 语句.
 * 4). 在 save 方法之前的 id 是无效的
 * 5). 持久化对象的 ID 是不能被修改的!
 */
@Test
public void testSave() {
    Student student = new Student("小明", 56, new Date(new java.util.Date().getTime()));
    session.save(student);
//  student.setId(200);
}

/**
 * persist(): 也会执行 INSERT 操作
 * 和 save() 的区别 : 
 * 在调用 persist 方法之前, 若对象已经有 id 了, 则不会执行 INSERT, 而抛出异常
 */
@Test
public void testPersist() {
    Student student = new Student("小明", 57, new Date(new java.util.Date().getTime()));
    //student.setId(35);
    session.persist(student);
}

get() 和 load() 方法

• 都可以根据跟定的 OID 从数据库中加载一个持久化对象
• 区别
  • 执行 get 方法: 会立即加载对象. 执行 load 方法, 若不适用该对象, 则不会立即执行查询操作, 而返回一个代理对象，get 是 立即检索, load 是延迟检索.
  • 在需要初始化代理对象之前已经关闭了 Session ， load 方法可能会抛出 LazyInitializationException 异常。
  • 若数据表中没有对应的记录, Session 也没有被关闭.get 返回 null，load 若不使用该对象的任何属性, 没问题; 若一旦使用该对象，就会去获取对象, 就会抛出异常（ObjectNotFoundException ）.

@Test
public void testGet() {
    //get 获取对象时立即加载
    Student student = session.get(Student.class, 1);
    System.out.println(student.getName());
}

@Test
public void testLoad() {
    //load 获取对象时，等到使用时才会加载，如果使用时加载的对象不存在，就会抛出 ObjectNotFoundException 异常
    Student student = session.load(Student.class, 100);
    System.out.println(student.getName());
}

update() 方法

• Session 的 update() 方法使一个游离对象转变为持久化对象, 并且计划执行一条 update 语句.
• 若更新一个持久化对象, 不需要显示的调用 update 方法. 因为在调用 Transaction的 commit() 方法时, 会先执行 session 的 flush 方法.
• 若希望 Session 仅当修改了 News 对象的属性时, 才执行 update() 语句, 可以把映射文件中 <class> 元素的 select-before-update 设为 true. 该属性的默认值为 false
• 当 update() 方法关联一个游离对象时, 如果在 Session 的缓存中已经存在相同 OID 的持久化对象, 会抛出异常
• 当 update() 方法关联一个游离对象时, 如果在数据库中不存在相应的记录, 也会抛出异常.

<class name="com.cfox.hibernate.Student" table="STUDENT_INFO" select-before-update="true">

/**
 * update:
 * 1. 若更新一个持久化对象, 不需要显示的调用 update 方法. 因为在调用 Transaction
 * 的 commit() 方法时, 会先执行 session 的 flush 方法.
 * 2. 更新一个游离对象, 需要显式的调用 session 的 update 方法. 可以把一个游离对象
 * 变为持久化对象
 * 
 * 需要注意的:
 * 1. 无论要更新的游离对象和数据表的记录是否一致, 都会发送 UPDATE 语句. 
 *    如何能让 updat 方法不再盲目的出发 update 语句呢 ? 在 .hbm.xml 文件的 class 节点设置
 *    select-before-update=true (默认为 false). 但通常不需要设置该属性. 
 * 
 * 2. 若数据表中没有对应的记录, 但还调用了 update 方法, 会抛出异常
 * 
 * 3. 当 update() 方法关联一个游离对象时, 
 * 如果在 Session 的缓存中已经存在相同 OID 的持久化对象, 会抛出异常. 因为在 Session 缓存中
 * 不能有两个 OID 相同的对象!
 *    
 */
@Test
public void testUpdate() {
    
    Student student = session.get(Student.class, 1);
    student.setName("AAA");
    session.close();
    session = sessionFactory.openSession();
    Student student1 = session.get(Student.class, 1);
    session.update(student);
}

saveOrUpdate() 方法

• Session 的 saveOrUpdate() 方法同时包含了 save() 与 update() 方法的功能
• 执行流程图：

执行流程图

• 判定对象为临时对象的标准

  • Java 对象的 OID 为 null
  • 映射文件中为 <id> 设置了 unsaved-value 属性, 并且 Java 对象的 OID 取值与这个 unsaved-value 属性值匹配

  <id name="id" type="java.lang.Integer" unsaved-value="12">
  

@Test
public void testSaveOrUpdate() {
    Student student = new Student("小li", 35, new java.util.Date());
    session.saveOrUpdate(student);
}

delete() 方法

• Session 的 delete() 方法既可以删除一个游离对象, 也可以删除一个持久化对象

• Session 的 delete() 方法处理过程

  • 计划执行一条 delete 语句
  • 把对象从 Session 缓存中删除, 该对象进入删除状态.

• Hibernate 的 cfg.xml 配置文件中有一个 hibernate.use_identifier_rollback 属性, 其默认值为 false, 若把它设为 true, 将改变 delete() 方法的运行行为: delete() 方法会把持久化对象或游离对象的 OID 设置为 null, 使它们变为临时对象

  <property name="hibernate.use_identifier_rollback">true</property>
  

/**
 * delete: 执行删除操作. 只要 OID 和数据表中一条记录对应, 就会准备执行 delete 操作
 * 若 OID 在数据表中没有对应的记录, 则抛出异常
 * 
 * 可以通过设置 hibernate 配置文件 hibernate.use_identifier_rollback 为 true,
 * 使删除对象后, 把其 OID 置为  null
 */
@Test
public void testDelete() {
    Student student = session.get(Student.class, 2);
    session.delete(student);
    
    System.out.println(student.toString());
}

doWork(Work) 方法

通过 Hibernate 调用存储过程

• Work 接口: 直接通过 JDBC API 来访问数据库的操作

public interface Work {
    void execute(Connection connection) throws SQLException;
}

• Session 的 doWork(Work) 方法用于执行 Work 对象指定的操作, 即调用 Work 对象的 execute() 方法. Session 会把当前使用的数据库连接传递给 execute() 方法.

@Test
public void testDoWork() {
    Work work = new Work() {
        // 通过jdbc API 来访问数据库
        @Override
        public void execute(Connection connection) throws SQLException {
            System.out.println(connection); 
        }
    };
    session.doWork(work);
}

Hibernate 与触发器协同工作

• Hibernate 与数据库中的触发器协同工作时, 会造成两类问题
  触发器使 Session 的缓存中的持久化对象与数据库中对应的数据不一致:触发器运行在数据库中, 它执行的操作对 Session 是透明的
• Session 的 update() 方法盲目地激发触发器: 无论游离对象的属性是否发生变化, 都会执行 update 语句, 而 update 语句会激发数据库中相应的触发器
  解决方案:
  • 在执行完 Session 的相关操作后, 立即调用 Session 的 flush() 和 refresh() 方法, 迫使 Session
  • 的缓存与数据库同步(refresh() 方法重新从数据库中加载对象)
• 在映射文件的的 <class> 元素中设置 select-before-update 属性: 当 Session 的 update 或 saveOrUpdate() 方法更新一个游离对象时, 会先执行 Select 语句, 获得当前游离对象在数据库中的最新数据, 只有在不一致的情况下才会执行 update 语句