初始Mybatis

99 阅读3分钟

Mybatis简介

  1. MyBatis 是一款优秀的持久层框架;
  2. 它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
  3. 持久层:Dao层、Service层、Controller层
    • 完成持久化工作的代码块。
    • 层界限十分明显。
  4. 功能:
    1. 方便存储数据到数据库中。
    2. 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
    3. 提供xml标签,支持编写动态sql
    4. sql和代码的分离,提高了可维护性。

搭建一个简单的Mybatis(这里用IDEA搭建)

  1. 创建数据库

image.png

  1. 创建一个普通的Maven项目
  2. 打开setting设置,查看自己的Maven配置(这个在之前的Blog有),有时候IDEA会改掉这个Maven设置,改成自己自带的Maven3。

image.png

  1. 删除src目录 ----> 这样就可以把这个工程当成父工程了,然后创建子工程
  2. 导入Maven依赖
    <!--导入依赖-->
    <dependencies>
        <!--mysqlq驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.12</version>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.4</version>
        </dependency>
        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
  1. IDEA连接数据库
  2. 创建子模块
  3. 在子模块进行项目结构分层

image.png

  1. 编写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核心配置文件-->
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/wu/dao/UserMapper.xml"/>
    </mappers>
</configuration>

注意: 在mybatis的核心配置文件 mybatis-config.xml 中,必须添加<mappers> <mapper resource="com/wu/dao/UserMapper.xml"/> </mappers> ,因为每一个mapper.xml都需要在mybatis核心配置文件下注册

  1. 编写mybatis工具类 MybatisUtils
package com.wu.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 MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory = null;

    static {
        try {
            //使用Mybatis第一步 :获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    //既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例.
    // SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
    public static SqlSession getSqlSession(){

        return sqlSessionFactory.openSession();
    }

}

  1. 编写实体类(快捷键:alt+insert实现方法的构造)

image.png

package com.wu.pojo;

public class User {
    private int id;
    private String name;
    private String pwd;

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

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

    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 + '\'' +
                '}';
    }
}

  1. 编写Dao接口
package com.wu.dao;

import com.wu.pojo.User;

import java.util.List;

public interface UserDao {
    public List<User> getUserList();
}

  1. 编写Dao接口实现类

注意:mybatis编写Dao接口实现类,将原来的UserDaoImpl转变为一个Mapper配置文件

<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!--namespace=绑定一个指定的Dao/Mapper接口-->
<mapper namespace="com.wu.dao.UserDao">
    <select id="getUserList" resultType="com.wu.pojo.User">
        select * from mybatis.user
    </select>
</mapper>
  1. 进行测试
package com.wu.dao;

import com.wu.pojo.User;
import com.wu.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @Test
    public void test(){

        //1.获取SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //2.执行SQL
        // 方式一:getMapper
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userList = userDao.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }

        //关闭sqlSession
        sqlSession.close();
    }

}

可能出现的问题

  1. org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry. ----> 没有在mybatis核心配置文件注册mapper 2.java.lang.ExceptionInInitializerError ----->在控制台看,具体是什么错误(两种错误,两张照片解决)
  2. 报错信息:1个字节的UTF-8 。。。。(具体忘了。)
    
  3. Dao接口实现类没找到,在pom.xml文件中配置resources
    

image.png

image.png

一个注意点

在配置pom.xml时,可以导入resources,避免资源无法找到

    <!--在build中配置resources,来防止我们资源到处失败的问题-->
    <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>