Плагин Mybatis-Auditlog: мониторинг изменений данных в mapper

Плагин Mybatis-Auditlog предназначен для мониторинга изменений данных в различных mapper. Для его использования достаточно обновить библиотеку Druid до последней версии и внести небольшие изменения. Плагин поддерживает большинство баз данных, включая MySQL.

Этот плагин использует перехватчики для записи значений oldValue (до изменения, вставки или удаления) и newValue (после изменения, вставки или удаления). Эти данные затем записываются в таблицу аудита audit_log, что упрощает восстановление данных для администраторов.

Использование

Чтобы использовать плагин, выполните следующие шаги:

1. Добавьте зависимость в файл pom.xml:

     <dependency>
         <groupId>com.gitee.lopssh</groupId>
         <artifactId>mybatis-auditlog-plugin</artifactId>
         <version>1.0.0</version>
     </dependency>

2. Включите плагин в файле mybatis-config.xml:

<plugins>
    <plugin interceptor="com.gitee.lopssh.plugin.mybatis.auditlog.interceptor.SQLAuditLogInterceptor">
        <!-- 是否启用，默认值: true -->
        <property name="enable" value="true"/>
        <!-- 是否进行自动分表，默认值: true -->
        <property name="split" value="true"/>  
        <!-- 不分表时的表名，表不存在将会自动新建，默认值: audit_log -->
        <property name="defaultTableName" value="audit_log"/>  
        <!-- 分表时的表名前缀，每月自动新建一张，生成规则 前缀名+年月，默认值: audit_log_ -->
        <property name="preTableName" value="audit_log_"/>
        <!-- 指定用于获取当前登录用户ID的方法，#号之前是类的全限定名称，#号之后是静态方法的名称，返回int类型，如不需要记录用户ID可删除此配置项 -->  
        <property name="clerkIdMethod" value="com.test.utils.ClerkIdGetter#current"/>
    </plugin>
</plugins>

Пример тестирования

На рисунке представлен пример использования плагина.

Описание полей таблицы аудита (audit_log / audit_log_дата)

Таблица аудита содержит следующие поля:

• ID — идентификатор записи;
• TableName — имя таблицы;
• ColumnName — имя столбца;
• PrimaryKey — имя первичного ключа;
• ParentID — родительский идентификатор (например, для insert, delete, update);
• NewValue — новое значение поля;
• OldValue — старое значение поля;
• Operation — действие (update, insert, delete);
• CreateTime — время создания записи;
• CreateClerk — идентификатор пользователя (в данном примере -1).