转载:
mybatis-plus入门使用、踩坑记录 - 灰信网(软件开发博客聚合)
首先引入MYBATIS-PLUS依赖:
SPRING BOOT项目:
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.2.0</version>
</dependency>
SPRING MVC项目:
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus</artifactId>
<version>3.2.0</version>
</dependency>
配置:
SPRING BOOT 工程:
@MapperScan("com.xxx.mapper")
SPRING MVC 工程:
-
配置 MapperScan
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.baomidou.mybatisplus.samples.quickstart.mapper"/> </bean> -
调整 SqlSessionFactory 为 MyBatis-Plus 的 SqlSessionFactory
<bean id="sqlSessionFactory" class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> </bean>
引入:EXTENDS BASEMAPPER<T>
还有扩展的server方法及实现,可以自己点进去看下
需要用到就对应service继承即可, 示例:
public interface UserService extends BaseService<User> {
}
public class UserServiceImpl extends BaseServiceImpl<UserMapper, User> implements UserService {
}
坑一:出现 INVALID BOUND STATEMENT (NOT FOUND)
异常
- 未去除原有mybatis-spring-boot-starter依赖,导致冲突
- mapper文件夹未扫描到,加入@MapperScan
坑二:CAUSED BY: JAVA.SQL.SQLINTEGRITYCONSTRAINTVIOLATIONEXCEPTION: COLUMN 'XXX' CANNOT BE NULL
这个问题很明显是字段不能是空,必须使用selective方法进行插入。一开始怀疑mybatis-plus的插入语句(就只一个insert)是全量插入
后来查找mapper文件找到了问题所在。之前用的mybatis框架自动生成的mapper.xml代码中的insert语句为全量插入,本地写了同名的xml会优先使用本地的SQL进行查询。
解决:删除所有mybatis生成的SQL语句,避免与mybatis-plus的底层SQL冲突
坑三:主键随机自增,导致ID超范围问题 COULD NOT SET PROPERTY 'ID' OF 'CLASS COM.XXX.USER' WITH VALUE '1037678924715731598' CAUSE: JAVA.LANG.ILLEGALARGUMENTEXCEPTION: ARGUMENT TYPE MISMATCH
如果没有指定ID生成策略,mybatis-plus默认是使用自己随机的ID生成策略,会生成一个比较大的数,可能会大小溢出。
解决:在实体类ID字段上加上注解 @TableId(type = IdType.AUTO),使用数据库的自增策略。 如果自增主键很多都是id,可以写一个基础的BasePO,在这个类里面指定id的生成策略,其它表对应实体类继承即可,如下:
public class BasePO {
@TableId(type= IdType.AUTO)
private Long id;
}
下面是IdType其它类型介绍
坑四:关键字冲突问题 CAUSE: JAVA.SQL.SQLSYNTAXERROREXCEPTION: YOU HAVE AN ERROR IN YOUR SQL SYNTAX; CHECK THE MANUAL THAT CORRESPONDS TO YOUR MYSQL SERVER VERSION FOR THE RIGHT SYNTAX TO USE NEAR 'ORDER WHERE ID=1
当你的数据库表名是order、group等之类的关键字时,对该表的操作则会报错.
解决:在表对应的实体上增加注解 @TableName("`order`"),使用``指定表名即可