MyBatis学习（上）

环境说明：

• jdk 8 +

• MySQL 5.7.19

• maven-3.6.0

• IDEA

学习前需要掌握：

• JDBC

• MySQL

• Java 基础

• Maven

• Junit

1 MyBatis简介

1.1 什么是MyBatis

• MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。

• MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。

• MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

• maven仓库

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.10</version>
</dependency>

• Github:Releases · mybatis/mybatis-3 (github.com)
• 中文文档：mybatis – MyBatis 3 | 简介

1.2 持久化

数据持久化

• 持久化就是将程序的数据在持久状态的瞬时状态转化的过程

  • 即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。持久化的主要应用

  • 是将内存中的对象存储在数据库中，或者存储在磁盘文件中、XML数据文件中等等。

  • JDBC就是一种持久化机制。文件IO也是一种持久化机制。

  • 在生活中 : 将鲜肉冷藏，吃的时候再解冻的方法也是。将水果做成罐头的方法也是。

• 为什么需要持久化服务呢？那是由于内存本身的缺陷引起的

  • 内存断电后数据会丢失，但有一些对象是无论如何都不能丢失的，比如银行账号等，遗憾的是，人们还无法保证内存永不掉电。

  • 内存过于昂贵，与硬盘、光盘等外存相比，内存的价格要高2~3个数量级，而且维持成本也高，至少需要一直供电吧。所以即使对象不需要永久保存，也会因为内存的容量限制不能一直呆在内存中，需要持久化来缓存到外存。

1.3 持久层

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

1.4为什么需要Mybatis?

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

最重要的一点：使用人多

2 第一个MyBatis程序

思路： 搭建环境–> 导入MyBatis -->编写代码 -->测试！

2.1 搭建环境

• 搭建数据库

CREATE TABLE `mybatis`;
USE `mybatis`;

CREATE TABLE `user`(
	`id` INT(20) NOT NULL PRIMARY KEY,
	`name` VARCHAR(30) DEFAULT NULL,
	`pwd` VARCHAR(30) DEFAULT NULL
) ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT INTO `user` (`id`,`name`,`pwd`) VALUES
(1,'小明','123456'),
(2,'张三','123456'),
(3,'李四','125236')

• 新建项目

1. 新建一个普通的maven项目,导入MyBatis相关jar包

   <!--导入依赖-->
   <dependencies>
   <!--mysql驱动-->
       <dependency>
           <groupId>mysql</groupId>
           <artifactId>mysql-connector-java</artifactId>
           <version>5.1.47</version>
       </dependency>
   <!--mybatis-->
      <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
       <dependency>
           <groupId>org.mybatis</groupId>
           <artifactId>mybatis</artifactId>
           <version>3.5.10</version>
       </dependency>
   <!--junit-->
       <dependency>
           <groupId>junit</groupId>
           <artifactId>junit</artifactId>
           <version>4.12</version>
       </dependency>
   </dependencies>
   

2. 删除src -->变成父项目 以后创建的子项目均不需要导包

2.2 创建一个模块,导入MyBatis

• 编写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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/kuppy/dao/UserMapper.xml"/>
    </mappers>
</configuration>

• 编写mybatis工具类

//sqlSessionFactory --> sqlsession
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory; //提升作用域

    static {
        String resource = "org/mybatis/example/mybatis-config.xml";
        InputStream inputStream = null;
        try {
            //获取sqlSessionFactory
            inputStream = Resources.getResourceAsStream(resource);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }
    //既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
    //SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。

    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

2.3 编写代码

• 实体类 （pojo）

public class User {
    private int id;
    private String name;
    private String pwd;

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    public int getId() {
        return id;
    }

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

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", pwd='" + pwd + '\'' +
                '}';
    }
}

• Dao接口

public interface UserDao {
    List<User> getUserlist();
}

• 接口实现类

import com.kuppy.pojo.User;
import java.util.List;

public interface UserMapper {
    //获取全部用户
    List<User> selectUser();
}

• 编写Mapper.xml配置文件
  • namespace 十分重要，不能写错！
  • id为实现类的方法，resultType为sql语句执行的返回值

