实用指南：MyBatis完整教程IDEA版(1)

【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂: P1 - P9

环境：

  • JDK1.8
  • MySQL 5.7
  • maven 3.9.9
  • IDEA

回顾：

  • JDBC
  • MySQL
  • Java基础
  • Maven
  • Junit

SSM框架：配置文件的。最好的方式：看官网文档：https://mybatis.org/mybatis-3/

1、简介

1.1、什么是MyBatis

在这里插入图片描述

  • MyBatis 是一款优秀的持久层框架。

  • 它支持自定义 SQL、存储过程以及高级映射。

  • MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。

  • MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

  • MyBatis（原名为iBatis，名称来源于"internet"和"abatis"的组合）是一款基于Java的持久层框架，最初由Apache软件基金会开发，2010年迁移至Google Code并更名，2013年转至GitHub平台。

如何获得MyBatis？

  • Maven仓库

    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
  <dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>3.5.19</version>
  </dependency>

  • Github

  • 中文文档

1.2、持久化

数据持久化

  • 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
  • 内存：断电即失
  • 数据库（JDBC），IO文件持久化…
  • 生活：冷藏，罐头。

为什么需要持久化？

  • 有一些对象，不能让他丢掉。

  • 内存太贵了

1.3、持久层

Dao层，Service层，Controller层…

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

1.4、为什么需要MyBatis？

  • 帮助程序员将数据存入到数据库中。
  • 方便
  • 传统的JDBC代码太复杂了。简化。框架。自动化。
  • 不用Mybatis也可以。更容易上手。技术没有高低之分
  • 优点：
    • 简单易学
    • 灵活
    • sql和代码的分离，提高了可维护性。
    • 提供映射标签，支持对象与数据库的ORM字段关系映射。
    • 提供对象关系映射标签，支持对象关系组建维护。
    • 提供xml标签，支持编写动态sql。

最重要的一点：使用的人多！

Spring SpringMVC SpringBoot

2、第一个Mybatis程序

思路：搭建环境–>导入Mybatis–>编写代码–>测试！

2.1、搭建环境

搭建数据库

CREATE DATABASE `mybatis`;
USE `mybatis`;
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 = utf8mb4 ;
INSERT INTO `user`(`id`,`name`,`pwd`) VALUES
(1,'凌波','123456'),
(2,'张三','123456'),
(3,'李四','123456');

新建项目

  1. 新建一个普通的Maven项目

  2. 删除src目录

  3. 导入Maven依赖

    <!--导入依赖-->
  <dependencies>
    <!--mysql驱动-->
      <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.47</version>
      </dependency>
      <!--mybatis-->
        <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.19</version>
        </dependency>
        <!--junit-->
          <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>4.13.2</version>
          </dependency>
        </dependencies>

2.2、创建一个模块

  • 编写MyBatis的核心配置文件

    <?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-config.dtd">
  <!--configuration核心配置文件-->
    <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?useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
          </dataSource>
        </environment>
      </environments>
    </configuration>

  • 编写MyBatis的工具类

    //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) {
throw new RuntimeException(e);
}
}
// 既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
public static SqlSession getSqlSession() {
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;
}
}

  • Dao接口

    public interface UserDao {
List<User> getUserList();
  }

  • 接口实现类由原来的UserDaoImpl转变为一个Mapper配置文件

<?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
  <!--namespace=绑定一个对应的Dao/Mapper接口-->
      <mapper namespace="com.lingbo.dao.UserDao">
      <!--select查询语句-->
          <select id="getUserList" resultType="com.lingbo.pojo.User">
          select * from mybatis.user
        </select>
      </mapper>

2.4、测试

注意点：org.apache.ibatis.binding.BindingException: Type interface com.lingbo.dao.UserDao is not known to the MapperRegistry.

MapperRegistry是什么?

核心配置文件中注册Mappers

  • 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.toString());
  }
  //关闭SqlSession
  sqlSession.close();
  }

可能会在测试中遇到的问题：

  1. 配置文件没有注册

  2. 绑定接口错误

  3. 方法名不对

  4. 返回类型不对

  5. Maven导出资源问题

    <!-- 在build中配置resources，防止我们资源导出失败的问题   -->
  <build>
    <resources>
      <resource>
      <directory>src/main/java</directory>
        <includes>
        <include>**/*.properties</include>
        <include>**/*.xml</include>
        </includes>
      <filtering>false</filtering>
      </resource>
      <resource>
      <directory>src/main/resources</directory>
        <includes>
        <include>**/*.properties</include>
        <include>**/*.xml</include>
        </includes>
      <filtering>false</filtering>
      </resource>
    </resources>
  </build>

3、CRUD

3.1、namespace

namespace中的包名要和Dao/mapper接口中的包名一致！

3.2、select

选择，查询语句：

  • id:就是对应的namespace中的方法名;
  • resultType：Sql语句执行的返回值！
  • parameterType：参数类型！

  1. 编写接口

    //根据ID查询用户
User getUserById(int id);

  2. 编写对应的mapper中的sql语句

    <select id="getUserById" parameterType="int" resultType="com.lingbo.pojo.User">
  select * from mybatis.user where id = #{id}
</select>

  3. 测试

    @Test
public void getUserById(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}

3.3、Insert

<!--对象中的属性可以直接取出来-->
    <insert id="addUser" parameterType="com.lingbo.pojo.User">
    insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd});
  </insert>
//增删改需要提交事务
@Test
public void addUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int res = mapper.addUser(new User(4, "蛤蛤", "123322"));
if (res > 0){
System.out.println("插入成功！");
}
//提交事务
sqlSession.commit();
sqlSession.close();
}

