test and doc

mybatis-plus-annotation/src/main/java/com/baomidou/mybatisplus/annotation/Version.java

@@ -19,6 +19,15 @@ import java.lang.annotation.*;
 
 /**
  * 乐观锁注解、标记 @Verison 在字段上
+ * <p>
+ * 支持的字段类型:
+ * long,
+ * Long,
+ * int,
+ * Integer,
+ * java.util.Date,
+ * java.sql.Timestamp,
+ * java.time.LocalDateTime
  *
  * @author TaoYu
  * @since 2016-01-23

mybatis-plus/src/test/java/com/baomidou/mybatisplus/test/version/Entity.java

@@ -0,0 +1,24 @@
+package com.baomidou.mybatisplus.test.version;
+
+import com.baomidou.mybatisplus.annotation.Version;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.io.Serializable;
+
+/**
+ * @author miemie
+ * @since 2020-06-23
+ */
+@Data
+@Accessors(chain = true)
+public class Entity implements Serializable {
+    private static final long serialVersionUID = 6962439201546719734L;
+
+    private Long id;
+
+    private String name;
+
+    @Version
+    private Integer version;
+}

mybatis-plus/src/test/java/com/baomidou/mybatisplus/test/version/EntityMapper.java

@@ -0,0 +1,10 @@
+package com.baomidou.mybatisplus.test.version;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+
+/**
+ * @author miemie
+ * @since 2020-06-23
+ */
+public interface EntityMapper extends BaseMapper<Entity> {
+}

mybatis-plus/src/test/java/com/baomidou/mybatisplus/test/version/VersionTest.java

@@ -0,0 +1,81 @@
+package com.baomidou.mybatisplus.test.version;
+
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
+import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;
+import com.baomidou.mybatisplus.test.BaseDbTest;
+import org.apache.ibatis.plugin.Interceptor;
+import org.junit.jupiter.api.Test;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+/**
+ * @author miemie
+ * @since 2020-07-04
+ */
+public class VersionTest extends BaseDbTest<EntityMapper> {
+
+    @Test
+    void test() {
+        doTestAutoCommit(i -> {
+            int result = i.updateById(new Entity().setId(1L).setName("老张"));
+            assertThat(result).as("没放入version值更新成功").isEqualTo(1);
+        });
+
+        doTestAutoCommit(i -> {
+            int result = i.updateById(new Entity().setId(1L).setName("老张").setVersion(1));
+            assertThat(result).as("放入的version值不匹配更新失败").isEqualTo(0);
+        });
+
+        doTestAutoCommit(i -> {
+            Entity entity = new Entity().setId(1L).setName("老张").setVersion(0);
+            int result = i.updateById(entity);
+            assertThat(result).as("放入的version值匹配更新成功").isEqualTo(1);
+            assertThat(entity.getVersion()).isEqualTo(1);
+        });
+
+        doTestAutoCommit(i -> {
+            int result = i.update(new Entity().setName("老张"), Wrappers.<Entity>update().eq("id", 2));
+            assertThat(result).as("没放入version值更新成功").isEqualTo(1);
+        });
+
+        doTestAutoCommit(i -> {
+            int result = i.update(new Entity().setName("老张").setVersion(1), Wrappers.<Entity>update().eq("id", 2));
+            assertThat(result).as("放入的version值不匹配更新失败").isEqualTo(0);
+        });
+
+        doTestAutoCommit(i -> {
+            Entity entity = new Entity().setName("老张").setVersion(0);
+            int result = i.update(entity, Wrappers.<Entity>update().eq("id", 2));
+            assertThat(result).as("放入的version值匹配更新成功").isEqualTo(1);
+            assertThat(entity.getVersion()).isEqualTo(1);
+        });
+    }
+
+    @Override
+    protected List<Interceptor> interceptors() {
+        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
+        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
+        return Collections.singletonList(interceptor);
+    }
+
+    @Override
+    protected String tableDataSql() {
+        return "insert into entity(id,name) values(1,'老王'),(2,'老李')";
+    }
+
+    @Override
+    protected List<String> tableSql() {
+        return Arrays.asList("drop table if exists entity",
+            "CREATE TABLE IF NOT EXISTS entity (\n" +
+                "id BIGINT(20) NOT NULL,\n" +
+                "name VARCHAR(30) NULL DEFAULT NULL,\n" +
+                "version integer NOT NULL DEFAULT 0,\n" +
+                "PRIMARY KEY (id)" +
+                ")");
+    }
+}