MyBatis全版教程+源码分析(一)

一.什么是 MyBatis

MyBatis 是一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。(摘自MyBatis官网:http://www.mybatis.org/mybatis-3/zh/index.html)

我们来将他的介绍仔细分析一下

(1)首先它是一款持久层框架(persistence framework),什么是持久化,顾名思义就是将瞬时数据(比如内存中的数据,是不能永久保存的)持久化为持久数据(比如持久化至数据库中,能够长久保存)。规范的定义是将程序数据在持久状态和瞬时状态间转换的机制。目前比较流行的持久化框架就是Hibernate与MyBatis。

(2)它的优点是<避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集,我们在使用原生JDBC代码实现数据库的增删改查时,肯定会写大量冗余的代码比如数据库连接,将检索出来的数据原型映射成对象,当然我们可以在自己的项目手动将该类方法抽象成工具类。但是每个项目都需要这种工具类时,我们可以将其整理起来封装为jar包,随处使用,mybatis底层就实现了这种工具类

(3)方式:通过XML或注解来配置和映射原生信息,通过XML来获取配置,通过注解来入侵类,这是大量开源框架的惯用方式。

更多信息可以参见MyBatis官网

二.MyBatis项目构建

2.1.准备开发环境

(1)新建一个maven项目,

(2)目前mybatis最新版本是mybatis-3.4.5,pom文件如下:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.vichoufa</groupId>
    <artifactId>mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>6.0.6</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/junit/junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skip>true</skip>
                </configuration>
            </plugin>

        </plugins>
    </build>

</project>


(3)建立测试数据库

create database test default character utf8 COLLATE utf8_general_ci;  
CREATE TABLE `dept` (  
  `id` int(11) NOT NULL AUTO_INCREMENT,  
  `dept_name` varchar(50) DEFAULT NULL,  
  PRIMARY KEY (`id`)  
) ENGINE=InnoDB AUTO_INCREMENT=9 DEFAULT CHARSET=utf8;  
insert into dept (dept_name) values ('开发部'),('运营部'),('销售部'),('人事部'),('财务部'),('总经理办公室'),('后勤部'),('市场部');  

在mysql中运行


到此,前期的开发环境准备工作全部完成。
2.2.使用MyBatis查询表中的数据

(1)添加配置文件

<?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">
<!-- 在这个文件放置一些全局性的配置 如handler、objectFactory、plugin、以及mappers的映射路径 -->
<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/test" />
                    <property name="username" value="root" />
                    <property name="password" value="root" />
                </dataSource>
            </environment>
        </environments>
</configuration>
(2)新建对应的实体类


代码如下

package com.vichoufa.mybatis.pojo;

/**
 * Created by vichoufa on 2017/11/19 0019.
 */
public class DeptPojo {
    private int id;

    private String name;

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

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

(3)定义操作dept表的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">
<!-- 为这个mapper指定一个唯一的namespace,namespace的值习惯上设置成包名+sql映射文件名,这样就能够保证namespace的值是唯一的
 例如namespace="com.vichoufa.mybatis.mapper.deptMapper"就是com.vichoufa.mybatis.mapper(包名)+deptMapper(deptMapper.xml
 文件去除后缀)
 -->
<mapper namespace="com.vichoufa.mybatis.mapper.deptMapper">
    <!--更具ID检索部门-->
    <select id="selectDeptById" parameterType="int" 
            resultType="com.vichoufa.mybatis.pojo.DeptPojo">
        select id, name
        from dept
        where id = #{id}
    </select>
</mapper>

(4)将映射文件添加到mybatis.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">
<!-- 在这个文件放置一些全局性的配置 如handler、objectFactory、plugin、以及mappers的映射路径 -->
<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/test" />
                    <property name="username" value="root" />
                    <property name="password" value="root" />
                </dataSource>
            </environment>
        </environments>
        <mappers>
            <mapper resource="com/vichoufa/mybatis/mapper/deptMapper.xml"></mapper>
        </mappers>
</configuration>

(5)编写测试代码

package com.vichoufa.mybatis.test;

import com.vichoufa.mybatis.pojo.DeptPojo;
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 org.junit.Test;

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

/**
 * Created by vizhoufa on 2017/11/19 0019.
 */
public class TestDeptMapper {
    @Test
    public void testSelectDeptById() throws IOException {
        //mybatis的配置文件
        String resource = "MyBatis.xml";
        //使用类加载器加载mybatis的配置文件(它也加载关联的映射文件)
//        InputStream is = TestDeptMapper.class.getClassLoader().getResourceAsStream(resource);
//        //构建sqlSession的工厂
//        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
        //使用MyBatis提供的Resources类加载mybatis的配置文件(它也加载关联的映射文件)
        Reader reader = Resources.getResourceAsReader(resource);
        //构建sqlSession的工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        //创建能执行映射文件中sql的sqlSession
        SqlSession session = sessionFactory.openSession();

        String statement = "com.vichoufa.mybatis.mapper.deptMapper.selectDeptById";//映射sql的标识字符串
        //执行查询返回一个唯一user对象的sql
        DeptPojo dept = session.selectOne(statement, 1);
        System.out.println(dept);
    }
}

(6)运行测试用例:


有什么问题的话,请留言,我会及时回复

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章