hibernate的拦截器和监听器

拦截器(Intercept):顾名思义,拦截操作,也就是在Hibernate做出动作之前会调用的方法。如果你有需要在Hibernate操作数据库之前想要做的操作,就需要用到这个东西了。 

监听器(Listener):监听,就是监视Hibernate的一举一动,如果我们要获取Hibernate各种操作PO的前前后后的信息,那就要用到他了。 

这里有的朋友可能就有疑问了,从上面的描述来看,这个监听器似乎能够实现拦截器的功能,因为他也能获取Hibernate操作数据库前的状况。 
其实不然,在此我只举出两个很典型的例子,大家就会明白他们俩是不能被互相取代的。 

1、监听器只会默默的获取信息,不会阻断Hibernate的工作,而用拦截器时,我们可以根据我们的需求,去终止某个Hibernate的持久化动作。 
2、如果我有这样一个需求,在PO保存时,我想按我的需求改变某个属性的值后,再保存入库。分析下知道,这个操作要在Hibernate执行Save之前来做,那么看似拦截器和监听器都能实现,但实践一下就会知道,如果我们用监听器来做(比如此时PreInsertEventListener),当我们在此改变某属性值后,会发现,保存入库的仍然是原来的值,监听器的Pre******是不允许我们这样做的。此时就需要用到拦截器,实现其OnSave方法,在此进行处理。 


拦截器

  Hibernate为我们提供了实现拦截器的接口org.hibernate.Interceptor,它里面提供了许多拦截事件。通常不需要实现这个接口,因为我们实现自己的拦截器不可能每一个事件都是必须的。所以Hibernate为我们提供了org.hibernate.Interceptor接口的一个空实现类org.hibernate.EmptyIntercept,通常情况下我们只需继承这个空实现类,Override需要的事件方法即可。

拦截器的工作原理简易示意图:

设置拦截器后,相应的操作都会先穿过一层层相应的拦截器,让拦截器执行预处理或善后处理。

拦截器使用实例

创建拦截器:

public class MyIntercept extends EmptyInterceptor {
	private static final long serialVersionUID = -8597658125309889388L;

	/*
	 * entity - POJO对象 id - POJO对象的主键 
	 * state - POJO对象的每一个属性所组成的集合(除了ID) 
	 * propertyNames - POJO对象的每一个属性名字组成的集合(除了ID) 
	 * types - POJO对象的每一个属性类型所对应的Hibernate类型组成的集合(除了ID)
	 */
	@Override
	public boolean onSave(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) {
		if (entity instanceof People) {
			for (int index = 0; index < propertyNames.length; index++) {
				// 找到名为"checkinTime"的属性
				if ("checkinTime".equals(propertyNames[index])) {
					// 使用拦截器将People对象的"checkinTime"属性赋上值
					state[index] = new Timestamp(new Date().getTime());
					// 返回true则拦截本次相关操作
					return true;
				}
			}
		}
		return false;
	}
}

场景类

public class Client {
	public static void main(String[] args) {
		// 为Session添加拦截器
		Session session = HibernateUtil.getSessionFactory().openSession(new MyIntercept());
		Transaction tx = null;
		try {
			tx = session.beginTransaction();

			People people = new People();
			people.setName("zhangsan");

			session.save(people);

			tx.commit();
		} catch (Exception e) {
			if (tx != null) {
				tx.rollback();
			}
			e.printStackTrace();
		} finally {
			session.close();
		}
	}
}

<bean id="myIntercept"   
class="com...MyIntercept">  
.......  
<bean id="sessionFactory"   
class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">  
...  
        <property name="entityInterceptor">   
            <ref bean="myIntercept"/>  
        </property>  
...  
</bean>

 MyIntercept interceptor=new MyIntercept();  
 Configuration config=new Configuration();  
 config.setInterceptor(interceptor);  
 config.configure();  
          
 SessionFactory sf=config.buildSessionFactory();  
 Session session=sf.getCurrentSession();  

可以通过session方式加载拦截器对象,也可以通过Configuration对象加载拦截器

Configuration:对所有的session都会被拦截
session:只对当前的session进行拦截

场景类中并没有显示的设置了people对象的"checkinTime"的属性值,启动该场景类代码,现在来查看数据库信息:

  可以看到checkin_time这列属性依然被赋值了,说明该赋值操作是拦截器帮助我们完成的。使用拦截器的时候需要注意拦截器的返回值,我以前一直以为拦截器的返回值会控制一个操作是否可以继续,通过实验发现,即使返回false操作也会继续执行的,只是返回false的话,拦截器的所有设置都是无效的,不会反应到数据库中。

返回false:

public class MyIntercept extends EmptyInterceptor {
	private static final long serialVersionUID = -8597658125309889388L;

	/*
	 * entity - POJO对象
	 * id - POJO对象的主键
	 * state - POJO对象的每一个属性所组成的集合(除了ID)
	 * propertyNames - POJO对象的每一个属性名字组成的集合(除了ID)
	 * types - POJO对象的每一个属性类型所对应的Hibernate类型组成的集合(除了ID)
	 */
	@Override
	public boolean onSave(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) {
		if (entity instanceof People) {
			for (int index = 0; index < propertyNames.length; index++) {
				// 找到名为"checkinTime"的属性
				if ("checkinTime".equals(propertyNames[index])) {
					// 使用拦截器将People对象的"checkinTime"属性赋上值
					state[index] = new Timestamp(new Date().getTime());
					// return(true);
				}
			}
		}
		return (false);
	}
} 

查看插入的数据:

