# 12.1\. 攔截器(Interceptors) `Interceptor`接口提供了從會話(session)回調(callback)應用程序(application)的機制， 這種回調機制可以允許應用程序在持久化對象被保存、更新、刪除或是加載之前，檢查并（或）修改其 屬性。一個可能的用途，就是用來跟蹤審核(auditing)信息。例如：下面的這個`攔截器`，會在一個實現了 `Auditable`接口的對象被創建時自動地設置`createTimestamp`屬性，并在實現了 `Auditable`接口的對象被更新時，同步更新`lastUpdateTimestamp`屬性。 你可以直接實現`Interceptor`接口，也可以（最好）繼承自`EmptyInterceptor`。 ``` package org.hibernate.test; import java.io.Serializable; import java.util.Date; import java.util.Iterator; import org.hibernate.EmptyInterceptor; import org.hibernate.Transaction; import org.hibernate.type.Type; public class AuditInterceptor extends EmptyInterceptor { private int updates; private int creates; private int loads; public void onDelete(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) { // do nothing } public boolean onFlushDirty(Object entity, Serializable id, Object[] currentState, Object[] previousState, String[] propertyNames, Type[] types) { if ( entity instanceof Auditable ) { 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(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) { if ( entity instanceof Auditable ) { loads++; } return false; } public boolean onSave(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) { if ( entity instanceof Auditable ) { creates++; for ( int i=0; i<propertyNames.length; i++ ) { if ( "createTimestamp".equals( propertyNames[i] ) ) { state[i] = new Date(); return true; } } } return false; } public void afterTransactionCompletion(Transaction tx) { if ( tx.wasCommitted() ) { System.out.println("Creations: " + creates + ", Updates: " + updates, "Loads: " + loads); } updates=0; creates=0; loads=0; } } ``` 攔截器可以有兩種:`Session`范圍內的，和`SessionFactory`范圍內的。 當使用某個重載的SessionFactory.openSession()使用`Interceptor`作為參數調用打開一個session的時候，就指定了`Session`范圍內的攔截器。 ``` Session session = sf.openSession( new AuditInterceptor() ); ``` `SessionFactory`范圍內的攔截器要通過`Configuration`中注冊，而這必須在創建`SessionFactory`之前。在這種情況下，給出的攔截器會被這個`SessionFactory`所打開的所有session使用了；除非session打開時明確指明了使用的攔截器。`SessionFactory`范圍內的攔截器，必須是線程安全的，因為多個session可能并發使用這個攔截器，要因此小心不要保存與session相關的狀態。 ``` new Configuration().setInterceptor( new AuditInterceptor() ); ```