【体系-单体架构】11-持久层框架技术MyBatis

最新推荐文章于 2024-05-30 18:25:10 发布

山维

最新推荐文章于 2024-05-30 18:25:10 发布

阅读量432

点赞数

分类专栏：架构演化文章标签： mybatis spring java

本文链接：https://blog.csdn.net/qq_35162536/article/details/106686091

版权

架构演化专栏收录该内容

25 篇文章 0 订阅

订阅专栏

01 MyBatis 简介

概述：MyBatis 是一个优秀的基于 Java 的持久层框架，它内部封装了 JDBC，使开发者只需关注 SQL 语句本身，而不用再花费精力去处理诸如注册驱动、创建 Connection、配置 Statement 等繁杂过程。Mybatis 通过 xml 或注解的方式将要执行的各种 Statement（Statement、PreparedStatement 等）配置起来，并通过 Java 对象和 Statement 中 SQL 的动态参数进行映射生成最终执行的 SQL 语句，最后由 MyBatis 框架执行 SQL 并将结果映射成 Java 对象并返回
ORM：对象(POJO Java原生对象)关系(SQL)映射(联系)，MyBatis实质上就是将Java Entity 与Database table进行关联
在这里插入图片描述
MyBatis 的特点：在 XML 文件中配置 SQL 语句，实现了 SQL 语句与代码的分离；因为需要程序员自己去编写 SQL 语句，程序员可以结合数据库自身的特点灵活控制 SQL 语句，因此能够实现比 Hibernate 等全自动 ORM 框架更高的查询效率，能够完成复杂查询
在这里插入图片描述

02 Druid 简介

概述：Druid 是阿里巴巴开源平台上的一个项目，整个项目由数据库连接池、插件框架和 SQL 解析器组成。该项目主要是为了扩展 JDBC 的一些限制，可以让程序员实现一些特殊的需求，比如向密钥服务请求凭证、统计 SQL 信息、SQL 性能收集、SQL 注入检查、SQL 翻译等，程序员可以通过定制来实现自己需要的功能
总结：通过与Druid、tomcat-jdbc、DBCP、BoneCP、jboss-datasource、C3P0和C3P0对比总结出的

Druid 是性能最好的数据库连接池，tomcat-jdbc 和 druid 性能接近
proxool 在激烈并发时会抛异常，完全不靠谱
c3p0 和 proxool 都相当慢，慢到影响 sql 执行效率的地步
bonecp 性能并不优越，采用 LinkedTransferQueue 并没有能够获得性能提升除了 bonecp
其他的在 JDK 7 上跑得比 JDK 6 上快
jboss-datasource 虽然稳定，但是性能很糟糕

03 Spring 整合 Druid

步骤：提前在mysql创建库myshop确保下面配置能够连接上
在这里插入图片描述
在 pom.xml 文件中新增 com.alibaba:druid 和 mysql:mysql-connector-java 依赖

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.6</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.46</version>
</dependency>

配置数据库连接 jdbc.properties ，配置代码如下：

# JDBC
# MySQL 8.x: com.mysql.cj.jdbc.Driver
jdbc.driverClass=com.mysql.jdbc.Driver
jdbc.connectionURL=jdbc:mysql://192.168.75.134:3306/myshop?useUnicode=true&characterEncoding=utf-8&useSSL=false
jdbc.username=root
jdbc.password=123456

# JDBC Pool
jdbc.pool.init=1
jdbc.pool.minIdle=3
jdbc.pool.maxActive=20

# JDBC Test
jdbc.testSql=SELECT 'x' FROM DUAL

创建一个名为 spring-context-druid.xml 的 Spring 配置文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 加载配置属性文件 -->
    <context:property-placeholder ignore-unresolvable="true" location="classpath:jdbc.properties"/>

    <!-- 数据源配置, 使用 Druid 数据库连接池 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
        <!-- 数据源驱动类可不写，Druid默认会自动根据URL识别DriverClass -->
        <property name="driverClassName" value="${jdbc.driverClass}"/>

        <!-- 基本属性 url、user、password -->
        <property name="url" value="${jdbc.connectionURL}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>

        <!-- 配置初始化大小、最小、最大 -->
        <property name="initialSize" value="${jdbc.pool.init}"/>
        <property name="minIdle" value="${jdbc.pool.minIdle}"/>
        <property name="maxActive" value="${jdbc.pool.maxActive}"/>

        <!-- 配置获取连接等待超时的时间 -->
        <property name="maxWait" value="60000"/>

        <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->
        <property name="timeBetweenEvictionRunsMillis" value="60000"/>

        <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->
        <property name="minEvictableIdleTimeMillis" value="300000"/>

        <property name="validationQuery" value="${jdbc.testSql}"/>
        <property name="testWhileIdle" value="true"/>
        <property name="testOnBorrow" value="false"/>
        <property name="testOnReturn" value="false"/>

        <!-- 配置监控统计拦截的filters -->
        <property name="filters" value="stat"/>
    </bean>
