学习Mybatis的第一天

环境:

  • JDK1.8
  • Mysql8.0
  • maven3.6.1
  • 编译环境IDEA
  • SSM框架:配置文件的最好方式——看官方文档

1、简介

1.1、什么是mybatis

  • Mybatis是一款优秀的持久层框架
  • 支持定制化SQL、存储过程及高级映射
  • Mybatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集
  • Mybatis可以使用简单的XML或注解来配置和映射原生类型、接口和Java的POJO(Plain Old Java Objects,普通的老式对象)为数据库中的记录。
  • Mybatis本是apache的一个开源项目iBatis,2010年由apache software foundation 迁移到了google code,并且改名为MyBatis 。
  • 2013年11月迁移到Github。
  • Github:https://github.com/mybatis/mybatis-3/releases
  • 中文文档:https://mybatis.org/mybatis-3/zh/index.html

如何获得Mybatis?

  • maven仓库

    1
    2
    3
    4
    5
    6
    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
    <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.2</version>
    </dependency>

注:mybatis版本向下兼容

1.2、持久化

数据持久化

  • 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
  • 内存:断电即失
  • 早期出现文件,io文件持久化,后来演变发展出现数据库(JDBC)

为什么要持久化

  • 保护数据不被丢失
  • 从经济方面来看,内存比较贵

1.3、持久层

Dao层、Servers层、Controll层……

控制层(Controller)调业务层(Service)业务层调应用(Dao)层

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

1.4、为什么需要Mybatis

  • 帮助程序员将数据写入数据库中
  • 方便
  • 传统的JDBC代码太复杂。mybatis简化JDBC、框架化、自动化
  • 更容易上手,不用Mybatis也可以,技术层面没有高低之分
  • 优点:
    • 简单易学
    • 灵活
    • SQL和代码分离,提高了可维护性
    • 提供映射标签,支持对象与数据库的orm(对象关系映射)字段关系映射
    • 提供对象关系映射标签,支持对象关系组建维护
    • 提供xml标签,支持编写动态sql
  • 使用人多,Spring,SpringMVC,SpringBoot、SpringCloud

2、第一个Mybatis程序

思路:搭建环境–>导入Mybatis(导入maven依赖)–>编写代码–>测试!

2.1、搭建数据库

推荐使用DataGrip或Navicat

1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE DATABASE `mybatis`;

USE `mybatis`;

