Mybatis的介绍及使用

古城微笑少年丶 2024-03-31 13:07 57阅读 0赞

**目录**

Mybatis

搭建MyBatis开发环境

1、创建Maven工程，导入MyBatis依赖的组件

2、编写MyBatis核心配置文件(mybatis-config.xml)

3、创建实体类-POJO

4、创建SQL映射文件(mapper.xml)

5、创建测试类

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

### Mybatis ###

MyBatis是一款优秀的持久层框架，用于简化JDBC开发  
MyBatis 本是 Apache的一个开源项目iBatis, 2010年这个项目由apache softwarefoundation迁移到了google code，并且改名为MyBatis。2013年11月迁移到Github

官网：[mybatis – MyBatis 3 | 入门][mybatis _ MyBatis 3 _]

**持久层**

负责将数据到保存到数据库的那一层代码

JavaEE三层架构:表现层、业务层、持久层

**框架**

框架就是一个半成品软件，是一套可重用的、通用的、软件基础代码模型

在框架的基础之上构建软件编写更加高效、规范、通用、可扩展

**JDBC缺点**

1.硬编码：注册驱动，获取连接，SQL语句

2.操作繁琐：手动设置参数，手动封装结果集

**Mybatis特点**

1、基于SQL语法，简单易学

2、能了解底层封装过程，内部通过JDBC访问数据库的操作

3、SQL语句封装在配置文件中，便于统一管理与维护，降低程序的耦合度

4、方便程序代码调试

**ORM（Object Relational Mapping）**

即对象/关系映射，是一种数据持久化技术。它在对象模型和关系型数据库之间建立起对应关系，

并且提供了一种机制，通过JavaBean对象去操作数据库表中的数据。

编写程序的时候，以面向对象的方式处理数据。

保存数据的时候，却以关系型数据库的方式存储。

ORM解决方案包含下面四个部分：

1、在持久化对象上执行基本的增、删、改、查操作

2、对持久化对象提供一种查询语言或者API

3、对象关系映射工具

4、提供与事务对象交互、执行检查、延迟加载以及其他优化功能

### **搭建MyBatis开发环境** ###

#### 1、创建Maven工程，导入MyBatis依赖的组件 ####

找到pom.xml在dependencies中添加依赖

![9e09e7b59ee242b99be49c2d37ef7bc9.png][]

#### 2、**编写MyBatis核心配置文件(mybatis-config.xml)** ####

<table style="width:500px;"> 
 <tbody> 
 <tr> 
 <td>configuration </td> 
 <td>配置</td> 
 </tr> 
 <tr> 
 <td>properties&nbsp;&nbsp;&nbsp; </td> 
 <td>可以配置在Java 属性配置文件中</td> 
 </tr> 
 <tr> 
 <td>settings&nbsp;&nbsp;&nbsp; </td> 
 <td>修改 MyBatis 在运行时的行为方式</td> 
 </tr> 
 <tr> 
 <td>typeAliases&nbsp;&nbsp;</td> 
 <td>为 Java 类型命名一个别名（简称）</td> 
 </tr> 
 <tr> 
 <td>typeHandlers&nbsp;&nbsp;</td> 
 <td>类型处理器</td> 
 </tr> 
 <tr> 
 <td>objectFactory&nbsp;&nbsp;</td> 
 <td>对象工厂</td> 
 </tr> 
 <tr> 
 <td>plugins&nbsp;&nbsp; </td> 
 <td>插件</td> 
 </tr> 
 <tr> 
 <td>environments&nbsp;&nbsp; </td> 
 <td>环境</td> 
 </tr> 
 <tr> 
 <td>environment&nbsp;&nbsp; </td> 
 <td>环境变量</td> 
 </tr> 
 <tr> 
 <td>transactionManager&nbsp;</td> 
 <td>事务管理器</td> 
 </tr> 
 <tr> 
 <td>dataSource&nbsp;&nbsp;</td> 
 <td>数据源</td> 
 </tr> 
 <tr> 
 <td>mappers&nbsp;&nbsp;&nbsp; </td> 
 <td>映射器</td> 
 </tr> 
 </tbody> 
</table>

**配置properties元素的两种方式**

**1、通过外部指定的方式****，即配置在典型的****Java****属性文件中（如：****database.properties****），****实现动态配置**

**2、直接配置为****xml****，并使用这些属性对配置项****实现动态配置**

**通过外部指定的方式（database.properties），实现动态配置**

配置properties的resource属性

**若两种方式同时都用了，那么哪种方式优先？**

配置properties的resource指定

配置property的name和value

resource属性值的优先级高于property子节点配置的值

settings元素

作用：是设置一些非常重要的设置选项，用来设置和改变MyBatis运行时的行为方式

