我的第一个MyBatis
Posted 一只懒懒的熊Zz
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了我的第一个MyBatis相关的知识，希望对你有一定的参考价值。
一、简介
Mybatis：数据持久层框架，简化JDBC的操作，持久化即将数据从瞬态转换为持久态，保护数据的安全，传统的JDBC(Java数据库连接工具)，要编写很多重复繁琐的代码去对数据库CRUD，但是引入MyBatis持久层框架后，只需要编写简单的代码就能对数据库进行CRUD，提高程序的开发效率
二、数据库文件：
CREATE TABLE `user` ( `id` int(10) NOT NULL AUTO_INCREMENT, `name` varchar(15) DEFAULT NULL, `age` int(3) DEFAULT NULL, `sex` varchar(2) DEFAULT NULL, `location` varchar(50) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=9 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
三、MyBatis项目的配置步骤：
1、MyBatis的核心配置文档：https://mybatis.org/mybatis-3/zh/configuration.html#properties
2、创建maven工程：
a.从mvnreposity网址中查找到MyBatis、mysql连接驱动的依赖地址(mysql-connector-java连接驱动的版本必须和数据库的版本一致不然会报错)，并存放到pom.xml文件的<dependencies> </dependencies>标签中。
注意：如果连接数据库的驱动的版本和数据库版本不一致，就会产生数据库连接异常
mvnreposity地址：https://mvnrepository.com
b.在src-->main-->resources,文件下，创建mybatis配置文件mybatis-config.xml,配置文件中主要用于记录数据库的连接信息
注意：在intelliji idea开发工具中，项目运行时不会自动取编译src文件中的任何.xml文件，即不会在classes文件中生成字节码文件，这样就找不到xml文件，就会产生异常can\'t not find .xml exception
c.以文件字节输入流的形式去加载mybatis配置文件mybatis-config.xml，通过SqlSessionFactoryBuilder().build(inputStream)创建SqlSessionFactory，再通过 sqlSessionFactory创建sqlSession对象，即可创建SQL对象，用于对数据库进行CRUD
注意：创建的 sqlSessionFactory对象并没有类型，如果你指定它为 sqlSessionFactory类型就会报空指针异常：java.lang.NullPointerException
d.编写代码：
(1)实体类：一张数据库表对应一个Java的实体类，一般要求数据库字段的大小写和属性的大小写一致
(2)Dao接口：数据应用层
(3)接口实现类实现Dao接口
(4)编写mapper.xml文件，对数据库进行增删改查操作
(5)测试
3、创建Mybatis工程的具体步骤：
我自己工程的目录结构：mybatis-config.xml一般放在resources文件夹中
a.在创建好maven工程，并配置好本地仓库后，在src\\main\\resources文件夹中创建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> <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?autoReconnect=true&failOverReadOnly=false&useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=UTC"/> <property name="username" value="root"/> <property name="password" value="root"/> <property name="poolMaximumActiveConnections" value="300000" /> <property name="poolMaximumIdleConnections" value="30" /> <property name="poolPingEnabled" value="true"/> <property name="poolPingQuery" value="select 1"/> <property name="poolPingConnectionsNotUsedFor" value="1800"/> </dataSource> </environment> </environments> </configuration>
注意：任何的xml文件中都不要加注释，不然会报错
b.编写接口、编写数据库表对应的实体类（用于保存从数据库中读取到记录）
package Dao;
import java.util.List; public interface userDao { List<entity.user> getuserlist(); }
package entity; public class user { private int id; private String name; private int age; private char sex; private String location; public user() { } public user(int id, String name, int age, char sex, String location) { this.id = id; this.name = name; this.age = age; this.sex = sex; this.location = location; } 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 int getAge() { return age; } public void setAge(int age) { this.age = age; } public char getSex() { return sex; } public void setSex(char sex) { this.sex = sex; } public String getLocation() { return location; } public void setLocation(String location) { this.location = location; } @Override public String toString() { return "user{" + "id=" + id + ", name=\'" + name + \'\\\'\' + ", age=" + age + ", sex=" + sex + ", location=\'" + location + \'\\\'\' + \'}\'; } }
c.编写一个类MybatisUtils，以字节流的形式加载核心配置文件：mybatis-config.xml，并通过SqlSessionFactoryBuilder().build(inputStream)创建SqlSessionFactory，
再通过 sqlSessionFactory创建sqlSession对象
package com;//import jdk.internal.loader.Resource; 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;//提升作用域， 才能用在public static SqlSession getSqlSession()方法中 static{ try { // a.以流的形式加载核心配置文件mybatis-config.xml； // b.再创建sqlsessionfactory对象，并通过qlsessionfactory对象创建sqlsession会话 InputStream inputStream = null; String resource = "mybatis-config.xml"; inputStream = Resources.getResourceAsStream(resource); sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); } catch (IOException e) { e.printStackTrace(); } } //使用MyBatis第二步：通过sqlsessionfactory获取sqlsession对象： public static SqlSession getSqlSession() { return sqlSessionFactory.openSession(); } }
d.编写接口实现类：Mapper.xml，如果我们用传统的jdbc连接数据库的话，实现类是一个Java类，但是引用Mybatis框架后，实现类在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"> <mapper namespace="Dao.userDao"> <select id="getuserlist" resultType="entity.user">
select id,name,sex,age,location from mybatis.user </select> </mapper>
注意：上述提示过编写任何的xml 文件都不要加注释，不然会报错；且sql语句中不能使用 * 号，必须把所有字段都写出来，
其中namespace、resultType必须加包路径，不然返回值类型找不到
namespace：绑定接口userDao
id：表示执行userDao接口中getuserlist方法
resultType：返回到实体类user中
e.每一个Mapper.xml 必须在mybatis 核心配置文件中注册：
<?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?autoReconnect=true&failOverReadOnly=false&useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=UTC"/> <property name="username" value="root"/> <property name="password" value="root"/> <property name="poolMaximumActiveConnections" value="300000" /> <property name="poolMaximumIdleConnections" value="30" /> <property name="poolPingEnabled" value="true"/> <property name="poolPingQuery" value="select 1"/> <property name="poolPingConnectionsNotUsedFor" value="1800"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/userMapper.xml"/> </mappers> </configuration>
f. 编写测试代码：
import org.apache.ibatis.session.SqlSession; import org.junit.jupiter.api.Test; import com.MyBatisUtils; import java.util.List; public class userDaotest { @Test public void test() { try{ SqlSession sqlSession = MyBatisUtils.getSqlSession();//获取session会话 Dao.userDao userDao = sqlSession.getMapper(Dao.userDao.class);//拿到接口实现类，即userMapper.xml文件 List<entity.user> userList=userDao.getuserlist();//执行userMapper.xml里面的getuserlist()方法 for (entity.user user : userList) { System.out.println(user); }}catch(NullPointerException E){ E.printStackTrace(); System.out.println(E); } } }
g.在进行测试之前，我的两个配置文件分别放在src/main/resources、src/main/com目录下，由于maven的不会编译src文件下的xml文件，所以项目运行时无法在classes文件中找到编译后的xml文件，即会报无法找到资源异常。
需要在POM.xml文件中加入：
<build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.xml</include> </includes> <filtering>true</filtering> </resource> <resource> <directory>src/main/com</directory> <includes> <include>**/*.xml</include> </includes> <filtering>true</filtering> </resource> </resources> </build>
h.测试结果：
四、总结错误:
本次mybatis框架的第一次搭建，真的是费劲了九牛二虎之力，之前自己有搭建过，时间长忘记了，但是这次的错误真的让自己很崩溃~~~，因为错误真的太多了，具体有如下：
路径问题、xml文件无法编译导出问题、找不到实体类问题、空指针异常问题、数据库连接失败
(1)路径问题：找不到userMapper.xml
每一个Mapper.xml都需要在核心配置文件中进行注册，可能是核心配置文件中找不到Mapper.xml路径，路径是所在：包名.文件名，一般是从可编译文件夹的下一级路径开始填写文件的地址，只填写上一级路径会报错，我本次目录是main文件夹设置为可编译文件夹，即填写各个文件路径时候，都是从main文件夹下一级路径开始的。
(2)xml 文件无法编译导出问题
由于maven工程不会编译src文件下的xml文件，所以项目运行时无法在classes文件中找到编译后的xml文件，即会报无法找到Mapper.xml资源异常。
需要在POM.xml文件中加入：
(3)找不到实体类异常：找不到实体类的话主要是userMapper.xml 文件中的namespace=“ ”，resultType=“ ” ，接口路径和实体类路径没给对，
一般也是：namespace=“包名.接口名 ”，resultType=“包名.类名 ”
(4)空指针异常：创建sqlSessionFactory对象时，并没有具体的类型，如果加类型：空指针异常
不加类型：执行成功
(5)数据库连接异常：这也是让我最头疼的一个，什么设置时区、更改配置文件的：
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?autoReconnect=true&failOverReadOnly=false&useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=UTC"/>
也弄过、在数据库配置上设置，把数据库连接有效时间设置长一点，比如设置12小时或者24小时也搞了、Mysql也重启了，这些都弄了都还报错，最后是数据库连接驱动和mysql的版本不一致，才导致无法连接数据库，重新在POM.xml 文件中更改驱动版本号才能连接：
总结：生活的奔波让人头大，bug再次雪上加霜，这就是第一次搭建Mybatis，希望能慢慢学习进步吧，又是心累的一天！
以上是关于我的第一个MyBatis的主要内容，如果未能解决你的问题，请参考以下文章