Mybatis框架的简单运用

一、配置流程

1.流程示意图（通过XML映射文件实现）：

2.流程：

2.1 导入包：

2.1.1 下载包

　　数据库驱动包（本文以MySQL为例）：https://mvnrepository.com/artifact/mysql/mysql-connector-java

　　Mybatis框架包：https://mvnrepository.com/artifact/org.mybatis/mybatis

2.1.2 导入程序

将jar包放入程序新建的文件夹

　　

选中jar包，右键Build Path->Add to Build Path，结果如图，jar包已加载进程序内

2.2 添加规则文件

规则文件的位置：①mybatis-3.4.1orgapacheibatisuilderxml

　　　　　　　　②打开上面下载的Mybatis框架文件夹，查找dtd

规则文件的Key：官方文档内Ctrl+F查找public：

 

选择Window->Preferences

 点击OK，重复上面的操作，完成添加Mapper规则文件。

2.3.编写配置文件

2.3.1 创建XML文件

在src文件下创建XML文件，填写文件名为MybatisConfig.xml，然后Next：

选择DTD文件，然后Next，

选择创建配置文件，然后Next->FInish，创建成功。

2.3.2 编写文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "mybatis-3-config.dtd" >
<configuration>
    <!--environments标签用于配置数据库连接信息，可以配置多个数据库的连接信息  
        default属性：环境集里面可以配置多个数据库连接环境，但是必须要指定默认的环境，指定的是环境environment标签的ID
    -->
    <environments default="sms">
        <!-- environment环境标签 ，用于配置一个数据库连接的信息-->
        <environment id="sms">
            <!--指定使用的事务类型 
                JDBC : 使用JDBC的事务处理
                MANAGER: 不需要事务处理
            -->
            <transactionManager type="JDBC"></transactionManager>
            <!--dataSource标签：配置数据库连接信息
                 type:配置数据源的类型
                 JNDI :使用JNDI数据源，就是在web服务器配置数据源，让程序调用
                 POOLED ： 使用默认内置的连接池
                 UNPOOLED：使用直连数据库，不需要连接池
             -->
            <dataSource type="POOLED">
                <!-- 连接四要素 -->
                <property name="driver" value="org.gjt.mm.mysql.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/sms"/>
                <property name="username" value="root"/>
                <property name="password" value="12345"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 配置指定加载的映射文件 -->
    <mappers>
        <mapper class="cn.zwj.mapper.StudentMapper"></mapper>
    </mappers>
</configuration>

2.4 映射文件和映射接口

因为映射文件和映射接口要向对应，所以使用相同命名表示他们的对应关系，在多映射文件中可以很好找到相对应的接口

