本小节,我们来快速搭建一个mybatis项目。

开发环境

  • IDE:idea
  • 构建工具:maven
  • MySQL版本:MySQL 8
  • MyBatis版本:MyBatis 3.5.7

    创建maven工程

  • 引入依赖

    1. <dependencies>
    2. <!-- Mybatis核心 -->
    3. <dependency>
    4. <groupId>org.mybatis</groupId>
    5. <artifactId>mybatis</artifactId>
    6. <version>3.5.7</version>
    7. </dependency>
    8. <!-- junit测试 -->
    9. <dependency>
    10. <groupId>junit</groupId>
    11. <artifactId>junit</artifactId>
    12. <version>4.12</version>
    13. <scope>test</scope>
    14. </dependency>
    15. <!-- MySQL驱动 -->
    16. <dependency>
    17. <groupId>mysql</groupId>
    18. <artifactId>mysql-connector-java</artifactId>
    19. <version>5.1.3</version>
    20. </dependency>
    21. </dependencies>

创建MyBatis的核心配置文件

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

  1. <?xml version="1.0" encoding="utf8" ?>
  2. <!DOCTYPE configuration
  3. PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  4. "http://mybatis.org/dtd/mybatis-3-config.dtd">
  5. <!--核心配置文件-->
  6. <configuration>
  7. <environments default="development">
  8. <environment id="development">
  9. <transactionManager type="JDBC"/>
  10. <dataSource type="POOLED">
  11. <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
  12. <property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis-study?serverTimezone=UTC&amp;characterEncoding=utf8"/>
  13. <property name="username" value="root"/>
  14. <property name="password" value="123456"/>
  15. </dataSource>
  16. </environment>
  17. </environments>
  18. <mappers>
  19. <mapper resource="UserMapper.xml"/>
  20. </mappers>
  21. </configuration>

创建mapper接口

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

  1. package com.atguigu.mybatis.mapper;
  2. public interface UserMapper {
  3. /**
  4. * 添加用户信息
  5. */
  6. int insertUser();
  7. }

创建MyBatis的映射文件

  • 相关概念:ORM(Object Relationship Mapping)对象关系映射。
    • 对象:Java的实体类对象
    • 关系:关系型数据库
    • 映射:二者之间的对应关系 | Java概念 | 数据库概念 | | —- | —- | | 类 | 表 | | 属性 | 字段/列 | | 对象 | 记录/行 |
  • 映射文件的命名规则
    • 表所对应的实体类的类名+Mapper.xml
    • 例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
    • 因此一个映射文件对应一个实体类,对应一张表的操作
    • MyBatis映射文件用于编写SQL,访问以及操作表中的数据
    • MyBatis映射文件存放的位置是src/main/resources/mappers目录下
  • MyBatis中可以面向接口操作数据,要保证两个一致
    • mapper接口的全类名和映射文件的命名空间(namespace)保持一致
    • mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper
  3. PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  4. "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
  5. <mapper namespace="com.atguigu.mybatis.mapper.UserMapper">
  6. <!--int insertUser();-->
  7. <insert id="insertUser">
  8. insert into user values(null,'张三','123')
  9. </insert>
  10. </mapper>

通过junit测试功能

  • SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的会话)
  • SqlSessionFactory:是“生产”SqlSession的“工厂”
  • 工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象
  1. public class AppTest {
  2. @Test
  3. public void testInsertUser() throws IOException {
  4. //读取MyBatis的核心配置文件
  5. InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
  6. //获取SqlSessionFactoryBuilder对象
  7. SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
  8. //通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory,生产SqlSession对象
  9. SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
  10. //获取sqlSession,此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
  11. //SqlSession sqlSession = sqlSessionFactory.openSession();
  12. //创建SqlSession对象,此时通过SqlSession对象所操作的sql都会自动提交
  13. SqlSession sqlSession = sqlSessionFactory.openSession(true);
  14. //通过代理模式创建UserMapper接口的代理实现类对象
  15. UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
  16. //调用UserMapper接口中的方法,就可以根据UserMapper的全类名匹配元素文件,通过调用的方法名匹配映射文件中的SQL标签,并执行标签中的SQL语句
  17. int result = userMapper.insertUser();
  18. //提交事务
  19. //sqlSession.commit();
  20. System.out.println("result:" + result);
  21. }
  22. }
  • 此时需要手动提交事务,如果要自动提交事务,则在获取sqlSession对象时,使用SqlSession sqlSession = sqlSessionFactory.openSession(true);,传入一个Boolean类型的参数,值为true,这样就可以自动提交

加入log4j日志功能

  1. 加入依赖
    1. <!-- log4j日志 -->
    2. <dependency>
    3. <groupId>log4j</groupId>
    4. <artifactId>log4j</artifactId>
    5. <version>1.2.17</version>
    6. </dependency>
  1. 加入log4j的配置文件
    • log4j的配置文件名为log4j.xml,存放的位置是src/main/resources目录下
    • 日志的级别:FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试) 从左到右打印的内容越来越详细
      1. <?xml version="1.0" encoding="UTF-8" ?>
      2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
      3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
      4. <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
      5. <param name="Encoding" value="UTF-8" />
      6. <layout class="org.apache.log4j.PatternLayout">
      7. <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" />
      8. </layout>
      9. </appender>
      10. <logger name="java.sql">
      11. <level value="debug" />
      12. </logger>
      13. <logger name="org.apache.ibatis">
      14. <level value="info" />
      15. </logger>
      16. <root>
      17. <level value="debug" />
      18. <appender-ref ref="STDOUT" />
      19. </root>
      20. </log4j:configuration>

      整体目录结构:

      image.png