3.4、update

<update id="updateUser" parameterType="com.lingbo.pojo.User">
  update mybatis.user set `name` = #{name}, pwd = #{pwd} where id = #{id};
</update>
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.updateUser(new User(4,"嘻嘻","123311"));
//提交事务
sqlSession.commit();
sqlSession.close();
}

3.5、delete

<delete id="deleteUser" parameterType="int">
  delete from mybatis.user where id = #{id};
</delete>
@Test
public void deleteUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.deleteUser(4);
//提交事务
sqlSession.commit();
sqlSession.close();
}

注意点：

  • 增删改需要提交事务！

3.6、万能Map

假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应当考虑使用Map!

//万能的Map
int addUser2(Map<String, Object> map);
<!--对象中的属性可以直接取出来
传递map的key
-->
  <insert id="addUser2" parameterType="map" >
  insert into mybatis.user (id, pwd) values (#{userid},#{password});
</insert>
@Test
public void addUser2(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<String, Object>();
  map.put("userid",5);
  map.put("userName","小明");
  map.put("password","12332312");
  mapper.addUser2(map);
  sqlSession.commit();
  sqlSession.close();
  }

Map传递参数，直接在sql中取出key即可！【parameterType=“map”】

对象传递参数，直接在sql中取对象的属性即可！【parameterType=“Object”】

只有一个基本类型参数的情况下，可以直接在sql中取到！

多个参数用Map，或者注解！

3.7、模糊查询

模糊查询怎么写？

  1. Java代码执行的时候，传递通配符% %

    List<User> userList = mapper.getUserLike("%李%");

  2. 在SQL拼接中使用通配符！

    <select id="getUserLike" resultType="com.lingbo.pojo.User">
  select * from mybatis.user where name like "%" #{value} "%"
</select>

4、配置解析

4.1、核心配置文件

4.2、环境配置（environments）

MyBatis 可以配置成适应多种环境，不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

学会使用配置多套运行环境!

MyBatis默认的事务管理器就是JDBC，连接池：POOLED

4.3、属性（properties）

我们可以通过properties属性来实现引用配置文件！

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。【db.properties】
在这里插入图片描述

编写一个配置文件

db.properties

driver = com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456

在核心配置文件中引入

<!--引入外部配置文件-->
    <properties resource="db.properties">
    <property name="username" value="root"/>
    <property name="password" value="123556"/>
  </properties>
  • 可以直接引入外部文件
  • 可以在其中增加一些属性配置
  • 如果外部文件和内部属性配置有相同字段，会优先使用外部配置文件的！

4.4、类型别名（typeAliases）

  • 类型别名可为 Java 类型设置一个缩写名字。
  • 意在降低冗余的全限定类名书写。
<!--可以给实体类起别名-->
  <typeAliases>
    <typeAlias type="com.lingbo.pojo.User" alias="User"/>
  </typeAliases>

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，比如：

扫描实体类的包，它的默认别名就为这个类的类名首字母小写！pojo.User->user

<typeAliases>
  <package name="com.lingbo.pojo"/>
</typeAliases>

在实体类比较少的时候，使用第一种方式。

如果实体类十分多，建议使用第二种。

第一种可以DIY别名，第二种则不行，如果非要改，需要在实体类上增加注解！

import org.apache.ibatis.type.Alias;
//实体类
@Alias("hello")
public class User {
private int id;
private String name;
private String pwd;
}

下面是一些为常见的 Java 类型内建的类型别名。它们都是不区分大小写的，注意，为了应对原始类型的命名重复，采取了特殊的命名风格。加了下划线_的是八大基本类型！其他都是包装类型！

别名映射的类型
_bytebyte
_char (since 3.5.10)char
_character (since 3.5.10)char
_longlong
_shortshort
_intint
_integerint
_doubledouble
_floatfloat
_booleanboolean
stringString
byteByte
char (since 3.5.10)Character
character (since 3.5.10)Character
longLong
shortShort
intInteger
integerInteger
doubleDouble
floatFloat
booleanBoolean
dateDate
decimalBigDecimal
bigdecimalBigDecimal
bigintegerBigInteger
objectObject

4.5、设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

4.6、其他配置

4.7、映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件。

方式一：【推荐使用】

<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册!-->
  <mappers>
  <mapper resource="com/lingbo/dao/UserMapper.xml"></mapper>
  </mappers>

方式二：使用class的文件绑定注册

<mappers>
  <mapper class="com.lingbo.dao.UserMapper"/>
</mappers>

注意点：

  • 接口和他的Mapper配置文件必须同名！
  • 接口和他的配置文件必须在同一个包下！

方式三：使用扫描包进行注入绑定！

<mappers>
  <package name="com.lingbo.dao"/>
</mappers>

注意点：

  • 接口和他的Mapper配置文件必须同名！
  • 接口和他的配置文件必须在同一个包下！

4.8、生命周期和作用域

在这里插入图片描述
不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder：

  • 一旦创建了 SqlSessionFactory，就不再需要它了。
  • 局部变量

SqlSessionFactory：

  • 可以想象为：数据库连接池！
  • SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。
  • 因此 SqlSessionFactory 的最佳作用域是应用作用域。
  • 最简单的就是使用单例模式或者静态单例模式。

SqlSession

  • 连接到连接池的一个请求！
  • SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
  • 用完之后需要赶紧关闭，否则资源被占用！

在这里插入图片描述
这里面的每一个Mapper，就代表一个具体的业务！

posted @ 2025-12-04 08:08  gccbuaa  阅读(24)  评论(0)    收藏  举报