一文入门mybatis

mybatis简介

MyBatis是一种优秀的支持自定义SQL、存储过程和高级映射的开源持久化框架，其主要设计目的是让开发者更方便地访问数据库，并提供更好的性能和可维护性。通过将SQL和Java代码分离，MyBatis以更自然的方式处理数据，避免了JDBC编程中的大量重复代码和样板文件。

MyBatis的核心组成部分包括SqlSessionFactory、SqlSession和Mapper。SqlSessionFactory是MyBatis的用于创建SqlSession的工厂接口，SqlSession是MyBatis与数据库交互的主要接口，而Mapper是用于定义映射关系和SQL语句的接口。MyBatis还支持多种数据库，包括MySQL、Oracle、SQL Server、PostgreSQL等等，并且内置了许多高级功能，例如缓存、插件、拦截器等。

以下是一个使用MyBatis进行数据访问的简单示例：

1. 定义MyBatis的配置文件mybatis-config.xml，指定数据库连接信息和其他配置项。

2. 在Mapper.xml文件中定义SQL语句，并使用Mapper接口描述SQL的参数和返回类型。

3. 在Java代码中创建SqlSession对象，并调用Mapper接口中的方法执行SQL语句。

下面是一个使用MyBatis进行查询的简单代码示例：

// 创建SqlSessionFactory对象，通常在应用程序启动时创建一次
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

// 创建SqlSession对象，通常在执行查询语句时创建一次
SqlSession sqlSession = sqlSessionFactory.openSession();

// 获取Mapper接口对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

// 调用Mapper接口中的方法执行SQL语句
User user = userMapper.selectUserById(1);

// 关闭SqlSession对象
sqlSession.close();

上面的代码中，我们首先使用MyBatis的配置文件创建了SqlSessionFactory对象，然后创建了SqlSession对象。接下来，我们通过SqlSession对象获取了UserMapper接口对象，并调用了它的selectUserById方法来查询用户信息。最后，我们关闭了SqlSession对象。

总之，MyBatis是一个功能强大的持久化框架，在企业级应用程序中被广泛使用。通过上面的简单示例，我们可以看到MyBatis的使用方法非常直观和简单。

此文参考

java - MyBatis教程 - 知识点总结 - SegmentFault 思否

1.什么是MyBatis

Myba是一款优秀的持久层框架
MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程，减少了代码的冗余，减少程序员的操作。
MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
MyBatis原来是apache的一个开源项目，叫做ibatis，2010年这个项目由apache迁移到了google code，并且改名为MyBatis
2013年11月官方代码迁移到GitHub
MyBatis中文文档：https://mybatis.net.cn/
GitHub：GitHub - mybatis/mybatis-3: MyBatis SQL mapper framework for Java

2.持久层

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

3.Mybatis的作用

Mybatis就是帮助程序员将数据存取到数据库里面。
传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .
MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射
所有的事情，不用Mybatis依旧可以做到，只是用了它，会更加方便更加简单，开发更快速。

4.MyBatis的优点

简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件就可以了，易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
提供xml标签，支持编写动态sql。
现在主流使用方法

Mybatis 操作数据库的方式

1.可以通过xml文件的方式执行sql;
2.可以通过注解的方式执行SQL;

Mybatis 操作数据库的七大步骤?

1.SQLSession 传递SQL骨架给MappedStatement
2.由MappedStatement 结合骨架和SQL参数映射成完整的SQL语句
3.将完整的SQL语句交给Executer
4.执行SQL语句
5.返回结果集给MappedStatement
6.封装结果集
7.将结果集返回给SQLSession

5.搭建数据库，sql脚本，直接在数据库中运行即可

