入门

安装

获取方法：

maven仓库

<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>

github：https://github.com/mybatis/mybatis-3
中文文档：https://mybatis.org/mybatis-3/zh/index.html

本文参考：https://mybatis.org/mybatis-3/zh/getting-started.html

第一个mybatis程序

思路：搭建环境—->导入mybatis—->编写代码—->测试

搭建环境

创建数据库

CREATE DATABASE `mybatis`;

USE `mybatis`;

CREATE TABLE `user` (
    `id` INT(11) 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,'张三','123567'),
(3,'李四','123789')

创建项目

新建一个普通的maven项目
删除src目录，以此项目作为父工程
这样做的好处是之后的学习工程只需要新建一个个的模块，不需要每次都重复导入依赖。

导入依赖

<!-- 导入依赖 -->
<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 mybatis需要-->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>
</dependencies>

新建第一个模块

1. 编写mybatis的核心配置文件

在类路径下新建 mybatis-config.xml 文件。XML 配置文件中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）

<?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?useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

2.编写mybatis的工具类

public class MybatisUtil {
    private static SqlSessionFactory sqlSessionFactory;
    /**
     * 获得SqlSessionFactory
     */
    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    /**
     * 通过 SqlSessionFactory 得到可以执行sql的 SqlSession 实例
     * @return 可以执行sql的 SqlSession 对象
     */
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。
既然有了 SqlSessionFactory，顾名思义，我们就可以从中获得 SqlSession 的实例了。SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
编写代码
实体类 User.java

public class User {
    private Integer id;
    private String name;
    private String pwd;
    public User() {
    }
    public User(Integer id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }
    public Integer getId() {
        return id;
    }
    public void setId(Integer 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 + '\'' +
                '}';
    }
}

接口 UserDao.java

public interface UserDao {

    public List<User> getUserList();
}

接口实现 UserMapper.xml

<?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 命名空间：绑定对应的 mapper 接口-->
<mapper namespace="com.tassel.dao.UserDao">
    <select id="getUserList" resultType="com.tassel.pojo.User">
    select * from mybatis.user;
  </select>
</mapper>

测试

@Test
public void testGetUserList(){
    // 1. 获取SqlSession对象
    SqlSession sqlSession = MybatisUtil.getSqlSession();
    // 2. 执行sql
    UserDao userDao = sqlSession.getMapper(UserDao.class);
    List<User> userList = userDao.getUserList();

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

错误1：

org.apache.ibatis.binding.BindingException: Type interface com.tassel.dao.UserDao is not known to the MapperRegistry.

MapperRegistry 中找到不到我们定义的接口，这是因为我们的mapper 配置文件没有在mybatis 的核心配置文件中注册。

mybatis-config.xml

<configuration>    
    <mappers>
        <!-- 每一个mapper配置文件都要在mybatis核心配置文件中注册 -->
        <mapper resource="com/tassel/dao/UserMapper.xml" />
    </mappers>
</configuration>

错误2：

Caused by: java.io.IOException: Could not find resource com/tassel/dao/UserMapper.xml

这个错误的原因是由于maven导出静态资源的问题，由于我们这个配置文件放在了java目录下，所以maven无法导出此文件，需要在pom文件中加入以下配置：

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>

使用maven clean后再执行就可以查询出来数据了。

Java 技术手册

2.Mybatis入门

入门

安装