<table style="width:500px;"> 
 <tbody> 
 <tr> 
 <td> 设置项 </td> 
 <td> 描述 </td> 
 <td> 允许值 </td> 
 <td> 默认值 </td> 
 </tr> 
 <tr> 
 <td> cacheEnabled </td> 
 <td> 对在此配置文件下的所有cache 进行全局性开/关设置 </td> 
 <td> true | false </td> 
 <td> true </td> 
 </tr> 
 <tr> 
 <td> lazyLoadingEnabled </td> 
 <td> 全局性设置懒加载。如果设为‘false’，则所有相关联的都会被初始化加载 </td> 
 <td> true | false </td> 
 <td> true </td> 
 </tr> 
 <tr> 
 <td>autoMappingBehavior</td> 
 <td> MyBatis对于resultMap自动映射匹配级别 </td> 
 <td> NONE | PARTIAL | FULL </td> 
 <td> PARTIAL </td> 
 </tr> 
 </tbody> 
</table>

typeAliases元素

作用：配置类型别名，通过与MyBatis的SQL映射文件相关联，减少输入 多余的完整类名，以简化操作。

**environments元素**

表示配置MyBatis的多套运行环境，将SQL映射到多个不同的数据库上

子元素节点：environment，但是必须指定其中一个为默认运行环境（通过default指定）

**注意：每个****SqlSessionFactory****实例只能选择一个运行环境**

![ab335b89561e44e2b15386f2dd6b1d2c.png][]

**dataSource**

dataSource元素使用基本的JDBC数据源接口来配置JDBC连接对象的资源

有三种内建的数据源类型

**mappers元素**

作用：映射器，定义SQL映射语句

须在配置中引用mapper映射文件

方式一：使用类资源路径获取资源

<mappers>
 	<mapper resource="cn/smbms/dao/user/UserMapper.xml"/>
 </mappers>

方式二：使用URL获取资源

#### **3、创建实体类-POJO** ####

#### **4、创建SQL映射文件(mapper.xml)** ####

SQL映射文件的几个顶级元素(按照定义的顺序)

<table style="width:500px;"> 
 <tbody> 
 <tr> 
 <td>mapper</td> 
 <td>namespace</td> 
 </tr> 
 <tr> 
 <td>cache</td> 
 <td>配置给定命名空间的缓存</td> 
 </tr> 
 <tr> 
 <td>cache-ref</td> 
 <td>从其他命名空间引用缓存配置</td> 
 </tr> 
 <tr> 
 <td>resultMap</td> 
 <td>用来描述数据库结果集和对象的对应关系</td> 
 </tr> 
 <tr> 
 <td>sql</td> 
 <td>可以重用的SQL块，也可以被其他语句引用</td> 
 </tr> 
 <tr> 
 <td>insert </td> 
 <td>映射插入语句</td> 
 </tr> 
 <tr> 
 <td>update</td> 
 <td>映射更新语句</td> 
 </tr> 
 <tr> 
 <td>delete</td> 
 <td>映射删除语句</td> 
 </tr> 
 <tr> 
 <td>select</td> 
 <td>映射查询语句</td> 
 </tr> 
 </tbody> 
</table>

**mapper**

namespace：命名空间

namespace和子元素的id联合保证唯一，区别不同的mapper

绑定DAO接口

namespace的命名必须跟某个接口同名

接口中的方法与映射文件中SQL语句id一一对应

示例：

**select语句有很多属性可以详细配置每一条语句**

**id：**命名空间中唯一的标识符

接口中的方法与映射文件中的SQL语句id一一对应

**parameterType：**

表示查询语句传入参数的类型的完全限定名和别名

支持基础数据类型和复杂数据类型

**resultType**

SQL语句返回值类型的完整限定名或别名

示例：仅传入一个简单数据类型的查询条件，如一个基本类型或其包装类型，或一个String类型等，MyBatis框架的处理方式也非常简单。需求：根据真实姓名模糊查询用户信息

1.**在****SysUserMapper****接口中添加查询方法**

List<SysUser> getUserListByRealName(String realName);

2**在****SysUserMapper.xml****中添加****SQL****语句映射**

