• 依赖引用
• 实体类标记审计属性
• 审计自定义操作
• 应用开启审计功能
• 实体操作

Java SpringBoot JPA有些业务数据需要对数据的创建人、创建时间、最后更新人和最后更新时间进行记录。如果使用Spring Data Jpa做数据新增或更新，可实现自动保存这些信息而不需要显式设置对应字段的值。实现自动记录上述信息主要有5个注解：

• @EnableJpaAuditing：审计功能开关
• @CreatedBy：标记数据创建者属性
• @LastModifiedBy：标记数据最近一次修改者属性
• @CreatedDate：标记数据创建日期属性

• @LastModifiedDate：标记数据最近一次修改日期属性

  依赖引用

  使用Spring Data JPA要引用依赖spring-boot-starter-data-jpa

  <dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>

  实体类标记审计属性

  案例使用User实体演示过程，需要在实体对应的字段上添加对应的注解表示是审计属性，另外需要在实体类上开启审计监听，如下：

  @Entity
  @Table(name = "t_user")
  @EntityListeners({AuditingEntityListener.class})//开启审计监听
  public class UserDO implement Serializable {
        @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    //保存创建人的字段
    @CreatedBy
    @Column(name = "created_by")
    private String createdBy;
    //保存最近修改人的字段
    @LastModifiedBy
    @Column(name = "last_modified_by")
    private String lastModifiedBy;
    //保存创建时间的字段
    @CreatedDate
    @Column(name = "created_date")
    //保存最近修改日期的字段
    private Date createdDate;
    @LastModifiedDate
    @Column(name = "last_modified_date")
    private Date lastModifiedDate;
    @Column(name = "real_name")
    private String realName;
    @Column(name = "username")    
    private String username;
    @Column(name = "password")
    private String password;
    //TODO 省略 getter setter
  }

  User实体对应数据表定义如下：

  create table t_user (
    id int auto_increment primary key,
    username varchar(30) default '' not null comment '登录用户名',
    password varchar(100) default '' null comment '加密密码',
    real_name varchar(30) default '' null comment '真实姓名',
    created_by varchar(50) default 'HSystem' null comment '创建人',
    created_date datetime default CURRENT_TIMESTAMP not null,
    last_modified_by varchar(30) default 'HSystem' null comment '修改人',
    last_modified_date datetime default CURRENT_TIMESTAMP not null,
    constraint user_username_uindex unique (username)
  );

  审计自定义操作

  当对实体有新增或保存操作时，系统会自动获取操作时的系统时间作为创建时间和修改时间。对于创建人或最后修改人，审计过程会获取当前登录系统的用户信息，当未登录的情况下，需要指定默认操作，可通过实现AuditorAware类来实现。下面代码在未获取到用户信息时返回HSystem表示默认为系统操作。

  @Configuration
  public class SpringSecurityAuditorAware implements AuditorAware<String> {
    final Logger logger = LoggerFactory.getLogger(this.getClass());
    @Override
    public Optional<String> getCurrentAuditor() {
        try {
            //TODO 这里根据具体情况获取用户信息
            Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
            if (authentication instanceof AnonymousAuthenticationToken) {
                return Optional.of("HSystem");
            } else {
                if (authentication == null) {
                    return Optional.of("HSystem");
                }
                User user = (User) authentication.getPrincipal();
                return Optional.of(user.getUsername());
            }
        } catch (Exception ex) {
            logger.error("get user Authentication failed: " + ex.getMessage(), ex);
            return Optional.of("HSystem");
        }
    }
  }

  应用开启审计功能

  在应用程序入口类添加注解@EnableJpaAuditing开启审计功能，如下

  @SpringBootApplication
  //启用JPA审计功能，自动填充@CreateDate、@CreatedBy、@LastModifiedDate、@LastModifiedBy注解的字段
  @EnableJpaAuditing(auditorAwareRef = "springSecurityAuditorAware")
  public class JapAuditApplication {
    public static void main(String[] args) {
        SpringApplication.run(HBackendApplication.class, args);
    }
  }

  注意：如果系统中有多个审计实现，需要指定Bean的名称，上面案例中使用名称为springSecurityAuditorAware的bean。

  实体操作

  定义User实体类的JPA操作接口UserRepository如下 ```java @Repository public interface UserRepository extends PagingAndSortingRepository, JpaRepository {

} ``` 经过以上步骤再使用UserRepository保存User信息时，就会自动更新创建人，创建时间，更新人和更新时间者四个字段。