MyBtais
Published on 2022-11-22 14:59 in 分类: 后端 with HFUUwzy
分类: 后端

MyBtais

1. Mybatis简介

前情提示:本文笔记依据为狂神说

学习帮助文档,很重要! 入门_MyBatis中文网

环境说明:

  • jdk 8+ (本人jdk17)
  • MySQL 5.7.19(8.0)
  • maven-3.6.0(3.8.6)
  • IDEA(2022..2.1)

学习前需要掌握:

  • JDBC(非必要)
  • MySQL
  • Java 基础
  • Maven
  • Junit

image

1.1、什么是MyBatis

  • MyBatis 是一款优秀的持久层框架
  • MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程
  • MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息,将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
  • MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code,并且改名为MyBatis 。
  • 2013年11月迁移到Github .
  • Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html
  • GitHub : https://github.com/mybatis/mybatis-3

1.2、持久化

  • 持久化是将程序数据在持久状态和瞬时状态间转换的机制。
    • 即把数据(如内存中的对象)保存到可永久保存的存储设备中(如磁盘)。持久化的主要应用是将内存中的对象存储在数据库中,或者存储在磁盘文件中、XML数据文件中等等。
    • JDBC就是一种持久化机制。文件IO也是一种持久化机制。
    • 在生活中 : 将鲜肉冷藏,吃的时候再解冻的方法也是。将水果做成罐头的方法也是。
  • 为什么需要持久化服务呢?那是由于内存本身的缺陷引起的
    • 内存断电后数据会丢失,但有一些对象是无论如何都不能丢失的,比如银行账号等,遗憾的是,人们还无法保证内存永不掉电。
    • 内存过于昂贵,与硬盘、光盘等外存相比,内存的价格要高2~3个数量级,而且维持成本也高,至少需要一直供电吧。所以即使对象不需要永久保存,也会因为内存的容量限制不能一直呆在内存中,需要持久化来缓存到外存。

1.3、持久层

  • 什么是持久层?
    • 完成持久化工作的代码块 . ——> dao层 【DAO (Data Access Object) 数据访问对象】
    • 大多数情况下特别是企业级应用,数据持久化往往也就意味着将内存中的数据保存到磁盘上加以固化,而持久化的实现过程则大多通过各种关系数据库来完成。
    • 不过这里有一个字需要特别强调,也就是所谓的“层”。对于应用系统而言,数据持久功能大多是必不可少的组成部分。也就是说,我们的系统中,已经天然的具备了“持久层”概念?也许是,但也许实际情况并非如此。之所以要独立出一个“持久层”的概念,而不是“持久模块”,“持久单元”,也就意味着,我们的系统架构中,应该有一个相对独立的逻辑层面,专著于数据持久化逻辑的实现.
    • 与系统其他部分相对而言,这个层面应该具有一个较为清晰和严格的逻辑边界。 【说白了就是用来操作数据库存在的!】

1.4、为什么需要Mybatis

  • Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据 .
  • 传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .
  • MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) —>对象关系映射
  • 所有的事情,不用Mybatis依旧可以做到,只是用了它,所有实现会更加简单!技术没有高低之分,只有使用这个技术的人有高低之别
  • MyBatis的优点
    • 简单易学:本身就很小且简单。没有任何第三方依赖,最简单安装只要两个jar文件+配置几个sql映射文件就可以了,易于学习,易于使用,通过文档和源代码,可以比较完全的掌握它的设计思路和实现。
    • 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
    • 解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。
    • 提供xml标签,支持编写动态sql。
    • …….
  • 最重要的一点,使用的人多!公司需要!

2. 第一个Mybatis程序

思路流程:搭建环境—>导入Mybatis—->编写代码—->测试

