Mybatis学习笔记(一)

前言

1. MyBatis简介

1.1 Mybatis特性

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

1.2 Mybatis下载

MyBatis下载地址:https://github.com/mybatis/mybatis
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

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

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

2. 搭建Mybatis步骤

2.1 开发环境

IDE:idea 2019.2
构建工具:maven 3.5.4
MySQL版本:MySQL 8
MyBatis版本:MyBatis 3.5.7
以下Mybaits的工程搭建都在Maven中完成

2.2 创建Mybatis工程

(1)Maven配置参考以下文章
https://blog.csdn.net/weixin_44262932/article/details/125953580?spm=1001.2014.3001.5502
(2)新建工程
创建一个java工程
在这里插入图片描述
创建一个Module
在这里插入图片描述
确保Maven配置
在这里插入图片描述
a> 创建完成后在pom.xml文件中首先在 pom.xml 文件中设置 packing 标签,将打包方式设置为 jar 包;
b> 然后点击右上角的小图标自动导入 jar 包,或者使用你自己设置的快捷键自动导包。
在这里插入图片描述
c> 导入依赖

<dependencies>
        <!-- Mybatis核心 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.10</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.16</version>
        </dependency>
        <!-- log4j日志 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
</dependencies>

2.3 创建MyBatis核心配置文件

  1. 在 src/main/resources 包下面新建一个核心配置文件,一般命名为 mybatis-config.xml ;
  2. 核心配置文件主要用于配置连接数据库的环境以及 MyBatis 的全局配置信息,这里用的是优化版;
<?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>
    <!--mybatis中的核心配置文件必须按照指定的顺序配置
    The content of element type "configuration" must match
    "(properties?,settings?,typeAliases?,typeHandlers?,
    objectFactory?,objectWrapperFactory?,reflectorFactory?,
    plugins?,environments?,databaseIdProvider?,mappers?)".
    -->

    <properties resource="jdbc.properties"/>

    <typeAliases>
        <package name="com.xiaole.mybatis.pojo"/>
    </typeAliases>

    <environments default="development">
        <environment id="development">
            <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>

    <!--  引入mybatis的映射文件  -->
    <mappers>
        <package name="com.xiaole.mybatis.mapper"/>
    </mappers>
</configuration>

注:以上代码除了package标签内name属性的全类名需要更换,其他可不作更换。
3. 在 src/main/resources 文件夹下创建关于数据库连接的配置文件 jdbc.properties:

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC
jdbc.username=root
jdbc.password=123456

注:设置 properties 的时候为了区分同名的不同功能的参数,在配置文件中某一参数前面加上前缀,例如: jdbc.xxx;在MyBatis核心配置文件通过 properties 标签引入。

2.4 创建Mapper接口

  1. 这里的Mapper接口相当于之前的DAO接口,但区别在于,mapper仅仅是接口,不需要提供实现类,即“面向接口编程”
  2. 根据mybatis-mapper.xml文件配置,调用接口方法中对应的sql语句
  3. 首先在src/main/java路径下新建包,例如“com.xiaole.mybatis.mapper”用来放置实现各个模块功能的mapper接口,这里以接口UserMapper为例
package com.xiaole.mybatis.mapper;

import com.xiaole.mybatis.pojo.User;

import java.util.List;

public interface UserMapper {
    /**
     * 添加用户信息
     * @return
     */
    int insertUser();
    /**
     * 修改用户信息
     */
    void updateUser();
    /**
     * 删除用户信息
     */
    void deleteUser();
    /**
     * 根据id查询用户
     * @return
     */
    User getUserById();
    /**
     * 查询所有的用户信息
     * @return
     */
    List<User> getAllUser();
}

2.5 创建UserMapper的映射文件

在src/main/resource文件夹下创建与Mapper接口所在包名相一致的包,即“com.xiaole.mybatis.mapper”,在该包下创建UserMapper的映射文件,UserMapper.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">
<mapper namespace="com.xiaole.mybatis.mapper.UserMapper">

  <!--
    mapper接口和映射文件保证两个一致
    1、mapper接口的全类名和映射文件的namespace保持一致
    2、mapper接口中的方法名要和映射文件的sql的id保持一致
  -->
    <!--  int insertUser();  -->
    <insert id="insertUser">
        insert into t_user values (null,'admin','123456',23,'男','746873213@qq.com')
    </insert>

    <!--    void updateUser();-->
    <update id="updateUser">
        update t_user set username='root',password='123' where id='3'
    </update>

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

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

