org.synyx.hades.domain.auditing.support
Class AuditingEntityListener<T>

java.lang.Object
  org.synyx.hades.domain.auditing.support.AuditingEntityListener<T>

All Implemented Interfaces:

org.springframework.beans.factory.InitializingBean

@Configurable
public class AuditingEntityListener<T>
extends java.lang.Object
implements org.springframework.beans.factory.InitializingBean

JPA entity listener to capture auditing information on persiting and updating entities. To get this one flying be sure you configure it as entity listener in your orm.xml as follows:

 <persistence-unit-metadata>
     <persistence-unit-defaults>
         <entity-listeners>
             <entity-listener class="org.synyx.hades.domain.auditing.support.AuditingEntityListener" />
         </entity-listeners>
     </persistence-unit-defaults>
 </persistence-unit-metadata>
 

After that it's just a matter of activating auditing in your Spring config:

 <hades:auditing auditor-aware-ref="yourAuditorAwarebean" />
 

Author:

Oliver Gierke

Constructor Summary

AuditingEntityListener()

Method Summary

void	afterPropertiesSet()
void	setAuditorAware(AuditorAware<T> auditorAware) Setter to inject a AuditorAware component to retrieve the current auditor.
void	setDateTimeForNow(boolean dateTimeForNow) Setter do determine if Auditable#setCreated(DateTime) and Auditable#setLastModified(DateTime) shall be filled with the current Java time.
void	setModifyOnCreation(boolean modifyOnCreation) Set this to false if you want to treat entity creation as modification and thus set the current date as modification date, too.
void	touch(java.lang.Object target) Sets modification and creation date and auditor on the target object in case it implements Auditable.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AuditingEntityListener

public AuditingEntityListener()

Method Detail

setAuditorAware

public void setAuditorAware(AuditorAware<T> auditorAware)

Setter to inject a AuditorAware component to retrieve the current auditor.

Parameters:

auditorAware - the auditorAware to set

setDateTimeForNow

public void setDateTimeForNow(boolean dateTimeForNow)

Setter do determine if Auditable#setCreated(DateTime) and Auditable#setLastModified(DateTime) shall be filled with the current Java time. Defaults to true. One might set this to false to use database features to set entity time.

Parameters:

dateTimeForNow - the dateTimeForNow to set

setModifyOnCreation

public void setModifyOnCreation(boolean modifyOnCreation)

Set this to false if you want to treat entity creation as modification and thus set the current date as modification date, too. Defaults to true.

Parameters:

modifyOnCreation - if modification information shall be set on creation, too

touch

public void touch(java.lang.Object target)

Sets modification and creation date and auditor on the target object in case it implements Auditable.

Parameters:

target -

afterPropertiesSet

public void afterPropertiesSet()

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean