Mybatis简介及第一个Mybatis程序

1. 简介

1.1 为什么使用Mybatis

java服务器需要与数据库操作，java传统的数据库操作通过JDBC实现。JDBC提供了java与数据库连接及操作的接口，但与数据库交互时需要编写JDBC文件，同时SQL语句也会出现在java中，导致java与SQL的耦合，为了解决这两个问题，引入了Mybatis解决java JDBC实现数据库操作带来的问题。

1.2 什么是Mybatis

MyBatis 是一款优秀的 持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

持久层框架；
支持自定义SQL、存储过程和高级映射；
免除JDBC代码，设置参数及获取结果集的工作；
XML或注解进行配置；

1.3 持久层

易失性存储：指存储在内存中，数据随着系统掉电会丢失，为非持久化数据。

持久化：对应于“易失性存储”，将易失性存储的数据转变为持久状态。

为什么持久化：有些数据需要长久保存，不能断电即失。

持久化的方式：数据库；IO文件；...

持久层：处理持久化过程的代码块，实现持久化数据与内存数据的相互转化。

1.4 Mybatis的特点

Mybatis的作用：帮助程序操作数据库。

Mybatis的特点：

sql与代码的分离，提高可维护性；
提供映射标签，支持对象与数据库的orm字段关系映射；
提供对象关系映射标签，支持对象关系组建维护；
提供xml标签，支持编写动态sql。

1.5 如何学习Mybatis

maven仓库中查找Mybatis依赖包： https://mvnrepository.com/

Mybatis文档：https://mybatis.org/mybatis-3...

2. 第一个Mybaits程序（基于Maven）

2.1 环境搭建

基于Maven项目中使用Mybatis，只需要在.pom文件中引入Mybatis对应的包即可。


    
    
        mysql
        mysql-connector-java
        8.0.21
    
    
    
        org.mybatis
        mybatis
        3.4.6
    
    
    
        junit
        junit
        4.12

2.2 第一个Mybatis程序

一个Mybatis程序构建完成后的示例结构如下图。

其具体构建步骤如下：

准备数据库；

新建一个maven项目，并在项目的main目录下的resource文件夹中新建mybatis-config.xml文件，结构如下：

构建Mybatis工具类：在utils文件夹中新建MybatisUtil.java工具类，用于读取xml构建sqlSession实例，作为程序与数据库的连接。

//文件名：MybatisUtils.java
public class MybatisUtils {
    //新建静态sqlSessionFactory对象，该对象只需要在项目初始化时生成一次；
    private static SqlSessionFactory sqlSessionFactory;
    
    static {
        try {
            //定义xml文件地址，默认地址在resources文件夹中；
            String resource = "mybatis-config.xml";
            InputStream inputStream = null;
            //对过inputSteam流解析xml中的数据库及项目信息；
            inputStream = Resources.getResourceAsStream(resource);
            //sqlSessionFactory对象由sqlSessionFactoryBuilder对象的build方法实例化；
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    //定义一个getSqlSession方法来构建一个sqlSession实例，通过sqlSessionFactory的openSession()方法实现。
    //sqlSession完全包含了面向数据库执行SQL命令所需的所有方法！
    //参数true指打开了sqlSession的自动提交，即更改数据库后无需手动commit。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession(true);
    }
}

编写数据库

数据定义一般放入pojo文件夹，一般一个数据表与一个类对应，类的属性为表中的字段，同时构建出get/set方法，tostring方法，有参/无参构造方法。

//文件名：User.java
package com.hy.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文件夹，定义数据库的基本操作（CRUD），一般命名为XxxMapper，定义为接口文件。

//文件名：UserMapper.java
public interface UserMapper {
    //获取全部用户；
    List getUserList();

    //根据id查询用户；
    User getUserById(int id);

    //根据name查询用户；
    List getUserListByName(String name);

    //insert一个用户；
    void addUser(User user);

    //按id更新一个用户；
    void updateUserById(User user);

    //按id删除一个用户；
    Integer deleteUserById(int id);

    //利用map适配查询内容；
    int addUserPartly(Map map);

    //模糊查询；
    List getUserLike(String value);
}

编写XxxMapper.xml文件

上一步中的接口的实现在此xml文件中定义，当然也可以直接用java编写实现类。而Mybatis的作用即在此步骤中，通过xml配置文件替换了java的实现类，免去了实现类中连接数据库等基础操作的代码，简化代码并实现了java和SQL的解耦。






    

    
    
    
    
    

    

    

    
        insert into db_hy.user (id,name,pwd) values (#{id}, #{name}, #{pwd})
    

    
    
        insert into db_hy.user (id,name,pwd) values (#{userid}, #{userName}, #{passWORD})
    

    
        update db_hy.user set name=#{name}, pwd=#{pwd} where id=#{id}
    

    
        delete from db_hy.user where id=#{id}

将Mapper.xml引入项目

要使上一步中的Mapper.xml文件在项目中起作用，需要将xml文件引入项目。具体实现分为2步。

首先，需要将该文件引入mybatis的核心配置文件中，即引入mybatis-config.xml文件中。

其次，需要在maven中将xml文件所在地址定义为maven搜索配置文件扫描的地址，否则maven在编译程序时不会读取该文件。


    


    
        
            src/main/resources
            
                **/*.properties
                **/*.xml
            

        
        
            src/main/java
            
                **/*.properties
                **/*.xml

编写测试类进行测试

在test文件夹中新建对应接口文件相同位置的建立对应的测试类，测试测试方法验证。

//文件名： UserMapperTest.java
public class UserMapperTest {

    @Test
    public void test(){
        //新建sqlSession连接。
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        try{
            //通过sqlSession的getMapper方法获取UserMapper对象；
            //该对象就是对应UserMapper接口的实例化对象。
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            //UserMapper对象可以直接使用接口定义的方法，方法的实现来自Mapper.xml配置文件。
            List userList = userMapper.getUserList();

            for (User user : userList) {
                System.out.println(user);
            }
        } finally {
            //测试完毕要记得关闭连接，释放内存。
            sqlSession.close();
            System.out.println("=====================");
        }

    }
}