[000-01-018].第02节：MyBatis开发环境搭建

已于 2024-09-11 23:57:33 修改
阅读量991 收藏 10
点赞数 21
分类专栏： # 常用框架 文章标签： mybatis java
于 2024-05-11 16:29:54 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43783284/article/details/121353857
版权

我的后端学习大纲

MyBatis学习大纲

1、库表准备：

1.1.建库：

  • 1.在建库的时候，字符集选择utf-8b4
    在这里插入图片描述

1.2.建表：

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

2、创建Empty Project：

因为会创建很多个模块，所以我可以先创建一个空的项目，然后将各个模块都放在这个空项目下，这样比较容易看代码

2.1.创建Empty Project：

在这里插入图片描述

2.2.设置JDK版本：

在这里插入图片描述

2.3.设置maven:

在这里插入图片描述

2.4.设置字符格式：

在这里插入图片描述

3、创建第一个MyBatis模块：

3.1.创建模块:

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

3.2.打包方式更改：jar

在这里插入图片描述

3.3.引入有依赖：mybatis依赖 + mysql依赖

在这里插入图片描述

3.4.编写mybatis的核心配置文件：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="${driver}"/>
        <property name="url" value="${url}"/>
        <property name="username" value="${username}"/>
        <property name="password" value="${password}"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
  
  </mappers>
</configuration>

1.这个文件的名称随意，不是固定的，一般是叫这个名字
2.这个文件的位置随意，不一定是mybatis-config.xml，可以是其它名字。但是一般会放在类的根路径下,在resources目录中的内容就相当于放在了类的根路径下
3.这个文件主要是用来配置连接数据库的一些信息，通过这个xml文件构建SqlSessionFactory，通过SqlSessionFactory工厂来生产SqlSession对象。我需要通过SqlSessionFactoryBuilder对象中的build方法来获取一个SqlSessionFactory对象,即:SqlSessionFactoryBuilder -- > SqlSessionFactory --> SqlSession，然后SqlSession负责执行SQL语句

3.5.编写xxxMapper.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先随意写一个-->
<mapper namespace="car">
    <!--insert sql：保存一个汽车信息-->
    <insert id="insertCar">
        insert into t_car
            (id,car_num,brand,guide_price,produce_time,car_type) 
        values
            (null,'102','丰田mirai',40.30,'2014-10-05','氢能源')
    </insert>
</mapper>

1.在XML文件中的SQL后的分号无所谓，可有可无:

在这里插入图片描述

2.这个文件名称和位置是随意,现在我先在resources根目录下新建CarMapper.xml配置文件

3.6.将xxxMapper.xml文件配置到核心配置文件中：

在这里插入图片描述

1.在mybatis-config.xml中指定xxMapper.xml文件的路径，相当于是将CarMapper.xml文件路径配置到mybatis-config.xml：<mapper resource="CarMapper.xml"/>
2.核心配置文件中会执行XXMapper.xml文件的路径，resource属性会自动的从类的根路径下开始查找资源

3.7.编写测试类MyBatisIntroductionTest.java代码:

a.编写测试程序说明：

  • 1.编写MyBatis测试程序意思就是：使用mybatis的类库，编写mybatis程序，连接数据库，做增删改查就行了
  • 2.在MyBatis当中，负责执行SQL语句的那个对象叫做：SqlSession；SqlSession是专门用来执行SQL语句的，是一个Java程序和数据库之间的一次会话。 要想获取SqlSession对象，需要先获取SqlSessionFactory对象，通过SqlSessionFactory工厂来生产SqlSession对象。
  • 3.要想获取SqlSessionFactory对象，首先获取SqlSessionFactoryBuilder对象。通过SqlSessionFactoryBuilder对象的build方法，来获取一个SqlSessionFactory对象。

b.测试程序如下：

package com.jianqun;

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.InputStream;

