Mybatis学习总结(结合个人理解)

Mybatis

1. MyBatis简介

1.1 什么是Mybatis

• MyBatis 是一款优秀的持久层框架
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程
• MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
• MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code，并且改名为MyBatis 。
• 2013年11月迁移到Github .
• Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html
• GitHub : https://github.com/mybatis/mybatis-3

1.2 持久化

持久化是将程序数据在持久状态和瞬时状态间转换的机制。

• 即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。持久化的主要应用是将内存中的对象存储在数据库中，或者存储在磁盘文件中、XML数据文件中等等。
• JDBC就是一种持久化机制。文件IO也是一种持久化机制。
• 在生活中 : 将鲜肉冷藏，吃的时候再解冻的方法也是。将水果做成罐头的方法也是。

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

• 内存断电后数据会丢失，但有一些对象是无论如何都不能丢失的，比如银行账号等，遗憾的是，人们还无法保证内存永不掉电。
• 内存过于昂贵，与硬盘、光盘等外存相比，内存的价格要高2~3个数量级，而且维持成本也高，至少需要一直供电吧。所以即使对象不需要永久保存，也会因为内存的容量限制不能一直呆在内存中，需要持久化来缓存到外存。

持久层

1.3 持久层

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

为什么需要Mybatis

• Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据 .

• 传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .

• MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射

• 所有的事情，不用Mybatis依旧可以做到，只是用了它，所有实现会更加简单！技术没有高低之分，只有使用这个技术的人有高低之别

• MyBatis的优点

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

• 最重要的一点，使用的人多！公司需要！

2. 入门

思路流程：搭建环境–>导入Mybatis—>编写代码—>测试

代码演示

1、搭建实验数据库

CREATE DATABASE `mybatis`;

USE `mybatis`;

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

insert  into `user`(`id`,`name`,`pwd`) values (1,'狂神','123456'),(2,'张三','abcdef'),(3,'李四','987654');

2、导入MyBatis相关 jar 包

• GitHub上找

<dependency>
   <groupId>org.mybatis</groupId>
   <artifactId>mybatis</artifactId>
   <version>3.5.2</version>
</dependency>
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>5.1.47</version>
</dependency>

3、编写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=utf8"/>
               <property name="username" value="root"/>
               <property name="password" value="123456"/>
           </dataSource>
       </environment>
   </environments>
   <mappers>
       <mapper resource="com/kuang/dao/userMapper.xml"/>
   </mappers>
</configuration>

4、编写MyBatis工具类

• 查看帮助文档

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.IOException;
import java.io.InputStream;

public class MybatisUtils {
   

   private static SqlSessionFactory sqlSessionFactory;

   static {
   
       try {
   
           String resource = "mybatis-config.xml";
           InputStream inputStream = Resources.getResourceAsStream(resource);
           sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
      } catch (IOException e) {
   
           e.printStackTrace();
      }
  }

   //获取SqlSession连接
   public static SqlSession getSession(){
   
       return sqlSessionFactory.openSession();
  }

}

5、创建实体类

public class User {
   
   
   private int id;  //id
   private String name;   //姓名
   private String pwd;   //密码
   
   //构造,有参,无参
   //set/get
   //toString()
   
}

6、编写Mapper接口类

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

public interface UserMapper {
   
   List<User> selectUser();
}

7、编写Mapper.xml配置文件

• namespace 十分重要，不能写错！

<?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.kuang.dao.UserMapper">
 <select id="selectUser" resultType="com.kuang.pojo.User">
  select * from user
 </select>
</mapper>

8、编写测试类

• Junit 包测试

public class MyTest {
   
   @Test
   public void selectUser() {
   
       SqlSession session = MybatisUtils.getSession();
       //方法一:
       //List<User> users = session.selectList("com.kuang.mapper.UserMapper.selectUser");
       //方法二:
       UserMapper mapper = session.getMapper(UserMapper.class);
       List<User> users = mapper.selectUser();

       for (User user: users){
   
           System.out.println(user);
      }
       session.close();
  }
}