<?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">
<!--namespace= 绑定一个对应的Mapper接口-->
<mapper namespace="com.kuppy.dao.UserDao">
<!--查询语句-->
    <select id="getUsername" resultType="com.kuppy.pojo.User">
        select * from mybatis.user;
    </select>
</mapper>

2.4 测试

注意：配置MapperRegistry

MapperRegistry是什么？核心配置文件中注册mappers

• junit测试

public class UserDaoTest {
    @Test
    public void test(){
        //第一步：获取得SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        //方式一：getMapper
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userlist = userDao.selectUser();

        for (User user : userlist) {
            System.out.println(user);
        }

        //关闭SqlSession
        sqlSession.close();
    }
}

2.5 可能出现的问题

• Maven资源导出失败

<!--在build中配置resources，来防止我们资源导出失败的问题-->
<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

3 CRUD

3.1 namespace

​ namespace中的包名要和Dao/mapper接口的包名一致！

3.2 select

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

需求：根据id查询用户

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

public interface UserMapper {
    //获取全部用户
    List<User> selectUser();
    //根据ID查询用户
    User getUserById(int id);
}

2. 在UserMapper.xml中添加Select语句

<select id="getUserById" parameterType="int" resultType="com.kuppy.pojo.User">
    select * from mybatis.user where id = #{id};
</select>

3. 测试类中测试

@Test
public void getUserById(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();

    UserMapper mapper = sqlSession.getMapper(UserMapper.class);

    User user = mapper.getUserById(1);
    System.out.println(user);

    sqlSession.close();
}

练习：根据 密码 和 名字 查询用户

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

User getUserByPwd(Map<String,Object> map);

2. 在UserMapper.xml中添加Select语句

<select id="getUserByPwd" parameterType="map" resultType="com.kuppy.pojo.User">
    select * from mybatis.user where name = #{username} and pwd = #{pwd};
</select>

3. 测试类中测试

@Test
public void getUserByPwd(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);

    Map<String, Object> map = new HashMap<String, Object>();
    map.put("username","小黑");
    map.put("pwd","66666");

    User userByPwd = mapper.getUserByPwd(map);
    System.out.println(userByPwd);

    sqlSession.close();
}

总结：如果参数过多，我们可以考虑直接使用Map实现，如果参数比较少，直接传递参数即可

3.3 insert

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

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

//insert一个用户 int返回受影响的行数
int addUser(User user);

2. 在UserMapper.xml中添加insert语句

<insert id="addUser" parameterType="com.kuppy.pojo.User">
    insert into mybatis.user (id,name,pwd) values (#{id},#{name},#{pwd});
</insert>

3. 测试

//增删改需要提交事务
@Test
public void addUser(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();

    UserMapper mapper = sqlSession.getMapper(UserMapper.class);

    int res = mapper.addUser(new User(4, "王五", "123456"));
    if (res > 0){
        System.out.println("插入成功");
    }

    //提交事务
    sqlSession.commit();

    sqlSession.close();
}

注意点：增、删、改操作需要提交事务！

3.4 update

需求：修改用户的信息

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

//修改用户
int updateUser(User user);

2. 在UserMapper.xml中添加update语句

<update id="updateUser" parameterType="com.kuppy.pojo.User">
    update mybatis.user set name = #{name},pwd =#{pwd} where id = #{id};
</update>

3. 测试

@Test
public void updateUser(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();

    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    mapper.updateUser(new User(1,"小黑","66666"));

    sqlSession.commit();

    sqlSession.close();
}

3.5 delete

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

//删除用户
int deleteUser(int id);

2. 在UserMapper.xml中添加delete语句

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

3. 测试

public void deleteUser(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();

    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    mapper.deleteUser(4);

    sqlSession.commit();
    sqlSession.close();
}

小结：

• 所有的增删改操作都需要提交事务！

• 接口所有的普通参数，尽量都写上@Param参数，尤其是多个参数时，必须写上！

• 有时候根据业务的需求，可以考虑使用map传递参数！

• 为了规范操作，在SQL的配置文件中，我们尽量将Parameter参数和resultType都写上！

3.6 模糊查询

方法：

1. Java执行时传递通配符% %

List<User> userLike = mapper.getUserLike("%李%");

2. 在sql拼接中使用通配符

select * from mybatis.user where name like "%"#{value}"%";