【MyBatis学习笔记】MyBatis基础学习

MyBatis简介

MyBatis特性

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

MyBatis下载

MyBatis下载地址：https://github.com/mybatis/mybatis-3

和其他持久化层技术对比

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

核心配置文件详解

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

DOCTYPE configuration
        PUBLIC "-//MyBatis.org//DTD Config 3.0//EN"
        "http://MyBatis.org/dtd/MyBatis-3-config.dtd">
<configuration>
    
    <properties resource="jdbc.properties">properties>
    <settings>
        
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        
        <setting name="lazyLoadingEnabled" value="true"/>
    settings>
    <typeAliases>
        
        
        
        
        <package name="com.atguigu.mybatis.bean"/>
    typeAliases>
    
    <environments default="mysql_test">
        
        <environment id="mysql_test">
            
            <transactionManager type="JDBC"/>
            
            <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>
    
    <mappers>
        
        
        <package name="com.atguigu.mybatis.mapper"/>
    mappers>
configuration>

• 

默认的类型别名

搭建MyBatis

开发环境

IDE：idea

构建工具：maven3.8.6

MySQL版本：MySQL5.7

MyBatis版本：3.5.11

创建maven工程

1. 打包方式：jar
2. 引入依赖

<dependencies>
    
    <dependency>
        <groupId>org.mybatisgroupId>
        <artifactId>mybatisartifactId>
        <version>3.5.11version>
    dependency>

    
    <dependency>
        <groupId>junitgroupId>
        <artifactId>junitartifactId>
        <version>4.12version>
        <scope>testscope>
    dependency>

    
    <dependency>
        <groupId>mysqlgroupId>
        <artifactId>mysql-connector-javaartifactId>
        <version>5.1.3version>
    dependency>
dependencies>

创建MyBatis的核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求，将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴

核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息

核心配置文件存放的位置是src/main/resources目录下

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.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="org/mybatis/example/BlogMapper.xml"/>
    mappers>
configuration>

创建mapper接口

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

public interface UserMapper {
   /**
    * 添加用户信息
    */
   int insertUser();
   
}

创建MyBatis的映射文件

相关概念：ORM（Object Relationship Mapping）对象关系映射。

• 对象：Java的实体类对象
• 关系：关系型数据库
• 映射：二者之间的对应关系

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

1. 映射文件的命名规则：表对应的实体类的类名 + Mapper.xml

例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml

因此一个映射文件对应一个实体类，对应一张表的操作

MyBatis映射文件用于编写SQL，访问以及操作表中的数据

MyBatis映射文件存放的位置是src/main/resources/mappers目录下

2. MyBatis中可以面向接口操作数据，要保证两个一致：

2.1 mapper接口的全类名和映射文件的命名空间（namespace）保持一致

2.2 mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="nuc.kang.mapper.UserMapper">

    <insert id="insertUser">
        insert into t_user values(null,'admin','123456',23,'男','[email protected]')
    insert>

mapper>

通过junit测试功能

• SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）
• SqlSessionFactory：是“生产”SqlSession的“工厂”
• 工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象

public class UserMapperTest {
    @Test
    public void testInsertUser() throws IOException {
        //读取MyBatis的核心配置文件
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        //获取SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory，生产SqlSession对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
        //获取sqlSession，此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
        //SqlSession sqlSession = sqlSessionFactory.openSession();
	    //创建SqlSession对象，此时通过SqlSession对象所操作的sql都会自动提交  
		SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //通过代理模式创建UserMapper接口的代理实现类对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //调用UserMapper接口中的方法，就可以根据UserMapper的全类名匹配元素文件，通过调用的方法名匹配映射文件中的SQL标签，并执行标签中的SQL语句
        int result = userMapper.insertUser();
        //提交事务
        //sqlSession.commit();
        System.out.println("result:" + result);
    }
}

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

加入log4j日志功能

1. 加入依赖

   
   <dependency>
   <groupId>log4jgroupId>
   <artifactId>log4jartifactId>
   <version>1.2.17version>
   dependency>
   

2. 加入log4j的配置文件

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

   
   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>
   

MyBatis获取参数值的两种方式（重点）

• MyBatis获取参数值的两种方式：${}和#{}
• ${}的本质就是字符串拼接，#{}的本质就是占位符赋值
• ${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号；但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

单个字面量类型的参数

• 若mapper接口中的方法参数为单个的字面量类型，此时可以使用${}和#{}以任意的名称（最好见名识意）获取参数的值，注意${}需要手动加单引号

<select id="getUserByUsername" resultType="User">
	select * from t_user where username = #{username}
select>

<select id="getUserByUsername" resultType="User">  
	select * from t_user where username = '${username}'  
select>

多个字面量类型的参数

• 若mapper接口中的方法参数为多个时，此时MyBatis会自动将这些参数放在一个map集合中

  1. 以arg0,arg1…为键，以参数为值；
  2. 以param1,param2…为键，以参数为值；

• 因此只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号。

• 使用arg或者param都行，要注意的是，arg是从arg0开始的，param是从param1开始的

<select id="checkLogin" resultType="User">  
	select * from t_user where username = #{arg0} and password = #{arg1}  
select>

<select id="checkLogin" resultType="User">
	select * from t_user where username = '${param1}' and password = '${param2}'
select>

map集合类型的参数

• 若mapper接口中的方法需要的参数为多个时，此时可以手动创建map集合，将这些数据放在map中只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号

<select id="checkLoginByMap" resultType="User">
	select * from t_user where username = #{username} and password = #{password}
select>

@Test
public void checkLoginByMap() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
	Map<String,Object> map = new HashMap<>();
	map.put("usermane","admin");
	map.put("password","123456");
	User user = mapper.checkLoginByMap(map);
	System.out.println(user);
}

实体类类型的参数

• 若mapper接口中的方法参数为实体类对象时此时可以使用${}和#{}，通过访问实体类对象中的属性名获取属性值，注意${}需要手动加单引号

<insert id="insertUser">
	insert into t_user values(null,#{username},#{password},#{age},#{sex},#{email})
insert>

@Test
public void insertUser() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
	User user = new User(null,"Tom","123456",12,"男","[email protected]");
	mapper.insertUser(user);
}

使用@Param标识参数

• 可以通过@Param注解标识mapper接口中的方法参数，此时，会将这些参数放在map集合中

  1. 以@Param注解的value属性值为键，以参数为值；
  2. 以param1,param2…为键，以参数为值；

• 只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号

    <select id="CheckLoginByParam" resultType="User">
        select * from t_user where username = #{username} and password = #{password}
    select>

@Test
public void checkLoginByParam() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
	mapper.CheckLoginByParam("admin","123456");
}

总结

• 建议分成两种情况进行处理

  1. 实体类类型的参数
  2. 使用@Param标识参数

MyBatis的增删改查

1. 添加

   
   <insert id="insertUser">
   	insert into t_user values(null,'admin','123456',23,'男','[email protected]')
   insert>
   

2. 删除

   
    <delete id="deleteUser">
        delete from t_user where id = 6
    delete>
   

3. 修改

   
    <update id="updateUser">
        update t_user set username = '张三' where id = 5
    update>
   

4. 查询一个实体类对象

     
   <select id="getUserById" resultType="com.atguigu.mybatis.bean.User">  
   	select * from t_user where id = 2  
   select>
   

5. 查询集合

   
   <select id="getUserList" resultType="com.atguigu.mybatis.bean.User">
   	select * from t_user
   select>
   

• 注意：

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