SpringBoot + MybatisPlus 整合記錄
- 1. 硬件軟件基本信息
- 2. 相關鏈接
- 3. 通過idea快速生成一個Springboot項目
- 4. 啟動報錯問題解決
- 問題一:Springboot啟動的時候報錯提示 “沒有符合條件的Bean關于Mapper類型”
- 問題二:啟動的時候提示需要一個Bean,但是發現了兩個Bean
- 問題三:沒有找到對應的statement
1. 硬件軟件基本信息


2. 相關鏈接
JDK1.8.0_361下載地址
Maven-3.9.6 下載地址
Mybatis-Plus 官方文檔
3. 通過idea快速生成一個Springboot項目
大致快速生成springBoot項目的有兩種方法
方式一:使用maven生成
方式二:使用springBoot生成
我這里直接選用第二種,第一種可以 點擊鏈接 學習學習
注意事項:
如果想生成 JDK8 的項目但是下拉沒有這個版本:
那是因為 Spring2.X 版本在2023年11月24日停止維護了,因此創建 Spring 項目時不再有 2.X 版本的選項,只能從 3.1.X 版本開始選擇,而 Spring3.X 版本不支持 JDK8,JDK11,最低支持JDK17,因此 JDK11 也無法選擇了。
所以需要替換服務地址為阿里云的就可以了
初始地址Server URL:http://start.springboot.io/
替換地址Server URL:https://start.aliyun.com/
點擊下一步然后選擇需要初始化的依賴了,一般就spring web,lombok等等,其他的就基本上需要啥就自己添加上,一般還有mysql,mybatis,不過我們有mybatis-plus,就不需要mybatis的依賴了
最后點擊create就可以完成一個Springboot項目的創建了
目錄結構
這里我簡單的創建了Controller,Service,Mapper等目錄,結構如下
Controller 代碼如下
package com.fan.sd.demos.controller;import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.fan.sd.demos.VO.TestInfo;
import com.fan.sd.demos.service.ITestInfoService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping(value = "/testInfo")
public class TestInfoController {@Autowiredpublic ITestInfoService iTestInfoService;@PostMapping("getTestInfo")public TestInfo getTestInfo() {// 使用Wrapper進行快速查詢// LambdaQueryWrapper<TestInfo> queryWrapper = new LambdaQueryWrapper<>();// queryWrapper.eq(TestInfo::getId,"1");// return iTestInfoService.getOne(queryWrapper);return iTestInfoService.selectById1("1");}}
接口類信息如下
接口類要繼承 IService 類
package com.fan.sd.demos.service;import com.baomidou.mybatisplus.extension.service.IService;
import com.fan.sd.demos.VO.TestInfo;public interface ITestInfoService extends IService<TestInfo> {/*** 查詢測試信息*/TestInfo selectById1(String id);/*** 插入測試信息*/void insertTestInfo(TestInfo testInfo);/*** 刪除測試信息*/void deleteTestInfo(Long id);/*** 修改測試信息*/void updateTestInfo(TestInfo testInfo);
}
實現類信息如下
這里實現類要實現接口類,然后繼承Mybatis-Plus的 ServiceImpl 類
package com.fan.sd.demos.service.impl;import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.fan.sd.demos.VO.TestInfo;
import com.fan.sd.demos.mapper.TestInfoMapper;
import com.fan.sd.demos.service.ITestInfoService;
import org.springframework.stereotype.Service;@Service
public class TestInfoServiceImp extends ServiceImpl<TestInfoMapper, TestInfo> implements ITestInfoService {@Overridepublic TestInfo selectById1(String id) {return baseMapper.selectById1(id);}@Overridepublic void insertTestInfo(TestInfo testInfo) {baseMapper.insert(testInfo);}@Overridepublic void deleteTestInfo(Long id) {baseMapper.deleteById(id);}@Overridepublic void updateTestInfo(TestInfo testInfo) {baseMapper.updateById(testInfo);}
}
mapper類信息如下
繼承mybatisPlus的 BaseMapper 類就可以了
package com.fan.sd.demos.mapper;import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.fan.sd.demos.VO.TestInfo;public interface TestInfoMapper extends BaseMapper<TestInfo> {TestInfo selectById1(String id);}
mapper.xml代碼如下
注意一下 namespace 和 Id 就可以了,不過現在有MybatisCodeHelpPro插件,基本上沒有對應不上的
<?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.fan.sd.demos.mapper.TestInfoMapper"><select id="selectById1" resultType="com.fan.sd.demos.VO.TestInfo">select * from test_info_table where id = #{id}</select></mapper>
4. 啟動報錯問題解決
問題一:Springboot啟動的時候報錯提示 “沒有符合條件的Bean關于Mapper類型”
這是因為啟動的時候沒有掃描對應的 Mapper 文件,所以沒有生成對應的 bean 在 spring 容器中管理
我們只需要在啟動類上加上注解 @MaaperSacn(“路徑”)
問題二:啟動的時候提示需要一個Bean,但是發現了兩個Bean
我們進入Controller看看,鼠標移上去,很有意思的提示,@autowired找到兩個Bean,但是在整個項目中ITestInfoService是接口類,而TestInfoServiceImpl是其實現類,
這是由于MapperScan的路徑設置不當(屬于強行承上啟下了),將 MapperScan 的搜索范圍擴大了,導致項目下所有包的接口都創建了一個實現類,因此在使用 @Autowired 后,對Service層的依賴注入就會找到兩個Bean(一個Service接口本身,一個Service接口實現類)。
所以我們把Mapper掃描的配置路徑寫的顆粒度更細一點,就可以解決了
問題三:沒有找到對應的statement
剛剛通過配置 MapperScan 掃描,解決了 mapper 沒有生成bean在 Spring 容器中管理,現在成功啟動,但是調用 mapper 里面的方法的時候又報這個錯,網上檢查什么 namespace 啊,檢查 id 什么之類的,現在都是有插件幫我們檢查好了,什么不對應的一紅就知道了,所以這些也沒必要檢查。
這里主要的原因有兩個
第一個原因:
我放的xml的目錄位置問題,正常來說存放在 Resources/mapper/ *.xml 路徑下,但是我們的項目基本上都是多模塊項目,為了方便管理對應的 mapper 文件,我都是喜歡放在 mapper/xml/ *.xml 路徑下面。所以這里需要有個對應的配置,具體配置如下
# 服務端口
server:port: 8080
spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverusername: rootpassword: root123456url: jdbc:mysql://localhost:3306/SD_DB?useSSL=false&serverTimezone=Asia/Shanghai
mybatis-plus:# 指定 MyBatis Mapper 對應的 XML 文件位置mapper-locations: classpath*:com/fan/sd/demos/**/xml/*.xmlconfiguration:# 這個配置會將執行的sql打印出來,在開發或測試的時候可以用log-impl: org.apache.ibatis.logging.stdout.StdOutImpl# 返回類型為Map,顯示null對應的字段call-setters-on-nulls: truejdbc-type-for-null: 'null'
第二個原因:
可以查看一下生成的 target 文件目錄,然后會發現根本都沒有xml目錄以及對應的mapper.xml文件,那肯定會報這個問題的。
主要原因是我們啟動項目或者打包項目的時候,默認只會編譯src/main/java下面的class文件,對應的一些xml等靜態文件是不會打包編譯的,所以我們這里就需要在pom文件里面設置一下
具體配置信息如下,最后Maven刷新一下,就可以正常編譯了
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.fan</groupId><artifactId>SD</artifactId><version>0.0.1-SNAPSHOT</version><name>SD</name><description>SD</description><properties><java.version>1.8</java.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><spring-boot.version>2.6.13</spring-boot.version><djl.version>0.20.0</djl.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web-services</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><!-- 在 <dependencies> 區域內添加 --><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.5.6</version> <!-- 替換為最新版本 --></dependency><!-- druid數據庫連接池 --><dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-starter</artifactId><version>1.2.8</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.23</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>${spring-boot.version}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version><configuration><source>1.8</source><target>1.8</target><encoding>UTF-8</encoding></configuration></plugin><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version><configuration><mainClass>com.fan.sd.SdApplication</mainClass><skip>true</skip></configuration><executions><execution><id>repackage</id><goals><goal>repackage</goal></goals></execution></executions></plugin></plugins><!-- 項目打包時會將java目錄中的*.xml文件也進行打包 --><resources><resource><directory>src/main/resources</directory><filtering>false</filtering></resource><resource><directory>src/main/java</directory><includes><include>**/*.xml</include><include>**/*.json</include><include>**/*.ftl</include></includes><filtering>false</filtering></resource></resources></build>
</project>