MyBatis-入门

MyBatis简介

---

---

什么是MyBatis

• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
• MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。

---

持久层框架

1. 数据持久化

• 持久化：
  就是将程序的数据在持久状态和瞬时状态转化的过程。
  内存的特点是断电即失，大多数情况下特别是企业级应用，大量的数据需要保存到可掉电式存储设备中。

数据持久化就是将内存中的数据模型转换为存储模型，以及将存储模型转换为内存中的数据模型的统称

存储模型可以是：关系模型、XML、二进制流等等

在Java程序中最普遍的例子就是：

1. java程序中所用到的配置文件（.properties,.xml文件等），将一些用户配置通过序列化流从内存中读到配置文件并储存到电脑磁盘中，实现配置的持久化。
2. 数据库实现的就是数据持久化的典型实例，将内存中（对象）的属性储存到数据库中。

2.持久层

Java的MVC三层架构:

• 所谓持久层，也就是在系统逻辑层面上，专注于实现数据持久化的一个相对独立的领域(Domain)，是把数据保存到可掉电式存储设备中。持久层是负责向（或者从）一个或者多个数据存储器中存储（或者获取）数据的一组类和组件。
• 之所以要独立出一个“持久层”的概念,而不是“持久模块”，“持久单元”，也就意味着，我们的系统架构中，应该有一个相对独立的逻辑层面，专著于数据持久化逻辑的实现.与系统其他部分相对而言，这个层面应该具有一个较为清晰和严格的逻辑边界。

持久层框架：Hibernate、MyBatis

---

MyBatis的作用

MyBatis帮助程序员将数据存入到数据库中：

• 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。
• mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
• 解除sql与程序代码的耦合，通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。

---

---

MyBatis入门程序

我们的需求是实现对用户表（User）的增、删、改、查操作。

步骤：搭建环境–>导入Mybatis–>编写代码–>测试！

---

搭建环境

1.搭建数据库：
创建一个mysql数据库（mybatis），创建用户表（user）

CREATE DATABASE `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,'李四','111111'),
(3,'王五','654321')

2. 创建一个maven项目

3. 配置pom.xml，导入项目所需maven依赖

• MySql驱动
• MyBatis驱动
• junit测试驱动

<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.2</version>
        </dependency>
        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

• maven由于他的约定大于配置，我们之后可以能遇到我们写的配置文件，无法被导出或者生效的问题。解决方案，在pom.xml中导入：

<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>

---

创建一个模块

1. 在resource文件夹中创建创建MyBatis的核心配置文件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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/><!--mysql核心驱动-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/><!--数据库同一资源定位符-->
                <property name="username" value="root"/><!--用户名-->
                <property name="password" value="123456"/><!--密码-->
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

2. 编写mybatis工具类：

• 通过mybatis获取SqlSessionFactory对象
• 通过sqlSessionFactory对象获取SqlSession 的实例

package com.mybatis.util;


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 MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

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

    }

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


}

---

编写代码

1. 实体类

• 根据user表属性对应编写一个储存表数据的User类：

package com.mybatis.vo;

public class User {
    private int id;
    private String username;
    private String password;

    public int getId() {
        return id;
    }

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

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

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

2. Mapper接口

• 用于定义对数据库进行操作的方法：

package com.mybatis.mapper;

import com.mybatis.vo.User;

import java.util.List;

public interface UserMapper {

//方法返回值根据JDBC中执行对应的sql语句返回值进行判断

    int insertUser(User user);//增添用户

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

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

    List<User> getUserList();//查询用户列表

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

3. 创建并编写Mapper配置文件

• 接口实现类由原来的UserDaoImpl转变为一个 Mapper配置文件：

<?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接口-->
<mapper namespace="com.mybatis.mapper.UserMapper"> 

<!--定义parameterType为指定执行此sql语句需传入的参数类型，与接口中方法对应-->
<!--若该方法需返回一个结果集，定义resultType为结果集中元素类型-->

<!--增添用户-->
    <insert id="insertUser" parameterType="com.mybatis.vo.User">
        insert into mybatis.user (id,username,password) values (#{id},#{username},#{password})
    </insert>

<!--删除用户-->
    <delete id="deleteUser" parameterType="int">
        delete from mybatis.user where id=${id}
    </delete>

<!--修改用户-->
    <update id="updateUser" parameterType="com.mybatis.vo.User">
        update mybatis.user set username=#{username},password=#{password} where id=#{id}
    </update>

<!--查询用户列表-->
    <select id="getUserList" resultType="com.mybatis.vo.User">
       select * from mybatis.user
   </select>

<!--根据id查询用户-->
    <select id="getUserById" parameterType="int" resultType="com.mybatis.vo.User">
        select * from mybatis.user where id=#{id}
    </select>

</mapper>

• 修改MyBatis核心配置文件中的Mapper配置文件映射：

<?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"/><!--mysql核心驱动-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/><!--数据库同一资源定位符-->
                <property name="username" value="root"/><!--用户名-->
                <property name="password" value="123456"/><!--密码-->
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/mybatis/mapper/UserMapper.xml"/><!--Mapper配置文件映射-->
    </mappers>
</configuration>

---

测试

• 原数据库

实现接口方法前，我们需要通过工具类得到sqlSession对象，并通过其getMapper（Mapper接口class文件）获取接口对象来调用其方法。（再操作数据库进行增删改后必须通过sqlSession.commit()提交事务才能执行成功）

1. 增添用户

创建一个User类对象，并给成员变量赋值，再传入接口中增添用户的方法执行：

    @org.junit.Test

    public void insertUser(){
        User user = new User();
        user.setId(4);
        user.setUsername("赵六");
        user.setPassword("222222");

        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
       
        int i = mapper.insertUser(user);
        sqlSession.commit();
        System.out.println(i);
    }

运行结果输出1表示增添用户操作成功！

2. 删除用户

通过传入参数id，执行接口中删除指定用户的方法：

@org.junit.Test
    public void deleteUser(){
        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        
        int i = mapper.deleteUser(2);
        sqlSession.commit();
        System.out.println(i);
    }

运行结果输出1表示删除用户操作成功！

3. 修改用户

创建一个User类对象，并给成员变量赋值，再传入接口中修改用户的方法执行：

@org.junit.Test
    public void updateUser(){
        User user = new User();
        user.setId(1);
        user.setUsername("李雷");
        user.setPassword("000000");

        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        int i = mapper.updateUser(user);
        sqlSession.commit();
        System.out.println(i);
    }

运行结果输出1表示修改用户操作成功！

4. 查询用户列表

直接执行接口中查询用户列表的方法，返回List集合：

    @org.junit.Test
    public void getUserList(){
        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        List<User> userList = mapper.getUserList();

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

遍历集合得到结果：

5. 根据id查询用户

通过传入参数id，执行接口中根据id查询用户的方法：

@org.junit.Test
    public void getUserById(){
        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        User id1 = mapper.getUserById(1);
        System.out.println("id为1的用户："+id1);
        
        User id3 = mapper.getUserById(3);
        System.out.println("id为3的用户："+id3);
        
        User id4 = mapper.getUserById(4);
        System.out.println("id为3的用户："+id4);

    }

返回指定id的User对象：