dynamic-add-date

一款基于MyBatis框架,可以对插入和更新Sql语句动态地添加日期列和对应值的插件

License

License

GroupId

GroupId

io.github.yidasanqian
ArtifactId

ArtifactId

dynamic-add-date
Last Version

Last Version

1.1.0
Release Date

Release Date

Type

Type

jar
Description

Description

dynamic-add-date
一款基于MyBatis框架,可以对插入和更新Sql语句动态地添加日期列和对应值的插件
Project URL

Project URL

https://github.com/yidasanqian/dynamic-add-date
Source Code Management

Source Code Management

https://github.com/yidasanqian/dynamic-add-date/tree/master

Download dynamic-add-date

How to add to project

<!-- https://jarcasting.com/artifacts/io.github.yidasanqian/dynamic-add-date/ -->
<dependency>
    <groupId>io.github.yidasanqian</groupId>
    <artifactId>dynamic-add-date</artifactId>
    <version>1.1.0</version>
</dependency>
// https://jarcasting.com/artifacts/io.github.yidasanqian/dynamic-add-date/
implementation 'io.github.yidasanqian:dynamic-add-date:1.1.0'
// https://jarcasting.com/artifacts/io.github.yidasanqian/dynamic-add-date/
implementation ("io.github.yidasanqian:dynamic-add-date:1.1.0")
'io.github.yidasanqian:dynamic-add-date:jar:1.1.0'
<dependency org="io.github.yidasanqian" name="dynamic-add-date" rev="1.1.0">
  <artifact name="dynamic-add-date" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.github.yidasanqian', module='dynamic-add-date', version='1.1.0')
)
libraryDependencies += "io.github.yidasanqian" % "dynamic-add-date" % "1.1.0"
[io.github.yidasanqian/dynamic-add-date "1.1.0"]

Dependencies

compile (4)

Group / Artifact Type Version
com.github.jsqlparser : jsqlparser jar 2.1
org.mybatis : mybatis Optional jar 3.5.1
org.slf4j : slf4j-api Optional jar 1.7.26
org.slf4j : log4j-over-slf4j Optional jar 1.7.26

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

dynamic-add-date

Build Status Maven Central

Dynamic-add-date是基于Mybatis插件原理开发的可以动态在InsertUpdate Sql语句中添加日期列和对应的值的插件。

可以解决MySQL 5.6.5之前的版本对自动初始化时间戳的限制:

  • DATETIME列不支持DEFAULT CURRENT_TIMESTAMPON UPDATE CURRENT_TIMESTAMP
  • DEFAULT CURRENT_TIMESTAMPON UPDATE CURRENT_TIMESTAMP每张表最多可以使用在一个TIMESTAMP列上而且不能和另一个TIMESTAMP列一起使用。

要求

  • 支持jdk7及之后的版本
  • MySql

功能

  • 自定义要生成的日期列的名称
  • 自动处理原始Sql语句中已包含自定义日期列名
  • 支持插入、更新、批量插入和批量更新Sql语句日期列的生成
  • 支持INSERT INTO SELECT语句
  • 支持忽略表,表名支持正则表达式

在你的应用中添加Dynamic-add-date

添加下面的依赖到你的pom文件中:

<dependency>
    <groupId>io.github.yidasanqian</groupId>
    <artifactId>dynamic-add-date</artifactId>
    <version>1.1.0</version>
</dependency>

若使用Gradle/Grails:

compile 'io.github.yidasanqian:dynamic-add-date:1.1.0'

然后在mybatis-config.xml配置文件中加入如下设置即可:

<plugins>
        <plugin interceptor="io.github.yidasanqian.dynamicadddate.AddDateInterceptor">
        </plugin>
</plugins>

例如,原始Sql为:

insert into user(name, profession) values(?, ?)

使用该插件后Sql语句为:

insert into user(name, profession, gmt_create, gmt_modified) values(?, ?, '2017-10-15 10:10:10', '2017-10-15 10:10:10')

批量插入的情况:

insert into user(name, profession) values(?, ?), (?, ?), (?, ?)

使用该插件后Sql语句为:

insert into user(name, profession, gmt_create, gmt_modified) values(?, ?, '2017-10-15 10:10:10', '2017-10-15 10:10:10'),
(?, ?, '2017-10-15 10:10:10', '2017-10-15 10:10:10'), (?, ?, '2017-10-15 10:10:10', '2017-10-15 10:10:10')

支持INSERT INTO SELECT语句

原始sql:

insert into t_user(username, mobile, create_at)
       select r.`name`, ?, r.create_at from t_role r;

使用该插件后Sql语句为:

INSERT INTO t_user (username, mobile, create_at, update_at) SELECT r.`name`, ?, '2019-07-06 10:36:51.066', '2019-07-06 10:36:51.066' FROM t_role r

默认新建日期的列名为 gmt_create, 更新日期的列名为 gmt_modified

可以通过设置key createDateColumnNameupdateDateColumnName来分别指定日期列的名称:

<plugin interceptor="io.github.yidasanqian.dynamicadddate.AddDateInterceptor">
    <property name="createDateColumnName" value="gmt_create"/>
    <property name="updateDateColumnName" value="gmt_modified"/>
</plugin>

与Spring Boot集成

首先mybatis依赖

<!-- https://mvnrepository.com/artifact/org.mybatis.spring.boot/mybatis-spring-boot-starter -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.4</version>
</dependency>

其次写入自定义配置:

1)xml方式进行配置
也是在mybatis-config.xml配置文件中加入如下设置:

 <plugin interceptor="io.github.yidasanqian.dynamicadddate.AddDateInterceptor">
     <property name="createDateColumnName" value="gmt_create"/>
     <property name="updateDateColumnName" value="gmt_modified"/>
 </plugin>

然后在 application.properties加入如下配置即可:

mybatis.config-location=classpath:mybatis-config.xml

2)创建bean方式进行配置

@Bean
public AddDateInterceptor addDateInterceptor(){
    Properties properties = new Properties();
    properties.setProperty("createDateColumnName","gmt_create");
    properties.setProperty("updateDateColumnName","gmt_modified");
    AddDateInterceptor addDateInterceptor = new AddDateInterceptor();
    addDateInterceptor.setProperties(properties);
    return addDateInterceptor;
}

忽略表

实际应用中并不是所有的表都需要创建时间和更新时间字段,如何设置忽略处理的表呢?

1)xml方式
也是在mybatis-config.xml配置文件中加入如下设置:

<plugins>
    <plugin interceptor="io.github.yidasanqian.dynamicadddate.AddDateInterceptor">
        <property name="ignoreTables" value="^user.*,permission"/>
    </plugin>
</plugins>

2)创建Bean方式

@Bean
public AddDateInterceptor addDateInterceptor(){
    Properties properties = new Properties();
    properties.setProperty("createDateColumnName","gmt_create");
    properties.setProperty("updateDateColumnName","gmt_modified");
    properties.setProperty("ignoreTables","^user.*,permission");
    AddDateInterceptor addDateInterceptor = new AddDateInterceptor();
    addDateInterceptor.setProperties(properties);
    return addDateInterceptor;
}

其中name=ignoreTables属性值为固定,不能变,value的格式:表名,表名

其中value的值为表名,支持正则表达式,且多个表名以英文逗号,分隔并且之间不含空格。

Versions

Version
1.1.0
1.0.4
1.0.3
1.0.2
1.0.1Beta
1.0.0Beta