CREATE TABLE `user` (  `userId` bigint NOT NULL AUTO_INCREMENT,  `userName` varchar(255) COLLATE utf8mb4_bin NOT NULL,  `userAddress` varchar(255) COLLATE utf8mb4_bin NOT NULL,  PRIMARY KEY (`userId`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

6.创建MyBatis程序

7.单击一下maven的刷新按钮

8.项目结构

9.在resources文件夹下创建application.yml文件并输入如下内容：

server:  port: 8080spring:  datasource:    driver-class-name: com.mysql.cj.jdbc.Driver    url: jdbc:mysql://localhost:3306/test?useUnicode=true & characterEncoding=utf-8 &      useSSL=true & serverTimezone=Asia/Shanghai    username: root    password: 123456mybatis:  mapper-locations: classpath:/Mapper/*.xml  type-aliases-package: com.example.testapi.Entity    //这个是扫描到Entity实体包的路径，可根据自己的配置10.连接自己本地的MySQL数据库

11.依次编写Entity、Dao、Service、Controller层，还有创建mapper.xml文件

1.Entity包：创建一个UserEntity类，内容如下：

public class UserEntity {    private Integer userId;    private String userName;    private String userAddress;    public Integer getUserId() {        return userId;    }    public void setUserId(Integer userId) {        this.userId = userId;    }    public String getUserName() {        return userName;    }    public void setUserName(String userName) {        this.userName = userName;    }    public String getUserAddress() {        return userAddress;    }    public void setUserAddress(String userAddress) {        this.userAddress = userAddress;    }}

2.Dao包：创建一个UserDao接口，内容如下：

package com.example.testapi.Dao;import com.example.testapi.Entity.UserEntity;import org.apache.ibatis.annotations.Mapper;import java.util.List;@Mapperpublic interface UserDao {    List<UserEntity> queryLimit(Integer currentPage, Integer pageSize);    Integer addUser(UserEntity user);    Integer updateUser(UserEntity user);    Integer deleteUser(UserEntity user);}

3.Service包：创建一个UserService类，内容如下：

package com.example.testapi.Service;import com.example.testapi.Dao.UserDao;import com.example.testapi.Entity.UserEntity;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Service;import java.util.List;@Service("UserService")public class UserService {    @Autowired    private UserDao userDao;    public List<UserEntity> queryLimit(Integer currentPage,Integer pageSzie){        return userDao.queryLimit(currentPage,pageSzie);    }    public Integer addUser(UserEntity user){        return userDao.addUser(user);    }    public Integer updateUser(UserEntity user){        return userDao.updateUser(user);    }    public Integer deleteUser(UserEntity user){        return userDao.deleteUser(user);    }}

4.Controller包：创建一个UserController类，内容为：

package com.example.testapi.Controller;import com.example.testapi.Entity.UserEntity;import com.example.testapi.Service.UserService;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.*;import java.util.List;@RestController@RequestMapping("user")public class UserController {    @Autowired    private UserService userService;    String message = "";    @RequestMapping("/queryLimit")    public List<UserEntity> queryLimit(@RequestParam("currentPage") Integer currentPage,@RequestParam("pageSize") Integer pageSize){        return userService.queryLimit(currentPage,pageSize);    }    @PostMapping("/addUser")    public String addUer(@RequestBody UserEntity user){        //用Mybatis执行insert语句的时候，插入成功会返回1，不成功则会抛出异常，捕获一下异常就好        try {            userService.addUser(user);            message = "增加用户成功";        }catch (Exception exception){            message = "增加用户异常";        }        return message;    }    @PutMapping("/updateUser")    public String updateUser(@RequestBody UserEntity user){        //Mybatis的更新操作成功返回1，用户不存在返回0，失败则抛异常        try {            message = userService.updateUser(user) == 1?"更新用户成功":"用户不存在，更新失败";        }catch (Exception exception){            message = "更新异常";        }        return message;    }    @DeleteMapping("/deleteUser")    public String deleteUser(@RequestBody UserEntity user){        //Mybatis的删除操作和更新返回值一样，成功返回1，用户不存在返回0，失败则抛异常        try {            message = userService.deleteUser(user) == 1?"删除用户成功":"用户不存在，删除失败";        }catch (Exception exception){            message = "删除异常";        }        return message;    }}

12.编写完上面的内容之后我们需要在Mapper文件夹下创建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.example.testapi.Dao.UserDao">    <select id="queryLimit" resultType="UserEntity">        select * from user limit #{currentPage},#{pageSize};    </select>    <insert id="addUser" parameterType="UserEntity">        insert into user(userName,userAddress) values(#{userName},#{userAddress});    </insert>    <update id="updateUser" parameterType="UserEntity">        update user set userName=#{userName},userAddress=#{userAddress} where userId=#{userId};    </update>    <delete id="deleteUser" parameterType="UserEntity">        delete from user where userId=#{userId};    </delete></mapper>13.最后我们需要在启动类加一点东西（MapperScan扫描的是我们Dao包的地址，填写自己的就好）

14.测试接口添加用户数据-> 地址为：http://localhost:8080/user/addUser

查询用户数据->地址为：http://localhost:8080/user/queryLimit?currentPage=0&pageSize=5

更新用户数据-> 地址为：http://localhost:8080/user/updateUser

删除用户数据-> 地址为：http://localhost:8080/user/deleteUser

http://localhost:8080/user/deleteUser