SSM之MyBatis（一）

àì夳堔傛蜴生んèń 2023-09-23 19:54 69阅读 0赞

**目录**

一：MyBatis简介

1.1 MyBatis特性

1.2 与其他持久化层技术框架对比

二：搭建MyBatis

2.1开发环境

2.2 创建maven工程

2.3 创建MyBatis的核心配置文件

2.4 创建mapper接口

2.5 创建MyBatis的映射文件

2.6 创建测试类

2.7 加入log4j日志功能

三：MyBatis的增删改查

4.1 添加

4.2 删除

4.3 更新

4.4 查询（一个实体类对象）

4.5 查询list集合

五：MyBatis获取参数的两种方式

5.1、单个字面量类型的参数

5.2、多个字面量类型的参数

5.3、map集合类型的参数

5.4、实体类类型的参数

5.5、使用@Param标识参数

--------------------

# 一：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 与其他持久化层技术框架对比 ##

**JDBC**

>  *  **SQL 夹杂在Java代码中耦合度高**，导致硬编码内伤 
>  *  维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见 
>  *  **代码冗长，开发效率低**

**Hibernate 和 JPA**

>  *  操作简便，开发效率高 
>  *  程序中的长难复杂 SQL 需要绕过框架 
> 
>  *  内部自动生产的 SQL，不容易做特殊优化 
>  *  基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。 
>  *  反射操作太多，导致数据库性能下降

**MyBatis**

>  *  轻量级，性能出色 
>  *  **SQL 和 Java 编码分开，功能边界清晰。**Java代码专注业务、SQL语句专注数据 
>  *  开发效率稍逊于HIbernate，但是完全能够接受

# 二：搭建MyBatis #

## 2.1开发环境 ##

> MySQL 不同版本的注意事项 
> 
> 1 、驱动类 driver-class-name 
> 
> MySQL 5 版本使用 jdbc5 驱动，驱动类使用： com.mysql.jdbc.Driver 
> 
> MySQL 8 版本使用 jdbc8 驱动，驱动类使用： com.mysql.cj.jdbc.Driver 
> 
> 2 、连接地址 url 
> 
> MySQL 5 版本的 url ： 
> 
> jdbc:mysql://localhost:3306/ssm 
> 
> MySQL 8 版本的 url ： 
> 
> jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC

## 2.2 创建maven工程 ##

（1）打包方式：jar包

（2）导入依赖

<dependencies>
    
    <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
    </dependency>
    
    <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    <scope>test</scope>
    </dependency>
    
    <dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.16</version>
    </dependency>
    </dependencies>

## 2.3 **创建****MyBatis****的核心配置文件**  ##

> 习惯上命名为 **mybatis-config.xml** ，这个文件名仅仅只是建议，并非强制要求。将来整合 Spring 之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。核心配置文件主要用于配置连接数据库的环境以及MyBatis 的全局配置信息 ，核心配置文件存放的位置是src/main/resources 目录下。

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE configuration
    PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
    "http://mybatis.org/dtd/mybatis-3-config.dtd">
    <configuration>
    
    <environments default="development">
    <environment id="development">
    <transactionManager type="JDBC"/>
    <dataSource type="POOLED">
    <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/ssm?
    serverTimezone=UTC"/>
    <property name="username" value="root"/>
    <property name="password" value="123456"/>
    </dataSource>
    </environment>
    </environments>
    
    <mappers>
    <package name="mappers/UserMapper.xml"/>
    </mappers>
    </configuration>

## 2.4 创建mapper接口 ##

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

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

## 2.5 **创建****MyBatis****的映射文件**  ##

相关概念： **ORM** （ **O** bject  **R** elationship  **M** apping ）对象关系映射。

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

![b8e5494e80f74763af5faabaa20eef93.png][]

1 、映射文件的命名规则：

> 表所对应的实体类的类名 \+Mapper.xml 
> 
> 例如：表 t\_user ，映射的实体类为 User ，所对应的映射文件为 UserMapper.xml 
> 
> 因此一个映射文件对应一个实体类，对应一张表的操作 
> 
> MyBatis 映射文件用于编写 SQL ，访问以及操作表中的数据 
> 
> MyBatis 映射文件存放的位置是 src/main/resources/mappers 目录下

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

> a>mapper **接口的全类名**和**映射文件的命名空间**（ namespace ）保持一致 
> 
> b>mapper **接口中方法的方法名**和映射文件中编写 SQL 的标签的 **id** 属性保持一致

<?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.atguigu.mybatis.mapper.UserMapper">
    
    <insert id="insertUser">
    insert into t_user values(null,'admin','123456',23,'男','12345@qq.com')
    </insert>
    </mapper>

## 2.6 创建测试类 ##

//读取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);

**说明：**

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

## 2.7 **加入****log4j****日志功能** ##

**①加入依赖**

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
    </dependency>

**②加入****log4j****的配置文件**

> log4j 的配置文件名为 log4j.xml ，存放的位置是 src/main/resources 目录下

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

> **日志的级别：**
> 
> **FATAL**( 致命 )>**ERROR**( 错误 )>**WARN**( 警告 )>**INFO**( 信息 )>**DEBUG**( 调试 ) ，从左到右打印的内容越来越详细

# 三：MyBatis的增删改查 #

## 4.1 添加 ##

<insert id="insertUser">
    insert into t_user values(null,'admin','123456',23,'男')
    </insert>

## 4.2 删除 ##

<delete id="deleteUser">
    delete from t_user where id = 7
    </delete>

## 4.3 更新 ##

<update id="updateUser">
    update t_user set username='ybc',password='123' where id = 6
    </update>

## 4.4 查询（一个实体类对象） ##

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

## 4.5 **查询****list****集合** ##

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

**注意：**

> 1 、查询的标签 select 必须设置属性 resultType 或 resultMap ，用于设置实体类和数据库表的映射关系 
> 
>  *  resultType：自动映射，用于属性名和表中字段名一致的情况 
>  *  resultMap：自定义映射，用于一对多或多对一或字段名和属性名不一致的情况

# 五：MyBatis获取参数的两种方式 #

MyBatis获取参数值的两种方式：**$\{\}**和**\#\{\}**

*  $\{\}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号；
 *  \#\{\}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

## **5.1****、单个字面量类型的参数** ##

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

## **5.2****、多个字面量类型的参数** ##

> 若 mapper 接口中的方法参数为多个时，此时MyBatis 会自动将这些参数放在一个 map 集合中，以 arg0,arg1... 为键，以参数为值；以 
> 
> param1,param2... 为键，以参数为值；因此只需要通过 $\{\} 和 \#\{\} 访问 map 集合的键就可以获取相对应的值，注意$\{\}需要手动加单引号

## **5.3****、****map****集合类型的参数**  ##

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

## **5.4****、实体类类型的参数**  ##

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

## **5.5****、使用****@Param****标识参数** ##

> 可以通过@Param注解标识mapper接口中的方法参数。此时，会将这些参数放在map集合中，以@Param注解的value属性值为键，以参数为值；以 
> 
> param1,param2... 为键，以参数为值；只需要通过 $\{\} 和 \#\{\} 访问 map 集合的键就可以获取相对应的值，注意$\{\}需要手动加单引号

[b8e5494e80f74763af5faabaa20eef93.png]: https://img-blog.csdnimg.cn/b8e5494e80f74763af5faabaa20eef93.png