可以看到数据依然保存到数据库中了,但拦截器的操作并没有反映到数据库中,拦截器的操作是无效的。
但是比较奇怪的是Console输出的SQL语句:

Hibernate: 
    insert 
    into
        people
        (name, checkin_time, id) 
    values
        (?, ?, ?)
Hibernate: 
    update
        people 
    set
        name=?,
        checkin_time=? 
    where
        id=?

居然多了一条Update语句,我使用了p6spy显示了这两条SQL语句的绑定值:

1327304507491|0|0|statement|insert into people (name, checkin_time, id) values (?, ?, ?)|insert into people (name, checkin_time, id) values ('zhangsan', '2012-01-23 15:41:47.45', '402881e53509837f0135098380370001')
1327304507491|0|0|statement|update people set name=?, checkin_time=? where id=?|update people set name='zhangsan', checkin_time='' where id='402881e53509837f0135098380370001'

  可以看到,拦截器的操作会直接反映到数据库中的,但是如果返回值是false的话,Hibernate会产生一条Update SQL语句将拦截器的操作结果取消了。

  最后,Hibernate的拦截器有两种设置方式,一种是使用sessionFactory.openSession(Interceptor interceptor),这样的拦截器只会针对该session有效,又叫做局部拦截器。另一种是使用Configuration的setInterceptor(Interceptor interceptor)方法设置,这样的拦截器对每一个session都有效,又称之为全局拦截器。


事件监听器

  基本上,Session接口的每个方法都有相对应的事件。比如 LoadEvent,FlushEvent,等等(查阅XML配置文件的DTD,以及org.hibernate.event包来获得所有已定义的事件的列表)。当某个方法被调用时,Hibernate Session会生成一个相对应的事件并激活所有配置好的事件监听器。系统预设的监听器实现的处理过程就是被监听的方法要做的(被监听的方法所做的其实仅仅是激活监听器, “实际”的工作是由监听器完成的)。不过,你可以自由地选择实现一个自己定制的监听器(比如,实现并注册用来处理处理LoadEvent的LoadEventListener接口), 来负责处理所有的调用Session的load()方法的请求。

  在定义自己的事件监听器时,其实不需要实现XXXListener接口,Hibernate为了方便我们定义事件监听器,已经为每个事件监听器接口实提供了一个默认的实现。在org.hibernate.event.def包下面可以找到Hibernate为我们提供的默认实现,我们只需要继承这些默认实现,在其基础上添加我们自定义的功能即可。

事件监听器的简单示意图:

当某个方法被调用时,Hibernate Session会生成一个相对应的事件并激活所有配置好的事件监听器。

事件监听器使用

创建事件监听器:

public class SaveOrUpdateListener extends DefaultSaveOrUpdateEventListener {
	private static final long serialVersionUID = 7496518453770213930L;

	// 监听保存或更新事件
	@Override
	public void onSaveOrUpdate(SaveOrUpdateEvent event) {
		People people = null;

		if (event.getObject() instanceof People) {
			people = (People) event.getObject();
		}

		people.setCheckinTime(new Timestamp(new Date().getTime()));

		System.out.println("invoke!");

		// 一定要调用父类提供的功能,不然就和继承接口一样了
		super.onSaveOrUpdate(event);
	}
}

通过hibernate.cfg.xml配置文件将事件监听器配置到Hibernate中:

第一种配置方式: 

<event type="save-update">
    <listener class="com...SaveOrUpdateListener"/>
</event>

第二种配置方式:

<listener class="com...SaveOrUpdateListener" type="save-update"/>

  两种配置方式产生的效果都是一样的。只是一个以"事件"为主,一个以"监听器"为主。type是指定监听事件的类型,class指定监听器的实现类,一个事件可以有多个监听器。type有许多取值,下表列出了所有type的值:

上面列表每一个选项对应着一个特定的事件。

场景类:

public class Client {
	public static void main(String[] args) {
		Session session = HibernateUtil.getSessionFactory().openSession();
		Transaction tx = null;
		try {
			tx = session.beginTransaction();

			People people = new People();
			people.setName("lisi");

			session.saveOrUpdate(people);

			tx.commit();
		} catch (Exception e) {
			if (tx != null) {
				tx.rollback();
			}
			e.printStackTrace();
		} finally {
			session.close();
		}
	}
}

people对象依然没有设置checkinTime属性,运行程序后,查看数据库:

可以看到,checkin_time字段的依然赋值了,说明我们配置的事件监听器生效了。

使用事件监听器我发现需要注意父类行为的顺序,例如:

public void onSaveOrUpdate(SaveOrUpdateEvent event) {
        People people = null;
        
        if(event.getObject() instanceof People) {
            people = (People)event.getObject();
        }
        
        people.setCheckinTime(new Timestamp(new Date().getTime()));
        
        System.out.println("invoke!");
        
        // 一定要调用父类提供的功能,不然就和继承接口一样了
        super.onSaveOrUpdate(event);
}
public void onSaveOrUpdate(SaveOrUpdateEvent event) {
        // 一定要调用父类提供的功能,不然就和继承接口一样了
        super.onSaveOrUpdate(event);
        
        People people = null;
        
        if(event.getObject() instanceof People) {
            people = (People)event.getObject();
        }
        
        people.setCheckinTime(new Timestamp(new Date().getTime()));
        
        System.out.println("invoke!");
}

  例如上面的顺序,虽然最后产生的效果一致,但是第二种顺序会多产生一条update语句,有可能会产生性能问题,所以在使用事件监听器的时候需要多加注意。

posted on 2018-08-22 11:05  疯狂的小萝卜头  阅读(388)  评论(0编辑  收藏  举报