初识Mybatis/封装mybatisUtils类/常见错误解决方案

249 阅读2分钟

搭建数据库

CREATE TABLE `user` ( 
`id` INT ( 20 ) NOT NULL PRIMARY KEY,
`name` VARCHAR ( 30 ) DEFAULT NULL, 
`pwd` VARCHAR ( 30 ) DEFAULT NULL 
) ENGINE = INNODB DEFAULT CHARSET = utf8;

INSERT into `user`(`id`,`name`,`pwd`) VALUES (1,'张三','11111')

创建项目

  • 新建一个普通的maven项目
  • 删除src目录
  • 导入maven依赖
<!--导入依赖-->
<dependencies>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.30</version>
    </dependency>
    <!--mybatis-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.2</version>
    </dependency>
    <!--junit-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
    </dependency>
</dependencies>

创建一个模块

  • 编写mybatis核心配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/sqlstudy?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>
  • 编写mybatis工具类
    • 从 XML 中构建 SqlSessionFactory:每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。从 XML 文件中构建 SqlSessionFactory 的实例非常简单,建议使用类路径下的资源文件进行配置。 但也可以使用任意的输入流(InputStream)实例,比如用文件路径字符串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类,它包含一些实用方法,使得从类路径或其它位置加载资源文件更加容易。

package com.mybatisstudy.utils;

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;

/**
 * @author tian
 * sqlSessionFactory --> sqlSession
 */
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    // 静态代码块
    static {
        // 使用mybatis第一步 获取sqlSessionFactory
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
           sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

    // 既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
    /**
     * sqlSession完全包含了面向数据库执行sql,命令所需的所有方法.
     */
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

编写代码

  • 实体类pojo
package com.mybatisstudy.pojo;

/**
 * @author tian
 */
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;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + ''' +
                ", 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;
    }
}
  • Dao接口
package com.mybatisstudy.dao;
import com.mybatisstudy.pojo.User;
import java.util.List;

/**
 * @author tian
 */
public interface UserDao {
    /**
     * 获取用户列表
     * @return
     */
    List<User> getUserList();
}
  • 接口实现类由原来的UserDaoImpl转化为一个Mapper配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace绑定一个对应的dao/Mapper接口-->
<mapper namespace="com.mybatisstudy.dao.UserDao">
    <!--resultType结果集-->
    <select id="getUserList" resultType="com.mybatisstudy.pojo.User">
        select * from user
    </select>
</mapper>

注意点

每一个Mapper.XML都需要在核心配置文件中注册!

错误1:资源过滤

image.png

解决方案

<!--maven由于约定大于配置,如果遇到配置文件无法被导出和生效时,解决方案:-->
<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>

错误2: 数据库连接安全认证问题

com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure

image.png 配置文件数据库连接路径 image.png 原因:useSSL=true时 数据库连接 安全认证不通过 

解决办法:将useSSL true改为false  (可以使用)

正常执行 不过推荐连接驱动换:com.mysql.cj.jdbc.Driver image.png 更换JDBC驱动:使用:com.mysql.cj.jdbc.Driver (需注意:需要指定时区serverTimezone:)

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC

如果还有异常,切换mysql坐标版本(高版本)

  • 测试代码
public class UserDaoTest {
    @Test
    public void test(){
        // 第一步:获得sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        // 方式一:执行SQL
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        List<User> userList = mapper.getUserList();
        userList.forEach(e -> {
            System.out.println(e);
        });
        // 关闭sqlSession
        sqlSession.close();
    }

}