9、运行测试

成功的查询出来的我们的数据，ok！

问题说明

重要 ！可能出现问题说明：Maven静态资源过滤问题

<resources>
   <resource>
       <directory>src/main/java</directory>
       <includes>
           <include>**/*.properties</include>
           <include>**/*.xml</include>
       </includes>
       <filtering>false</filtering>
   </resource>
   <resource>
       <directory>src/main/resources</directory>
       <includes>
           <include>**/*.properties</include>
           <include>**/*.xml</include>
       </includes>
       <filtering>false</filtering>
   </resource>
</resources>

有了MyBatis以后再也不用写原生的JDBC代码了，舒服！

10思路总结

单词:

​ mapper—映射器

背景：

​ 1.你首先需要连接Mysql的数据库(输入正确的数据库用户名、密码、想要连接的数据库名、以及URL例如：jdbc:mysql://localhost:3306/mybatis)
​ 2.在pom.xml里面导入所依赖的jar包(以下这三个)

<!--导入依赖-->
    <dependencies>
        <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

​ 顺便还有如果你想在非reources文件夹下加配置文件，maven是可能读取不到的，因为默认就是reources文件夹,需要在pom.xml的project标签中添加以下代码

<!--在pom.xml的build中配置resource，我们希望在java文件中的配置文件也能生效，
    以下代码防止了我们资源导出失败的问题-->
    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>

实操:

1.创建工具类和核心配置文件

​ 我们想要和数据库进行连接，就需要一个工具类(格式:数据库名Utils 如:MyBatisUtils)来获取数据库连接对象。
​ 1.1连接过程中我们需要调用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：核心配置文件-->
<!--作用:连接数据库-->
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <!--主要修改以下三个property和最下面的mapper标签即可了-->
                <!--&amp;就相当于 & 符号，只是在xml中需要些转义-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>

       <!--
       我们如果想自定义一个test环境也是可以的，再将environments的default设置为test
       <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
        -->
    </environments>
    
    <!--每一个Mapper.xml都需要在Mybatis核心配置文件中去注册-->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
</configuration>

​ 1.2配置文件写完之后，我们再继续写工具类(MyBatisUtils)

package com.kuang.utils;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

/**这时MyBatis的工具类
 * @author <作者>
 * @version <版本>
 * @since <JDK版本>
 */
public class MyBatisUtils {
   
    private static SqlSessionFactory sqlSessionFactory;
    static {
   
        try {
   
            //使用MyBatis第一步：获取sqlSessionFactory对象
            String source = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(source);
            //建造一个数据库工厂
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
   
            e.printStackTrace();
        }
    }
    //要获取数据库对象就用这个类就可以了
    public static SqlSession getSqlSession(){
   
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //当然也可以直接return整合到一句，这里为了清晰就不弄了
        return sqlSession;
    }
}

2.创建一个与数据库属性对应的实体类

​ 在文件夹pojo中(黑马中就是叫domain，两者没有差别),里面编写对应的私有成员变量，和无参，有参构造，对应的get和set，和tostring

3.编写对应的表的接口(老版的叫UserDao,新版的叫UserMapper)

​ 以前我们需要什么表，就是什么Dao!，现在就是什么Mapper)!

​ 里面编写一些我们的需求(也就是实际开发中的抽象方法)，比如我们想要查询所有用户信息，就需要一个List< User > getUserList的抽象方法来存放多个用户的信息,

4.重点,编写UserMapper.xml

这就相当于之前我们中的UserDaoImpl实现方法，现在就是用了配置文件的方式去实现接口

​ 重要属性解读：
​ namespcae：选择你需要绑定的表接口
​ < select></ select>:选择你所操作的方式，是update，insert还是什么根据实际要求去写

​ id：绑定接口里面的方法
​ resultType：取决于你这个方法的返回值类型
​ 标签体内容：你选择的标签所对应的sql语句