2.1、代码演示

  1. 搭建实验数据库

    CREATE DATABASE `mybatis`;
    use `mybatis` 
    
    DROP TABLE IF EXISTS `user`;
    
    CREATE TABLE `user` (
      `id` int(20) NOT NULL,
      `name` varchar(30) DEFAULT NULL,
      `pwd` varchar(30) DEFAULT NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    
    insert  into `user`(`id`,`name`,`pwd`) values (1,'狂神','123456'),(2,'张三','abcdef')
    
    INSERT INTO `user` (`id`,`name`,`pwd`) VALUES (3,'王二','552211')
    
    
  2. maven环境搭建

    <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/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.Hfuuwzy</groupId>
      <artifactId>Mybatis-Study</artifactId>
      <packaging>pom</packaging>
      <version>1.0-SNAPSHOT</version>
      <modules>
        <module>mybatis-01</module>
      </modules>
      <name>Mybatis-Study Maven Webapp</name>
      <url>http://maven.apache.org</url>
    
    
    <!--导入依赖-->
      <dependencies>
    
        <dependency>
          <groupId>mysql</groupId>
          <artifactId>mysql-connector-java</artifactId>
          <version>8.0.30</version>
        </dependency>
    
        <dependency>
          <groupId>org.mybatis</groupId>
          <artifactId>mybatis</artifactId>
          <version>3.5.11</version>
        </dependency>
    
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>4.13.2</version>
          <scope>test</scope>
        </dependency>
    
        <dependency>
          <groupId>org.projectlombok</groupId>
          <artifactId>lombok</artifactId>
          <version>1.18.24</version>
          <scope>provided</scope>
        </dependency>
    
      </dependencies>
    
    
      <build>
        <finalName>Mybatis-Study</finalName>
    
          <plugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.8.1</version>
              <configuration>
                <!--根据个人需要自己修改-->
                <source>17</source>
                <target>17</target>
              </configuration>
            </plugin>
          </plugins>
    
        <resources>
          <resource>
            <directory>src/main/java</directory>
            <includes>
              <include>**/*.properties</include>
              <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
          </resource>
    
          <resource>
            <directory>src/main/resources</directory>
            <includes>
              <include>**/*.properties</include>
              <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
          </resource>
        </resources>
    
      </build>
    </project>
    
  3. 编写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>
      
          <environments default="development">
              <environment id="development">
                  <transactionManager type="JDBC"/>
                  <dataSource type="POOLED">
                      <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <!--mysql80的驱动-->
                      <property name="url" value="jdbc:mysql://localhost:3306/mybatis?						  			  
         					useSSL=false&amp;useUnicode=true&amp;serverTimezone=GMT"/>
                      <!-- mysql8.0需要配置时区    serverTimezone=GMT-->
                      <property name="username" value="root"/>
                      <property name="password" value="521wzy..."/>
                  </dataSource>
              </environment>
          </environments>
      <!--    每一个Mapper.xml都需要在Mybatis核心配置文件中注册-->
          <mappers>
              <mapper resource="com/Hfuuwzy/mapper/UserMapper.xml"/>
          </mappers>
      </configuration>
      
  4. 创建Mybatis工具类获取SqlSession对象连接

    package com.Hfuuwzy.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 MybatisUtils {
        // 提升作用域
        private static SqlSessionFactory sqlSessionFactory;
    
        static{
            try{
                // 使用Mybatis第一步,获取sqlSessionFactory对象
                String resource = "mybatis-config.xml";
                InputStream inputStream = Resources.getResourceAsStream(resource);
                sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            }catch (IOException e){
                e.printStackTrace();
            }
        }
    
        // 获取SqlSession对象连接
        public static SqlSession getSession(){
            return sqlSessionFactory.openSession();
        }
    
    }
    
  5. 创建实体类

    package com.Hfuuwzy.pojo;
    
    import lombok.Data;
    
    @Data
    public class User {
        private int id;
        private String name;
        private String pwd;
    }
    
    
  6. 创建mapper接口

    package com.Hfuuwzy.mapper;
    
    import com.Hfuuwzy.pojo.User;
    
    import java.util.List;
    
    public interface UserMapper {
        List<User> getUserList();
    }
    
  7. 编写Mapper.xml配置文件

    • namespace 十分重要,不能写错!

      <?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.Hfuuwzy.mapper.UserMapper">
      <!--标签id绑定方法,返回类型为返回值,黄色体里面写sql语句    -->
          <select id="getUserList" resultType="com.Hfuuwzy.pojo.User">
              select * from user
          </select>
      </mapper>
      
  8. 编写测试类

    • Junit包测试
    package com.Hfuuwzy.mapper;
    
    import com.Hfuuwzy.pojo.User;
    import com.Hfuuwzy.utils.MybatisUtils;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    
    import java.util.List;
    
    public class UserMapperTest {
        @Test
        public void test(){
    
            //第一步: 获取sqlSession对象
            SqlSession sqlSession = MybatisUtils.getSession();
    
            // 方式一(主流): 执行sql
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            List<User> userList = mapper.getUserList();
    
    //        // 方式二:
    //        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    //        List<User> userList = mapper.getUserList();
    
    
            for (User user : userList) {
                System.out.println(user);
            }
            // 关闭sqlSession
            sqlSession.close();
        }
    
    }
    
    

2. 碰到的各种问题

(22条消息) Error java 错误 不支持发行版本5 ( 完美解决版)_. 清酒凉茶“的博客-CSDN博客_java错误不支持发行版本

(22条消息) useSSL=false 连接配置详解_HeroSongZ的博客-CSDN博客_usessl

/*
error1:
org.apache.ibatis.binding.BindingException: Type interface com.Hfuuwzy.dao.UserDao is not known to the MapperRegistry.
	配置文件没有注册
<!--    每一个Mapper.xml都需要在Mybatis核心配置文件中注册-->
*/

/*error2:
### The error may exist in com/Hfuuwzy/dao/UserMapper.xml
Could not find resource com/Hfuuwzy/dao/UserMapper.xml
   Maven静态资源过滤问题
*/
    <resources>
      <resource>
        <directory>src/main/java</directory>
        <includes>
          <include>**/*.properties</include>
          <include>**/*.xml</include>
        </includes>
        <filtering>true</filtering>
      </resource>

      <resource>
        <directory>src/main/resources</directory>
        <includes>
          <include>**/*.properties</include>
          <include>**/*.xml</include>
        </includes>
        <filtering>true</filtering>
      </resource>
    </resources>

//字体设置问题 characterEncoding=utf8;

3. CRUD

3.1、namespace

  1. 将上面案例中的UserMapper接口改名为 UserDao;
  2. 将UserMapper.xml中的namespace改为为UserDao的路径 .
  3. 再次测试

结论:

配置文件中namespace中的名称为对应Mapper接口或者Dao接口的完整包名,必须一致!

3.2、select

  • select标签是mybatis中最常用的标签之一
  • select语句有很多属性可以详细配置每一条SQL语句
    • id
      • 命名空间中唯一的标识符
      • 接口中的方法名与映射文件中的SQL语句ID 一一对应
    • parameterType
      • 传入SQL语句的参数类型 。【万能的Map,可以多尝试使用】
    • resultType
      • SQL语句返回值类型。【完整的类名或者别名】

需求:根据id查询用户

  1. 在UserMapper中添加对应方法

    public interface UserMapper {    
        // 一个方法对应一个sql语句
    
        // 查询全部用户
        List<User> getUserList();
        // 根据Id查询用户
        List<User> getUserById(int id);
    }
    
  2. 在UserMapper.xml中添加Select语句

     <select id="getUserList" resultType="com.Hfuuwzy.pojo.User">
            select * from user
        </select>
    
        <select id="getUserById" parameterType="int" resultType="com.Hfuuwzy.pojo.User">
            select * from user where id = #{id}
        </select>
    
  3. 测试类中测试

      @Test
        public void getUserList(){
    
            //第一步: 获取sqlSession对象
            SqlSession sqlSession = MybatisUtils.getSession();
    
            // 方式一(主流): 执行sql
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            List<User> userList = mapper.getUserList();
    
    //        // 方式二:
    //        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    //        List<User> userList = mapper.getUserList();
    
    
            for (User user : userList) {
                System.out.println(user);
            }
            // 关闭sqlSession
            sqlSession.close();
        }
    
        @Test
        public void getUserById(){
            SqlSession sqlSession = MybatisUtils.getSession();
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            List<User> userById = mapper.getUserById(1);
    
            userById.forEach(System.out::println);
            sqlSession.close();
    
        }
    

3.3、insert

我们一般使用insert标签进行插入操作,它的配置和select标签差不多!

需求:给数据库增加一个用户

  1. 在UserMapper接口中添加对应的方法

    //添加一个用户
    int addUser(User user);
    
  2. 在UserMapper.xml中添加insert语句

    <insert id="addUser" parameterType="com.Hfuuwzy.pojo.User" >
            insert into user (id,`name`,pwd) values (#{id},#{name},#{pwd})
        </insert>
    
  3. 测试

       @Test
        public void addUser(){
            SqlSession sqlSession = MybatisUtils.getSession();
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    //        mapper.addUser(new User(5,"妮露","wzy521521"));
            int res = mapper.addUser(new User(4,"胡桃","456213"));
            if(res > 0){
                System.out.println("插入成功");
            }
            // 提交事务!!!
            sqlSession.commit();
            sqlSession.close();
        }
    

注意点:增、删、改操作需要提交事务!

3.4、update

我们一般使用update标签进行更新操作,它的配置和select标签差不多!

需求:修改用户的信息

  1. 同理,编写接口方法

    //修改一个用户
    int updateUser(User user);
    
  2. 编写对应的配置文件SQL

     <update id="updateUser" parameterType="com.Hfuuwzy.pojo.User">
            update user set  `name` = #{name}, pwd = #{pwd} where id = #{id} -- 关于主键使用where
        </update>
    
  3. 测试

     @Test
        public void updateUser(){
            SqlSession sqlSession = MybatisUtils.getSession();
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            int res = mapper.updateUser(new User(2, "雷神", "521wzy521"));
            String result = res >0 ? "修改成功" : "修改失败";
            System.out.println(result);
            sqlSession.commit();
            sqlSession.close();
        }
    

3.5、delete

我们一般使用delete标签进行删除操作,它的配置和select标签差不多!

需求:根据id删除一个用户

  1. 同理,编写接口方法

    //根据id删除用户
    int deleteUser(int id);
    
  2. 编写对应的配置文件SQL

    <delete id="deleteUser" parameterType="int">
            delete from user where id = #{id};
        </delete>
    
  3. 测试

    @Test
        public void deleteUser(){
            SqlSession sqlSession = MybatisUtils.getSession();
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            String res = mapper.deleteUser(5) > 0 ? "删除成功" : "删除失败";
            System.out.println(res);
            sqlSession.commit();
            sqlSession.close();
        }
    

小结:

  • 所有的增删改操作都需要提交事务
  • 接口所有的普通参数,尽量都写上@Param参数,尤其是多个参数时,必须写上!
  • 有时候根据业务的需求,可以考虑使用map传递参数!
  • 为了规范操作,在SQL的配置文件中,我们尽量将Parameter参数和resultType都写上!

3.6、思考题

模糊查询like语句该怎么写?

第1种:在Java代码中添加sql通配符。

string wildcardname = “%smi%”;
list<name> names = mapper.selectlike(wildcardname);
<select id=”selectlike”>
 select * from foo where bar like #{value}
</select>

第2种:在sql语句中拼接通配符,会引起sql注入

string wildcardname = “smi”;
list<name> names = mapper.selectlike(wildcardname);
<select id=”selectlike”>
     select * from foo where bar like "%"#{value}"%"
</select>

4. MyBatis配置解析

4.1、核心配置文件

  • mybatis-config.xml 系统核心配置文件
  • MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
  • 能配置的内容如下:
configuration(配置)
    properties(属性)
    settings(设置)
    typeAliases(类型别名)
    typeHandlers(类型处理器)
    objectFactory(对象工厂)
    plugins(插件)
    environments(环境配置)
        environment(环境变量)
            transactionManager(事务管理器)
            dataSource(数据源)
    databaseIdProvider(数据库厂商标识)
    mappers(映射器)
<!-- 注意元素节点的顺序!顺序不对会报错 -->

我们可以阅读 mybatis-config.xml 上面的dtd的头文件!【演示】

4.2、environments元素

<environments default="development">
  <environment id="development">
    <transactionManager type="JDBC">
      <property name="..." value="..."/>
    </transactionManager>
    <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>
  • 配置MyBatis的多套运行环境,将SQL映射到多个不同的数据库上,必须指定其中一个为默认运行环境(通过default指定)

  • 子元素节点:environment

    • 具体的一套环境,通过设置id进行区别,id保证唯一!

    • 子元素节点:transactionManager - [ 事务管理器 ]

      <!-- 语法 -->
      <transactionManager type="[ JDBC | MANAGED ]"/>
      
    • 子元素节点:数据源(dataSource)

      • dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

      • 数据源是必须配置的。

      • 有三种内建的数据源类型

        type="[UNPOOLED|POOLED|JNDI]")
        
      • unpooled: 这个数据源的实现只是每次被请求时打开和关闭连接。

      • pooled: 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。

      • jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。

      • 数据源也有很多第三方的实现,比如dbcp,c3p0,druid等等….

4.3、mappers元素

4.3.1、mappers

  • 映射器 : 定义映射SQL语句文件
  • 既然 MyBatis 的行为其他元素已经配置完了,我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:/// 的 URL),或类名和包名等。映射器是MyBatis中最核心的组件之一,在MyBatis 3之前,只支持xml映射器,即:所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始,还支持接口映射器,这种映射器方式允许以Java代码的方式注解定义SQL语句,非常简洁。

4.3.2、引入资源方式

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

<!-- 使用完全限定资源定位符(URL) -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

<!-- 
使用映射器接口实现类的完全限定类名
需要配置文件名称和接口名称一致,并且位于同一目录下
-->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>

<!-- 
将包内的映射器接口实现全部注册为映射器
但是需要配置文件名称和接口名称一致,并且位于同一目录下
-->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>

4.3.3、Mapper文件

<?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.kuang.mapper.UserMapper">
</mapper>
  • namespace中文意思:命名空间,作用如下:
    1. namespace和子元素的id联合保证唯一 , 区别不同的mapper
    2. 绑定DAO接口
      • namespace的命名必须跟某个接口同名
      • 接口中的方法与映射文件中sql语句id应该一一对应
    3. namespace命名规则 : 包名+类名

MyBatis 的真正强大在于它的映射语句,这是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比,你会立即发现省掉了将近 95% 的代码。MyBatis 为聚焦于 SQL 而构建,以尽可能地为你减少麻烦。

4.4、Properties优化

数据库这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,亦可通过 properties 元素的子元素来传递。具体的官方文档

我们来优化我们的配置文件

第一步 ; 在资源目录下新建一个db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=123456

第二步 : 将文件导入properties 配置文件

<configuration>
    <!--导入properties文件-->
    <properties resource="db.properties"/>
    <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>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

更多操作,可以查看官方文档!【演示带领学习】

  • 配置文件优先级问题
  • 新特性:使用占位符

4.5、typeAliases优化

类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关,存在的意义仅在于用来减少类完全限定名的冗余。

<!--配置别名,注意顺序-->
<typeAliases>
    <typeAlias type="com.kuang.pojo.User" alias="User"/>
</typeAliases>

当这样配置时,User可以用在任何使用com.kuang.pojo.User的地方。

也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:

<typeAliases>
    <package name="com.kuang.pojo"/>
</typeAliases>

每一个在包 com.kuang.pojo 中的 Java Bean,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。

若有注解,则别名为其注解值。见下面的例子:

@Alias("user")
public class User {
    ...
}

【演示】去官网查看一下Mybatis默认的一些类型别名!

4.6、其他配置浏览

4.6.1、设置

  • 设置(settings)相关 => 查看帮助文档

    • 懒加载
    • 日志实现
    • 缓存开启关闭
  • 一个配置完整的 settings 元素的示例如下:

    <settings>
      <setting name="cacheEnabled" value="true"/>
      <setting name="lazyLoadingEnabled" value="true"/>
      <setting name="multipleResultSetsEnabled" value="true"/>
      <setting name="useColumnLabel" value="true"/>
      <setting name="useGeneratedKeys" value="false"/>
      <setting name="autoMappingBehavior" value="PARTIAL"/>
      <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
      <setting name="defaultExecutorType" value="SIMPLE"/>
      <setting name="defaultStatementTimeout" value="25"/>
      <setting name="defaultFetchSize" value="100"/>
      <setting name="safeRowBoundsEnabled" value="false"/>
      <setting name="mapUnderscoreToCamelCase" value="false"/>
      <setting name="localCacheScope" value="SESSION"/>
      <setting name="jdbcTypeForNull" value="OTHER"/>
      <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
    </settings>
    

4.6.2、类型处理器

官方文档

  • 无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时, 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。
  • 你可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型。【了解即可】

4.6.3、对象工厂

官方文档

  • MyBatis 每次创建结果对象的新实例时,它都会使用一个对象工厂(ObjectFactory)实例来完成。
  • 默认的对象工厂需要做的仅仅是实例化目标类,要么通过默认构造方法,要么在参数映射存在的时候通过有参构造方法来实例化。
  • 如果想覆盖对象工厂的默认行为,则可以通过创建自己的对象工厂来实现。【了解即可】

4.7 生命周期和作用域

作用域(Scope)和生命周期

理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的,因为错误的使用会导致非常严重的并发问题。

我们可以先画一个流程图,分析一下Mybatis的执行过程!

image

作用域理解

  • SqlSessionFactoryBuilder 的作用在于创建 SqlSessionFactory,创建成功后,SqlSessionFactoryBuilder 就失去了作用,所以它只能存在于创建 SqlSessionFactory 的方法中,而不要让其长期存在。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。
  • SqlSessionFactory 可以被认为是一个数据库连接池,它的作用是创建 SqlSession 接口对象。因为 MyBatis 的本质就是 Java 对数据库的操作,所以 SqlSessionFactory 的生命周期存在于整个 MyBatis 的应用之中,所以一旦创建了 SqlSessionFactory,就要长期保存它,直至不再使用 MyBatis 应用,所以可以认为 SqlSessionFactory 的生命周期就等同于 MyBatis 的应用周期。
  • 由于 SqlSessionFactory 是一个对数据库的连接池,所以它占据着数据库的连接资源。如果创建多个 SqlSessionFactory,那么就存在多个数据库连接池,这样不利于对数据库资源的控制,也会导致数据库连接资源被消耗光,出现系统宕机等情况,所以尽量避免发生这样的情况。
  • 因此在一般的应用中我们往往希望 SqlSessionFactory 作为一个单例,让它在应用中被共享。所以说 SqlSessionFactory 的最佳作用域是应用作用域。
  • 如果说 SqlSessionFactory 相当于数据库连接池,那么 SqlSession 就相当于一个数据库连接(Connection 对象),你可以在一个事务里面执行多条 SQL,然后通过它的 commit、rollback 等方法,提交或者回滚事务。所以它应该存活在一个业务请求中,处理完整个请求后,应该关闭这条连接,让它归还给 SqlSessionFactory,否则数据库资源就很快被耗费精光,系统就会瘫痪,所以用 try…catch…finally… 语句来保证其正确关闭。
  • 所以 SqlSession 的最佳的作用域是请求或方法作用域。

image

5. ResultMap

要解决的问题:属性名和字段名不一致

环境:新建一个项目,将之前的项目拷贝过来

5.1、查询为null问题

  1. 查看之前的数据库的字段名

image

  1. Java中的实体类设计

    package com.Hfuuwzy.pojo;
    
    
    public class User {
        private int id;
        private String name;
        private String password;
    // 构造方法 
    // get set
    // toString
    // 注意,使用lombok会导致样例没达到效果,因该是setPwd方法的原因
    }
    
    
    
  2. 接口

    public interface UserMapper {
        // 根据Id查询用户
        User getUserById(int id);
    }
    
  3. mapper映射文件

    <select id="getUserById" resultType="user">
    select * from user where id = #{id}
    </select>
    
  4. 测试

    @Test
        public void getUserById(){
            SqlSession sqlSession = MybatisUtils.getSession();
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            User user = mapper.getUserById(4);
    
            System.out.println(user);
    
            sqlSession.close();
    
        }
    

结果:

  • User{id=1, name=’狂神’, password=’null’}
  • 查询出来发现 password 为空 . 说明出现了问题!

分析:

  • select * from user where id = #{id} 可以看做

    select id,name,pwd from user where id = #

  • mybatis会根据这些查询的列名(会将列名转化为小写,数据库不区分大小写) , 去对应的实体类中查找相应列名的set方法设值 , 由于找不到setPwd() , 所以password返回null ; 【自动映射】

5.2、解决方案

方案一:为列名指定别名 , 别名和java实体类的属性名一致 .

select id,name,pwd as password from user where id = #{id}

方案二:使用结果集映射->ResultMap 【推荐】

<!--方法二:    结果集映射-->
    <resultMap id="UserMap" type="user">

<!--        显而易见的可以忽视-->
        <!-- column是数据库表的列名 , property是对应实体类的属性名 -->
<!--        <id column="id" property="id"/>   &lt;!&ndash; id为主键 &ndash;&gt;-->
<!--        <result column="name" property="name"/>-->
        <result column="pwd" property="password"/>
    </resultMap>

    <select id="getUserById" resultMap="UserMap">
        select id,name,pwd from user where id = #{id}
    </select>

5.3、ResultMap

5.3.1、自动映射

  • resultMap 元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来。
  • 实际上,在为一些比如连接的复杂语句编写映射代码的时候,一份 resultMap 能够代替实现同等功能的长达数千行的代码。
  • ResultMap 的设计思想是,对于简单的语句根本不需要配置显式的结果映射,而对于复杂一点的语句只需要描述它们的关系就行了。

你已经见过简单映射语句的示例了,但并没有显式指定 resultMap。比如:

<select id="selectUserById" resultType="map">    select id , name , pwd     from user     where id = #{id}</select>

(不建议使用)

上述语句只是简单地将所有的列映射到 HashMap 的键上,这由 resultType 属性指定。虽然在大部分情况下都够用,但是 HashMap 不是一个很好的模型。你的程序更可能会使用 JavaBean 或 POJO(Plain Old Java Objects,普通老式 Java 对象)作为模型。

ResultMap 最优秀的地方在于,虽然你已经对它相当了解了,但是根本就不需要显式地用到他们。

5.3.2、手动映射

  1. 返回值类型为resultMap

    <select id="getUserById" resultMap="UserMap">
    select id,name,pwd from user where id = #{id}
    </select>
    
  2. 编写resultMap,实现手动映射!

    <resultMap id="UserMap" type="user">
    <!--        显而易见的可以忽视-->
            <!-- column是数据库表的列名 , property是对应实体类的属性名 -->
            <id column="id" property="id"/>   <!-- id为主键 -->
            <result column="name" property="name"/>
            <result column="pwd" property="password"/>
        </resultMap>
    

如果这个世界总是这么简单就好了。

但是肯定不是的,数据库中,存在一对多,多对一的情况,我们之后会使用到一些高级的结果集映射,association,collection这些,我们将在之后讲解,今天你们需要把这些知识都消化掉才是最重要的!理解结果集映射的这个概念!

6. 日志和分页

6.1、日志工厂

思考:我们在测试SQL的时候,要是能够在控制台输出 SQL 的话,是不是就能够有更快的排错效率?

如果一个 数据库相关的操作出现了问题,我们可以根据输出的SQL语句快速排查问题。

对于以往的开发过程,我们会经常使用到debug模式来调节,跟踪我们的代码执行过程。但是现在使用Mybatis是基于接口,配置文件的源代码执行过程。因此,我们必须选择日志工具来作为我们开发,调节程序的工具。

Mybatis内置的日志工厂提供日志功能,具体的日志实现有以下几种工具:

  • SLF4J
  • Apache Commons Logging
  • Log4j 2
  • Log4j
  • JDK logging

具体选择哪个日志实现工具由MyBatis的内置日志工厂确定。它会使用最先找到的(按上文列举的顺序查找)。 如果一个都未找到,日志功能就会被禁用。

标准日志实现

指定 MyBatis 应该使用哪个日志记录实现。如果此设置不存在,则会自动发现日志记录实现。

<settings>    
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

测试,可以看到控制台有大量的输出!我们可以通过这些输出来判断程序到底哪里出了Bug

6.2、Log4j

简介:

  • Log4j是Apache的一个开源项目
  • 通过使用Log4j,我们可以控制日志信息输送的目的地:控制台,文本,GUI组件….
  • 我们也可以控制每一条日志的输出格式;
  • 通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。

使用步骤:

  1. 导入log4j的包

       <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    
  2. 配置文件编写

    #将等级为DEBUG的日志信息输出到console和file这两个目的地,console和file的定义在下面的代码
    log4j.rootLogger=DEBUG,console,file
    #控制台输出的相关设置
    log4j.appender.console = org.apache.log4j.ConsoleAppender
    log4j.appender.console.Target = System.out
    log4j.appender.console.Threshold=DEBUG
    log4j.appender.console.layout = org.apache.log4j.PatternLayout
    log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
    
    #文件输出的相关设置
    log4j.appender.file = org.apache.log4j.RollingFileAppender
    log4j.appender.file.File=./log/Hfuuwzy.log
    log4j.appender.file.MaxFileSize=10mb
    log4j.appender.file.Threshold=DEBUG
    log4j.appender.file.layout=org.apache.log4j.PatternLayout
    log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
    
    #日志输出级别
    log4j.logger.org.mybatis=DEBUG
    log4j.logger.java.sql=DEBUG
    log4j.logger.java.sql.Statement=DEBUG
    log4j.logger.java.sql.ResultSet=DEBUG
    log4j.logger.java.sql.PreparedStatement=DEBUG
    
  3. setting设置日志实现

    <settings> 
    <setting name="logImpl" value="LOG4J"/>
    </settings>
    
  4. 在程序中使用Log4j进行输出!

    import org.apache.log4j.Logger;
    static Logger logger = Logger.getLogger(UserMapperTest.class);
    
    // 把方法中的三个语句穿插到程序之中
        @Test
        public void testLog4j(){
            logger.info("info:进入selectUser方法");
            logger.debug("debug:进入selectUser方法");
            logger.error("error: 进入selectUser方法");
        }
    
    
  5. 测试,看控制台输出!

    • 使用Log4j 输出日志
    • 可以看到还生成了一个日志的文件 【需要修改file的日志级别】

6.3、limit实现分页

思考:为什么需要分页?

在学习mybatis等持久层框架的时候,会经常对数据进行增删改查操作,使用最多的是对数据库进行查询操作,如果查询大量数据的时候,我们往往使用分页进行查询,也就是每次处理小部分数据,这样对数据库压力就在可控范围内。

使用Limit实现分页

#语法
SELECT * FROM table LIMIT stratIndex,pageSize
SELECT * FROM table LIMIT 5,10; // 检索记录行 6-15   
#为了检索从某一个偏移量到记录集的结束所有的记录行,可以指定第二个参数为 -1SELECT * FROM table LIMIT 95,-1; // 检索记录行 96-last.   
#如果只给定一个参数,它表示返回最大的记录行数目:    
SELECT * FROM table LIMIT 5; //检索前 5 个记录行   
#换句话说,LIMIT n 等价于 LIMIT 0,n。

步骤:

  1. 修改Mapper文件

    <select id="selectUser" parameterType="map" resultType="user">
        select * from user limit #{startIndex},#{pageSize}
    </select>
    
  2. Mapper接口,参数为map

    //选择全部用户实现分页
    List<User> selectUser(Map<String,Integer> map);
    
  3. 在测试类中传入参数测试

    • 推断:起始位置 = (当前页面 - 1 ) * 页面大小
    //分页查询 , 两个参数startIndex , pageSize
    @Test
    public void testSelectUser() {
        SqlSession session = MybatisUtils.getSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        int currentPage = 1;  //第几页
        int pageSize = 2;  //每页显示几个
        Map<String,Integer> map = new HashMap<String,Integer>();
        map.put("startIndex",(currentPage-1)*pageSize);
        map.put("pageSize",pageSize);
        List<User> users = mapper.selectUser(map);
        for (User user: users){
            System.out.println(user);
        }
        session.close();
    }
    

7. 使用注解开发

’7.1、面向接口编程

  • 大家之前都学过面向对象编程,也学习过接口,但在真正的开发中,很多时候我们会选择面向接口编程
  • 根本原因 : 解耦 , 可拓展 , 提高复用 , 分层开发中 , 上层不用管具体的实现 , 大家都遵守共同的标准 , 使得开发变得容易 , 规范性更好
  • 在一个面向对象的系统中,系统的各种功能是由许许多多的不同对象协作完成的。在这种情况下,各个对象内部是如何实现自己的,对系统设计人员来讲就不那么重要了;
  • 而各个对象之间的协作关系则成为系统设计的关键。小到不同类之间的通信,大到各模块之间的交互,在系统设计之初都是要着重考虑的,这也是系统设计的主要工作内容。面向接口编程就是指按照这种思想来编程。

关于接口的理解

  • 接口从更深层次的理解,应是定义(规范,约束)与实现(名实分离的原则)的分离。
  • 接口的本身反映了系统设计人员对系统的抽象理解。
  • 接口应有两类:
    • 第一类是对一个个体的抽象,它可对应为一个抽象体(abstract class);
    • 第二类是对一个个体某一方面的抽象,即形成一个抽象面(interface);
  • 一个体有可能有多个抽象面。抽象体与抽象面是有区别的。

三个面向区别

  • 面向对象是指,我们考虑问题时,以对象为单位,考虑它的属性及方法 .
  • 面向过程是指,我们考虑问题时,以一个具体的流程(事务过程)为单位,考虑它的实现 .
  • 接口设计与非接口设计是针对复用技术而言的,与面向对象(过程)不是一个问题.更多的体现就是对系统整体的架构

7.2、利用注解开发

  • mybatis最初配置信息是基于 XML ,映射语句(SQL)也是定义在 XML 中的。而到MyBatis 3提供了新的基于注解的配置。不幸的是,Java 注解的的表达力和灵活性十分有限。最强大的 MyBatis 映射并不能用注解来构建
  • sql 类型主要分成 :

【注意】利用注解开发就不需要mapper.xml映射文件了 .

  1. 我们在我们的接口中添加注解

    //查询全部用户
    @Select("select id,name,pwd password from user")
    public List<User> getAllUser();
    
  2. 在mybatis的核心配置文件中注入

    <!--使用class绑定接口-->
    <mappers>
        <mapper class="com.kuang.mapper.UserMapper"/>
    </mappers>
    
  3. 我们去进行测试

    @Test
    public void testGetAllUser() {
        SqlSession session = MybatisUtils.getSession();
        //本质上利用了jvm的动态代理机制
        UserMapper mapper = session.getMapper(UserMapper.class);
    ●   List<User> users = mapper.getAllUser();
        for (User user : users){
            System.out.println(user);
        }
        session.close();
    }
    
  4. 利用Debug查看本质

image

  1. 本质上利用了jvm的动态代理机制

image

  1. Mybatis详细的执行流程

image

7.3、注解增删改

改造MybatisUtils工具类的getSession( ) 方法,重载实现。【鸡汤:多看源码实现】

   //获取SqlSession连接
   public static SqlSession getSession(){
       return getSession(true); //事务自动提交
   }
   public static SqlSession getSession(boolean flag){
       return sqlSessionFactory.openSession(flag);
   }

【注意】确保实体类和数据库字段对应

查询:

  1. 编写接口方法注解

    //根据id查询用户
    @Select("select * from user where id = #{id}")
    User selectUserById(@Param("id") int id);
    
  2. 测试

    @Test
    public void testSelectUserById() {
        SqlSession session = MybatisUtils.getSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        User user = mapper.selectUserById(1);
        System.out.println(user);
        session.close();
    }
    

新增:

  1. 编写接口方法注解

    //添加一个用户
    @Insert("insert into user (id,name,pwd) values (#{id},#{name},#{pwd})")
    int addUser(User user);
    
  2. 测试

    @Test
    public void testAddUser() {
        SqlSession session = MybatisUtils.getSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        User user = new User(6, "秦疆", "123456");
        mapper.addUser(user);
        session.close();
    }
    

修改:

  1. 编写接口方法注解

    //修改一个用户
    @Update("update user set name=#{name},pwd=#{pwd} where id = #{id}")
    int updateUser(User user);
    
  2. 测试

    @Test
    public void testUpdateUser() {
        SqlSession session = MybatisUtils.getSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        User user = new User(6, "秦疆", "zxcvbn");
        mapper.updateUser(user);
        session.close();
    }
    

删除:

  1. 编写接口方法注解

    //根据id删除用
    @Delete("delete from user where id = #{id}")
    int deleteUser(@Param("id")int id);
    
  2. 测试

    @Test
    public void testDeleteUser() {
        SqlSession session = MybatisUtils.getSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        mapper.deleteUser(6);
        session.close();
    }
    

【注意点:增删改一定记得对事务的处理】

7.4、关于@Param

@Param注解用于给方法参数起一个名字。以下是总结的使用原则:

7.5、#与$的区别

  • {} 的作用主要是替换预编译语句(PrepareStatement)中的占位符? 【推荐使用】

    INSERT INTO user (name) VALUES (#{name});
    INSERT INTO user (name) VALUES (?);
    
  • ${} 的作用是直接进行字符串替换

    INSERT INTO user (name) VALUES ('${name}');
    INSERT INTO user (name) VALUES ('kuangshen');
    

8. 多对一处理

多对一的理解:

  • 多个学生对应一个老师
  • 如果对于学生这边,就是一个多对一的现象,即从学生这边关联一个老师!

8.1、数据库设计

image

CREATE TABLE `teacher` (
  `id` INT(10) NOT NULL,
  `name` VARCHAR(30) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8

INSERT INTO teacher(`id`, `name`) VALUES (1, '秦老师'); 

CREATE TABLE `student` (
  `id` INT(10) NOT NULL,
  `name` VARCHAR(30) DEFAULT NULL,
  `tid` INT(10) DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `fktid` (`tid`),
  CONSTRAINT `fktid` FOREIGN KEY (`tid`) REFERENCES `teacher` (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8

INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('1', '小明', '1'); 
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('2', '小红', '1'); 
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('3', '小张', '1'); 
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('4', '小李', '1'); 
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('5', '小王', '1');

8.2、搭建测试环境

【Lombok的使用】

  1. IDEA安装Lombok插件

  2. 引入Maven依赖

    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.24</version>
        <scope>provided</scope>
    </dependency>
    
  3. 在代码中增加注解

    @Data
    public class Teacher {
        private int id;
        private String name;
    }
    
    @Data
    public class Student {
        private int id;
        private String name;
        // 学生需要关联一个老师
        private Teacher teacher;
    }
    
  4. 编写实体类对应的Mapper接口 【两个】

    • 无论有没有需求,都应该写上,以备后来之需!
    public interface StudentMapper {}
    
    public interface TeacherMapper {}
    
  5. 编写Mapper接口对应的 mapper.xml配置文件 【两个】

    • 无论有没有需求,都应该写上,以备后来之需!
    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper
            PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <!--核心配置文件-->
    <mapper namespace="com.Hfuuwzy.mapper.TeacherMapper">
    
    </mapper>
    
    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper
            PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <!--核心配置文件-->
    
    <mapper namespace="com.Hfuuwzy.mapper.StudentMapper">
    
    </mapper>
    

8.3、按查询嵌套处理

  1. 给StudentMapper接口增加方法

    //获取所有学生及对应老师的信息
    List<Student> getStudents();
    
  2. 编写对应的Mapper文件

    <!--    方式1 : 按照查询嵌套处理-->
        <select id="getStudent" resultMap="StudentTeacher">
            select * from student
        </select>
    
        <resultMap id="StudentTeacher" type="student">
            <result property="id" column="id"/>
            <result property="name" column="name"/>
    <!--    复杂的属性:我们需要单独处理
            对象 : association             集合 ; collection
        -->
            <association property="teacher" javaType="Teacher" column="tid" select="getTeacher"/>
        </resultMap>
    
        <select id="getTeacher" resultType="teacher">
            select * from teacher where id = #{tid} 
        </select>
    
  3. 编写完毕去Mybatis配置文件中,注册Mapper!

     <mappers>
    <!--        <mapper resource="com/Hfuuwzy/mapper/TeacherMapper.xml"/>-->
    <!--        <mapper resource="com/Hfuuwzy/mapper/StudentMapper.xml"/>-->
            
    <!--        <mapper class="com.Hfuuwzy.mapper.TeacherMapper"/>-->
    <!--        <mapper class="com.Hfuuwzy.mapper.StudentMapper"/>-->
           
            <package name="com.Hfuuwzy.mapper"/>
    </mappers>
    
  4. 注意点说明:

    <resultMap id="StudentTeacher" type="Student">
        <!--association关联属性  property属性名 javaType属性类型 column在多的一方的表中的列名-->
        <association property="teacher"  column="{id=tid,name=tid}" javaType="Teacher" select="getTeacher"/>
    </resultMap>
    <!--
    这里传递过来的id,只有一个属性的时候,下面可以写任何值
    association中column多参数配置:
        column="{key=value,key=value}"
        其实就是键值对的形式,key是传给下个sql的取值名称,value是片段一中sql查询的字段名。
    -->
    <select id="getTeacher" resultType="teacher">
        select * from teacher where id = #{id} and name = #{name}
    </select>
    
  5. 测试

     @Test
        public void getStudent(){
            SqlSession session = MybatisUtils.getSession();
            StudentMapper mapper = session.getMapper(StudentMapper.class);
            List<Student> studentList = mapper.getStudent();
            studentList.forEach(System.out::println);
            session.close();
        }
    

8.4 、按结果嵌套处理

除了上面这种方式,还有其他思路吗?

我们还可以按照结果进行嵌套处理;

  1. 接口方法编写

    public List<Student> getStudents2();
    
  2. 编写对应的mapper文件

    <!--    方式2 : 按照结果查询-->
        <select id="getStudent2" resultMap="StudentTeacher2">
            select s.id sid,s.name sname,t.id tid,t.name tname
            from student s ,teacher t where s.tid = t.id
        </select>
    
        <resultMap id="StudentTeacher2" type="student">
            <result property="id" column="sid"/>
            <result property="name" column="sname"/>
            <association property="teacher" javaType="Teacher">
                <result property="id" column="tid"/>
                <result property="name" column="tname"/>
            </association>
        </resultMap>
    
  3. 去mybatis-config文件中注入【此处应该处理过了】

  4. 测试

    @Test
        public void getStudent2(){
            SqlSession session = MybatisUtils.getSession();
            StudentMapper studentMapper = session.getMapper(StudentMapper.class);
            List<Student> studentList = studentMapper.getStudent2();
            studentList.forEach(System.out::println);
            session.close();
        }
    

8.5、小结

  • 按照查询进行嵌套处理就像SQL中的子查询
  • 按照结果进行嵌套处理就像SQL中的联表查询

9. 一对多处理

一对多的理解:

  • 一个老师拥有多个学生
  • 如果对于老师这边,就是一个一对多的现象,即从一个老师下面拥有一群学生(集合)!

9.1、实体类编写

@Data
public class Student {
    private int id;
    private String name;
    private int tid;
}
@Data
public class Teacher {
    private int id;
    private String name;
   private List<Student> students;
}

….. 和之前一样,搭建测试的环境!

9.2、按结果嵌套处理

  1. TeacherMapper接口编写方法

    //获取指定老师,及老师下的所有学生
    public Teacher getTeacher(int id);
    
  2. 编写接口对应的Mapper配置文件

    <mapper namespace="com.kuang.mapper.TeacherMapper">
        <!--
        思路:
            1. 从学生表和老师表中查出学生id,学生姓名,老师姓名
            2. 对查询出来的操作做结果集映射
                1. 集合的话,使用collection!
                    JavaType和ofType都是用来指定对象类型的
                    JavaType是用来指定pojo中属性的类型
                    ofType指定的是映射到list集合属性中pojo的类型。
        -->
        <select id="getTeacher" resultMap="TeacherStudent">
            select s.id sid, s.name sname , t.name tname, t.id tid
            from student s,teacher t
            where s.tid = t.id and t.id=#{id}
        </select>
        <resultMap id="TeacherStudent" type="Teacher">
            <result  property="name" column="tname"/>
            <collection property="students" ofType="Student">
                <result property="id" column="sid" />
                <result property="name" column="sname" />
                <result property="tid" column="tid" />
            </collection>
        </resultMap>
    </mapper>
    
  3. 将Mapper文件注册到MyBatis-config文件中

     <package name="com.Hfuuwzy.mapper"/>
    
  4. 测试

    @Test
    public void testGetTeacher(){
        SqlSession session = MybatisUtils.getSession();
        TeacherMapper mapper = session.getMapper(TeacherMapper.class);
        Teacher teacher = mapper.getTeacher(1);
        System.out.println(teacher.getName());
        System.out.println(teacher.getStudents());
    }
    

9.3、按查询嵌套处理

  1. TeacherMapper接口编写方法

    public Teacher getTeacher2(int id);
    
  2. 编写接口对应的Mapper配置文件

    <select id="getTeacher2" resultMap="TeacherStudent2">
      select * from teacher where id = #{id}
    </select>
    <resultMap id="TeacherStudent2" type="Teacher">
        <!--column是一对多的外键 , 写的是一的主键的列名-->
        <collection property="students" javaType="ArrayList" ofType="Student" column="id" select="getStudentByTeacherId"/>
    </resultMap>
    <select id="getStudentByTeacherId" resultType="Student">
        select * from student where tid = #{id}
    </select>
    
  3. 将Mapper文件注册到MyBatis-config文件中

  4. 测试

    @Test
    	public void getTeacher2(){
            SqlSession sqlSession = MybatisUtils.getSession();
            TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
            Teacher teacher = mapper.getTeacher(1);
            System.out.println(teacher);
            sqlSession.close();
    }
    

9.4、小结

  1. 关联-association
  2. 集合-collection
  3. 所以association是用于一对一和多对一,而collection是用于一对多的关系
  4. JavaType和ofType都是用来指定对象类型的
    • JavaType是用来指定pojo中属性的类型
    • ofType指定的是映射到list集合属性中pojo的类型。

注意说明:

  1. 保证SQL的可读性,尽量通俗易懂
  2. 根据实际要求,尽量编写性能更高的SQL语句
  3. 注意属性名和字段不一致的问题
  4. 注意一对多和多对一 中:字段和属性对应的问题
  5. 尽量使用Log4j,通过日志来查看自己的错误

10. 动态 SQL

官方文档

10.1、介绍

什么是动态SQL:动态SQL指的是根据不同的查询条件 , 生成不同的Sql语句.

官网描述:
    MyBatis 的强大特性之一便是它的动态 SQL。如果你有使用 JDBC 或其它类似框架的经验,你就能体会到根据不同条件拼接 SQL 语句的痛苦。例如拼接时要确保不能忘记添加必要的空格,还要注意去掉列表最后一个列名的逗号。利用动态 SQL 这一特性可以彻底摆脱这种痛苦。
    虽然在以前使用动态 SQL 并非一件易事,但正是 MyBatis 提供了可以被用在任意 SQL 映射语句中的强大的动态 SQL 语言得以改进这种情形。
    动态 SQL 元素和 JSTL 或基于类似 XML 的文本处理器相似。在 MyBatis 之前的版本中,有很多元素需要花时间了解。MyBatis 3 大大精简了元素种类,现在只需学习原来一半的元素便可。MyBatis 采用功能强大的基于 OGNL 的表达式来淘汰其它大部分元素。
    -------------------------------
    - if
    - choose (when, otherwise)
    - trim (where, set)
    - foreach
    -------------------------------

我们之前写的 SQL 语句都比较简单,如果有比较复杂的业务,我们需要写复杂的 SQL 语句,往往需要拼接,而拼接 SQL ,稍微不注意,由于引号,空格等缺失可能都会导致错误。

  那么怎么去解决这个问题呢?这就要使用 mybatis 动态SQL,通过 if, choose, when, otherwise, trim, where, set, foreach等标签,可组合成非常灵活的SQL语句,从而在提高 SQL 语句的准确性的同时,也大大提高了开发人员的效率。

10.2、搭建环境

新建一个数据库表:blog

字段:id,title,author,create_time,views

CREATE TABLE `blog` (
  `id` varchar(50) NOT NULL COMMENT '博客id',
  `title` varchar(100) NOT NULL COMMENT '博客标题',
  `author` varchar(30) NOT NULL COMMENT '博客作者',
  `create_time` datetime NOT NULL COMMENT '创建时间',
  `views` int(30) NOT NULL COMMENT '浏览量'
) ENGINE=InnoDB DEFAULT CHARSET=utf8
  1. 创建Mybatis基础工程

image

  1. IDutil工具类

    public class IDUtils {
        public static String getId(){
            return UUID.randomUUID().toString().replaceAll("-","");
        }
    }
    
  2. 实体类编写 【注意set方法作用】

    @Data
    public class Blog {
            private String id;
            private String title;
            private String author;
            private Date createTime;
            private int views;
    }
    
  3. 编写Mapper接口及xml文件

    public interface BlogMapper {
    	
    }
    
    <?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.Hfuuwzy.mapper.BlogMapper">
    </mapper>
    
  4. mybatis核心配置文件,下划线驼峰自动转换

     <settings>
         <setting name="logImpl" value="STDOUT_LOGGING"/>
         <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>
    
    <typeAliases>
        <package name="com.Hfuuwzy.pojo"/>
    </typeAliases>
    
    <mappers>
        <package name="com.Hfuuwzy.mapper"/>
    </mappers>
    
    
  5. 插入初始数据

    编写接口

    //新增一个博客
    int addBlog(Blog blog);
    

    sql配置文件

    <insert id="addBlog" parameterType="blog">
        insert into blog(id,title,author,create_time,views)
        values (#{id},#{title},#{author},#{createTime},#{views});
    </insert>
    

    初始化博客方法

      @Test
        public void addBlog(){
            SqlSession session = MybatisUtils.getSession();
            BlogMapper mapper = session.getMapper(BlogMapper.class);
            Blog blog = new Blog();
            blog.setId(IDUtils.getId());
            blog.setTitle("Mybatis如此简单");
            blog.setAuthor("狂神说");
            blog.setCreateTime(new Date());
            blog.setViews(9999);
            mapper.addBlog(blog);
            blog.setId(IDUtils.getId());
            blog.setTitle("Java如此简单");
            mapper.addBlog(blog);
            blog.setId(IDUtils.getId());
            blog.setTitle("Spring如此简单");
            mapper.addBlog(blog);
            blog.setId(IDUtils.getId());
            blog.setTitle("微服务如此简单");
            mapper.addBlog(blog);
            session.close();
        }
    

初始化数据完毕!

10.3、if 语句

需求:根据作者名字和博客名字来查询博客!如果作者名字为空,那么只根据博客名字查询,反之,则根据作者名来查询

  1. 编写接口类

    List<Blog> queryBlogIf(Map map);
    
  2. 编写SQL语句

      <!--需求1:
            根据作者名字和博客名字来查询博客!
            如果作者名字为空,那么只根据博客名字查询,反之,则根据作者名来查询
            select * from blog where title = #{title} and author = #{author}
        -->
        <select id="queryBlogIf" parameterType="map" resultType="blog">
            select * from blog where 1=1
            <if test="title != null">
                and title = #{title}
            </if>
            <if test="author != null">
                and author = #{author}
            </if>
        </select>
    

    注意where 1=1 and都必须加上

  3. 测试

       @Test
        public void queryBlogIf(){
            SqlSession sqlSession = MybatisUtils.getSession();
            BlogMapper blogMapper = sqlSession.getMapper(BlogMapper.class);
            Map<String, String> map = new HashMap<String, String>();
            map.put("title","Mybatis如此简单");
    //        map.put("author","狂神说");
            List<Blog> blogs = blogMapper.queryBlogIf(map);
            blogs.forEach(System.out::println);
            sqlSession.close();
        }
    

这样写我们可以看到,如果 author 等于 null,那么查询语句为 select from user where title=#{title},但是如果title为空呢?那么查询语句为 select from user where and author=#{author},这是错误的 SQL 语句,如何解决呢?请看下面的 where 语句!

10.4、Where

修改上面的SQL语句;

<select id="queryBlogIf" parameterType="map" resultType="blog">
    select * from blog 
    <where>
        <if test="title != null">
            title = #{title}
        </if>
        <if test="author != null">
            and author = #{author}
        </if>
    </where>
</select>

这个“where”标签会知道如果它包含的标签中有返回值的话,它就插入一个‘where’。此外,如果标签返回的内容是以AND 或OR 开头的,则它会剔除掉。【这是我们使用的最多的案例】

【演示】SQL分析
### 10.6、choose语句
有时候,我们不想用到所有的查询条件,只想选择其中的一个,查询条件有一个满足即可,使用 choose 标签可以解决此类问题,类似于 Java switch 语句
1. 编写接口方法
   List<Blog> queryBlogChoose(Map map);
  1. sql配置文件

    <select id="queryBlogChoose" parameterType="map" resultType="blog">
        select * from blog
        <where>
            <choose>
                <when test="title != null">
                     title = #{title}
                </when>
                <when test="author != null">
                    and author = #{author}
                </when>
                <otherwise>
                    and views = #{views}
                </otherwise>
            </choose>
        </where>
    </select>
    
  2. 测试类

    @Test
    public void testQueryBlogChoose(){
        SqlSession session = MybatisUtils.getSession();
        BlogMapper mapper = session.getMapper(BlogMapper.class);
        HashMap<String, Object> map = new HashMap<String, Object>();
        map.put("title","Java如此简单");
        map.put("author","狂神说");
        map.put("views",9999);
        List<Blog> blogs = mapper.queryBlogChoose(map);
        System.out.println(blogs);
        session.close();
    }
    

【演示】SQL分析

10.5、Set

同理,上面的对于查询 SQL 语句包含 where 关键字,如果在进行更新操作的时候,含有 set 关键词,我们怎么处理呢?

  1. 编写接口方法

    int updateBlog(Map map);
    
  2. sql配置文件

    <!--注意set是用的逗号隔开-->
    <update id="updateBlog" parameterType="map">
        update blog
          <set>
              <if test="title != null">
                  title = #{title},
              </if>
              <if test="author != null">
                  author = #{author}
              </if>
          </set>
        where id = #{id};
    </update>
    
  3. 测试

    @Test
        public void UpdateBlog(){
            SqlSession session = MybatisUtils.getSession();
            BlogMapper mapper = session.getMapper(BlogMapper.class);
            HashMap<String, String> map = new HashMap<String, String>();
            map.put("title","动态SQL");
            map.put("author","秦疆");
            map.put("id","288084443c3544aaa575959fd94e3610");
            mapper.updateBlog(map);
            session.close();
        }
    
    

10.6、SQL片段

有时候可能某个 sql 语句我们用的特别多,为了增加代码的重用性,简化代码,我们需要将这些代码抽取出来,然后使用时直接调用。

提取SQL片段:

<sql id="if-title-author">
    <if test="title != null">
        title = #{title}
    </if>
    <if test="author != null">
        and author = #{author}
    </if>
</sql>

引用SQL片段:

<select id="queryBlogIf" parameterType="map" resultType="blog">
    select * from blog
    <where>
        <!-- 引用 sql 片段,如果refid 指定的不在本文件中,那么需要在前面加上 namespace -->
        <include refid="if-title-author"></include>
        <!-- 在这里还可以引用其他的 sql 片段 -->
    </where>
</select>

注意:①、最好基于 单表来定义 sql 片段,提高片段的可重用性

   ②、在 sql 片段中不要包括 where

10.7、Foreach

将数据库中前三个数据的id修改为1,2,3;

需求:我们需要查询 blog 表中 id 分别为1,2,3的博客信息

  1. 编写接口

    List<Blog> queryBlogForeach(Map map);
    
  2. 编写SQL语句

    <select id="queryBlogForeach" parameterType="map" resultType="blog">
        select * from blog
        <where>
            <!--
            collection:指定输入对象中的集合属性
            item:每次遍历生成的对象
            open:开始遍历时的拼接字符串
            close:结束时拼接的字符串
            separator:遍历对象之间需要拼接的字符串
            select * from blog where 1=1 and (id=1 or id=2 or id=3)
          -->
            <foreach collection="ids"  item="id" open="and (" close=")" separator="or">
                id=#{id}
            </foreach>
        </where>
    </select>
    
  3. 测试

    @Test
    public void testQueryBlogForeach(){
        SqlSession session = MybatisUtils.getSession();
        BlogMapper mapper = session.getMapper(BlogMapper.class);
        HashMap map = new HashMap();
        List<Integer> ids = new ArrayList<Integer>();
        ids.add(1);
        ids.add(2);
        ids.add(3);
        map.put("ids",ids);
        List<Blog> blogs = mapper.queryBlogForeach(map);
        System.out.println(blogs);
        session.close();
    }
    

小结:其实动态 sql 语句的编写往往就是一个拼接的问题,为了保证拼接准确,我们最好首先要写原生的 sql 语句出来,然后在通过 mybatis 动态sql 对照着改,防止出错。多在实践中使用才是熟练掌握它的技巧

11. 缓存(了解)

不想了解了,太累了

完结撒花

posted @   HFUUwzy  阅读(58)  评论(0编辑  收藏  举报
相关博文:
阅读排行:
· 全程不用写代码,我用AI程序员写了一个飞机大战
· MongoDB 8.0这个新功能碉堡了,比商业数据库还牛
· 记一次.NET内存居高不下排查解决与启示
· DeepSeek 开源周回顾「GitHub 热点速览」
· 白话解读 Dapr 1.15:你的「微服务管家」又秀新绝活了
点击右上角即可分享
微信分享提示