MyBatis入门与实践

文档中心

MyBatis入门与实践

jdk 1.8

Maven：3.6.3

MyBatis入门与实践

MyBatis入门与实践
一、 MyBatis简介
- 1. 什么是 `MyBatis`？
- 2. MyBatis历史
- 3. MyBatis下载
- 4. 持久化
- - 4.1 数据持久化
  - 4.2 为什么需要持久化？
- 5. 持久层
- 6. 为什么需要Mybatis
- - 6.1 优点
- 7. 和其它持久化层技术对比
二、搭建MyBatis
- 1. 开发环境
- 2. 第一个 mybatis 程序
- - 2.1 搭建环境
  - - 2.1.1 创建数据库
    - 2.1.2 新建一个普通的maven项目
    - 2.1.3 删除`src文件`
  - 2.2 导入Maven依赖（MyBatis）
  - 2.3 编写代码
  - - 2.3.1 创建一个模块 new module
    - 2.3.2 编写mybatis的核心配置文件
    - 2.3.3 编写mybatis工具类
    - 2.3.4 编写代码
    - - 1. 实体类
      - 2. Dao接口
      - 3. 接口实现类
  - 2.4 测试（junit测试）
  - - 2.4.1 建立对应的包
    - 2.4.2 可能报错，需要注意：
    - - 报错1：
      - 报错2：初始化异常
  - 2.5 运行
  - - 2.5.1 结果显示
    - 2.5.2 文件结构
    - 2.5.3 可能遇到的问题：
- 3. 特别注意（核心接口）
- 4. 总结流程

一、 MyBatis简介

mybatis

1. 什么是 `MyBatis`？

MyBatis 是一款优秀的持久层框架。
它支持自定义 SQL、存储过程以及高级映射。
MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
MyBatis 可以通过简单的 XML（常用） 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
MyBatis 是一个半自动的ORM（Object Relation Mapping，【对象(实体类) 关系（关系型数据库的数据）映射】，将实体类对象与数据库中的数据形成映射关系）框架。（_JDBC_纯手动；MyBatis 半自动，需要自己写sql语句；Hibernate全自动）

2. MyBatis历史

MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下， iBatis3.x正式更名为MyBatis。
代码于2013年11月迁移到Github。
iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。 iBatis提供的持久层框架包括SQL Maps（MyBatis封装JDBC过程）和Data Access Objects（DAO）。

3. MyBatis下载

MyBatis下载：
MyBatis下载
MyBatis下载(Maven仓库)
MyBatis官方网址：MyBatis官方网址
中文文档：中文文档

MyBatis是Maven项目：
mybatis
点击上图中的，Download Latest 下载最新版本的MyBatis：此时的最新版本是3.5.9，点击mybatis-3.5.9.zip即可下载MyBatis

mybatis

mybatis-3.5.9.zip是jar包
Source code （zip）和 Source code （tar.gz）是不同格式的MyBatis源码，tar.gz是linux系统下的压缩文件格式

mybatis
我们平时创建项目一般都是Maven项目，因此mybatis-3.x.x.jar包基本上不需要自己下载，官方文档倒是可以下载下来看看。

4. 持久化

4.1 数据持久化

持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 瞬时状态：内存断电即失
- 持久状态：数据库（jdbc）、IO文件持久化（相比较数据库浪费资源）
生活中持久化例子：冷藏、罐头

4.2 为什么需要持久化？

有一些对象，不能让它丢掉
内存太贵了（外在原因）

5. 持久层

Dao,Service, Controller层

完成持久化工作的代码块 Dao层
层界限十分明显

6. 为什么需要Mybatis

帮助程序员将数据存入到数据库
方便
传统的JDBC代码太复杂，简化、框架、自动化
不用mybatis也可以，更容易上手。技术没有高低之分

6.1 优点

简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件。易于学习，易于使用。通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
提供映射标签，支持对象与数据库的orm字段关系映射。
提供对象关系映射标签，支持对象关系组建维护。
.提供xml标签，支持编写动态sql。
最重要的一点：使用的人多!

未来： mybatis => spring | spring mvc | sring boot

7. 和其它持久化层技术对比

JDBC

SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
代码冗长，开发效率低

Hibernate 和 JPA

操作简便，开发效率高
程序中的长难复杂 SQL 需要绕过框架
内部自动生产的 SQL，不容易做特殊优化
基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
反射操作太多，导致数据库性能下降

MyBatis