</beans>

Druid 提供了大量的监控数据，只需要在 web.xml 中配置一个 Servlet 就可以方便的查看这些信息

<servlet>
    <servlet-name>DruidStatView</servlet-name>
    <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>DruidStatView</servlet-name>
    <url-pattern>/druid/*</url-pattern>
</servlet-mapping>

启动工程，在地址栏输入http://localhost:8080/druid/index.html访问即可
在这里插入图片描述

04 Spring 整合 MyBatis

步骤：(暂无注意事项)
在 pom.xml 文件中增加 MyBatis 相关依赖：

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.2.8</version>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>1.3.1</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>4.3.17.RELEASE</version>
</dependency>

创建一个名为 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>
    <!-- 全局参数 -->
    <settings>
        <!-- 打印 SQL 语句 -->
        <setting name="logImpl" value="STDOUT_LOGGING" />
    
        <!-- 使全局的映射器启用或禁用缓存。 -->
        <setting name="cacheEnabled" value="false"/>

        <!-- 全局启用或禁用延迟加载。当禁用时，所有关联对象都会即时加载。 -->
        <setting name="lazyLoadingEnabled" value="true"/>

        <!-- 当启用时，有延迟加载属性的对象在被调用时将会完全加载任意属性。否则，每种属性将会按需要加载。 -->
        <setting name="aggressiveLazyLoading" value="true"/>

        <!-- 是否允许单条 SQL 返回多个数据集 (取决于驱动的兼容性) default:true -->
        <setting name="multipleResultSetsEnabled" value="true"/>

        <!-- 是否可以使用列的别名 (取决于驱动的兼容性) default:true -->
        <setting name="useColumnLabel" value="true"/>

        <!-- 允许 JDBC 生成主键。需要驱动器支持。如果设为了 true，这个设置将强制使用被生成的主键，有一些驱动器不兼容不过仍然可以执行。 default:false  -->
        <setting name="useGeneratedKeys" value="false"/>

        <!-- 指定 MyBatis 如何自动映射 数据基表的列 NONE：不映射 PARTIAL：部分 FULL:全部  -->
        <setting name="autoMappingBehavior" value="PARTIAL"/>

        <!-- 这是默认的执行类型 （SIMPLE: 简单； REUSE: 执行器可能重复使用prepared statements语句；BATCH: 执行器可以重复执行语句和批量更新） -->
        <setting name="defaultExecutorType" value="SIMPLE"/>

        <!-- 使用驼峰命名法转换字段。 -->
        <setting name="mapUnderscoreToCamelCase" value="true"/>

        <!-- 设置本地缓存范围 session:就会有数据的共享 statement:语句范围 (这样就不会有数据的共享 ) defalut:session -->
        <setting name="localCacheScope" value="SESSION"/>

        <!-- 设置 JDBC 类型为空时,某些驱动程序 要指定值, default:OTHER，插入空值时不需要指定类型 -->
        <setting name="jdbcTypeForNull" value="NULL"/>
    </settings>
</configuration>

创建一个名为 spring-context-mybatis.xml 的 Spring 配置文件(Spring 集成 MyBatis)，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 配置 SqlSession -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <!-- 用于配置对应实体类所在的包，多个 package 之间可以用 ',' 号分割 -->
        <property name="typeAliasesPackage" value="com.demo.my.shop.domain"/>
        <!-- 用于配置对象关系映射配置文件所在目录 -->
        <property name="mapperLocations" value="classpath:/mapper/**/*.xml"/>
        <property name="configLocation" value="classpath:/mybatis-config.xml"></property>
    </bean>

    <!-- 扫描 Mapper -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.funtl.my.shop.web.admin.dao" />
    </bean>
</beans>

05 测试与字符集

步骤：(暂无注意事项)
编写完相关代码后，我们可以使用单元测试查看 MyBatis 的执行效果，需要增加单元测试相关依赖，配置如下：

