前言
这次的项目,使用spring boot 多模块开发。其中,数据库集成了data Jpa 和 Mybatis。最先引入的data jpa,但是后面涉及到多表关联多条件查询的时候,就显得很麻烦。然后就把mybatis也引入了进来。
这里重点记录一下如何使用通用mapper逆向生成代码。提高我们的工作效率。
环境
开发工具:IntelliJ IDEA 2018
项目框架: 基于Spring Boot + mysql + mybatis + data jpa
最后的项目结构
简单说一下:因为后台管理系统cms和接口系统web都共用同一个mapper,所以提出来了。
Spring boot 引入Mybatis
这里如何引入mybtais,我就不记录了,网上教程很多~
application.yml
# mybatis
mybatis:
mapper-locations: classpath*:com/flk/mapper/**/*.xml # mapper.xml文件所在位置
# config-location: classpath:config/mybatis_config.xml
type-aliases-package: com.flk.* #对应实体类的包名
configuration:
map-underscore-to-camel-case: true #配置驼峰命名转换 在进行sql查询和初始化实体时mybatis会为我们自动转化
# log-impl: org.apache.ibatis.logging.stdout.StdOutImpl #mybatis 控制台打印sql
mybatis自动生成dao,entity,mapper
1.传统的生成方式
ps:这种方法生成的dao层,没有继承通用mapper。
用过的小伙伴应该都会发现,当你数据库某张表突然要加一个字段的时候,就会变得特别麻烦。首先你得去修改实体,然后修改mapper,mapper对应的xml里面自带的增删改查等方法都需要修改,很麻烦。如果需要修改的表字段比较多~~啧啧啧。反正我觉得不是很好用。
2.tk.mybatis.mapper方式生成(通用mapper)
2.1 pom.xml中添加引用
需要添加两个引用mapper-spring-boot-starter
和 tk.mybatis
<dependencies>
<dependency>
<groupId>com.flk</groupId>
<artifactId>flk-mapper</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<!-- mybatis generator自动生成代码 -->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.5</version>
<dependencies>
<dependency>
<groupId> mysql</groupId>
<artifactId> mysql-connector-java</artifactId>
<version>5.1.39</version>
</dependency>
<dependency>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-core</artifactId>
<version>1.3.5</version>
</dependency>
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper</artifactId>
<version>3.5.2</version>
</dependency>
</dependencies>
<executions>
<execution>
<id>Generate MyBatis Artifacts</id>
<phase>package</phase>
<goals>
<goal>generate</goal>
</goals>
</execution>
</executions>
<configuration>
<!--允许移动生成的文件 -->
<verbose>true</verbose>
<!-- 是否覆盖 -->
<overwrite>true</overwrite>
<!-- 自动生成的配置 -->
<configurationFile>
src/main/resources/mybatis-generator.xml</configurationFile>
</configuration>
</plugin>
</plugins>
</build>
2.2 编写mybatis-generator.xml
这里,你需要修改配置文件中的数据库连接等配置targetProject
这个修改为你自己项目所在目录的绝对路径!
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<!--数据库驱动jar -->
<!--<classPathEntry-->
<!--location="C:\Users\Administrator\.m2\repository\mysql\mysql-connector-java\5.1.45" />-->
<context id="Tables" targetRuntime="MyBatis3">
<!--去除注释 -->
<!--<commentGenerator>
<property name="suppressAllComments" value="true" />
</commentGenerator>-->
<plugin type="tk.mybatis.mapper.generator.MapperPlugin">
<property name="mappers" value="tk.mybatis.mapper.common.Mapper"/>
<!-- caseSensitive默认false,当数据库表名区分大小写时,可以将该属性设置为true -->
<property name="caseSensitive" value="true"/>
</plugin>
<!--数据库连接 -->
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
connectionURL="jdbc:mysql://127.0.0.1:3306/flk_qa" userId="root"
password="123456">
</jdbcConnection>
<!--默认false Java type resolver will always use java.math.BigDecimal if
the database column is of type DECIMAL or NUMERIC. -->
<javaTypeResolver>
<property name="forceBigDecimals" value="false" />
</javaTypeResolver>
<!--生成实体类 指定包名 以及生成的地址 (可以自定义地址,但是路径不存在不会自动创建 使用Maven生成在target目录下,会自动创建) -->
<javaModelGenerator targetPackage="com.flk.mybatis.user"
targetProject="D:\work\git\flk\flk-entity\src\main\java">
<property name="enableSubPackages" value="true" />
<property name="trimStrings" value="true" />
</javaModelGenerator>
<!--生成SQLMAP文件 -->
<sqlMapGenerator targetPackage="com.flk.mapper.user"
targetProject="D:\work\git\flk\flk-mapper\src\main\java">
<property name="enableSubPackages" value="false" />
</sqlMapGenerator>
<!--生成Dao文件 可以配置 type="XMLMAPPER"生成xml的dao实现 context id="DB2Tables" 修改targetRuntime="MyBatis3" -->
<javaClientGenerator type="XMLMAPPER"
targetPackage="com.flk.mapper.user"
targetProject="D:\work\git\flk\flk-mapper\src\main\java">
<property name="enableSubPackages" value="false" />
</javaClientGenerator>
<!--对应数据库表 mysql可以加入主键自增 字段命名 忽略某字段等 -->
<table tableName="flk_user" domainObjectName="FlkUser" enableCountByExample="false" enableUpdateByExample="false" enableDeleteByExample="false" enableSelectByExample="false" selectByExampleQueryId="false" />
</context>
</generatorConfiguration>
2.3 生成代码
idea:找到项目下面的这个窗口,双击mybatis-generator,即可自动生成代码
eclipse:以application的方式运行就可以了
2.4 查看控制台打印
生成文件ok!
生成文件如下:
FlkNewsMapper.java:
import tk.mybatis.mapper.common.Mapper;
public interface FlkNewsMapper extends Mapper<FlkNews> {
}
FlkNewsMapper.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.flk.mapper.news.FlkCoverMapper">
<resultMap id="BaseResultMap" type="com.flk.mybatis.news.FlkCover">
<!--
WARNING - @mbg.generated
-->
<id column="cover_id" jdbcType="INTEGER" property="coverId" />
<result column="name" jdbcType="VARCHAR" property="name" />
<result column="template" jdbcType="VARCHAR" property="template" />
<result column="platform" jdbcType="VARCHAR" property="platform" />
<result column="mark" jdbcType="VARCHAR" property="mark" />
<result column="create_time" jdbcType="TIMESTAMP" property="createTime" />
<result column="is_delete" jdbcType="INTEGER" property="isDelete" />
<result column="update_time" jdbcType="TIMESTAMP" property="updateTime" />
</resultMap>
<sql id="Base_Column_List">
<!--
WARNING - @mbg.generated
-->
cover_id, name, template, platform, mark, create_time, is_delete, update_time
</sql>
</mapper>
总结
1.使用tk.mybatis.mapper生成的mapper,在扫描的时候,需要用tk的这个实体tk.mybatis.spring.annotation.MapperScan
来扫描,不然项目启动的时候,会报mapper找不到的错。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.scheduling.annotation.EnableScheduling;
import tk.mybatis.spring.annotation.MapperScan;
@SpringBootApplication
@MapperScan("com.flk.mapper.*")
@EntityScan(basePackages = {"com.flk.jpa"})
@EnableScheduling
public class CmsApplication {
public static void main(String[] args) {
SpringApplication.run(CmsApplication.class, args);
}
}
2.data jpa 和 mybatis共用问题
结果是可以共用,同时jpa的pageable分页和mybatis的pageHelper分页都是可以同时用的。我在配引入mybatis的时候,引入了一个mybatis的配置文件,里面配了一个pageHelper,导致在使用pageHelper分页的时候,报下面这个错。
系统中发现了多个分页插件????????
最开始我和同事都一直认为是因为我们同时集成了jpa和mybatis的原因,不能同时使用pageable和pageHelper两个分页插件。
后面得出的结果是可以同时使用这两个分页插件的。
这个错误是因为:
pom中引入pageHelper,如果你引入的依赖是spring boot 自己的starter – pagehelper-spring-boot-starter
。
yml文件中不需要任何配置。直接使用就可以了。
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.2.9</version>
</dependency>
而我,引入的spring boot 自己的starter – pagehelper-spring-boot-starter
。还在yml中自己有配置了一个pageHelper。当使用pageHelper进行分页的时候,就报了分页插件冲突这个错。我猜大概是存在两个分页拦截器,当你分页的时候,程序不知道去使用哪一个进行拦截并分页。去掉yml关于pageHelper的相关配置就好了。
所以,当你使用spring boot集成某个组件的时候,百度搜索,最好是带上spring boot
这个关键字。不然就会出现这种奇奇怪怪的问题。改起来还很花时间。