CREATE TABLE `user`(
`id` INT(20) NOT NULL PRIMARY KEY,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT INTO `user`(`id`,`name`,`pwd`) VALUES
(1,'李华','123456'),
(2,'张三','123456'),
(3,'李四','123890')

数据库数据可以按照自己的方式修改插入

新建项目

  1. 新建一个maven项目

  2. 删除src

  3. 导入依赖

    父工程maven导入

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    <!--导入依赖-->
    <dependencies>
    <!--mysql驱动-->
    <dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.22</version>
    </dependency>
    <!--mybatis-->
    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
    <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.4</version>
    </dependency>
    <!--junit-->
    <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    </dependency>
    </dependencies>

    数据库版本要与个人电脑的数据库版本一致,不一致可能导致数据库驱动错误,出现乱码

2.2、创建一个模块

  • 编写Mybatis的核心配置文件

    子工程resources目录下建立mybatis核心配置xml文件

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    <?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核心配置文件-->
    <configuration>
    <!-- 多个环境,defaul默认环境-->
    <environments default="development">
    <environment id="development">
    <!-- transactionManager事务管理-->
    <transactionManager type="JDBC"/>
    <dataSource type="POOLED">
    <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC&amp;useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
    <property name="username" value="zhwroot"/>
    <property name="password" value="zhwroot"/>
    </dataSource>
    </environment>
    </environments>
    <mappers>
    <mapper resource="com/pomeloisland/dao/UserMapper.xml"/>
    </mappers>

    </configuration>

    serverTimezone设置数据库时区

  • 编写mybatis工具类

    子工程java目录下新建utils包,在utils包中建立工具类java文件

    查看官方文档

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    //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 命令所需的所有方法。
    public static SqlSession getSqlSession(){
    return sqlSessionFactory.openSession();
    }

2.3、编写代码

  • 实体类

    子工程java目录下新建pojo包,在pojo包中建立实体类java文件

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    public class User {

    private int id;
    private String name;
    private String pwd;

    public User(int id, String name, String pwd) {
    this.id = id;
    this.name = name;
    this.pwd = pwd;
    }

    public User() {
    }

    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接口(Mapper接口)

    子工程java目录下新建dao(Mapper)包,在dao(Mapper)包中建立实体类java文件

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    public interface UserMapper {
    //查询用户
    List<User> getUserList();

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

    //insert一个用户
    int addUser(User user);

    //update一个用户
    int updateUser(User user);

    //删除一个用户
    int deleteUser(int id);

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

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    <?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.pomeloisland.dao.UserMapper">

    <!--select查询语句-->
    <select id="getUserList" resultType="com.pomeloisland.pojo.User">
    select * from mybatis.user
    </select>

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

    <insert id="addUser" parameterType="com.pomeloisland.pojo.User">
    insert into mybatis.user (id,name,pwd) value (#{id},#{name},#{pwd});
    </insert>

    <update id="updateUser" parameterType="com.pomeloisland.pojo.User">
    update mybatis.user set name = #{name},pwd = #{pwd} where id = #{id};
    </update>

    <delete id="deleteUser" parameterType="int">
    delete from mybatis.user where id = #{id};
    </delete>

    </mapper>

2.4、测试

重要错误:

org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.

MapperRegistry是什么?

核心配置文件中注册mappers

1
2
3
<mappers>
<mapper resource="com/pomeloisland/dao/UserMapper.xml"/>
</mappers>
  • junit测试

    子工程test目录下新建包,路径与java目录下的路径一致,建立测试类java文件

    1. 查询用户测试
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    @Test
    public void test() {
    //第一步:获得SqlSession对象
    SqlSession sqlSession = MybatisUtils.getSqlSession();


    //方式一:getMapper
    UserMapper userDao = sqlSession.getMapper(UserMapper.class);
    List<User> userList = userDao.getUserList();
    // 方式二 (不推荐使用该方式)
    // List<User> userList = sqlSession.selectList("com.pomeloisland.dao.UserDao.getUserList");
    for (User user : userList) {
    System.out.println(user);
    }


    //关闭SqlSession
    sqlSession.close();
    }
    • Dao接口

      1
      2
      //查询用户
      List<User> getUserList();
    • mapper文件

      1
      2
      3
      4
      <!--select查询语句-->
      <select id="getUserList" resultType="com.pomeloisland.pojo.User">
      select * from mybatis.user
      </select>
    1. 根据ID查询用户测试

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      @Test
      public void getUserByID(){
      SqlSession sqlSession = MybatisUtils.getSqlSession();

      UserMapper mapper = sqlSession.getMapper(UserMapper.class);
      User userByID = mapper.getUserByID(1);
      System.out.println(userByID);

      sqlSession.close();
      }
      • Dao接口

        1
        2
         //根据ID查询用户
        User getUserByID(int id);
      • mapper文件

        1
        2
        3
        <select id="getUserByID2" parameterType="int" resultType="com.pomeloisland.pojo.User">
        select * from mybatis.user where id = #{id}
        </select>
        1. 万能Map
        • 测试

          1
          2
          3
          4
          5
          6
          7
          8
          9
          10
          11
          12
          13
          14
          @Test
          public void getUserByID2(){
          SqlSession sqlSession = MybatisUtils.getSqlSession();

          UserMapper mapper = sqlSession.getMapper(UserMapper.class);

          Map<String, Object> map = new HashMap<String, Object>();
          map.put("id",1);

          User userByID2 = mapper.getUserByID2(map);

          System.out.println(userByID2);
          sqlSession.close();
          }
        • Dao接口

          1
          User getUserByID2(Map<String,Object> map);
        • mapper文件

          1
          2
          3
          <select id="getUserByID2" parameterType="map" resultType="com.pomeloisland.pojo.User">
          select * from mybatis.user where id = #{id}
          </select>
      1. 插入一个用户测试

        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        @Test
        public void addUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.addUser(new User(4,"张衡","654321"));


        sqlSession.close();
        }
        • Dao接口

          1
          2
          //insert一个用户
          int addUser(User user);
        • mapper文件

          1
          2
          3
          <insert id="addUser" parameterType="com.pomeloisland.pojo.User">
          insert into mybatis.user (id,name,pwd) value (#{id},#{name},#{pwd});
          </insert>
      2. 修改用户信息

        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        @Test
        public void updateUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.updateUser(new User(4,"马壮","123123"));


        sqlSession.close();
        }
        • Dao接口

          1
          2
          //update一个用户
          int updateUser(User user);
        • mapper文件

          1
          2
          3
          <update id="updateUser" parameterType="com.pomeloisland.pojo.User">
          update mybatis.user set name = #{name},pwd = #{pwd} where id = #{id};
          </update>
      3. 删除一个用户

        1
        2
        3
        4
        5
        6
        7
        8
        9
        @Test
        public void deleteUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.deleteUser(4);

        sqlSession.close();
        }
        • Dao接口

          1
          2
          //删除一个用户
          int deleteUser(int id);
        • mapper文件

          1
          2
          3
          <delete id="deleteUser" parameterType="int">
          delete from mybatis.user where id = #{id};
          </delete>
  • 可以能会遇到的问题:

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

3、CRUD

1、namespace

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

2、select

选择、查询语句

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

注意点:增上改需要提交事务!

3、Map

  • Map传递参数,直接在sql中取出key即可! 【parameterType=”map”】

  • 对象传递参数,直接在sql中取对象的属性即可!【parameterType=”Object”】

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

  • 多个参数用Map,或者注解!

4、模糊查询

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

    1
    List<User> userList = mapper.getUserLike("%李%");
  2. 在sql拼接中使用通配符!

    1
    select * from mybatis.user where name like "%"#{value}"%"