<!--用户注入application-->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>4.3.17.RELEASE</version>
</dependency>
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>

删除之前在mysql创建的库mysql(次库仅用于测试druid)，然后创建新数据库
myshop
在这里插入图片描述
utf8 与 utf8mb4 区别：能否存放emoji表情

UTF-8字符集，支持中文，资格字符集能存3个字节
GBK 支持中文(中文是一个字符2个字节，英文是一个字符1个字节)
ISO-8859-1 一个字符集只能存1个字节乱码
utf8mb4是utf-8扩展，一个字符集能存4个字节(emoji表情4个字节)

地址：myshop表结构与数据提取码:3wgx

05 第一个 MyBatis 对象关系映射

以tb_user为示例进行查询，体验下mybatis映射关系的处理过程
在这里插入图片描述
在com.demo.my.shop.domain包下创建TbUser.java(原生POJO与表对应上)

package com.demo.my.shop.domain;

import java.io.Serializable;
import java.util.Date;

public class TbUser implements Serializable {
    private Long id;
    private String username;
    private String password;
    private String phone;
    private String email;
    private Date created;
    private Date updated;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getPhone() {
        return phone;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public Date getCreated() {
        return created;
    }

    public void setCreated(Date created) {
        this.created = created;
    }

    public Date getUpdated() {
        return updated;
    }

    public void setUpdated(Date updated) {
        this.updated = updated;
    }
}

创建数据访问层接口TbUserDao.java(不用创建实现，因为MyBatis已经完成创建连接等操作，而业务相关的SQL也分离出来了)

package com.demo.my.shop.web.admin.dao;

import com.demo.my.shop.domain.TbUser;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public interface TbUserDao {
    /**
     * 查询用户表所有信息
     * @return
     */
    public List<TbUser> selectAll();

    /**接下来本来要写实现(创建连接和编写查询语句)
     * 但MyBatis能够实现代码与SQL语句分离，且MyBatis已经在spring-context-mybatis.xml完成创建连接等工作
     * 故现在唯一要关注的就是SQL本身的使用
     */
}

在resources/mapper目录下创建TbUserMapper.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.demo.my.shop.web.admin.dao.TbUserDao">
    <!--
        id 要和接口里的方法名对应
        resultType 接口类型
    -->
    <select id="selectAll" resultType="TbUser">
    <!--结果映射：查询的字段必须与实体类中属性相同-->
        SELECT
          a.id,
          a.username,
          a.password,
          a.phone,
          a.email,
          a.created,
          a.updated
        FROM
          tb_user AS a
    </select>
</mapper>

创建TbUserService.java和TbUserServiceImpl.java编写业务逻辑层(MyBatis只关注与数据访问层Dao，除Dao层其他层都按原来的样子即可)

/******************TbUserService.java*********************/
package com.demo.my.shop.web.admin.service;

import com.demo.my.shop.domain.TbUser;

import java.util.List;

public interface TbUserService {
    public List<TbUser> selectAll();
}
/******************TbUserServiceImpl.java*********************/
package com.demo.my.shop.web.admin.service.impl;

import com.demo.my.shop.domain.TbUser;
import com.demo.my.shop.web.admin.dao.TbUserDao;
import com.demo.my.shop.web.admin.service.TbUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class TbUserServiceImpl implements TbUserService {
    @Autowired
    private TbUserDao tbUserDao;

    @Override
    public List<TbUser> selectAll() {
        return tbUserDao.selectAll();
    }
}

测试一下

package com.demo.my.shop.web.admin.service.test;

import com.demo.my.shop.domain.TbUser;
import com.demo.my.shop.web.admin.service.TbUserService;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import java.util.List;

@RunWith(SpringJUnit4ClassRunner.class)
//若没有加classpath它会在当前路径下找，加classpath:则会到编译后文件target的classes目录下找
@ContextConfiguration({"classpath:spring-context.xml", "classpath:spring-context-druid.xml", "classpath:spring-context-mybatis.xml"})
public class TbUserServiceTest {
    @Autowired
    private TbUserService tbUserService;

