第2天学习打卡（Mybatis：简介、第一个Mybatis程序）

最新推荐文章于 2024-05-25 09:29:09 发布

Joseph_JL

最新推荐文章于 2024-05-25 09:29:09 发布

阅读量116

点赞数

文章标签： mybatis

本文链接：https://blog.csdn.net/weiguang2020/article/details/118469531

版权

MyBatis

SSM框架

环境：

JDK1.8
Mysql 5.7 或者升版本
maven3.6.1或者升版本
IDEA

回顾：

JDBC
Mysql
Java基础
Maven
Junit

**框架：**配置文件的。学习框架最好的方式：看官方文档；

**Mybatis3官方开发文档：**https://mybatis.org/mybatis-3/zh/getting-started.html

1.简介

1.1 什么是MyBatis

MyBatis 是一款优秀的持久层框架
它支持自定义 SQL、存储过程以及高级映射。
MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
MyBatis 可以通过简单的XML或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了[google code](https://baike.baidu.com/item/google code/2346604)，并且改名为MyBatis 。2013年11月迁移到Github。
iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAOs）

获取方式：

gitHub搜索下载 https://github.com/mybatis/mybatis-3/releases
Maven仓库 https://mvnrepository.com/search?q=mybatis

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

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 AUTO_INCREMENT,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL,
PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT INTO `user`(`name`,`pwd`)VALUES
('狂神','123456'),
('张三','123456'),
('李四','123456');

新建项目：

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

2.删除src目录，便于后面创建子模块

3.导入maven依赖

导入mysql、mabatis、junit包

在build中配置resources，来防止我们资源导出的失败的问题

在父工程的pom.xml中

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!--父工程-->
    <groupId>org.example</groupId>
    <artifactId>mybatis</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>simpleDemo</module>
    </modules>

    <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.3</version>
        </dependency>
    <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
        </dependency>
    </dependencies>

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


</project>

2.2 创建一个子模块

（1）编写Mybatis的核心配置文件

在resources目录下创建mybatis-config.xml

<?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>
    <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=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

    <!--每一个Mapper都需要在mybatis-config.xml中注册-->
    <!--易错：分隔出采用斜杠，不是点-->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>

</configuration>

（2）编写Mybatis工具类

获取SqlSession对象（相当于connection对象），封装成工具类。

在utils包下建立工具类MybatisUtils

package com.kuang.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;

//工具类
//需要获得数据库操作对象SqlSession
//SqlSessionFactory---->SqlSession
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;//提升作用域

    static {
        //使用Mybatis的第一步：获取SqlSessionFactory对象
        try {
            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();
    }
}

（3）创建实体类

在pojo包下面创建实体类User

package com.kuang.pojo;

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 + '\'' +
                '}';
    }
}

（4）dao层：UserDao接口和UserMapper.xml

持久层操作数据库执行sql

UserDao接口，UserMapper.xml采用配置文件形式替换以前的UserDaoImpl实现类实现操作数据库

UserDao接口：

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

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


<!--namespace=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.kuang.dao.UserDao">
    <select id="getUserList" resultType="com.kuang.pojo.User">
        select * from `user`;
    </select>
</mapper>

（5）测试

在test目录下建立对应的dao包：test/com.kuang.dao

再建立UserDaoTest类添加测试方法

1.先获取SqlSession对象

2.利用SqlSession调用Mapper得到UserDao对象

3.操作数据库，返回与实体类对应的结果

package com.kuang.dao;

import com.kuang.pojo.User;
import com.kuang.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @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();
    }
}

2.3 可能会遇到的问题

1.配置文件getUserMapper.xml没有注册

每一个Mapper.xml都需要在Mybatis核心配置文件mybatis-config.xml中注册

注册的资源路径，采用斜杠，而不是点分隔

<!--每一个Mapper都需要在mybatis-config.xml中注册-->
<!--易错：分隔出采用斜杠，不是点-->
<mappers>
    <mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>

2.Maven导出资源问题，先放到外层pom.xml，如果没生效，子模块的pom.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>

3.注意Mapper.xml文件中：绑定接口、方法名、返回类型

错误：

Cause: com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceExcep

解决方法：之前在pom.xml文件中删除了下面代码，现在加上：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

2.4 运行思路

连接数据库，导入jar包（mysql、mabatis、junit、此处还可以配置好maven的资源导出问题build)
操作数据库需要一个SqlSession对象，为此建造了一个工具类utils/MybatisUtils，编写了配置文件mybatis-config.xml（配置文件一上来连接了数据库，仅需修改选项参数；删除mapper.xml的注册配置）
创建实体类User
创建接口UserDao，并创建getUserList()抽象方法
写Mapper配置文件UserMapper.xml，代替原来实现类Impl：namespace绑定接口，标签id绑定接口方法，标签体专注sql，返回类型专注返回值类型；每一个mapper写完需要到mabatis-config.xml中去注册