[Java知识库]MyBatis--介绍和搭建

MyBatis介绍

MyBatis历史

Mybatis特性

Mybatis下载

https://github.com/mybatis/mybatis-3/releases

和其他持久化层技术对比

搭建MyBatis

开发环境

创建maven工程

pom.xml
1、打包方式：jar

    <groupId>com.bijing.mybatis</groupId>
    <artifactId>mybatis_helloworld</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--    打包方式jar-->
    <packaging>jar</packaging>

2、引入依赖

 <dependencies>
        <!--MyBatis核心-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>
        <!--MYSQL驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.16</version>
        </dependency>

        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
        <!--junit测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

    </dependencies>

创建Mybatis的核心配置文件

resource下的mybatis-config.xml

<?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>
    <!--    配置连接数据库的环境-->
    <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?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root1234"/>
            </dataSource>
        </environment>
    </environments>
    <!--    引入mybatis的映射文件-->
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

加入log4j日志功能

加入依赖

pom.xml

       <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

加入log4j配置文件

resource下的log4j.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM
        "http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/doc-files/log4j.dtd">
<log4j:configuration debug="true">
    <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>

日志的级别

FATAL(致命) > ERROR(错误) > WARN(警告) > INFO(信息) > DEBUG(调试)
从左到右打印的内容越来越详细

创建mapper接口

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

package com.bijing.mapper;

/**
 * @author 毕晶
 * @date 2022/9/25 11:55
 */
public interface UserMapper {
    //添加成功会返回行数
    int insertUser();
}

创建MyBatis的映射文件

UserMapper.xml

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

<!--Mapper接口和映射文件对应
1.mapper接口的全类名和映射文件的namespace一致
2.mapper接口中的方法的方法名要和映射文件中的sql的id保持一致
3.记得在mybatis-config.xml中引入映射文件
-->
<mapper namespace="com.bijing.mapper.UserMapper">
    <!--    int insertUser();-->
    <!--    调用UserMapper接口中的insertUser方法时,会根据UserMapper接口的全类名来找到找到映射文件UserMapper.xml,
然后根据当前要调用的方法insertUser的方法名找到UserMapper.xml中的sql语句 然后获取标签中的sql来执行sql-->
    <insert id="insertUser">
        insert into t_user values(null,'admin','123456',23,'男','123456@qq.com');
    </insert>
</mapper>

通过unit测试功能

测试文件夹下的MyBatisTest.java

import com.bijing.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;

/**
 * @author 毕晶
 * @date 2022/9/25 19:22
 */
public class MyBatisTest {
    @Test
    public void testInsert() throws IOException {
        //获取核心配置文件中的输入流
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
        //获取SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //获取SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
        //获取sql的会话对象SqlSession(不会自动提交事务),是MyBatis提供的操作数据库的对象
//        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //获取sql的会话对象SqlSession(true自动提交事务),是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //获取UserMapper的代理实现类对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //调用Mapper接口中的方法,实现添加用户信息的功能
        int result = mapper.insertUser();
        //提供SQL以及唯一的标识找到sql并执行,唯一标识是namespace.sqlId
//        int result = sqlSession.insert("com.bijing.mapper.UserMapper.insertUser");
        System.out.println("结果:" + result);
        //手动提交事务
//        sqlSession.commit();
        //关闭SqlSession对象
        sqlSession.close();
    }
}

封装SessionUtil工具类

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

/**
 * @author 毕晶
 * @date 2022/9/25 20:08
 */
public class SqlSessionUtil {

    public static SqlSession getSqlSession(String config) {
        SqlSession sqlSession = null;
        //获取核心配置文件的输入流
        try {
            InputStream inputStream = Resources.getResourceAsStream(config);
            //获取SqlSessionFactoryBuilder对象
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            //获取SqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
            //获取SqlSession对象
            sqlSession = sqlSessionFactory.openSession(true);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return sqlSession;
    }

    public static SqlSession getSqlSession() {
        return getSqlSession("mybatis-config.xml");
    }
}

测试查询

• resultType:设置结果类型,即查询的数据要转换为的java类型
• esultMap:自定义映射,处理多对一或者一对多的映射关系

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

<!--Mapper接口和映射文件对应
1.mapper接口的全类名和映射文件的namespace一致
2.mapper接口中的方法的方法名要和映射文件中的sql的id保持一致
3.记得在mybatis-config.xml中引入映射文件
-->
<mapper namespace="com.bijing.mapper.UserMapper">
    <!--    int insertUser();-->
    <!--    调用UserMapper接口中的insertUser方法时,会根据UserMapper接口的全类名来找到找到映射文件UserMapper.xml,
然后根据当前要调用的方法insertUser的方法名找到UserMapper.xml中的sql语句 然后获取标签中的sql来执行sql-->
    <insert id="insertUser">
        insert into t_user values(null,'蔡徐坤','123456',31,'女','666@qq.com');
    </insert>
    <!--    updateUser-->
    <update id="updateUser">
        update t_user set username ='root',password='123' where id =2;
    </update>

