hibernate

最新推荐文章于 2025-08-09 15:58:26 发布

最新推荐文章于 2025-08-09 15:58:26 发布 · 65 阅读

文章标签：

#java

第13章拦截器与事件(Interceptors and events)

应用程序能够响应Hibernate内部产生的特定事件是非常有用的。这样就允许实现某些通用的功能以及允许对Hibernate功能进行扩展。

13.1.拦截器(Interceptors)

Interceptor接口提供了从会话(session)回调(callback)应用程序(application)的机制，这种回调机制可以允许应用程序在持久化对象被保存、更新、删除或是加载之前，检查并（或）修改其属性。一个可能的用途，就是用来跟踪审核(auditing)信息。例如：下面的这个拦截器，会在一个实现了 Auditable接口的对象被创建时自动地设置createTimestamp属性，并在实现了Auditable接口的对象被更新时，同步更新lastUpdateTimestamp属性。

package org.hibernate.test;

import java.io.Serializable;

import java.util.Date;

import java.util.Iterator;

import org.hibernate.Interceptor;

import org.hibernate.type.Type;

public class AuditInterceptor implements Interceptor, Serializable {

private int updates;

private int creates;

public void onDelete(Objectentity,

Serializableid,

Object[]state,

String[]propertyNames,

Type[]types) {

// do nothing

}

public booleanonFlushDirty(Object entity,

Serializableid,

Object[] currentState,

Object[] previousState,

String[] propertyNames,

Type[] types) {

if ( entity instanceofAuditable ) {

updates++;

for ( int i=0; i <propertyNames.length; i++ ) {

if ("lastUpdateTimestamp".equals( propertyNames[i] ) ) {

currentState[i]= new Date();

return true;

}

return false;

}

public boolean onLoad(Objectentity,

Serializable id,

Object[]state,

String[]propertyNames,

Type[]types) {

return false;

}

public boolean onSave(Objectentity,

Serializable id,

Object[]state,

String[]propertyNames,

Type[]types) {

if ( entity instanceofAuditable ) {

creates++;

for ( int i=0;i<propertyNames.length; i++ ) {

if ("createTimestamp".equals( propertyNames[i] ) ) {

state[i] = newDate();

return true;

}

return false;

}

public void postFlush(Iteratorentities) {

System.out.println("Creations:" + creates + ", Updates: " + updates);

}

public void preFlush(Iteratorentities) {

updates=0;

creates=0;

}

...

}

创建会话(session)的时候可以指定拦截器。

Session session = sf.openSession( new AuditInterceptor() );

你也可以使用Configuration来设置一个全局范围的拦截器。

new Configuration().setInterceptor( new AuditInterceptor() );

13.2.事件系统(Event system)

如果需要响应持久层的某些特殊事件，你也可以使用Hibernate3的事件框架。该事件系统可以用来替代拦截器，也可以作为拦截器的补充来使用。

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

监听器应该被看作是单例(singleton)对象，也就是说，所有同类型的事件的处理共享同一个监听器实例，因此监听器不应该保存任何状态（也就是不应该使用成员变量）。

用户定制的监听器应该实现与所要处理的事件相对应的接口，或者从一个合适的基类继承（甚至是从Hibernate自带的默认事件监听器类继承，为了方便你这样做，这些类都被声明成non-final的了）。用户定制的监听器可以通过编程使用Configuration对象来注册，也可以在Hibernate的XML格式的配置文件中进行声明（不支持在Properties格式的配置文件声明监听器）。下面是一个用户定制的加载事件(loadevent)的监听器：

public class MyLoadListener extends DefaultLoadEventListener {

// this is the single methoddefined by the LoadEventListener interface

public Object onLoad(LoadEventevent, LoadEventListener.LoadType loadType)

throwsHibernateException {

if (!MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) {

throwMySecurityException("Unauthorized access");

}

return super.onLoad(event,loadType);

}

你还需要修改一处配置，来告诉Hibernate以使用选定的监听器来替代默认的监听器。

<hibernate-configuration>

<session-factory>