创建一个映射文件，

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "mybatis-3-mapper.dtd" >
<mapper namespace="cn.zwj.mapper.StudentMapper">
    <!-- #{}类似于？（预处理块），与POJO中的变量名对应 -->
    <insert id="insert">
        INSERT INTO tb_student (STUDENT_NAME, STUDENT_PWD, STUDENT_STATUS, CREATE_DATE, STUDENT_ACCOUNT) VALUES (#{studentName}, #{studentPwd}, #{studentStatus}, #{createDate}, #{studentAccount})
    </insert>
</mapper>

package cn.zwj.mapper;

import cn.zwj.pojo.Student;

public interface StudentMapper {
    int insert(Student student);
}

 通过XML中的<mapper>标签的namespace属性，来绑定对应的接口，<insert>标签的id属性值为借口中的方法名

2.5 POJO

import java.io.Serializable;
import java.util.Date;

public class Student implements Serializable{
    private static final long serialVersionUID = -9125884258413809899L;
    public Long studentId;//bigint(20) not null auto_increment comment '学生编号',
    public String studentName;//varchar(50) null default null comment '姓名',
    public String studentPwd;//varchar(50) null default null comment '密码',
    public Integer studentStatus;//int(11) null default null comment '状态',
    public Date createDate;//datetime null default null comment '创建时间',
    public String studentAccount;//varchar(50) null default null comment '学生帐号',
    public Long getStudentId() {
        return studentId;
    }
    public void setStudentId(Long studentId) {
        this.studentId = studentId;
    }
    public String getStudentName() {
        return studentName;
    }
    public void setStudentName(String studentName) {
        this.studentName = studentName;
    }
    public String getStudentPwd() {
        return studentPwd;
    }
    public void setStudentPwd(String studentPwd) {
        this.studentPwd = studentPwd;
    }
    public Integer getStudentStatus() {
        return studentStatus;
    }
    public void setStudentStatus(Integer studentStatus) {
        this.studentStatus = studentStatus;
    }
    public Date getCreateDate() {
        return createDate;
    }
    public void setCreateDate(Date createDate) {
        this.createDate = createDate;
    }
    public String getStudentAccount() {
        return studentAccount;
    }
    public void setStudentAccount(String studentAccount) {
        this.studentAccount = studentAccount;
    }
}

与数据库中的一个表对应的实体类，实现set/get方法

2.6 会话构建工具类

import java.io.IOException;
import java.io.Reader;

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

public class MybatisUtils {
    //对外只开放一个工厂
    public static final SqlSessionFactory SSF = createSqlSessionFactory();
    //声明一个线程变量
    public static final ThreadLocal<SqlSession> THREAD_LOCAL = new ThreadLocal<>();
    
    //1.获得会话工厂
    private static SqlSessionFactory createSqlSessionFactory() {
        try {
            //读取配置文件
            Reader reader = Resources.getResourceAsReader("MybatisConfig.xml");
            //创建会话工厂构建类对象
            SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
            //构建会话工厂
            return builder.build(reader);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        return null;
    }
    
    //2.获得会话
    public static SqlSession getSession() {
        if (THREAD_LOCAL.get() == null) {
            SqlSession session = SSF.openSession();
            THREAD_LOCAL.set(session);
        }
        return THREAD_LOCAL.get();
    }
    
    public static void close() {
        if (THREAD_LOCAL.get() != null) {
            SqlSession session = THREAD_LOCAL.get();
            session.close();
            THREAD_LOCAL.remove();
        }
    }
}

为什么只对外开放一个工厂？

答：因为如果出现多个数据源，数据库的连接就可能来自于不同的数据源！导致数据库连接无法同步，从而导致事务失效！

为什么要声明一个线程变量？

答：同访问的一条线程，获得的会话是相同的，实现线程安全

2.7.测试

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import cn.zwj.mapper.StudentMapper;
import cn.zwj.pojo.Student;
import cn.zwj.utils.MybatisUtils;

public class StudentTest {
    @Test
    public void test1() {
        //获得会话
        SqlSession session = MybatisUtils.getSession();
        //构建映射接口 的动态对象
        StudentMapper studentMapper = session.getMapper(StudentMapper.class);
        Student student = new Student();
        student.setStudentName("张三1");
        int insert = studentMapper.insert(student);
        System.out.println(insert);
        //提交事务
        session.commit();
        MybatisUtils.close();
    }
}

当控制台输出一个大于0的数字，表示成功实现运用mybatis框架操作数据库

2.8 修改为注解实现

2.8.1 流程示意图：

2.8.2 修改代码：

import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Options;

import cn.zwj.pojo.Student;

public interface StudentMapper {
    @Insert("INSERT INTO tb_student (STUDENT_NAME, STUDENT_PWD, STUDENT_STATUS, CREATE_DATE, STUDENT_ACCOUNT) VALUES (#{studentName}, #{studentPwd}, #{studentStatus}, #{createDate}, #{studentAccount})")
    @Options(useGeneratedKeys = true, keyProperty = "studentId")
    //@Options：注解声明生成主键
    int insert(Student student);
}

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "mybatis-3-config.dtd" >
<configuration>
    <environments default="sms">
        <environment id="sms">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="org.gjt.mm.mysql.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/sms"/>
                <property name="username" value="root"/>
                <property name="password" value="12345"/>
            </dataSource>
        </environment>
    </environments>
        <!-- 修改映射文件为映射接口-->
    <mappers>
        <mapper class="cn.zwj.mapper.StudentMapper"></mapper>
    </mappers>
</configuration>

删除映射文件，然后测试代码。