<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--
namespace 绑定一个对应的Dao/Mapper接口
相当于 java反射中class中的forname吧,Mybatis就会知道怎么去哪里找对应的接口
也就是说一个namespace的存在，就代表一个Dao接口 
-->
<mapper namespace="com.kuang.dao.UserDao">
    <!--
    查询语句:
        id:
            这就是在Dao/Mapper中的方法名，这个UserMapper.xml我感觉就是个Impl，
            id就是为哪个方法重写
        resultType:
            就是返回的类型，就相当于你在Impl中查询出来之后结果的类型
            我们这里要查的就是用户，因为是可能为多个那么肯定要用List集合，
            但本质存的还是User类型，我们这里要加全限定名
            resultType会对结果集封装
    -->
    <select id="getUserList" resultType="com.kuang.pojo.User">
        select * from  mybatis.user
    </select>
</mapper>

5.编写Test方法，进行调试

package com.kuang.dao;

import com.kuang.pojo.User;
import com.kuang.utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

/**
 * @author <作者>
 * @version <版本>
 * @since <JDK版本>
 */
public class UserDaoTest {
   
    @Test
    public void test01(){
   
        //获取数据库对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        /*try catch finally 为什么要这样干呢？
        	作用：主要是我们需要去关闭sqlSession，而如果报错了就无法正常关闭了，所以用finally就能不管发生什么都能正常去关闭它.
        */
        try{
   
            /*
        方式一
            执行SQL,从sqlSession中获取mapper
            也就是说，其实UserDao就相当于一个Mapper，想要获取Mapper，你肯定要将一个类的字节码传入
            就是你在UserMapper.xml里面对应的方法绑定的Mapper接口
            这里是反射，实现了一个接口(UserDao)，并且创建了实现类的实例
         */
            UserDao usedao = sqlSession.getMapper(UserDao.class);
            List<User> userList = usedao.getUserList();
            for (User user : userList) {
   
                System.out.println(user);
            }
        }catch (Exception e){
   
            e.printStackTrace();
        }finally {
   
            //不管怎么样都要关闭sqlSession
            sqlSession.close();
        }
    }
}

3. CRUD功能实现

​ CRUD知识回顾:crud是指在做计算处理时的增加(Create)、检索(Retrieve)、更新(Update)和删除(Delete)几个单词的首字母简写。crud主要被用在描述软件系统中数据库或者持久层的基本操作功能。

前提注意:增删改必须要提交事务，即执行commit方法

思考:

​ 我们需要增加我们的需求(增删改查)需要改哪些文件

思考后，发现只需要改
1.UserMapper(相当于操作数据库的接口，里面放抽象方法)
2.UserMapper.xml(相当于操作数据库接口的实现类，只是用了配置文件的方式)
3.UserMapperTest(一个测试类，有点像我们之前的service层，主要是调用我们在xml里面配置的一些实现方法)

步骤:

1.在UserMapper中添加新方法

​ 用户(如管理系统的某个功能，管理者就是用户；如果是什么网站，那么用户就是浏览者)想要增加什么功能，我们就首先要创建个抽象方法
​

package com.kuang.dao;

import com.kuang.pojo.User;

import java.util.List;

/**
 * @author <作者>
 * @version <版本>
 * @since <JDK版本>
 */
public interface UserMapper {
   
    /**
     * 查询所有用户信息
     * @return 返回一个存放多个用户信息的列表
     */
    List<User> getUserList();

    /**
     * 根据id值来查询具体的某个用户信息
     * @param id 用户的id值
     * @return 返回某个具体的用户信息
     */
    User getUserById(int id);

    /**
     * 根据用户注册基本信息来向数据库添加用户
     * @param user 这里应该就是Service层封装好的用户注册的基本信息,不用在写什么int id,String name,String pwd了
     * @return 这里的int是返回受影响的行数
     */
    int addUser(User user);
}

2.在UserMapper.xml中添加需要实现的对应方法的对应标签(insert、delete、update、select等标签)