轻量级，性能出色
SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
开发效率稍逊于HIbernate，但是完全能够接受

二、搭建MyBatis

1. 开发环境

IDE：idea 2021.3
构建工具：maven 3.6.1
MySQL版本：MySQL 8.0.3
MyBatis版本：MyBatis 3.5.9

2. 第一个 mybatis 程序

思路：搭建环境 -> 导入MyBatis -> 编写代码 -> 测试

2.1 搭建环境

2.1.1 创建数据库

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,'李四','123456'),(3,'王五','123890')

2.1.2 新建一个普通的maven项目

mybatis
命名：
mybatis
重新配置一下Maven：
Windows系统：File -> Setting -> Build,Execution,Deployment -> Build Tool -> Maven
macOS: IntelliJ IDEA -> Preferences...-> Build,Execution,Deployment -> Build Tool -> Maven
应该是自己的路径，不是Bundled(Maven 3)

mybatis

2.1.3 删除`src文件`

目的是创建一个项目是父项目，以后直接创建各个模块子项目

2.2 导入Maven依赖（MyBatis）

     <dependencies>  <dependency>     <groupId>mysql</groupId>     <artifactId>mysql-connector-java</artifactId>     <version>8.0.28</version> </dependency>   <dependency>     <groupId>org.mybatis</groupId>     <artifactId>mybatis</artifactId>     <version>3.5.9</version> </dependency>  <dependency>     <groupId>junit</groupId>     <artifactId>junit</artifactId>     <version>4.12</version>     <scope>test</scope> </dependency>    </dependencies>

确保依赖都导入成功：
右边Maven栏：必要时点刷新
mybatis
mybatis

2.3 编写代码

2.3.1 创建一个模块 new module

mybatis

mybatis
mybatis

这样创建的好处是：每一个模块单独拥有自己的pom.xml文件，管理不同的依赖
mybatis

2.3.2 编写mybatis的核心配置文件

mybatis

连接mysql：
mybatis

填写必要的信息：
mybatis
选择Schemas
mybatis
可能需要下载必要的文件：
mybatis

连接测试：之后点击Apply，在点击OK
mybatis
mybatis

连接后可以显示：
mybatis

显示配置项：
mybatis
核心配置文件：mybatis-config.cml

<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"><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://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=GMT"/>      <property name="username" value="root"/>      <property name="password" value="*"/>     </dataSource> </environment>    </environments></configuration>

2.3.3 编写mybatis工具类

创建一些类
mybatis
mybatis
mybatis

最终结构：
mybatis
编写工具类：MybatisUtils

package com.guo.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.IOException;import java.io.InputStream;//sqlSessionFactory --> sqlSession   加载资源  创建对象public class MybatisUtils {    private static SqlSessionFactory sqlSessionFactory;    static { try {     //使用mybatis第一步获取sqlSessionFactory对象     String resource = "mybatis-config.xml";  //初始就加载     InputStream inputStream = Resources.getResourceAsStream(resource); //读取配置文件     sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //创建流 }catch (IOException e){     e.printStackTrace(); }    }    //既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例了。    //SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。    public static SqlSession getSqlSession(){ return sqlSessionFactory.openSession();    }}

2.3.4 编写代码

1. 实体类

package com.guo.pojo;//实体类public class User {    private int id;    private String name;    private String pwd;    //构造函数快捷键：command + N    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 + '\'' +  '}';    }    }

2. Dao接口

