# auditlog-oracle

**Repository Path**: tangyan123456/auditlog

## Basic Information

- **Project Name**: auditlog-oracle
- **Description**: 监控mapper的各种增删改查操作，日志审计插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2020-08-17
- **Last Updated**: 2024-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Auditlog-Oracle (mapper数据修改监控插件)
<br/>
Auditlog-Oracle参考了https://gitee.com/lopssh/Mybatis-Auditlog-Plugin?_from=gitee_search基础上方做了Oracle版本。

Auditlog-Oracle 数据修改日志插件对各种mapper的增删改进行监控，且仅需升级最新版本的Druid库并作少量更改即可支持大部分的数据库（目前版本支持ORACLE）。

本插件通过拦截器记录Mybatis下所有Mapper类在进行增删改动作时所影响数据的 oldValue（修改前，插入前，删除前），newValue（修改后，插入后，删除后），并将此类数据日志插入到`audit_log`数据审计表中，方便运维人员进行数据复原。


#### 使用说明

完成如下两个步骤后，当启动基于mybatis的项目时，将会自动建立数据监控表，监控并记录所有由mapper引起的数据变动。

pom.xml引入
```
 	<dependency>
			<groupId>com.htffund</groupId>
			<artifactId>auditlog</artifactId>
			<version>1.0.0</version>
		</dependency>
```

mybatis-config.xml加入

```

	<plugins>
        <plugin interceptor="com.htffund.auditlog.interceptor.SQLAuditLogInterceptor">
            <!-- 默认日志表名 --> 
            <property name="defaultTableName" value="audit_log"/>
            <!-- 过滤不拦截的表 --> 
            <property name="excludeTables" value="sys_oper_log,sys_logininfor,sys_user_online"/> 
             <!-- 指定用于获取当前登录用户ID的方法，#号之前是类的全限定名称，#号之后是静态方法的名称，返回int类型，如不需要记录用户ID可删除此配置项 -->  
            <property name="clerkIdMethod" value="com.test.utils.ClerkIdGetter#current"/>
        </plugin>
    </plugins>
```


#### 测试示例

![输入图片说明](https://images.gitee.com/uploads/images/2018/0820/202016_5ae56bc5_1478767.png "屏幕截图.png")

#### 数据审计记录表（audit_log）的字段介绍
```
> ID -- 本记录ID----使用了SEQ_AUDIT_LOG
> TableName -- 记录下的表名
> ColumnName -- 记录下的列名
> PrimaryKey -- 记录下的主键名
> ParentID -- 父记录ID （例如：insert、delete、update语句 从第二个字段开始 会以第一个字段在本表的ID作为ParentID，以便于SQL分组）
> NewValue -- 该字段的新值
> OldValue -- 该字段的旧值
> Operation -- 记录下的动作（目前有：update、insert、delete）
> CreateTime -- 记录的创建时间
> CreateClerk -- 操作人员ID（本例子默认为 -1）




#### TODO
1、mysql版本已经做好了，待合并成mysql、oracle兼容版本
2、目前没有做分表的打算，后续可以加上这个功能
3、update触发后的数据可以不用查数据库了，直接获取到修改的对象，待后面完善