Session的save()方法使一个临时对象转变为持久化对象。
例如以下代码保存一个Customer对象:
Customer customer = new Customer();
customer.setId(new Long(9)); // 为Customer临时对象设置OID是无效的
customer.setName("Tom");
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
session.save(customer);
session.close();
Session的save()方法完成以下的操作:
(1)把Customer对象加入到缓存中,使它变为持久化对象。
(2)选用映射文件指定的标识符生成器为持久化对象分配惟一的OID。Customer.hbm.xml文件中<id>元素的<generator>子元素指定标识符生成器:
<id name="id" column="ID">
<generator class="increment"/>
</id>
以上程序试图通过setId()方法为Customer临时对象设置OID是无效的。假如起初CUSTOMERS表中没有记录,那么执行完save()方法后,Customer对象的ID为1。如果希望由程序来为Customer对象指定OID,可以调用save()的另一个重载方法:
save(customer, new Long(9));
以上save()方法的第二参数显示指定Customer对象的OID。这种形式的save()方法不推荐使用,尤其在使用代理主键的场合,不应该由程序为持久化对象指定OID。
(3)计划执行一个insert语句,把Customer对象当前的属性值组装到insert语句中:
insert into CUSTOMERS(ID, NAME, ......) values(1, 'Tom', ......);
值得注意的是,save()方法并不立即执行SQL insert语句。只有当Session清理缓存时,才会执行SQL insert语句。如果在save()方法之后,又修改了持久化对象的属性,这会使得Session在清理缓存时,额外执行SQL update语句。
以下两段代码尽管都能完成相同的功能,但是左边代码仅执行一条SQL insert语句,而右边代码执行一条SQL insert和一条SQL update语句。左边代码减少了操作数据库的次数,具有更好的运行性能。
Customer customer = new Customer(); | Customer customer = new Customer();
// 先设置Customer对象的属性,再保存它 | session.save(customer);
customer.setName("Tom"); | // 先保存Customer对象,再修改它的属性
session.save(customer); | customer.setName("Tom");
transaction.commit(); | transaction.commit();
Hibernate通过持久化对象的OID来维持它和数据库相关记录的对应关系。当Customer对象处于持久化状态时,不允许程序随意修改它的OID,例如:
Customer customer = new Customer();
session.save(customer);
customer.setId(new Long(100)); // 抛出HibernateException
transaction.commit();
以上代码会导致Session在清理缓存时抛出异常。