Mybatis 小谈 (上篇)
写在前面:分享技术,共同进步,有不足请见谅,相关意见可评论告知 ~
编程路漫之远兮,运架构体之帷幄;
劝君专注案前事,亦是杯酒敬苍生;
概述
MyBatis 是一款优秀的持久层框架,避免了几乎所有的JDBC 代码和手动设置参数以及获取结果集的过程, 可以使用简单的 XML 或注解来配置和映射原生信息,将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射
Mybatis官方文档 :
GitHub :
Maven 仓库
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>
持久化
持久化是将程序数据在持久状态和瞬时状态间转换的机制。即把数据(如内存中的对象)保存到可永久保存的存储设备中(如磁盘)。持久化的主要应用是将内存中的对象存储在数据库中,或者存储在磁盘文件中、XML数据文件中等等。
注意:JDBC就是一种持久化机制。文件IO也是一种持久化机制。
原因:
①内存断电后数据丢失
②内存过于昂贵。
持久层
其他层: Dao层,Service层,Controller层….
- 完成持久化工作的代码块
- 层界限十分明显。
完成持久化工作的代码块 . ----> dao层 【DAO (Data Access Object) 数据访问对象】
MyBatis的优点
本质:Mybatis就是帮助我们将数据存入数据库中 , 和从数据库中取数据 .
传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等... , 通过框架可以减少重复代码,提高开发效率 .
①小巧简单,没有任何第三方依赖
②灵活:sql写在xml里,提供xml标签,支持编写动态sql便于统一管理和优化。解除sql与程序代码的耦合,提高了可维护性
③通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。
搭建环境
搭建数据库
架构设计器
新建项目
maven开始
-
新建一个普通的maven项目
-
删除src目录
-
导入maven依赖
效果示意图
在Idea 中连接数据库
连接成功图示如下
其中测试连接数据库失败的原因之一(时区问题)
show variables like'%time_zone';
set global time_zone = '+8:00';
【Idea 相关配置】
编写mybatis的核心配置文件
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatistwo?useSSL=true&useUnicode=true&characterEncoding=UTF-8""/>
<property name="username" value="root"/>
<property name="password" value="${}"/>
</dataSource>
其中:
mybatistwo 为数据库名
编写mybatis工具类
核心代码
提升sqlSessionFactory
作用域
private static SqlSessionFactory sqlSessionFactory;
下为代码块 ,使用 Mybatis 第一步: 获取sqlessionFactory 对象
static{
try {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
获得取SqlSession 实例,SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
主要代码编写
实体类
get,set 方法有参,空参构造,String等
Dao接口
public interface UserDao {
List<User> getUserList();
}
可以体现 Mybatis 的优越性
Mapper配置文件
接口实现类由原来的UserDaoImpl转变为一个 Mapper配置文件.
<?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">
<!--namespace=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.lzh.dao.UserDao">
<select id="getUserList" resultType="com.lzh.pojo.User">
select * from mybatistwo.user
</select>
</mapper>
namespace=绑定一个对应的Dao/Mapper接口
其他拓展
【映射文件配置】(拓展)
创建 User.xml
文件
<mapper namespace="user">
<select id="findUserById" parameterType="int" resultType="com.lzh.model.User">
SELECT * FROM user WHERE id = #{a}
</select>
[id]:statement的id,要求在命名空间内唯一
[parameterType]:入参的java类型
[resultType]:查询出的单条结果集对应的java类型
[#{}]: 表示一个占位符?
[#{id}]:表示该占位符待接收参数的名称为id。
注意:如果参数为简单类型时,#{}里面的参数名称可以是任意定义
【配置加载映射文件】(拓展)
测试
注意: test目录与src 目录结构一一对应
junit 测试
@Test
public void test(){
//第一步:获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//方式一:getMapper
UserDao userDao = sqlSession.getMapper(UserDao.class);
List<User> userList = userDao.getUserList();
for (User user : userList) {
System.out.println(user);
}
//关闭SqlSession
sqlSession.close();
}
常见异常解析(关键)
①异常一 未绑定异常
org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.
解决:mybatis-config.xml
中优化配置
②异常二资源过滤问题
<!--在build中配置resources,来防止我们资源导出失败的问题-->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
③异常三jdk版本不兼容问题
Error:java: 不再支持源选项 5。请使用 6 或更高版本。
解法:在pom.xml
配置文件加上如下代码
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.encoding>UTF-8</maven.compiler.encoding>
<java.version>11</java.version>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
</properties>
④异常四 编码问题
case1:
1 字节的 UTF-8 序列的字节 1 无效。
case2:
org.xml.sax.SAXParseException:
元素内容必须由格式正确的字符数据或标记组成,的错误问题
解法:
(1)配置文件不能有中文注释
(2)在 mybatis-config.xml
,样式如下图
useSSL=true ----> useSSL=false
characterEncoding=UTF-8 --> characterEncoding=UTF8
(3)clean Maven 的缓存
常见问题
- 配置文件没有注册
- 绑定接口错误。
- 方法名不对
- 返回类型不对
- Maven导出资源问题
注意 : 依赖的时候注意依赖版本与本地版本一致
七步曲
基于实战中学习,学习快乐中成长
.
时间会回答成长,成长会回答梦想