MyBatis框架基础+进阶（一）（Mybatis介绍入门、测试连接数据库实现增删改查功能）

---

一、MyBatis简介

1.1、MyBatis特性

1） MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
2） MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
3） MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO	（Plain Old Java
					Objects，普通的Java对象）映射成数据库中的记录
4） MyBatis 是一个 半自动的ORM（Object Relation Mapping）框架

1.2、和其他持久化层技术对比

* JDBC
		SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
		维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
		代码冗长，开发效率低
		
* Hibernate 和 JPA
		操作简便，开发效率高
	程序中的长难复杂 SQL 需要绕过框架
	内部自动生产的 SQL，不容易做特殊优化
	基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
	
* MyBatis
	轻量级，性能出色
	SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
	开发效率稍逊于HIbernate，但是完全能够接受
	反射操作太多，导致数据库性能下降

二、搭建MyBatis

2.1、pom.xml 引入依赖，创建pojo类，创建对应数据库

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

    <groupId>cn.hncj</groupId>
    <artifactId>MyBatis_demo1</artifactId>
    <version>1.0</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
    <dependencies>
        <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.9</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-api -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.8.2</version>
            <scope>test</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-engine -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.8.2</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.28</version>
        </dependency>

    </dependencies>
</project>

pojo类：

package cn.hncj.pojo;

/**
 * Created on 2022/4/6.
 *
 * @author Hou chaof
 */

import lombok.Data;

@Data
public class User {
    private Integer id;
    private String username;
    private String password;
    private Integer age;
    private String sex;
    private String email;

    public User() {
    }

    public User(Integer id, String username, String password, Integer age, String sex, String email) {
        this.id = id;
        this.username = username;
        this.password = password;
        this.age = age;
        this.sex = sex;
        this.email = email;
    }
}

2.2、创建MyBatis的核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。
将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。
核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息

<?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.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/MyBatis"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments> <!--引入映射文件-->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

2.3、创建mapper接口

MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要提供实现类。

package cn.hncj.mapper;

/**
 * Created on 2022/4/6.
 *
 * @author Hou chaof
 */
public interface UserMapper {
        /**MyBatis面向接口编程的两个一致
         * 1.映射文件的namespace要和mapper接口的全类名保持一致
         * 2.映射文件中SQL语句的id要和mapper接口中的方法名一致
        * Description:添加用户信息
        * @date:2022/4/6 14:42
        * @params:
        * @return:
        */
        int insertUser();      
}

2.4、创建MyBatis的映射文件

相关概念：ORM（Object Relationship Mapping）对象关系映射。
	对象：Java的实体类对象
	关系：关系型数据库
	映射：二者之间的对应关系

1、映射文件的命名规则：
	表所对应的实体类的类名+Mapper.xml
		例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
			  因此一个映射文件对应一个实体类，对应一张表的操作
			  
MyBatis映射文件用于编写SQL，访问以及操作表中的数据
MyBatis映射文件存放的位置是src/main/resources/mappers目录下


2、MyBatis中可以面向接口操作数据，要保证两个一致：
	a>mapper接口的全类名和映射文件的命名空间（namespace）保持一致
	b>mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

<?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="cn.hncj.mapper.UserMapper">
    <!--int insertUser();-->
    <insert id="insertUser">
    insert into t_user values (null, '张三', '123', 23, '女','1833415689@qq.com')
    </insert>
</mapper>

2.5、测试类

import cn.hncj.mapper.UserMapper;
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 org.junit.Test;

import java.io.IOException;
import java.io.InputStream;

/**
 * Created on 2022/4/6.
 *
 * @author Hou chaof
 */
public class MyBatisTest {
    @Test
    public void testMyBatis() throws IOException {
        //1.加载核心配置文件
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        //获取SqlSessionFactoryBuilder
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder=new SqlSessionFactoryBuilder();
        //获取SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
        //获取sqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //获取mapper接口对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //测试功能
        int result = mapper.insertUser();
         //提交事务
        //sqlSession.commit();
        System.out.println("result:"+result);
    }
}

2.6、假如log4j日志框架性能优化

2.6.1、加入pom.xml依赖

<!-- log4j日志 --> 
<dependency> 
	<groupId>log4j</groupId> 
	<artifactId>log4j</artifactId> 
	<version>1.2.17</version> 
</dependency>

2.6.2、加入log4j的配置文件

log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下：

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n"/>
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug"/>
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info"/>
    </logger>
    <root>
        <level value="debug"/>
        <appender-ref ref="STDOUT"/>
    </root>
</log4j:configuration>

return：1 . 项目成功运行!

2.7、删除功能

2.7.1、mapper接口中添加抽象方法

void deleteUser();

2.7.2、UserMapper.xml中添加sql语句

      <!--void deleteUser()-->
    <delete id="deleteUser">
        delete from t_user where id=15;
    </delete>

2.7.3、 测试类中增加测试方法

 @Test
    public void testdelete() throws IOException {
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.deleteUser();
    }

2.8、修改功能

2.8.1、mapper接口中添加抽象方法

 void updateUser();

2.8.2、UserMapper.xml中添加sql语句

 <!-- void updateUser()-->
    <update id="updateUser">
        update t_user set username="李四" where id=14;
    </update>

2.8.3、测试类中增加测试方法

 @Test
    public void testUpdate() throws IOException {
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.updateUser();
    }

2.9、查询功能

2.9.1、 根据id查询用户信息

*1.mapper接口中添加抽象方法

        /**
        * Description:根据id查询用户信息
        * @date:2022/4/6 17:34
        * @params:
        * @return:
        */
        User getUserById();

*2.UserMapper.xml中添加sql语句

    <!--
    查询功能的标签必须设置resultType或resultMap
    resultType：设置默认的映射关系（字段名和属性名一致）
    resultMap：设置自定义的映射关系（字段名和属性名不一致）
    -->
    <!--   User getUserById()-->
    <select id="getUserById" resultType="cn.hncj.pojo.User">
        select * from t_user where id=9;
    </select>

 *3.测试类中增加测试方法

 @Test
    public void testselectById() throws IOException {
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User userById = mapper.getUserById();
        System.out.println(userById);
    }

*4.查询结果如下：

2.9.2、查询所有用户信息

*1.mapper接口中添加抽象方法

  /**
        * Description:查询所有用户信息
        * @date: 17:56
        * @params:
        * @return:
        */
        List<User> getAllUser();

*2.UserMapper.xml中添加sql语句

 <!--List<User> getAllUser()-->
    <select id="getAllUser" resultType="cn.hncj.pojo.User">
        select * from t_user;
    </select>

 *3.测试类中增加测试方法

@Test
    public void testSelectAllUser() throws IOException {
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> list = mapper.getAllUser();
        list.forEach(user -> System.out.println(user));
    }

*4.查询结果如下：

2.10、测试功能总结

*1.SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）


*2.SqlSessionFactory：是“生产”SqlSession的“工厂”。


*3.工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的
相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象。


*4.查询的标签select必须设置属性resultType或resultMap，用于设置实体类和数据库表的映射关系
		resultType：自动映射，用于属性名和表中字段名一致的情况
		resultMap：自定义映射，用于一对多或多对一或字段名和属性名不一致的情况
		
		
*5.当查询的数据为多条时，不能使用实体类作为返回值，只能使用集合，否则会抛出异常TooManyResultsException；
 		但是若查询的数据只有一条，可以使用实体类或集合作为返回值