整合 MyBatis 的初步剖析
概述
Mybatis 是一个优良的长久层框架,底层基于 JDBC 实现与数据库的交互。并在 JDBC 操作的根底上做了封装和优化,它借助灵便的 SQL 定制,参数及后果集的映射形式,更好的适应了以后互联网技术的倒退。Mybatis 框架的简略利用架构如图所示:
在当今的互联网利用中我的项目,mybatis 框架通常会由 spring 框架进行资源整合,作为数据层技术实现数据交互操作。
筹备工作
第一步: 创立我的项目 module, 例如:
第二步: 增加依赖
mysql 驱动依赖
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
spring jdbc 依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jdbc</artifactId>
</dependency>
mybatis starter 依赖
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.1</version>
</dependency>
第二步:application.properties 配置文件中增加繁难配置
连接池配置
spring.datasource.url=jdbc:mysql:///dbgoods?serverTimezone=GMT%2B8&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=root
mybatis 配置
mybatis.mapper-locations=classpath:/mapper/*/*.xml
环境测试代码实现
在 src/test/java 目录中增加测试类,对 mybatis 框架整合进行根本测试,代码如下:
package com.cy.pj.goods.dao;
import java.sql.Connection;
import org.apache.ibatis.session.SqlSession;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
public class MyBatisTests {
@Autowired
private SqlSession sqlSession;
@Test
public void testGetConnection() {Connection conn=sqlSession.getConnection();
System.out.println("connection="+conn);
}
}
在 SpringBoot 脚手架工程中,Spring 框架会基于 MyBatis 框架底层配置,创立 SqlSessionFactory 对象,而后再通过此工厂对象创立 SqlSession,最初基于 Springku 框架为测试类注入 SqlSession 对象,接下来,咱们能够通过 SqlSession 对象实现与数据库的会话了。
整合 MyBatis 业务代码实现及原理剖析
业务形容
基于 SpringBoot 脚手架工程对 MyBatis 框架的整合,实现对商品库中商品数据的查问业务。
API 架构设计
业务时序图剖析
业务代码设计及实现
第一步: 定义商品模块 POJO 对象类型 (基于此对象存储商品数据), 代码如下:
package com.cy.pj.goods.pojo;
import java.util.Date;
/** 用于存储商品信息的 pojo 对象 */
public class Goods {
private Long id;
private String name;
private String remark;
private Date createdTime;
public Long getId() {return id;}
public void setId(Long id) {this.id = id;}
public String getName() {return name;}
public void setName(String name) {this.name = name;}
public String getRemark() {return remark;}
public void setRemark(String remark) {this.remark = remark;}
public Date getCreatedTime() {return createdTime;}
public void setCreatedTime(Date createdTime) {this.createdTime = createdTime;}
}
第二步: 定义商品模块长久层对象 GoodsDao 接口及办法映射, 代码如下
GoodsDao 接口及办法定义
package com.cy.pj.goods.dao;
import com.cy.pj.goods.pojo.Goods;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
/** 商品模块长久层对象, 基于此对象的实现类操作商品库中的数据
* @Mapper MyBatis 框架中定义, 用于形容长久层接口, 通知 mybatis
* 这个接口的实现类由 mybatis 创立, 并且交给 spring 框架治理.
* */
@Mapper
public interface GoodsDao {List<Goods> findGoods();
}
GoodsDao 接口映射文件及 SQL 映射定义
<?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.cy.pj.goods.dao.GoodsDao">
<select id="findGoods" resultType="com.cy.pj.goods.pojo.Goods">
select * from tb_goods
</select>
</mapper>
测试代码的编写及运行
定义单元测试类, 对 GoodsDao 办法进行单元测试, 例如:
package com.cy.pj.goods.dao;
@SpringBootTest
public class GoodsDaoTests {
@Autowired
private GoodsDao goodsDao;
@Test
void testFindGoods(){List<Goods> list=goodsDao.findGoods();
for(Goods g:list){System.out.println(g);
}
}
}
测试运行,底层 API 剖析,如图所示:
测试运行过程中的 BUG 剖析
- idea 中 @autowired 注解谬误提醒配置, 如图:
- BindingException, 如图所示:
解决办法:次要看映射文件 xml 中的配置。
- 单元测试类地位谬误,如图所示:
解决办法:查看这个测试类是否在测试包或者子包中。
- 找不到对应的映射元素,如图所示:
解决办法:如果通过 sqlseaaion 对象的办法拜访数据库,要按 staement 的标准来写。
业务层记录 MyBatis 底层 SQL 会话时长
业务形容
当初有一个业务,须要记录数据长久层 api 办法调用时执行时长,如何实现?
要求:
1) 咱们不能间接将日志记录写到单元测试类中。
2) 咱们不能批改数据长久层实现类。
API 架构设计
基于日志记录业务进行 API 设计,如图所示:
业务时序图剖析
商品查问并进行日志记录,其运行时序剖析,如图所示:
业务代码设计及实现
第一步:定义 GoodsService 接口,代码如下:
package com.cy.pj.goods.service;
import com.cy.pj.goods.pojo.Goods;
import java.util.List;
public interface GoodsService {List<Goods> findGoods();
}
第二步:定义 GoodsServiceImpl 实现类并进行日志记录,代码如下:
package com.cy.pj.goods.service;
import com.cy.pj.goods.dao.GoodsDao;
import com.cy.pj.goods.pojo.Goods;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class GoodsServiceImpl implements GoodsService{
private static final Logger log=
LoggerFactory.getLogger(GoodsServiceImpl.class);
@Autowired
private GoodsDao goodsDao;
@Override
public List<Goods> findGoods() {long t1=System.currentTimeMillis();
List<Goods> list=goodsDao.findGoods();
long t2=System.currentTimeMillis();
log.info("findGoods()->t2-t1={}",t2-t1);// 日志输入
return list;
}
}
日志 API 利用剖析,如图所示:
留神:这里使用到了门面模式,具体设置形式如下:
测试代码的编写及运行
编写单元测试类 GoodsServiceTests,对 GoodsService 对象办法进行单元测试,例如:
package com.cy.pj.goods.service;
import com.cy.pj.goods.pojo.Goods;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.List;
@SpringBootTest
public class GoodsServiceTests {
@Autowired
private GoodsService goodsService;
@Test
void testFindGoods(){List<Goods> list=goodsService.findGoods();
for(Goods g:list){System.out.println(g);
}
}
}
测试运行过程中的 BUG 剖析
- NullPointerException,空指针异样如图所示:
解决办法:查看是否交给了 Spring 框架赋值和治理,如属性上是否有 @Autowired 注解和属性的类交给 spring 框架治理。
- NoSuchBeanDefinitionException, 没找到对应的 bean 配置信息如图所示:
解决办法:接口是否有对应的实现类,这个实现类是否交给了 spring 框架治理如 @Service 注解等。
总结 (Summary)
本大节次要是对 MyBatis 框架做了一个根本介绍,并且基于 springboot 工程做了 mybatis 框架的整合实现,重点把握其利用架构,代码构造,编写过程、运行过程以及在实现过程中的问题剖析和对应的解决方案。