    @Test
    public void testSelectAll(){
        List<TbUser> tbUsers = tbUserService.selectAll();
        for (TbUser tbUser : tbUsers) {
            System.out.println(tbUser.getUsername());
        }
    }
}

06 MyBatis 单表 CRUD 操作

新增：修改、删除与新增逻辑相同，不再书面陈述，详见代码

在TbUserDao接口里面添加新增方法public void insert(TbUser tbUser);
获取SQL中新增语句，复制到TbUserMapper.xml
TbUserService接口中添加方法public void insert(TbUser tbUser);TbUserServiceImpl实现中添加方法public void insert(TbUser tbUser) { tbUserDao.insert(tbUser);}
TbUserServiceTest中添加测试方法，然后进行测试
但是一般密码都不会直接存放在数据库中，而是以md5的方式加密存入

注意：模糊查询的mapper.xml配置应该是拼接字符串的方式拼接SQL语句a.username LIKE CONCAT('%', #{username}, '%')
优化：mapper.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.demo.my.shop.web.admin.dao.TbUserDao">
    <!--
        id 要和接口里的方法名对应
        resultType 接口类型
    -->
    <!--SQL片段：用于重构-->
    <sql id="tbUserColumns">
          a.id,
          a.username,
          a.password,
          a.phone,
          a.email,
          a.created,
          a.updated
    </sql>
    <select id="selectAll" resultType="TbUser">
    <!--结果映射：查询的字段必须与实体类中属性相同-->
        SELECT
          <!--引入-->
          <include refid="tbUserColumns"/>
        FROM
          tb_user AS a
    </select>
    <select id="getById" resultType="TbUser">
        SELECT
        <!--引入-->
        <include refid="tbUserColumns"/>
        FROM
          tb_user AS a
        WHERE
           a.id = #{id}
    </select>
    <insert id="insert">
        insert into tb_user (
          username,
          password,
          phone,
          email,
          created,
          updated
        )
        values
          (
            #{username},
            #{password},
            #{phone},
            #{email},
            #{created},
            #{updated}
          )
    </insert>
    <delete id="delete">
        DELETE FROM tb_user WHERE id = #{id}
    </delete>
    <update id="update">
        UPDATE
            tb_user
        SET
            username = #{username},
            password = #{password},
            phone = #{phone},
            email = #{email},
            updated = #{updated}
        WHERE id = #{id}
    </update>
    <select id="selectByUsername" resultType="TbUser">
        SELECT
        <!--引入-->
        <include refid="tbUserColumns"/>
        FROM
          tb_user AS a
        WHERE
           a.username LIKE CONCAT('%', #{username}, '%')
    </select>
</mapper>

地址：Architecture-MVC-myshop 登录功能源码 tag:2.0.2-RELEASE

07 MyBatis 动态 SQL

概述：动态 SQL，主要用于解决查询条件不确定的情况：在程序运行期间，根据用户提交的查询条件进行查询。提交的查询条件不同，执行的 SQL 语句不同。若将每种可能的情况均逐一列出，对所有条件进行排列组合，将会出现大量的 SQL 语句。此时，可使用动态 SQL 来解决这样的问题。它通过 MyBatis 提供的各种标签对条件作出判断以实现动态拼接 SQL 语句，这里的条件判断使用的表达式为 OGNL 表达式。常用的动态 SQL 标签有 <if>、<where>、<choose>、<foreach> 等
注意事项：在 mapper 的动态 SQL 中若出现大于号（>）、小于号（<）、大于等于号（>=），小于等于号（<=）等符号，最好将其转换为实体符号。否则，XML 可能会出现解析出错问题。特别是对于小于号（<），在 XML 中是绝对不能出现的。否则，一定出错
在这里插入图片描述
foreach 标签-遍历数组（示例）：其他如有需要请自行百度
标签用于实现对于数组与集合的遍历。对其使用，需要注意：

collection 表示要遍历的集合类型，这里是数组，即 array
open、close、separator 为对遍历内容的 SQL 拼接

本例实现的需求是，查询出 id 为 2 与 4 的学生信息
定义映射文件：动态 SQL 的判断中使用的都是 OGNL 表达式。OGNL 表达式中的数组使用 array 表示，数组长度使用 array.length 表示
在这里插入图片描述

<!-- foreach -->
<select id="selectByForeach" resultType="com.lusifer.mybatis.entity.Student">
    <!-- select * from student where id in (2, 4) -->
    SELECT
        id,
        name,
        age,
        score
    FROM
      student
    <if test="array != null and array.length > 0">
        WHERE id IN
        <foreach collection="array" open="(" close=")" item="id" separator=",">
            #{id}
        </foreach>
    </if>
</select>