Mybatis（一）

1. Mybatis简介

MyBatis下载地址

1.1 MyBatis历史

• MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下，iBatis3.x正式更名为MyBatis。代码于2013年11月迁移到Github
• iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects（DAO）

1.2 MyBatis特性

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

1.3 和其它持久化层技术对比

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

2. 搭建MyBatis

2.1 开发环境

• IDE：idea 2019.2
• 构建工具：maven 3.5.4
• MySQL版本：MySQL 5.7
• MyBatis版本：MyBatis 3.5.7

代码结构如下：

pojo/User.java

package com.atguigu.mybatis.pojo;public class User {private Integer id;private String username;private String password;private Integer age;private String sex;private String email;//这里省略了有参、无参构造、get、setter、重载toString
}

2.2 pom.xml

• 打包方式：jar
• 引入依赖

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><groupId>com.atguigu.mybatis</groupId><artifactId>MyBatis_demo1</artifactId><version>1.0-SNAPSHOT</version><packaging>jar</packaging><dependencies><!-- Mybatis核心 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.7</version></dependency><!-- junit测试 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version><scope>test</scope></dependency><!-- MySQL驱动 --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.28</version></dependency><!-- log4j日志 --><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency></dependencies></project>

2.3 MyBatis核心配置文件：mybatis-config.xml

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。
核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息
核心配置文件存放的位置是src/main/resources目录下
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.cj.jdbc.Driver"/>  <property name="url" value="jdbc:mysql://localhost:3306/MyBatis"/>  <property name="username" value="root"/>  <property name="password" value="123456"/>  </dataSource>  </environment>  </environments>  <!--引入映射文件-->  <mappers>  <mapper resource="mappers/UserMapper.xml"/>  </mappers>  
</configuration>

2.3.1 核心配置文件详解

核心配置文件中的标签必须按照固定的顺序(有的标签可以不写，但顺序一定不能乱)：
properties、settings、typeAliases、typeHandlers、objectFactory、objectWrapperFactory、reflectorFactory、plugins、environments、databaseIdProvider、mappers

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!--MyBatis核心配置文件中，标签的顺序：properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?--><!--引入properties文件--><properties resource="jdbc.properties" /><!--设置类型别名--><typeAliases><!--typeAlias：设置某个类型的别名属性：type：设置需要设置别名的类型alias：设置某个类型的别名，若不设置该属性，那么该类型拥有默认的别名，即类名且不区分大小写--><!--<typeAlias type="com.atguigu.mybatis.pojo.User"></typeAlias>--><!--以包为单位，将包下所有的类型设置默认的类型别名，即类名且不区分大小写--><package name="com.atguigu.mybatis.pojo"/></typeAliases><!--environments：配置多个连接数据库的环境属性：default：设置默认使用的环境的id--><environments default="development"><!--environment：配置某个具体的环境属性：id：表示连接数据库的环境的唯一标识，不能重复--><environment id="development"><!--transactionManager：设置事务管理方式属性：type="JDBC|MANAGED"JDBC：表示当前环境中，执行SQL时，使用的是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><environment id="test"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/myDB"/><property name="username" value="root"/><property name="password" value="root"/></dataSource></environment></environments><!--引入映射文件--><mappers><!--<mapper resource="mappers/UserMapper.xml"/>--><!--以包为单位引入映射文件要求：1、mapper接口所在的包要和映射文件所在的包一致2、mapper接口要和映射文件的名字一致--><package name="com.atguigu.mybatis.mapper"/></mappers>
</configuration>

resources/jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/myDB
jdbc.username=root
jdbc.password=root

默认的类型别名

2.4 创建mapper接口：UserMapper.java

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

package com.atguigu.mybatis.mapper;import com.atguigu.mybatis.pojo.User;import java.util.List;public interface UserMapper {/*** MyBatis面向接口编程的两个一致：* 1、映射文件的namespace要和mapper接口的全类名保持一致* 2、映射文件中SQL语句的id要和mapper接口中的方法名一致** 表--实体类--mapper接口--映射文件*//*** 添加用户信息*/int insertUser();/*** 修改用户信息*/void updateUser();/*** 删除用户信息*/void deleteUser();/*** 根据id查询用户信息*/User getUserById();/*** 查询所有的用户信息*/List<User> getAllUser();}

2.5 创建MyBatis的映射文件：UserMapper.xml

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

Java概念	数据库概念
类	表
属性	字段/列
对象	记录/行

映射文件的命名规则：

• 表所对应的实体类的类名+Mapper.xml
• 例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
• 因此一个映射文件对应一个实体类，对应一张表的操作
• MyBatis映射文件用于编写SQL，访问以及操作表中的数据
• MyBatis映射文件存放的位置是src/main/resources/mapper目录下
• MyBatis中可以面向接口操作数据，要保证两个一致
• mapper接口的全类名和映射文件的命名空间（namespace）保持一致
• mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

resources/mapper/UserMapper.xml

2.5.1 增

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.atguigu.mybatis.mapper.UserMapper"><!--int insertUser();--><insert id="insertUser">insert into t_user values(null,'admin','123456',23,'男','[e-mail]')</insert></mapper>

2.5.2 改

    <!--void updateUser();--><update id="updateUser">update t_user set username = '张三' where id = 4</update>

2.5.3 删

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

2.5.4 查

    <!--User getUserById();--><!--查询功能的标签必须设置resultType或resultMapresultType：设置默认的映射关系resultMap：设置自定义的映射关系--><select id="getUserById" resultType="com.atguigu.mybatis.pojo.User">select * from t_user where id = 3</select><!--List<User> getAllUser();--><select id="getAllUser" resultType="User">select * from t_user</select>

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

2.6 通过junit测试功能

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

• SqlSessionFactory：是“生产”SqlSession的“工厂”

test/MyBatisTest.java

package com.atguigu.mybatis.test;import com.atguigu.mybatis.mapper.UserMapper;
import com.atguigu.mybatis.pojo.User;
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;public class MyBatisTest {/*** SqlSession默认不自动提交事务，若需要自动提交事务* 可以使用SqlSessionFactory.openSession(true);*/@Testpublic void testMyBatis() throws IOException {//加载核心配置文件InputStream is = Resources.getResourceAsStream("mybatis-config.xml");//获取SqlSessionFactoryBuilderSqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();//获取sqlSessionFactorySqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);//获取SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession(true);//获取mapper接口对象UserMapper mapper = sqlSession.getMapper(UserMapper.class);//测试功能int result = mapper.insertUser();//提交事务//sqlSession.commit();System.out.println("result:"+result);}@Testpublic void testCRUD() 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();//mapper.deleteUser();/*User user = mapper.getUserById();System.out.println(user);*/List<User> list = mapper.getAllUser();list.forEach(user -> System.out.println(user));
}}

• 此时需要手动提交事务，如果要自动提交事务，则在获取sqlSession对象时，使用SqlSession sqlSession = sqlSessionFactory.openSession(true);，传入一个Boolean类型的参数，值为true，这样就可以自动提交

2.7 加入log4j日志功能

1. 加入依赖

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

2. 加入log4j的配置文件

   • log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下
   • 日志的级别：FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试) 从左到右打印的内容越来越详细

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