深入浅出 MyBatis | Mybatis 简洁、第一个Mybatis程序
Mybatis
环境
- JDK1.8
- Mysql5.7
- maven 3.6.3
- IDEA
回顾
- JDBC
- Mysql
- Java基础
- Maven
- Junit
SSM框架:配置文件的最好的方式:看官网文档
Mybatis
Mybatis3 官方文档: https://mybatis.org/mybatis-3/zh_CN/index.html
1、Mybatis简介
- MyBatis 是一款优秀的持久层框架,
- 它支持自定义 SQL、存储过程以及高级映射。
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
MyBatis 本是 apache 的一个开源项目 iBatis, 2010 个项目由 apache software foundatic迁移google code,并且改名为MyBatis 。
1.1 什么是Mybatis
如何获得 Mybatis
- maven仓库,或直接在 mvnrepository 中搜索:https://mvnrepository.com/
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
Github 地址:https://gitcode.com/gh_mirrors/my/mybatis-3/releases?utm_source=csdn_github_accelerator&isLogin=1
1.2、持久化
数据持久化
- 持久化就是将程序的数据在特久状态和瞬时状态转化的过程
- 内存:断电即失
- 数据库(jdbc),io文件持久化。
- 生活:冷藏。罐头
为什么需要需要持久化?
- 有一些对象,不能让他丢掉。
- 内存太贵了
1.3、持久层
之前学过的:Dao层,Service层,Controller层…
- Mybatis 是持久层:完成持久化工作的代码块
- 层界限十分明显。
1.4、为什么需要Mybatis?
- 方便
- 帮助程序猿将数据存入到数据库中。
- 传统的JDBC代码太复杂了。简化。框架。
- 不用Mybatis也可以。更容易上手。技术没有高低之分
- 优点
- 简单易学
- 灵活
- sql和代码的分离,提高了可维护性。
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql。
最重要的一点:使用的人多!
Spring SpringMVC SpringBoot
2、第一个Mybatis程序
思路: 搭建环境 → \to → 导入 Mybatis → \to → 编写代码 → \to → 测试
2.1 搭建环境
搭建数据库
首先在数据库中执行如下 sql 语句
CREATE DATABASE `mybatis`;
USE `mybatis`;
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
insert into `user`(`id`,`name`,`pwd`) values (1,'狂神','123456'),(2,'张三','abcdef'),(3,'李四','987654');
sql 的执行可以通过图形化界面 Navicat,SQLyog 等,同时也可以使用 IDEA ,如下:
新建项目
- 新建一个普通maven项目
- 删除src目录
- 导入maven依赖
<!--import dependencies-->
<dependencies>
<!--mysql driver-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!--mybatis-->
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!--junit-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
自己在此用了mybatis3.5.2版本在之后导包会失败,所以换成3.5.6版本。
2.2 创建一个模块
- 编写 mybatis 的核心配置文件
IDEA 中连接数据库
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<!--configuration core file-->
<configuration>
<environments default="development">
<environment id="development">
<!--事务管理-->
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!--数据库相关配置-->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://112.124.60.179:3310/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
</configuration>
mysql的公网IP,端口号,以及账号密码输入要正确,并此处设 useSSL=false。
- 编写 mybatis 工具类
package com.uestc.utils;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.InputStream;
//SqlSessionFactory -->SqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//使用 Mybaties 第一步:获取 sqlSessionFactory 对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (Exception e) {
e.printStackTrace();
}
}
// 既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
public static SqlSession getSqlSession(){
// SqlSession sqlSession = sqlSessionFactory.openSession();
// return sqlSession;
return sqlSessionFactory.openSession();
}
}
2.3 编写代码
实体类
//实体类
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
}
Dao 接口
package com.uestc.dao;
import com.uestc.pojo.User;
import java.util.List;
public interface UserDao {
List<User> getUserList();
}
UserDao 的接口实现类由原来的 UserDaoImpl 转变成一个 Mapper 配置文件 UserMapper.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.uestc.dao.UserDao">
<!--sql-->
<select id="getUserList" resultType="com.uestc.pojo.User">
select * from mybatis.user
</select>
</mapper>
- resultType 为返回的类型
2.4 测试
@Test
public void getUserListTest(){
//第一步:获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//方式一:getMapper
UserMapper userDao = sqlSession.getMapper(UserMapper.class);
List<User> userList = userDao.getUserList();
for (User user : userList) {
System.out.println(user);
}
//关闭SqlSession
sqlSession.close();
}
注意点:MapperRegistry 是什么?
- org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.
解决办法:UserMapper.xml 没有在 mybatis-config.xml 中注册,需要加上如下这句:(核心配置文件中注册 mappers)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<!--configuration core file-->
<configuration>
<environments default="development">
<environment id="development">
<!--事务管理-->
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!--数据库相关配置-->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://112.124.60.179:3310/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--每一个 Mapper.xml 都需要在 Mybatis 核心配置文件(mybatis-config.xml) 中注册!-->
<mappers>
<mapper resource="com/uestc/dao/UserMapper.xml"/>
</mappers>
</configuration>
- junit 测试(测试代码放在 test 的 java 文件夹下,并与上面的代码一一对应)
遇到问题:找不到 dao 文件下的 xml 文件
maven由于他的约定大于配置,我们之后可以能遇到我们写的配置文件,无法被导出或者生效的问题,解决方案:
原因和解决方法如下:
在pom.xml文件中设置
<!--在build中配置resources,来防止我们资源导出失败的问题-->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
然后执行测试代码
可能遇到的问题:
- 配置文件没有注册;
- 绑定接口错误;
- 方法名不对;
- 返回类型不对;
- Maven导出资源问题。
尝试在mybatis-config.xml中配置
- 将IDEA项目编码改为UTF-8
- 设置时区
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=UTC"/>
- 修改加载驱动
重新配置后删除target目录重新编译
References
https://www.bilibili.com/video/BV1NE411Q7Nx/?spm_id_from=333.1007.top_right_bar_window_history.content.click&vd_source=0d2c67cd5361bad79f1ba0494e00f60e
【狂神说】Mybatis学习笔记(全)