在某些情况下,我们需要对实体的CURD操作进行捕获并执行一些操作,这可以通过数据库触发器来实现,但是正如我们上一节中所分析的,由于触发器的执行对Hibernate Session是透明的,因此会带来很多问题(参见上一节)。为此Hibernate提供了一些专门用于捕获监听实体CURD操作的接口,通过这些接口可以实现类似触发器的功能,能够在实体发生CURD操作时捕获事件,并且执行相应的动作逻辑。在Hibernate中这些接口是:Lifecycle,Validatable,Interceptor,下面我们就分别讲解怎样通过这些接口,实现回调拦截的技术细节。
A、Lifecycle与Validatable
在Hibernate中Lifecycle接口定义如下:
public interface Lifecycle{
/**
在实体对象执行save/insert操作之前触发
**/
public boolean onSave(Session session) throws CallbackException;
/**
在session.update()执行之前触发
**/
public boolean onUpdate(Session session) throws CallbackException;
/**
在实体对象执行delete操作之前触发
**/
public boolean onDelete(Session session) throws CallbackException;
/**
在实体对象加载之后触发
**/
public void onLoad(Session session) throws CallbackException;
}
实体对象可以实现Lifecycle接口,来获得在持久化阶段捕获CURD事件,并执行相应动作的能如下所示:
public class User implements Serializable,Lifecycle{
public boolean onSave(Session s) throws CallbackException{
……
return false;
……
}
public boolean onUpdate(Session s) throws CallbackException{
……
return true;
……
}
public boolean onDelete(Session s) throws CallbackException{
……
return false;
……
}
public boolean onLoad(Session s) throws CallbackException{
……
}
}
对于onSave,onUpdate,onDelete方法,如果返回true则意味着需要终止执行对应的操作过程。如果在运行时抛出CallbackException,对应的操作也会被终止。
注意在接口中对应的方法中,不要去通过方法的Session参数执行持久化操作,在这些方法中Session无法正常使用,如果必须要执行一些持久化操作,那么需要进行特殊的处理,我们将在Interceptor部分详细讲解。
Hibernate中还定义了Validatable接口,该接口定义如下:
public interface Validatable{
public void validate() throws ValidationFailure;
}
Validatable接口是用来实现数据验证的,实体类实现Validatable接口,并在接口的validate方法中实现数据验证逻辑,以保证数据输入的合法性。validate方法将会在实体对象持久化前得到调用进行数据验证,与Lifecycle接口中的方法不同,Validatable.validate()方法在实体生命周期中可能被多次调用,因此此方法应该仅限于数据合法性的验证,而不应该实现业务逻辑的验证。
B、Interceptor:
以上是Hibernate提供的Lifecycle接口和Validatable接口,以及使用方法,这两个方法定义了一种自然的回调机制,但是如我们所见,如果想实现对实体的回调拦截,那么相应的实体对象必须实现这两个Hibernate原生接口,这就使代码的可移植性大大下降,因为此时实体类已经不再是一个POJO了,Hibernate的那些天才的设计者们也已经意识到了这个问题,所以又提供了Interceptor接口,为持久化事件的捕获和处理提供了一个非入侵性的解决方案,Interceptor接口通过设置注入来实现持久化事件的捕获和处理,这是典型的IOC(控制反转)设计思想。下面我们就讲解Interceptor接口的技术细节和使用方法。
Hibernate中的Interceptor接口定义如下:
public interface Interceptor{
//对象初始化之前调用,这时实体对象刚刚被创建,各个属性还都为null,如果在这个方法中修改了实体对象的数据,那么返回true,否则返回null.
public boolean onLoad(Object entity,Serializable id,Object[] state,
String[] propertyNames,Type[] types) throws CallbackException;
//Session.flush()在进行脏数据检查时,如果发现实体对象数据已脏,就调用此方法
public boolean onFlushDirty(Object entity,Serializable id,Object[] state,
String[] propertyNames,Type[] types) throws CallbackException;
//实体对象被保存前调用,如果在这个方法中修改了实体对象的数据,那么返回true,否则返回null.
public boolean onSave(Object entity,Serializable id,Object[] state,
String[] propertyNames,Type[] types) throws CallbackException;
//通过Session删除一个实体对象前调用
public boolean onDelete(Object entity,Serializable id,Object[] state,
String[] propertyNames,Type[] types) throws CallbackException;
//Session执行flush()之前调用
public boolean preFlush(Iterator entities) throws CallbackException;
//Session执行flush()之后,所有的SQL语句都执行完毕后调用
public boolean postFlush(Iterator entities) throws CallbackException;
//当执行saveOrUpdate方法时调用,判断实体对象是否已经保存
public Boolean isUnsaved(Object entity);
//执行Session.flush()方法时,调用此方法判断该对象是否为脏对象,这提供了脏数据检查的另一个回调拦截机制
public int[] findDirty(Object entity,Serializable id,Object[] state,
String[] propertyNames,Type[] types) throws CallbackException;
//当Session构造实体类实例前调用,如果返回null,Hibernate会按照默认方式构造实体类对象实例
public Object findDirty(Class clazz,Serializable id) throws CallbackException;
}
Intercepter不需要实体对象来实现,而是通过开发人员定义一个实现Interceptor接口的类,然后在创建Hibernate Session时,通过将Interceptor对象设置进所创建的Session,这样通过这个Session来操作的实体对象,就都会具有对持久化动作的回调拦截能力。在Hibernate中Interceptor对象共有两种用法,如下所述:
1、 SessionFactory.openSession(Interceptor):为每个Session实例分配一个拦截Interceptor,这个拦截接口对象,存放在Session范围内,为每个Session实例所专用。
2、 Configuration.setInterceptor(Interceptor):为SessionFactory实例分配一个Interceptor实例,这个Interceptor实例存放在SessionFactory范围内,被每个Session实例所共享。
A、Interceptor的典型应用:
下面我实现一个利用Interceptor接口实现日志数据稽核的功能,所谓日志数据稽核就是针对一些关键操作进行记录,以便作为业务跟踪的基础依据。
首先定义用于记录操作的实体:
public class AudiLog implements Serializable{
private String id;
private String user;
private String action;
private String entityName;
private String comment;
private Long logtime;
…getter/setter…
}
接下来定义Interceptor接口的实现类和用于持久化操作的AuditDAO类:
package com.lbs.apps.unemployment.subsidy.beforeinfoimport.util;
import net.sf.hibernate.Session;
import net.sf.hibernate.Interceptor;
import Java.io.Serializable;
import net.sf.hibernate.type.Type;
import net.sf.hibernate.HibernateException;
import Java.util.Iterator;
import Java.util.Set;
import Java.util.HashSet;
import com.neusoft.entity.User;
public class MyInterceptor implements Interceptor{
private Set insertset=new HashSet();
private Set updateset=new HashSet();
private Session session;
private String userID;
public void setSession(Session session){
this.session=session
}
public void setUserID(String id){
this.userID=id;
}
public boolean onLoad(Object object, Serializable serializable,
Object[] objectArray, String[] stringArray,
Type[] typeArray) {
return false;
}
public boolean onFlushDirty(Object object, Serializable serializable,
Object[] objectArray, Object[] objectArray3,
String[] stringArray, Type[] typeArray) {
if(object instanceof User){
insertset.add(object);
}
return false;
}
public boolean onSave(Object object, Serializable serializable,
Object[] objectArray, String[] stringArray,
Type[] typeArray) {
if(object instanceof User){
updateset.add(object);
}
return false;
}
public void onDelete(Object object, Serializable serializable,
Object[] objectArray, String[] stringArray,
Type[] typeArray) {
}
public void preFlush(Iterator iterator) {
}
public void postFlush(Iterator iterator) {
try{
if(insertset.size()>0){
AuditDAO.dolog(“insert”,userID,inserset,session.connection);
}
if(updateset.size()>0){
AuditDAO.dolog(“update”,userID,updateset,session.connection);
}
}catch(HibernateException he){
he.printStackTrace();
}
}
public Boolean isUnsaved(Object object) {
return null;
}
public int[] findDirty(Object object, Serializable serializable,
Object[] objectArray, Object[] objectArray3,
String[] stringArray, Type[] typeArray) {
return null;
}
public Object instantiate(Class class0, Serializable serializable) {
return "";
}
}
public class AuditDAO{
public static void doLog(String action,String userID,Set modifySet,Connection connection){
Session tempsession=HibernateUtil.getSessionFactory().openSession(connection);
try{
Iterator it=modifyset.iterator();
while(it.hasNext()){
User user=(User)it.next();
AudiLog log=new AudiLog();
log.setUserID(userID);
log.setAction(action);
log.setComment(user.toString());
log.setLogTime(new Long(Calendar.getInstance().getTime().getTime()));
tempsession.save(log);
}
}catch(Exception e){
throw new CallbackException(e);
}finally{
try{
tempsesson.close();
}catch(HibernateException he){
throw new CallbackException(he);
}
}
}
}
最后看一下业务逻辑主程序:
SessionFactory sessionfactory=config.buildSessionFactory();
MyInterceptor it=new MyInterceptor();
session=sessionfactory().openSession(it);
it.setUserID(“currentUser”);
it.setSession(session);
User user=new User();
user.setName(“zx”);
Transaction tx=session.beginTransaction();
session.save(user);
tx.commit();
session.close();
以上示例代码中,在创建Session时,设置Interceptor实例对象,当执行到session.save(user)前,会触发onSave()方法,当执行tx.commit()时,会执行flush(),在执行该方法后会触发postFlush()方法,这个方法通过AuditDAO进行持久化保存业务日志,在这个类中的红色部分时有关持久化操作部分,我们并没有使用原有的Session实例,这是因为要避免Session内部状态混乱,因此我们依托当前Session的JDBC Connection创建了一个临时Session用于保存操作记录,在这个持久化操作中没有启动事务,这是因为临时Session中的JDBC Connection是与外围调用Interceptor的Session共享,而事务已经在外围Session的JDBC Connection上启动。这是在拦截方法中进行持久化操作的标准方法。总之Interceptor提供了非入侵性的回调拦截机制,使我们可以方便而且优雅的实现一些持久化操作的特殊需求。
posted on 2009-06-11 16:49
周锐 阅读(504)
评论(0) 编辑 收藏 所属分类:
Hibernate