來源:北大青鳥總部 2023年03月03日 14:08
伴隨著微服務的如此火爆的趨勢,SpringBoot逐漸成為了目前Java開發(fā)領域的必備技能,如果不會點SpringBoot感覺都沒臉在這個程序猿的森林里混。所以在掌握SpringBoot已經成為了大家的共識,同時SpringBoot和其他的無縫集成也成了程序員的必備技能,比如:MyBatis、Redis等......
SpringBoot作為Spring家族的明星產品,一出世就受到了廣泛的關注。Spring作為這座森林里的"森林之王",除了自家的技術給予了無縫的鏈接的支持,對于其他優(yōu)秀的技術,也是抱著開放的態(tài)度,支持各種優(yōu)秀的開源技術主動向SpringBoot的靠攏,MyBatis就是其中之一。
我們都知道在使用SpringBoot的過程中,常用的持久化解決方案主要有兩種,一種是Mybatis框架,另一個就是SpringData JPA。
而 SpringData Jpa和MyBatis最大的區(qū)別就是SpringData Jpa是Spring親生的,這個從名字的命名方式上也能看出來,當然是因為它們是一家人了。
為什么這么說呢?如果大家用過Mybatis的話應該會發(fā)現,Mybatis依賴的artifactId是mybatis-spring-boot-starter,而接下來我們要講的SpringDataJPA依賴的artifactId卻是spring-boot-starter-data-jpa,從這個名字關鍵字(mybatis、jpa)的順序上,我們就能看出來誰才是親生的。
雖然不是親生的,但是Mybatis憑借自己輕巧靈活的身姿(易上手、動態(tài)SQL等),贏得了廣大開發(fā)者的喜愛,大有奪嫡的之勢。
所以這篇文章咱么就來聊聊SpringBoot整合MyBatis的技術細節(jié)。
常言道,兵馬未動,糧草先行;沒有穩(wěn)重的大后方,前線的將士如何安心打仗,飯都沒了,即使打贏了也是會餓死的,所以在整合Mybatis之前呢,咱么還得先做一些準備工作,咱么首先使用SpringInitializer來構建SpringBoot的基礎工程,然后在此基礎上再進行整合Mybatis
創(chuàng)建數據庫
建數據庫表
通常情況下,建議數據庫名字以英文命名,數據庫的名字就叫kgc(課工場拼音首字母),字符集選擇utf8,排序規(guī)則選擇utf8generalci。字符集和排序規(guī)則也可以不選使用默認設置。設置完成之后點擊“確定”。
創(chuàng)建好數據庫之后,我們就要創(chuàng)建數據庫表,表名叫t_user,這張用戶表有三個屬性,分別是:
id 唯一標記
username 用戶名稱
age 年齡
并插入三條數據:
# 數據庫腳本文件 SET NAMES utf8mb4; -- ---------------------------- -- Table structure for t_user -- ---------------------------- DROP TABLE IF EXISTS `t_user`; CREATE TABLE `t_user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `username` varchar(255) NOT NULL, `age` varchar(255) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=13 DEFAULT CHARSET=utf8; # 插入數據 INSERT INTO `t_user`(username, age) VALUES ('張三', '18'); INSERT INTO `t_user`(username, age) VALUES ( '李四', '20'); INSERT INTO `t_user` (username, age) VALUES ('王五', '22'); |
做好準備工作之后,接下來最重要的就是要在pom.xml文件中添加數據庫驅動和數據庫連接池依賴。
添加MySQL驅動,這里如果不指定版本默認是8.0的版本,當然你也可以指定版本,8.0的版本這里有一問比較坑的問題:
MySQL數據庫默認使用的是美國的時區(qū),而我們連接的時候用的是中國的北京時間,然后比美國晚上8個小時,所以當我們在連接數據庫的時候要設置一下時區(qū)為東八區(qū)ServerTimezone=UTC
驅動類
MySQL5.x的版本使用的驅動類是com.mysql.jdbc.Driver
MySQL8.x的版本使用的驅動類是com.mysql.cj.jdbc.Driver
所以這兩個問題需要大家去注意一下,以免出現莫名其妙的bug
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> |
接著,添加數據庫連接池,這里咱們使用最火的阿里開源的Druid。
Druid首先是一個數據庫連接池。Druid是目前最好的數據庫連接池,在功能、性能、擴展性方面,都超過其他數據庫連接池,包括DBCP、C3P0、BoneCP、Proxool、JBossDataSource。Druid已經在阿里巴巴部署了超過600個應用,經過一年多生產環(huán)境大規(guī)模部署的嚴苛考驗。Druid是阿里巴巴開發(fā)的號稱為監(jiān)控而生的數據庫連接池!
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.1.9</version> </dependency> |
添加Mybatis的依賴,我們使用最新的版本2.0.1
番外篇:
如果大家細心的話可能會發(fā)現,通常我們在集成一些SpringBoot提供支持的技術的時候,所添加的依賴都是以spring-boot-starter開頭,格式:spring-boot-starter-xxx;但是剛才我們添加的Mybatis的依賴卻是mybatis-spring-boot-starter,是以mybatis開頭的,這個能其實是SpringBoot默認是不支持mybatis的,它默認支持的是它自己生態(tài)內的持久層框架JPA,由于SpringBoot是大勢所趨,所以mybatis就主動去迎合SpringBoot生態(tài),自己開發(fā)了mybatis的stater。以后大家凡是看到xxx-spring-boot-starter的依賴,都是SpringBoot沒有主動提供支持的技術。
<dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.0.1</version> </dependency> |
在pojo包下創(chuàng)建User對象,并實現序列化接口Serializable
public class User implements Serializable{ private Integer id; //用戶id private String username; //用戶名 private Integer age; //年齡 // 省略 setter、getter方法 } |
在application.properties屬性配置文件中配置數據源和mybatis相關配置
# 端口號 server.port=8080 # mapper xml 文件地址 mybatis.mapper-locations=classpath*:mapper/*Mapper.xml # 數據庫url spring.datasource.url=jdbc:mysql://localhost:3306/kgc?characterEncoding=utf8&serverTimezone=UTC # 數據庫用戶名 spring.datasource.username=root # 數據庫密碼 spring.datasource.password=root # 數據庫驅動 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver |
在mapper包下創(chuàng)建UserMapper接口,并在接口中定義各一個方法
并在resource包下創(chuàng)建依次創(chuàng)建com/example/demo/mapper/UserMapper.xml
這里要注意的是接口名稱要和映射文件的名稱一致
在測試之前我還需要在SpringBoot的主啟動類上加上一段注解配置@MapperScan,這個注解的意思是掃描我們com.example.demo.mapper包下的mapper接口并創(chuàng)建代理對象。
@SpringBootApplication @MapperScan(basePackages = {"com.example.demo.mapper"}) public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } } |
然后在我們的controller中寫一個測試的方法,可以直接使用@Autowired注解注入UserMapper,有同學可能會有這樣的疑問?接口是不能創(chuàng)建對象怎么能注入呢,因為在SpringBoot啟動的時候,會創(chuàng)建UserMapper的代理對象,所以實際上我們注入的是代理對象,這個跟咱么上一步說加@MapperScan正好可以對應上的。
@RestController public class DemoController { @Autowired private UserMappper userMappper; /** * 查詢所有用戶信息 */ @GetMapping("/hello") public List<User> hello() { List<User> users = userMappper.selectUserList(); return users; } } |
然后在瀏覽器地址欄輸入http://localhost:8080/hello,就可以看到瀏覽器已經查詢出來數據,這些數據和我們插入數據的數據是一樣的。這就說明我們SpringBoot集成Mybatis成功跑通了,是不是很簡單呢?
在實際的開發(fā)過程中,SpringBoot和MyBatis的整合也是這么簡單。如果你認真看完這篇文章,那么恭喜你又掌握了一新技能!