<?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 绑定一个表对应的Dao/Mapper接口
相当于 java反射中class中的forname吧,Mybatis就会知道怎么去哪里找对应的接口
就相当于以前黑马的时候一个表的Dao，这里com.kuang.dao.UserMapper就是User表的Dao
以前的UserDao转变为现在的UserMapper,这都是我们的编程规范
-->
<mapper namespace="com.kuang.dao.UserMapper">

    <!--
    查询语句:
        id:
            这就是在Dao/Mapper中的方法名，这个UserMapper.xml我感觉就是个表的Impl，
            id就是为哪个方法重写(对于以前DaoImpl来说)
        resultType:
            就是返回的类型，就相当于你在Impl中查询出来之后结果的类型
            我们这里要查的就是用户，因为是可能为多个那么肯定要用List集合，
            但本质存的还是User类型，我们这里要加全限定名
            resultType会对结果集封装
    -->
    <select id="getUserList" resultType="com.kuang.pojo.User">
        /*为什么要在表名前加mybatis(数据库名),因为我们在其他数据库中也有叫user表的，所以肯定要让mybatis知道我们要查询哪张表吧，之后都一样，都要让mybatis知道我们想删除哪个数据库中的哪个表....*/
        select * from  mybatis.user
    </select>

    <!--
    简单查询语句
    新知识点:
        parameterType:代表的是对应的方法的形参的类型，从左往右
    -->
    <select id="getUserById" parameterType="int" resultType="com.kuang.pojo.User">
                                            /*  id就是你形参的名字 */
        select * from mybatis.user where id = #{id}
    </select>

    <!--
    简单增加用户语句
        方法名叫addUser
        形参类型是一个user对象,里面存放着id，name，pwd属性
    -->
    <insert id="addUser" parameterType="com.kuang.pojo.User">
        /*
        getMapper是通过反射实例化的功能接口，所以可以忽略private权限,
          直接取到User里面的id，name，pwd属性
        */
        insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd})
    </insert>
</mapper>

3.编写对应的UserMapperTest类

​ 这也就是模拟我们之前的web环境，哪些用户信息我们这里就自己给了，作用主要是为了看看mybatis能不能正常执行!选择对应的测试方法进行 一 一 执行即可

package com.kuang.dao;

import com.kuang.pojo.User;
import com.kuang.utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

/**
 * @author <作者>
 * @version <版本>
 * @since <JDK版本>
 */
public class UserMapperTest {
   
    @Test
    public void test01() {
   
        //获取sqlSession对象，以后可以放到外面，这样不用每次声明了，我们现在主要是熟悉下
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        try {
   
            /*
            执行SQL,从sqlSession中获取mapper
            也就是说，其实UserDao就相当于一个UserMapper，想要获取Mapper，你肯定要将一个类的字节码传入
            就是你在UserMapper.xml里面对应的方法绑定的Mapper接口
            这里是反射，实现了一个接口(UserDao)，并且创建了实现类的实例
         */
            UserMapper usedao = sqlSession.getMapper(UserMapper.class);
            List<User> userList = usedao.getUserList();
            for (User user : userList) {
   
                System.out.println(user);
            }
        } catch (Exception e) {
   
            e.printStackTrace();
        } finally {
   
            //关闭sqlSession
            sqlSession.close();
        }
    }

    @Test
    public void Test02() {
   
        //获取sqlSession对象，以后可以放到外面，这样不用每次声明了，我们现在主要是熟悉下
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        /*
            获得接口
            就等价于之前我们之前的
            UserDao userDao = new UserDaoImpl();
        */
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //调用方法
        User user = userMapper.getUserById(2);
        System.out.println(user);//User{id=2, name='李四', pwd='112421'}
        sqlSession.close();
    }

    /**
     * 注意：增删改需要提交事务
     */
    @Test
    public void Test03() {
   
        //1.获取sqlSession对象，以后可以放到外面，这样不用每次声明了，我们现在主要是熟悉下