Auditing

最新推荐文章于 2025-07-13 16:24:31 发布

转载最新推荐文章于 2025-07-13 16:24:31 发布 · 313 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://my.oschina.net/hantsy/blog/170166

文章标签：

#java #runtime

为什么80%的码农都做不了架构师？>>>

#Auditing

Sometime we need to keep track with the change of the Entity, eg.

When it is created
Who created it
Last modified date
Last modified by somebody

Implement via JPA

JPA specification provides a complete lifecycle of an Entity, which is easy to archive those purposes.

An example(dummy codes).

<pre> @Entity public class Conference{ private User createdBy; private Date createdDate; private user lastModifiedBy; private Date lastModifiedDate; @PrePersist public void prePersist(){ setCreatedBy(currentUser); setCreatedDate(new Date()); } @PreUpdate public void preUpdate(){ setLastModifiedBy(currentUser); setLastModifiedDate(new Date()); } } </pre>

In this example, the method prePersist annotated with @PrePresist indicates it will be executed before em.persist is executed.

And @PreUpdate will be executed before em.merge is executed.

JPA also provides EntityListener feature. Use EntityListener, the lifecycle hook methods can be placed in a centered class.

Refactor the before example Conference entity and split it into three classes.

<pre> @MappedSuperclass @EntityListeners(value = { AuditEntityListener.class }) public class AuditableEntity { @ManyToOne @JoinColumn(name = "created_by") private User createdBy; @Temporal(TemporalType.TIMESTAMP) @Column(name = "created_date") private Date createdDate; @ManyToOne @JoinColumn(name = "last_modified_by") private User lastModifiedBy; @Temporal(TemporalType.TIMESTAMP) @Column(name = "last_modified_date") private Date lastModifiedDate; } </pre>

AuditableEntity is a base Entity class which defines the all auditing properties. It will apply an EntityListener AuditEntityListener class at runtime.

<pre> public class AuditEntityListener { private static final Logger log = LoggerFactory .getLogger(AuditEntityListener.class); @PrePersist public void prePersist(AuditableEntity e) { e.setCreatedBy(SecurityUtil.getCurrentUser()); e.setCreatedDate(new DateTime()); } @PreUpdate public void preUpdate(AuditableEntity e) { e.setLastModifiedBy(SecurityUtil.getCurrentUser()); e.setLastModifiedDate(new DateTime()); } } </pre>

The @PrePersist and @PreUpdate methods can accept an object which will be passed into the related method of EntityManager.

Any classes extends AuditableEntity will be listened by AuditEntityListener.

<pre> @Entity public class Conference extends AuditableEntity { } </pre>

Obviously, the second solution is more flexible and maintainable.

Auditing from Spring Data JPA

Spring Data Commons defines some classes for auditing, currently only the Spring Data JPA module provides complete implementation.

Utilize the Spring Data facility

Spring Data provides two basic interfaces.

Persistable indicates the class is a persistable class, any Persistable class could be indentified by a id property.
Auditable is an interface defines all required properties for auditing an Entity, it is inherited from Presistable interface.

Spring Data JPA provides two abstract classes to implement these interfaces.

AbstractPersistable implements Persisteable, annotates id property with @Id to indicate it is a JPA primary key.
AbstractAuditable implements Auditable, and the auditor type is a acceptable type argument passed into AbstractAuditable.

An example to demonstrate these.

<pre> @Entity public class Conference extends AbstractAuditable<User, Long>{ } </pre>

Spring Data JPA provides a generic EntityListener to track the Auditable interfaces.

You must configure it in the orm.xml(/src/main/resouces).

You have to create a empty persistence.xml in the same folder, or the AuditingEntityListener does not work as expected, even you have declared a LocalContainerEntityManagerFactoryBean which does not force you to provide a persistence.xml configuration. Maybe this is an issue of Spring.

Next, you must create an AuditorWare implementation bean which implements how to fetch auditor, generally it is the current user in the real world application. Spring will inject the auditor into AuditingEntityListener at runtime.