public class MyBatisIntroductionTest {
    public static void main(String[] args) throws Exception {

        // 1.获取SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

        // 2.获取SqlSessionFactory对象
        // Resources是mybtis的一个工具类
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml"); // Resources.getResourceAsStream默认就是从类的根路径下开始查找资源。
        //InputStream is = Resources.getResourceAsStream("com/mybatis.xml");
        //InputStream is = new FileInputStream("d:\\mybatis-config.xml");

        //InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is); // 一般情况下都是一个数据库对应一个SqlSessionFactory对象。

        // 获取SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession(); // 如果使用的事务管理器是JDBC的话，底层实际上会执行：conn.setAutoCommit(false);
        // 这种方式实际上是不建议的，因为没有开启事务。
        //SqlSession sqlSession = sqlSessionFactory.openSession(true);

        // 执行SQL语句
        int count = sqlSession.insert("insertCar"); // 返回值是影响数据库表当中的记录条数。

        System.out.println("插入了几条记录：" + count);

        // 手动提交
        sqlSession.commit(); // 如果使用的事务管理器是JDBC的话，底层实际上还是会执行conn.commit();

    }
}

c.对Resources.getResourceAsStream()的说明：

  • 1.小技巧：以后凡是遇到resource这个单词，大部分情况下，这种加载资源的方式就是从类的根路径下开始加载。（开始查找）
    • 优点：采用这种方式，从类路径当中加载资源，项目的移植性很强。项目从windows移植到linux，代码不需要修改，因为这个资源文件一直都在类路径当中
  • 2.采用* InputStream is = new FileInputStream(“d:\mybatis-config.xml”); 这种方式也可以
    • 缺点：可移植性太差，程序不够健壮。可能会移植到其他的操作系统当中。导致以上路径无效，还需要修改java代码中的路径。这样违背了OCP原则
  • 3.如下结论已经验证：
    • mybatis核心配置文件的名字，不一定是：mybatis-config.xml。可以是其它名字。
    • mybatis核心配置文件存放的路径，也不一定是在类的根路径下。可以放到其它位置。但为了项目的移植性，健壮性，最好将这个配置文件放到类路径下面。
    • InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream(“mybatis-config.xml”);
      ClassLoader.getSystemClassLoader() 获取系统的类加载器。
      系统类加载器有一个方法叫做：getResourceAsStream
      它就是从类路径当中加载资源的。
      通过源代码分析发现：
      InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
      底层的源代码其实就是：
      InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml");
  • 4.核心配置文件中的mapper标签中的resource和url属性值的区别
    • <mapper resource="CarMapper.xml"/> resource属性：这种方式是从类路径当中加载资源。
    • <mapper url="file:///d:/CarMapper.xml"/> url属性：这种方式是从绝对路径当中加载资源。

d.MyBatis中的事务说明：

1.transaction标签中值有两个,不区分大小写，JDBC和MANAGED,mybatis中通过这个标签进行事务管理；

在这里插入图片描述

2.JDBC管理事务

  • 1.Mybatis框架自己管理事务，自己采用原生的JDBC代码去管理事务，如代码中的 代码是：sqlSessionFactory.openSession() ，在其底层代码是：conn.setAutoCommit(false);表示开启事务。
  • 2.如果你编写的代码是下面的代码：SqlSession sqlSession = sqlSessionFactory.openSession(true) ，表示没有开启事务。因为这种方式压根不会执行：conn.setAutoCommit(false); 在JDBC事务中，没有执行conn.setAutoCommit(false);那么autoCommit就是true,true就代表没有开启事务。那么只要执行任意一条DML语句就提交一次。

3.MANAGED事务管理器：

  • 1.mybatis不再负责事务的管理了。事务管理交给其它容器来负责。例如：Spring
  • 2.对于我们当前的单纯的只有mybatis的情况下，如果配置为MANAGED，那么事务这块是没人管的。没有人管理事务表示事务压根没有开启。没有人管理事务就是没有事务。那么只要执行任意一条DML语句就提交一次。

3.8.到目前为止的代码目录结构：

在这里插入图片描述

  • 2.第一个完整的测试代码：
package com.jianqun.mybatis.test;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

/**
 * 采用正规的方式，写一个完整版的MyBatis程序。
 * @author jianqun
 * @version 1.0
 * @since 1.0
 */
public class MyBatisCompleteTest {
    public static void main(String[] args) {
        SqlSession sqlSession = null;
        try {
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));
            // 开启会话（底层会开启事务）
            sqlSession = sqlSessionFactory.openSession();
            // 执行SQL语句，处理相关业务
            int count = sqlSession.insert("insertCar");
            System.out.println(count);
            // 执行到这里，没有发生任何异常，提交事务。终止事务。
            sqlSession.commit();
        } catch (Exception e) {
            // 最好回滚事务
            if (sqlSession != null) {
                sqlSession.rollback();
            }
            e.printStackTrace();
        } finally {
            // 关闭会话（释放资源）
            if (sqlSession != null) {
                sqlSession.close();
            }
        }
    }
}

3.9.为MyBatis与数据库会话建立的工具类：

在上述代码中，我们每进行一次，都要重复编写MyBatis的会话连接，所以下面我们就抽取出来，写一个工具类，当需要建立连接的时候，直接调用即可

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

/**
 */
public class SqlSessionUtil {

    // 工具类的构造方法一般都是私有化的。
    // 工具类中所有的方法都是静态的，直接采用类名即可调用。不需要new对象。
    // 为了防止new对象，构造方法私有化。
    private SqlSessionUtil(){}

	// SqlSessionFactory对象：一个SqlSessionFactory对应一个environment，一个environment通常是一个数据库。
	// 所以就把SqlSessionFactory定义称静态方法中，只在类加载的时候加载，只加载一次即可
    private static SqlSessionFactory sqlSessionFactory;

    // 类加载时执行
    // SqlSessionUtil工具类在进行第一次加载的时候，解析mybatis-config.xml文件。创建SqlSessionFactory对象。
    static {
        try {
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

    /*public static SqlSession openSession(){
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        // SqlSessionFactory对象：一个SqlSessionFactory对应一个environment，一个environment通常是一个数据库。
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));
        SqlSession sqlSession = sqlSessionFactory.openSession();
        return sqlSession;
    }*/

    /**
     * 获取会话对象。
     * @return 会话对象
     */
    public static SqlSession openSession(){
        return sqlSessionFactory.openSession();
    }

}

4、引入单元测试JUnit

4.1.什么是JUnit：

  • 1.JUnit是专门做单元测试的组件
  • 2.在实际开发中，单元测试一般是由开发人员来完成的，我们要对自己写证每个业务方法在进行测试的时候都能通过,因此在前后端联调之前需要使用JUnit进行单元测试
  • 3.测试的过程中涉及到两个概念：
    • 期望值
    • 实际值

期望值和实际值相同表示测试通过，期望值和实际值不同则单元测试执行时会报错。

4.2.MyBatis整合Junit的步骤：

a.第一步：引入依赖

<!-- junit依赖 -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.13.2</version>
    <scope>test</scope>
</dependency>

b.第二步：编写单元测试类【测试用例】

  • 1.测试用例中每一个测试方法上使用@Test注解进行标注。
// 测试用例
public class CarMapperTest{
    // 测试方法
    @Test
    public void testInsert(){

	}
    
    @Test
    public void testUpdate(){
    
    }
}

说明：
1.测试用例的名字以及每个测试方法的定义都是有规范的：
2.测试用例的名字：XxxTest
3.测试方法声明格式：public void test业务方法名(){}

c.第三步：执行测试方法：

  • 1.测试方法可以在类上执行，也可以在方法上执行
    • 在类上执行时，该类中所有的测试方法都会执行。
    • 在方法上执行时，只执行当前的测试方法

4.3.Junit中的断言：

  • 1.记录下单元测试中断言测试：
    在这里插入图片描述

4.4.使用JUnit测试MyBatis中现有的方法：

a.未编写MyBatis工具类进行测试：

package com.jianqun.mybatis.test;

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

public class CarMapperTest {
	//未编写工具类时进行的单元测试：    
    @Test
    public void testInsertCar(){
        // 编写mybatis程序
        SqlSession sqlSession = null;
        try {
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));
            // 开启会话（底层会开启事务）
            sqlSession = sqlSessionFactory.openSession();
            // 执行SQL语句，处理相关业务
            int count = sqlSession.insert("insertCar");
            System.out.println(count);
            // 执行到这里，没有发生任何异常，提交事务。终止事务。
            sqlSession.commit();
        } catch (Exception e) {
            // 最好回滚事务
            if (sqlSession != null) {
                sqlSession.rollback();
            }
            e.printStackTrace();
        } finally {
            // 关闭会话（释放资源）
            if (sqlSession != null) {
                sqlSession.close();
            }
        }
    }
}

