Mybatis学习笔记(一)--快速入门

一、Mybatis介绍

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

二、Mybatis快速入门_通过Maven来构建项目

2.1、准备开发环境

1.创建Maven工程，目录结构如下图所示

2. 在pom.xml文件中引入依赖的代码

<dependencies>
        <!--引入mybatis依赖-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>

        <!--引入mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.32</version>
        </dependency>

        <!--引入测试的依赖-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
        
</dependencies>

【需要引入的依赖代码，参考：https://mvnrepository.com/】

3.创建数据库和表

SQL脚本如下：

USE mybatis;

CREATE TABLE users(
    id INT PRIMARY KEY NOT NULL AUTO_INCREMENT,
    NAME VARCHAR(20) NOT NULL,
    age INT NOT NULL
);

INSERT INTO users(NAME,age) VALUES('张三',18);
INSERT INTO users(NAME,age) VALUES('李思',28);

到此，前期开发环境准备工作全部完成。

 

2.2、使用Mybatis查询表中的数据_使用xml配置完成

1.添加mybatis的配置文件sqlConfig.xml

 

 

 sqlConfig.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"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

2.定义数据库表中所对应的实体类，如下图所示：

 

 

 User类的代码如下：

package com.yif.pojo;

import java.io.Serializable;

public class User implements Serializable {

    //实体类的属性与数据库中的字段名称一一对应
    private Integer id;
    private String name;
    private Integer age;

    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 Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

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

3.定义操作users表的sql映射文件UserDao.xml

 

 UserDao.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">
<mapper namespace="com.yif.dao.UserDao">

    <!--
        在select标签中编写查询的SQL语句， 设置select标签的id属性为getUserById，id属性值必须是唯一的，不能够重复
        使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型
        resultType="com.yif.pojo.User"就表示将查询结果封装成一个User类的对象返回
        User类就是users表所对应的实体类
    -->
    <select id="getUserById" resultType="com.yif.pojo.User" parameterType="int">
        select * from users where id = #{id}
    </select>
</mapper>

4.在sqlConfig.xml文件中注册UserDao.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"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <package name="com.yif.dao"></package>
    </mappers>

5.编写测试代码：执行定义的sql语句

 

 UserDao代码如下：

package com.yif.dao;

import com.yif.pojo.User;

public interface UserDao {

    /**
     * 根据id查询用户信息
     * @param id
     * @return
     */
    public User getUserById(Integer id);

    /**
     * 向数据库中添加用户信息
     * @param user
     * @return
     */
    public int addUser(User user);

    /**
     * 更新数据库中的用户信息
     * @param user
     * @return
     */
    public int updateUser(User user);

    /**
     * 删除数据库中指定的用户信息
     * @param id
     * @return
     */
    public int deleteUserById(Integer id);
}

MybatisTest测试代码如下

 @Test
    public void testGetUserById(){
        InputStream is = MybatisTest.class.getClassLoader().getResourceAsStream("sqlConfig.xml");
        SqlSessionFactory build = new SqlSessionFactoryBuilder().build(is);
        SqlSession session = build.openSession();
        UserDao userDao = session.getMapper(UserDao.class);
        User user = userDao.getUserById(1);
        System.out.println(user);

    }

运行结果如下：

 

 

【踩坑记录】

1、操作users表的sql映射文件的目录结构以及文件名必须与UserDao的目录结构和名称一致，否则会报错：

 

 报错记录：