    <!--    deleteUser-->
    <delete id="deleteUser">
        delete from t_user where id=2;
    </delete>

    <!--    User getUserById();-->
    <!--    resultType:设置结果类型,即查询的数据要转换为的java类型-->
    <!--    resultMap:自定义映射,处理多对一或者一对多的映射关系-->
    <select id="getUserById" resultType="com.bijing.pojo.User">
        select * from t_user where id=2;
    </select>

    <!--        List<User> getAllUsers();-->
    <select id="getAllUsers" resultType="com.bijing.pojo.User">
        select * from t_user;
    </select>
</mapper>

import com.bijing.mapper.UserMapper;
import com.bijing.pojo.User;
import com.bijing.utils.SqlSessionUtil;
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;
import java.util.List;

/**
 * @author 毕晶
 * @date 2022/9/25 19:22
 */
public class MyBatisTest {
    @Test
    public void testInsert() throws IOException {
        //获取核心配置文件中的输入流
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
        //获取SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //获取SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
        //获取sql的会话对象SqlSession(不会自动提交事务),是MyBatis提供的操作数据库的对象
//        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //获取sql的会话对象SqlSession(true自动提交事务),是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //获取UserMapper的代理实现类对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //调用Mapper接口中的方法,实现添加用户信息的功能
        int result = mapper.insertUser();
        //提供SQL以及唯一的标识找到sql并执行,唯一标识是namespace.sqlId
//        int result = sqlSession.insert("com.bijing.mapper.UserMapper.insertUser");
        System.out.println("结果:" + result);
        //手动提交事务
//        sqlSession.commit();
        //关闭SqlSession对象
        sqlSession.close();
    }

    @Test
    public void testUpdate() {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        int result = mapper.updateUser();
        System.out.println("结果:" + result);
        sqlSession.close();
    }

    @Test
    public void testDelete() {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        int result = mapper.deleteUser();
        System.out.println("结果:" + result);
        sqlSession.close();
    }

    @Test
    public void getUserById() {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.getUserById();
        System.out.println("结果:" + user);
        sqlSession.close();
    }

    @Test
    public void getAllUsers() {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> users = mapper.getAllUsers();
        users.forEach(System.out::println);
        sqlSession.close();
    }

}

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>
    <!--    MyBatis核心配置文件中的标签必须按照指定的顺序配置:
    properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,
    objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?


    -->
    <!--    引入properties文件,此后就可以在当前文件中使用${key}的方式访问value-->
    <properties resource="jdbc.properties">
    </properties>

    <!--    typeAliases:设置类型别名,即为某个具体的数据类型设置一个别名
    在MyBatis的范围中,就可以使用别名来表示一个具体的类型
    -->
    <typeAliases>
<!--
            type:设置需要使用别名的类型
            alias:设置某个类型的别名,如果不写,这边默认为如User,不区分大小写
        -->
        <!--        <typeAlias type="com.bijing.pojo.User"></typeAlias>-->
        <!--        <typeAlias type="com.bijing.pojo.User" alias="abc"></typeAlias>-->

<!--        或者实体类所在的包-->
        <package name="com.bijing.pojo"/>

    </typeAliases>


    <!--    配置连接数据库的环境
    default:设置默认使用的环境id
    -->
    <environments default="development">
        <!--
         environment:设置一个具体的连接数据库的环境
        属性:
        id:设置环境的唯一标识,不能重复
        -->
        <environment id="development">
            <!--
             transactionManager:设置事务管理器
             属性:
             type:设置事务管理的方式,只要两种方式
             type="JDBC/MANAGED",jdbc表示使用jdbc中原生的事务管理方式,managed,被管理,例如Spring
            -->
            <transactionManager type="JDBC"/>
            <!--
                dataSource:设置数据源
                属性:
                type:设置数据源的类型
                type="POOLED/UNPOOLED/JNDI"
                pooled:表示使用数据库连接池;unpooled:不使用数据库连接池;jndi:表示使用上下文中的数据源
            -->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>

    <!--    引入mybatis的映射文件-->
    <mappers>
        <!--        <mapper resource="mappers/UserMapper.xml"/>-->
        
        <!--        以包的形式引入映射文件,但是必须满足两个条件:-->
        <!--        1.mapper接口和映射文件所在的包必须一致-->
        <!--        2.mapper接口的名字和映射文件的名字必须保持一致-->
        <package name="com.bijing.mapper"/>
    </mappers>
</configuration>