0
点赞
收藏
分享

微信扫一扫

个人学习 MyBatis 问题及解决方法总结

高子歌 2022-04-06 阅读 82
java

文章目录

前言

提示：下面案例错误均为自己学习过程中出现的错误，解决办法仅供参考：

一、基础项目构建

1.1 创建父工程

父工程的pom.xml配置文件

    <?xml version="1.0" encoding="UTF8"?>
<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.kuang</groupId>
    <artifactId>Mybatis-Study</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <!--指明子模块-->
    <modules>
        <module>mybatis-01</module>
    </modules>
    <!--导入依赖-->
    <dependencies>
    <!--mysql驱动-->
        <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
            <version>8.0.26</version>
        </dependency>
        <!--mybatis依赖-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.9</version>
        </dependency>
        <!--junit测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>
</project>

1.2 创建子模块

子模块的pom.xml——父子工程的这种模式，就不需要每次创建一个项目都要重新加载包，而是每次创建一个子模块，都用父模块的包

<?xml version="1.0" encoding="UTF8"?>
<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">
         <!--指明父工程-->
    <parent>
        <artifactId>Mybatis-Study</artifactId>
        <groupId>com.kuang</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>mybatis-01</artifactId>
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>
</project>

1.3 创建实体类

User

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;
    }
//三个属性的set/get方法
    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.4 创建接口

UserDao

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

1.5 创建实现接口的配置文件

UserMapper.xml

创建实现接口的配置文件——相当于接口的实现类

<?xml version="1.0" encoding="UTF8" ?>
<!--这个配置文件就是用来编写sql语句（sql语句映射），满足实例中的SqlSession调用-->
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace 命名空间，就是 绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.kuang.dao.UserDao"><!--相当于实现了UserDao接口-->
    <!--此处的id对应，对应接口中的方法名；resulType/resultMap 返回结果集 type 类型  map表示集合-->
    <select id="getUserList" resultType="com.kuang.pojo.User"><!--resultType:写的路径是，pojo层下面的实体类User-->
<!--sql语句写在配置文件中-->
        select * from mybatis.user
    </select>
</mapper>

1.6 创建工具类

MybatisUtils

//工具类 sqlSessionFactory用来生产sqlSession
public class MybatisUtils {
    private static  SqlSessionFactory sqlSessionFactory;
    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 命令所需的所有方法。
    //你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句
     public static SqlSession getSqlSession(){
         return sqlSessionFactory.openSession();
     }
}

1.7 resources配置文件

mybatis-config.xml

<?xml version="1.0" encoding="UTF8" ?>
<!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"/><!--事务管理——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"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册！-->
    <mappers>
<!--        <mapper class="com.kuang.dao.UserDao"></mapper>-->
        <!--mapper文件的寺中引入方式 https://www.cnblogs.com/canger/p/9911958.html-->
 <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
</configuration>

1.8 创建测试类

UserDaoTest

public class UserDaoTest {
    @Test
    public void test(){
        //第一步：获得sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //方式一：获取dao对象，执行sql语句
        UserDao mapper = sqlSession.getMapper(UserDao.class);//通过接口的class对象，来getMapper
        List<User> userList =mapper.getUserList();
        //遍历一个数组
        for (User user : userList) {
            System.out.println(user);
        }
        //关闭SqlSession
        sqlSession.close();
    }
}

二、常见错误

2.1 sqlSessionFactory null

错误描述：
在这里插入图片描述
错误原因：
在这里插入图片描述
从上图中可以明显的看出，标记的两个位置，同时定义了SqlSessionFactory的变量，分别是全局变量和局部变量，所以 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);创建对象的过程中是无法创建的，那么就会产生sqlSessionFactory null的状况
解决办法

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
改为
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);#全部使用全局变量

2.2 The error may exist in com/kuang/dao/UserMapper.xml.

错误描述：
在这里插入图片描述
错误原因
这个错误的意思：在该包中，可能不存在UserMapper.xml
但是，从截图中，你也可以很明显的发现，在dao层是存在这个UserMapper.xml配置文件的，那就说明XML配置文件存在但是识别不到，
出现这个问题的原因：maven的约束大于配置，我们写的配置文件无法导出或者生效
解决办法
在<父工程>和<子工程>的pom.xml配置文件中都加入如下内容(父子工程中都加入，防止识别不到而再次产生该类问题)

 <!--在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>

2.3 Invalid bound statement(not found)

错误描述：
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.kuang.dao.UserDao.getUserList
在这里插入图片描述错误原因
无效的绑定语句：UserMapper.xml文件中的namespace 与接口的捆绑 出现问题
出现这种情况的原因有如下几种：
(1)namespace 路径/名称写错或者不对应
(2)UserMapper.xml文件中 select标签内的 id 与接口中的方法名不对应
(3)配置文件mybatis-config.xml文件中的mapper映射路径不对
解决办法
(1)针对上面出现的原因一 一检查，具体可参考：https://note.youdao.com/web/#/file/WEBf6932456eaca4d3c6124532ed5458725/note/WEB7d88e8ff15f2834139849e8454afcb6b/
(2)mapper文件的四种引入方式检查，具体可参考：
https://www.cnblogs.com/canger/p/9911958.html

总结

这些问题都是在使用maven过程中一定会出现的问题！
避坑避坑~

举报

相关推荐

Mybatis的常用配置总结（个人学习总结）

java

Mybatis-Plus个人学习总结笔记

sqlmysql数据库MySQL

Redis个人学习总结

日记本软件测试

python问题总结解决方法

pythontensorflowkeras

Pytorch个人学习记录总结 10

学习pytorch人工智能娱乐python深度学习

换根DP问题（个人学习）

c++

HTML个人学习

html前端

Android内存泄露及解决方法总结

Android 学习Android...手机移动程序开发Android知识

Java虚拟机(JVM)个人学习总结

面试jvm

Linux云计算个人学习总结（二）

linux云计算学习
0 条评论