<!--  List<User> getAllUser();  -->
    <select id="getAllUser" resultType="User">
        select * from t_user;
    </select>
</mapper>

注意: mapper接口和映射文件保证两个一致
1. mapper接口的全类名和映射文件的namespace保持一致
2. mapper接口中的方法名要和映射文件的sql的id保持一致

2.6 加入log4j日志功能

  1. 加入log4j依赖
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
  1. 在src/main/resources目录下创建名为“log4j.xml”的配置文件
<?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>
  1. 在test\java编写代码测试。在此之前封装一个SqlSessionUtil工具类,代码如下
package com.xiaole.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;
import java.io.InputStream;

public class SqlSessionUtil {
    public static SqlSession getSqlSession(){
        SqlSession sqlSession = null;
        //获取核心配置文件的输入流
        InputStream inputStream = null;
        try {
            inputStream = Resources.getResourceAsStream("mybatis-config.xml");
            //获取SqlSessionFactoryBuilder对象
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            //获取SqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
            //获取sql的会话对象Sqlsession,是Mybatis提供的操作数据库的对象
            sqlSession = sqlSessionFactory.openSession(true);

        } catch (IOException e) {
            e.printStackTrace();
        }
        return sqlSession;
    }
}

然后是调用mapper接口中的方法来测试,这里以测试其中的更新方法为例

	@Test
    public void testMybatis() throws IOException {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //获取UserMapper的代理实现类对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //调用mapper接口中的方法,实现添加用户信息的功能
        int result = mapper.insertUser();
        //提供sql以及唯一标识找到sql并执行,唯一标识namespace.sqlId
//        int result = sqlSession.insert("com.xiaole.mybatis.mapper.UserMapper.insertUser");//用的不多
        System.out.println("结果" + result);
        //提交事务,这里可以不写,直接设置openSession(true)即可
//        sqlSession.commit();
        sqlSession.close();
    }

执行结果如下
在这里插入图片描述
以上虽报错但是执行成功了。解决上述报错方案:可将log4j的依赖中的版本往下降,然后重启再运行即可。我降到1.2.14版本后无报错信息。
在这里插入图片描述

3. 核心配置文件详情

<?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>
    <!--mybatis中的核心配置文件必须按照指定的顺序配置
    The content of element type "configuration" must match
    "(properties?,settings?,typeAliases?,typeHandlers?,
    objectFactory?,objectWrapperFactory?,reflectorFactory?,
    plugins?,environments?,databaseIdProvider?,mappers?)".
    -->


    <!-- 引入properties文件, 此后就可以在当前文件中使用${key}的方式访问value  -->
    <properties resource="jdbc.properties" />
    <!--
        typeAliases: 设置类型别名,即为某个具体的类型设置一个别名
        在Mybatis范围内就可以使用别名表示一个具体的类型
     -->
    <typeAliases>
    <!--
        type: 设置需要起别名的类型
        alias: 设置某个类型的别名

    -->
    <!--<typeAlias type="com.xiaole.mybatis.pojo.User" alias="abc"></typeAlias>-->
    <!--在不写alias的情况下,会默认有个别名,即类名-->
    <!--<typeAlias type="com.xiaole.mybatis.pojo.User"></typeAlias>-->
    <!--通过包设置类型别名,指定包下所有的类型将全部拥有默认的别名,即类名不区分大小写-->
        <package name="com.xiaole.mybatis.pojo"/>
    </typeAliases>
    <!--  enviroments:配置数据库的环境
      属性:
      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.xiaole.mybatis.mapper"/>
    </mappers>
</configuration>

4. 将MyBatis的核心配置文件与映射文件设置成模板

(1)在File>Setting>Editor>File and Code Templates中设置MyBatis核心配置文件模板mybatis-config
在这里插入图片描述

