> 摘要: 原创出处 http://www.iocoder.cn/Apollo/config-service-audit/ 「芋道源码」欢迎转载，保留摘要，谢谢！

1. 概述

本文分享 Config Service 操作审计日志 Audit 。在每次在做 ConfigDB 写操作( 增、删、改 )操作时，都会记录一条 Audit 日志，用于未来的审计追溯。

老艿艿：这种实践方式，非常适用于我们做的管理平台。

2. Audit

com.ctrip.framework.apollo.biz.entity.Audit ，继承 BaseEntity 抽象类，Audit 实体。代码如下：

@Entity

@Table(name = "Audit")

@SQLDelete(sql = "Update Audit set isDeleted = 1 where id = ?")

@Where(clause = "isDeleted = 0")

public class Audit extends BaseEntity {

/**

* 操作枚举

*/

public enum OP {

INSERT, UPDATE, DELETE

}

/**

* 实体名

*/

@Column(name = "EntityName", nullable = false)

private String entityName;

/**

* 实体编号

*/

@Column(name = "EntityId")

private Long entityId;

/**

* 操作名

*/

@Column(name = "OpName", nullable = false)

private String opName;

/**

* 备注

*/

@Column(name = "Comment")

private String comment;

}

entityName + entityId 字段，确实一个实体对象。

opName 字段，操作名。分成 INSERT、UPDATE、DELETE 三种，在 OP 中枚举。

comment 字段，备注。

例如：

老艿艿：在管理平台中，我比较喜欢再增加几个字段

ip 字段，请求方的 IP 。

ua 字段，请求的 User-Agent 。

extras 字段，数据结果为 Map 进行 JSON 化，存储重要字段。例如，更新用户手机号，那么会存储 mobile=15601691024 到 extras 字段中。

3. AuditService

在 apollo-biz 项目中，com.ctrip.framework.apollo.biz.service.AuditService ，提供 Aduit 的 Service 逻辑给 Admin Service 和 Config Service 。

@Service

public class AuditService {

@Autowired

private AuditRepository auditRepository;

List findByOwner(String owner) {

return auditRepository.findByOwner(owner);

}

List find(String owner, String entity, String op) {

return auditRepository.findAudits(owner, entity, op);

}

@Transactional

void audit(String entityName, Long entityId, Audit.OP op, String owner) {

Audit audit = new Audit();

audit.setEntityName(entityName);

audit.setEntityId(entityId);

audit.setOpName(op.name());

audit.setDataChangeCreatedBy(owner);

auditRepository.save(audit);

}

@Transactional

void audit(Audit audit) {

auditRepository.save(audit);

}

}

4. AuditRepository

com.ctrip.framework.apollo.biz.repository.AuditRepository ，继承 org.springframework.data.repository.PagingAndSortingRepository 接口，提供 Audit 的数据访问 给 Admin Service 和 Config Service 。代码如下：

public interface AuditRepository extends PagingAndSortingRepository {

@Query("SELECT a from Audit a WHERE a.dataChangeCreatedBy = :owner")

List findByOwner(@Param("owner") String owner);

@Query("SELECT a from Audit a WHERE a.dataChangeCreatedBy = :owner AND a.entityName =:entity AND a.opName = :op")

List findAudits(@Param("owner") String owner, @Param("entity") String entity, @Param("op") String op);

}

666. 彩蛋

水更一小篇，美滋滋。