b.编写了工具类进行测试：

package com.jianqun.mybatis.test;

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

public class CarMapperTest {
    // 工具类简化与数据库的连接进行测试
    @Test
    public void testInsertCarByUtil(){
        SqlSession sqlSession = SqlSessionUtil.openSession();
        int count = sqlSession.insert("insertCar");
        System.out.println(count);
        sqlSession.commit();
        sqlSession.close();
   }
}

5、MyBatis整合日志

5.1.MyBatis默认的日志：

  • 1.MyBatis的日志是在setting标签中进行配置的，其中STDOUT_LOGGING是标准日志，mybatis框架本身已经实现了这种标准。 只要开启即可。只要在核心配置文件：mybatis-config.xml文件中使用settings标签进行配置开启。
    <settings>
   <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
  • 2.这个标签在编写的时候要注意，它应该出现在environments标签之前。注意顺序。当然，不需要记忆这个顺序。因为有dtd文件进行约束呢。我们只要参考dtd约束即可

5.2.Mybatis常见的集成的日志组件有哪些：

在MyBatis的日志中想看到更多的信息，比如：连接对象什么时候创建，什么时候关闭，sql语句是怎样的、 日志详细的日期，线程名字等更加丰富的配置，我们可以去集成第三方的l日志组件来实现

  • 1.如下这些都是一些日志标准，名称叫做日志门面，根据这些日志标准，下面有众多的具体的日志框架，如logback
    SLF4J（沙拉风）：沙拉风是一个日志标准，其中有一个框架叫做logback，它实现了沙拉风这种规范
    LOG4J
    LOG4J2
    STDOUT_LOGGING
    …

注意：log4j log4j2 logback都是同一个作者开发的

5.3.MyBatis集成日志框架logback：

a.框架说明：

  • 1.日志框架logback实现了SLF4J;SLF4J相当于是一个日志标准，然后有个框架叫logback去实现了这种规范;

b.集成logback框架：

  • 1.添加依赖：
<dependency>
  <groupId>ch.qos.logback</groupId>
  <artifactId>logback-classic</artifactId>
  <version>1.2.11</version>
  <scope>test</scope>
</dependency>
  • 2.引入logback相关配置文件（文件名叫做logback.xml或logback-test.xml，不能是别的名字，配置文件必须的必放到类路径当中）
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
    <!-- 控制台输出 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 按照每天生成日志文件 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志文件输出的文件名-->
            <FileNamePattern>${LOG_HOME}/TestWeb.log.%d{yyyy-MM-dd}.log</FileNamePattern>
            <!--日志文件保留天数-->
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        </encoder>
        <!--日志文件最大的大小-->
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <MaxFileSize>100MB</MaxFileSize>
        </triggeringPolicy>
    </appender>

    <!--mybatis log configure-->
    <logger name="com.apache.ibatis" level="TRACE"/>
    <logger name="java.sql.Connection" level="DEBUG"/>
    <logger name="java.sql.Statement" level="DEBUG"/>
    <logger name="java.sql.PreparedStatement" level="DEBUG"/>

    <!-- 日志输出级别,logback日志级别包括五个：TRACE < DEBUG < INFO < WARN < ERROR -->
    <root level="DEBUG">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="FILE"/>
    </root>

</configuration>

注意： 添加的入职文件，文件名必须是：文件名叫做logback.xml或logback-test.xml，日志文件的位置也必须放在根路径下，不可以是别的路径

c.更改核心配置文件：

在这里插入图片描述

1.01^1000
关注
专栏目录
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值