package com.guo.dao;import com.guo.pojo.User;import java.util.List;public interface UserMapper {   //获取全部用户   List<User> getUserList();   }

3. 接口实现类

由原来的UserDaoImpl转换为一个Mapper配置文件：UserMapper.xml 满足SqlSession的调用
需要在配置里是设置一下SQL Dialects 保证下面使用Sql语句时可以出现表名
- Windows系统：File -> Setting -> Languages & Frameworks -> SQL Dialects
- macOS: IntelliJ IDEA -> Preferences...-> Languages & Frameworks -> SQL Dialects

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.guo.dao.UserMapper">           <select id="getUserList" resultType="com.guo.pojo.User" >       select * from mybatis.user where name like #{value};    </select></mapper>

2.4 测试（junit测试）

2.4.1 建立对应的包

package com.guo.dao;import com.guo.pojo.User;import com.guo.utils.MybatisUtils;import org.apache.ibatis.session.SqlSession;import org.junit.Test;import java.util.HashMap;import java.util.List;import java.util.Map;public class UserMapperTest {    @Test    public void test(){ //第一步，获得SQLSession对象 SqlSession sqlSession = MybatisUtils.getSqlSession(); // 方式一：执行SQL 获取mapper直接用 UserMapper userMapper = sqlSession.getMapper(UserMapper.class); List<User> userList =  userMapper.getUserList();     for (User user : userList){     System.out.println(user); } //关闭sqlSession sqlSession.close();// 官网建议写在try catch里// try{//     // 方式一：执行SQL 获取mapper直接用//     UserDao userDao = sqlSession.getMapper(UserDao.class);//     List userList =  userDao.getUserList();////////方式二： 根据具体的方法返回 selectList selectOne selectMap... 不推荐使用 不需要强转 (官网！)// List userList = sqlSession.selectList("com.guo.dao.UserDao.getUserList");//     for (User user : userList){//  System.out.println(user);//     }// }catch (Exception e){//     e.printStackTrace();// }finally {//     //关闭sqlSession//     sqlSession.close();// }    }

2.4.2 可能报错，需要注意：

报错1：

org.apache.ibatis.binding.BindingException: Type interface com.guo.dao.UserMapper is not known to the MapperRegistry.
mybatis
核心配置文件mybatis-config.cml中注册mapper.

        <mappers> <mapper resource="com/guo/dao/UserMapper.xml"/>     </mappers>

mybatis-config.cml配置文件：全部代码

<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"><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://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=GMT"/>      <property name="username" value="root"/>      <property name="password" value="*"/>     </dataSource> </environment>    </environments>          <mappers> <mapper resource="com/guo/dao/UserMapper.xml"/>     </mappers>    </configuration>

报错2：初始化异常

The error may exist in com/guo/dao/UserMapper.xml 问题是target文件中没有
mybatis
注意在主项目和子模块的pom.xml加代码，并重新刷新一遍maven

        <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>

如果不是第一次运行，需要clean一下 target文件
mybatis

2.5 运行

2.5.1 结果显示

mybatis

2.5.2 文件结构

mybatis

2.5.3 可能遇到的问题：

1.配置文件没有注册
2.绑定接口错误
3.方法名不对
4.返回类型不对
5.Maven导出资源问题

3. 特别注意（核心接口）

SqlSessionFactoryBuilder
这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了 。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例，但最好还是不要一直保留着它，以保证所有的 XML 解析资源可以被释放给更重要的事情。

SqlSessionFactory
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏习惯”。因此 SqlSessionFactory 的最佳作用域是应用作用域。有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。

SqlSession
每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中，比如 Servlet 框架中的 HttpSession。如果你现在正在使用一种 Web 框架，考虑将 SqlSession 放在一个和 HTTP 请求相似的作用域中。换句话说，每次收到 HTTP 请求，就可以打开一个 SqlSession，返回一个响应后，就关闭它。这个关闭操作很重要，为了确保每次都能执行关闭操作，你应该把这个关闭操作放到 finally 块中。

4. 总结流程

按顺序写：
mybatis

MyBatis入门与实践

MyBatis入门与实践

MyBatis入门与实践

一、 MyBatis简介

1. 什么是 MyBatis？

2. MyBatis历史

3. MyBatis下载

4. 持久化

4.1 数据持久化

4.2 为什么需要持久化？

5. 持久层

6. 为什么需要Mybatis

6.1 优点

7. 和其它持久化层技术对比

二、搭建MyBatis

1. 开发环境

2. 第一个 mybatis 程序

2.1 搭建环境

2.1.1 创建数据库

2.1.2 新建一个普通的maven项目

2.1.3 删除src文件

2.2 导入Maven依赖（MyBatis）

2.3 编写代码

2.3.1 创建一个模块 new module

2.3.2 编写mybatis的核心配置文件

2.3.3 编写mybatis工具类

2.3.4 编写代码

1. 实体类

2. Dao接口

3. 接口实现类

2.4 测试 （junit测试）

2.4.1 建立对应的包

2.4.2 可能报错，需要注意：

报错1：

报错2：初始化异常

2.5 运行

2.5.1 结果显示

2.5.2 文件结构

2.5.3 可能遇到的问题：

3. 特别注意（核心接口）

4. 总结流程

相关问题

公告

DeepSeek全套部署资料免费下载

免费可商用字体批量下载

标签

1. 什么是 `MyBatis`？

2.1.3 删除`src文件`

2.4 测试（junit测试）