<?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>
    <!--mybatis中的核心配置文件必须按照指定的顺序配置
    The content of element type "configuration" must match
    "(properties?,settings?,typeAliases?,typeHandlers?,
    objectFactory?,objectWrapperFactory?,reflectorFactory?,
    plugins?,environments?,databaseIdProvider?,mappers?)".
    -->

    <properties resource="jdbc.properties" />
    
    <typeAliases>
        <package name=""/>
    </typeAliases>
    
    <environments default="development">
        <environment id="development">
            <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>
    <!--  引入mybatis的映射文件  -->
    <mappers>
        <package name=""/>
    </mappers>
</configuration>

(2)创建映射文件模板
在这里插入图片描述

<?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">
<mapper namespace="">
</mapper>

创建完成之后我们就可以在新建xml文件中找到该模板,然后直接创建即可
在这里插入图片描述

5. MyBatis 的增删改查

5.1 增删改

(1)对于增删改只需要在 mapper 接口中先创建一个方法,然后自己编写 mapper 映射文件中对应的 sql 语句即可;
(2)mapper接口的全类名和映射文件的namespace保持一致
(3)mapper接口中的方法名要和映射文件的sql的id保持一致

<!--  int insertUser();  -->
    <insert id="insertUser">
        insert into t_user values (null,'Lina','123456',23,'男','746873213@qq.com')
    </insert>

    <!--    void updateUser();-->
    <update id="updateUser">
        update t_user set username='root',password='123' where id='3'
    </update>

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

5.2 查询数据库中的信息

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

<!--  List<User> getAllUser();  -->
    <select id="getAllUser" resultType="User">
        select * from t_user;
    </select>

注:
(1)查询的标签 select 必须设置属性 resultType 或 resultMap ,用于设置实体类和数据库表的映射关系, mybatis 省了处理结果集的的过程,但是我们还要指定返回的结果集的类型:

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

(2)当我们在核心配置文件中设置了 typeAliases 标签时,即我们设置了以包为单位,将包下所有的类型设置默认的类型别名,这里映射的 id 可以改为 User 即类的类名(不区分大小写)

	<select id="getAllUser" resultType="User">
        select * from t_user;
	</select>

(3)当查询的数据为多条时,不能使用实体类作为返回值,只能使用集合,否则会抛出异常;

TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 8

在这里插入图片描述

(4) 没有设置属性 resultType 或 resultMap 的时候,报错信息如下:

Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement ‘com.atguigu.mybatis.mapper.UserMapper.getUserById’. It’s likely that neither a Result Type nor a Result Map was specified.

在这里插入图片描述

6. MyBatis获取参数值得两种方式

${}的本质就是字符串拼接,#{}的本质就是占位符赋值
${}使用字符串拼接的方式拼接sql,若为字符串类型或日期类型的字段进行赋值时,需要手动加单引号。
但是#{}使用占位符赋值的方式拼接sql,此时为字符串类型或日期类型的字段进行赋值时,可以自动添加单引号

6.1 单个字面量类型的参数

可以通过 ${} 和 #{} 以任意的名称获取参数值,但是需要注意 ${} 的单引号问题; ${} 需要手动设置单引号 ;#{} 在解析的时候会自动添加单引号
在这里插入图片描述

6.2 多个字面量类型的参数

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

6.3 map集合类型的参数

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
注:需要我们手动的创建map集合,并设置键

6.4 实体类类型的参数

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

6.5 使用@Param标识参数

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

6.6 总结

(1)建议有实体类的时候用属性值来访问;
(2)没有实体类的时候用 @Param 注解命名参数,不管字面量单个还是多个,是不是 map 集合都可以使用自己用注解定义的参数来访问。

7. MyBatis中的各种查询

7.1 查询一个实体类对象

(1)可以通过实体类对象接收
(2)可以通过list集合接收(建议直接用 list 集合接收)

mapper接口中定义的方法
在这里插入图片描述
mapper接口中映射文件sql语句编写
在这里插入图片描述
测试类编写
在这里插入图片描述
测试结果
在这里插入图片描述

通过 map 集合接收到的数据是乱序的,因为 map 集合本身是通过计算 hashcode 散射来放置数据的。

7.2 查询一个list集合

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

7.3 查询单个数据

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

7.4 查询一条数据为map集合

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

7.5 查询多条数据为map集合

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

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值