select * from t_sys_user where realName like CONCAT ('%', #{param}, '%')

3、**在单元测试类中添加测试方法**

List<SysUser> userList =sqlSession.getMapper(SysUserMapper.class) .getUsersByRealName("李");

**别名与Java类型映射**

<table style="width:500px;"> 
 <tbody> 
 <tr> 
 <td>别名</td> 
 <td>映射的类型</td> 
 </tr> 
 <tr> 
 <td>string</td> 
 <td>String</td> 
 </tr> 
 <tr> 
 <td>byte</td> 
 <td>Byte</td> 
 </tr> 
 <tr> 
 <td>long</td> 
 <td>Long</td> 
 </tr> 
 <tr> 
 <td>short</td> 
 <td>Short</td> 
 </tr> 
 <tr> 
 <td>double</td> 
 <td>Double</td> 
 </tr> 
 <tr> 
 <td>float</td> 
 <td>Float</td> 
 </tr> 
 <tr> 
 <td>boolean</td> 
 <td>Boolean</td> 
 </tr> 
 <tr> 
 <td>date</td> 
 <td> Date </td> 
 </tr> 
 <tr> 
 <td>int</td> 
 <td>Integer</td> 
 </tr> 
 <tr> 
 <td> integer </td> 
 <td>Integer</td> 
 </tr> 
 <tr> 
 <td>arraylist</td> 
 <td>ArrayList</td> 
 </tr> 
 <tr> 
 <td>map</td> 
 <td>Map</td> 
 </tr> 
 <tr> 
 <td>list</td> 
 <td>List</td> 
 </tr> 
 <tr> 
 <td> collection </td> 
 <td>Collection</td> 
 </tr> 
 <tr> 
 <td>iterator</td> 
 <td>Iterator</td> 
 </tr> 
 <tr> 
 <td>decimal</td> 
 <td>BigDecimal</td> 
 </tr> 
 <tr> 
 <td>bigdecimal</td> 
 <td>BigDecimal</td> 
 </tr> 
 <tr> 
 <td>object</td> 
 <td>Object</td> 
 </tr> 
 <tr> 
 <td> …… </td> 
 <td> …… </td> 
 </tr> 
 </tbody> 
</table>

**parameterType**

**基础数据类型**

int、String、Date等，一个参数传递单一数值

用@Param注解为参数命名，通过 \#\{ 参数名\} 获取传入的值

**复杂数据类型**

Java实体类，Map

通过\#\{ 属性名\}或者\#\{map的keyName\}即可获取传入值

**resultType** **：直接表示返回类型**

基本数据类型

复杂数据类型

**resultMap** **：对外部****resultMap****的引用**

应用场景：

数据库字段信息与对象属性不一致

复杂的联合查询，自由控制映射结果

**二者不能同时存在，本质上都是Map数据结构**

resultMap自动映射匹配前提：字段名与属性名一致

resultMap的自动映射级别\-autoMappingBehavior

PARTIAL（默认）：自动匹配所有

NONE：进制自动匹配

insert属性：id、parameterType

<insert id="add" parameterType="User" >
 insert into smbms_user (userCode,userName,userPassword) 
 		values ( #{userCode},#{userName},#{userPassword})
 </insert>

**注意：****insert****、****update****、****delete****元素均没有****resultType****属性**

**update属性：**id、parameterType

<update id ="modify" parameterType="User">
 update smbms_user set userCode = #{userCode},
 	 userName = #{userName},
 userPassword = #{userPassword} where id = #{id}
 </update>

**delete属性：**id、parameterType

<delete id ="deleteUserById" parameterType="int">
 	delete from smbms_user where id = #{id}
 </delete>

**resultMap****属性**

id：resultMap的唯一标识

type：Java实体类

**resultMap****子元素**

id：一般对应数据库中该行的主键id，设置此项可提高MyBatis性能

result：映射到JavaBean的某个“简单类型”属性

association：映射到JavaBean的某个“复杂类型”属性，比如JavaBean类

collection：映射到JavaBean的某个“复杂类型”属性，比如集合

**association**

复杂的类型关联，一对一

内部嵌套：映射一个嵌套JavaBean属性

属性

property：映射数据库列的实体对象的属性

javaType：完整Java类名或者别名

resultMap：引用外部resultMap

子元素：id、result

property：映射数据库列的实体对象的属性

column：数据库列名或者别名

**collection**

复杂类型集合，一对多

内部嵌套、映射一个嵌套结果集到一个列表

属性

property：映射数据库列的实体对象的属性

ofType：完整Java类名或者别名(集合所包括的类型)

resultMap：引用外部resultMap

子元素：id、result

property：映射数据库列的实体对象的属性

column：数据库列名或者别名

#### **5、创建测试类** ####

1、读取核心配置文件mybatis-config.xml

2、创建SqlSessionFactory对象，读取配置文件

3、创建SqlSession对象

4、调用mapper文件进行数据操作

**SqlSessionFactory**

SqlSessionFactory是每个MyBatis应用的核心

作用：创建SqlSession实例

**SqlSessionFactory**工具类

public class MybatisUtil {
        private static SqlSessionFactory sqlSessionFactory;
        static {
            String mybatisPath = "mybatis/mybatis-config.xml";
            //1、加载mybatis配置文件
            InputStream is = null;
            try {
                is = Resources.getResourceAsStream(mybatisPath);
            } catch (IOException e) {
                e.printStackTrace();
            }
            //2、根据mybatis配置文件，创建生成SqlSession的factory工厂
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
        }
        public static SqlSession createSqlSession(){
            if (sqlSessionFactory != null){
                return sqlSessionFactory.openSession();
            }
            return null;
        }
        public static void closeSqlSession(SqlSession sqlSession){
            if (sqlSession != null){
                sqlSession.close();
            }
        }
    }

[mybatis _ MyBatis 3 _]: https://mybatis.org/mybatis-3/zh/getting-started.html
[9e09e7b59ee242b99be49c2d37ef7bc9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/3f9a0f3d30294aa2bf6236907524fe11.png
[ab335b89561e44e2b15386f2dd6b1d2c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/c5889587f2f04a86b44c5f35f4ed52b6.png