<pre> @Named(value="auditorBean") public class AuditorBean implements AuditorAware<User> { private static final Logger LOGGER=LoggerFactory.getLogger(AuditorBean.class); private User currentAuditor; @Override public User getCurrentAuditor() { // Authentication authentication = SecurityContextHolder.getContext().getAuthentication(); // // if (authentication == null || !authentication.isAuthenticated()) { // return null; // } // // return ((MyUserDetails) authentication.getPrincipal()).getUser(); LOGGER.debug("call AuditorAware.getCurrentAuditor("); return currentAuditor; } public void setCurrentAuditor(User currentAuditor) { this.currentAuditor = currentAuditor; } } </pre>

In the real world application, the current authenticated user can be fetched from SecurtiyContextHolder.

Declare a <jpa:auditing/> in Spring configuration to enable auditing feature in the project.

Now write some codes to test the auditing.

<pre> @Test @Transactional public void retrieveConference() { Conference conference = newConference(); conference.setSlug("test-jud"); conference.setName("Test JUD"); conference.getAddress().setCountry("US"); conference = conferenceRepository.save(conference); em.flush(); assertTrue(null != conference.getId()); conference = conferenceRepository.findBySlug("test-jud"); log.debug("conference @" + conference); assertTrue(null != conference); assertTrue(conference.getCreatedBy() != null); assertTrue("hantsy".equals(conference.getCreatedBy().getUsername())); assertTrue(conference.getCreatedDate() != null); assertTrue(conference.getLastModifiedBy() != null); assertTrue("hantsy" .equals(conference.getLastModifiedBy().getUsername())); assertTrue(conference.getLastModifiedDate() != null); assertTrue(conference.getCreatedDate().equals( conference.getLastModifiedDate())); conference .setDescription("change desc, the modified date should be updated."); conferenceRepository.save(conference); em.flush(); conference = conferenceRepository.findBySlug("test-jud"); log.debug("created date @" + conference.getCreatedDate()); log.debug("modified date @" + conference.getLastModifiedDate()); assertTrue(!conference.getCreatedDate().equals( conference.getLastModifiedDate())); } </pre>

Add auditing to existing classes

If you have some existing entities, and do not modify them to extend AbstractAuditable, you can add some annotations to existing classes to implement the auditing feature.

<pre> @Entity public class Signup { @Id @GeneratedValue(strategy = GenerationType.AUTO) @Column(name = "id") private Long id; @DateTimeFormat(style = "M-") @CreatedDate private Date createdDate; @LastModifiedDate @DateTimeFormat(style = "M-") private Date modifiedDate; @CreatedBy() @ManyToOne private User createdBy; @LastModifiedBy @ManyToOne private User modifiedBy; } </pre>

The date fields can accept java.util.Date, joda DateTime or Long/long type.

Here some test codes.

<pre> @Test @Transactional public void testSignup() { Conference conference = newConference(); conference.setSlug("test-jud"); conference.setName("Test JUD"); conference.getAddress().setCountry("US"); Signup signup = newSignup(); conference.addSignup(signup); conference = conferenceRepository.save(conference); em.flush(); assertTrue(null != conference.getId()); assertTrue(null != signup.getId()); Signup signup2=signupRepository.findById(signup.getId()); assertTrue(signup2.getCreatedBy() != null); assertTrue("hantsy".equals(signup2.getCreatedBy().getUsername())); assertTrue(signup2.getCreatedDate() != null); assertTrue(signup2.getModifiedBy() != null); assertTrue("hantsy" .equals(signup2.getModifiedBy().getUsername())); assertTrue(signup2.getModifiedDate() != null); assertTrue(signup2.getCreatedDate().equals( signup2.getModifiedDate())); signup2.setComment("add comment to signup, and the signup is changed, the modified date should be updated."); signupRepository.save(signup2); em.flush(); signup2=signupRepository.findById(signup.getId()); log.debug("created date @" + signup2.getCreatedDate()); log.debug("modified date @" + signup2.getModifiedDate()); assertTrue(!signup2.getCreatedDate().equals( signup2.getModifiedDate())); } </pre>

##Summary

The Auditing feature from Spring Data JPA is very simple and stupid, and it is useful in the real world application.

转载于:https://my.oschina.net/hantsy/blog/170166