前言:
小伙伴们,大家好,我是狂奔の蜗牛rz,当然你们可以叫我蜗牛君,我是一个学习Java半年多时间的小菜鸟,同时还有一个伟大的梦想,那就是有朝一日,成为一个优秀的Java架构师。
这个Mybatis基础学习系列是用来记录我学习Mybatis框架基础知识的全过程 (这个系列是参照B站狂神的Mybatis最新教程来写的,由于是之前整理的,但当时没有发布出来,所以有些地方可能有错误,希望大家能够及时指正!)
之后我将会尽量以一天一更的速度更新这个系列,还没有学习Mybatis3框架的小伙伴可以参照我的博客学习一下;当然学习过的小伙伴,也可以顺便跟我一起复习一下基础。 最后,希望能够和大家一同进步吧!加油吧!少年们!
今天我们来到了Mybatis基础学习的第二站:第一个Mybatis程序, 主要就是如何学习搭建环境和使用Mybatis框架。 废话不多说,让我们开始今天的学习内容吧。
3.第一个Mybatis程序
思路:搭建环境–>导入Mybatis–>编写代码–>测试
3.1 搭建环境
Create Database `MyBatis`;
Use `MyBatis`;
Create table `User`(
`id` int(10) 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,'周杰伦','zjl123456'),
(2,'方文山','fws123456'),
(3,'黄俊郎','hjl123456')
3.2 新建项目
1.新建一个普通的maven项目
2.删除src目录
3.导入maven依赖
<?xml version="1.0" encoding="UTF-8"?>
<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>5.1.47</version>
</dependency>
<!-- mybatis -->
<!-- https://mvnrepository.com/artifact/org.mybatis/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.12</version>
</dependency>
</dependencies>
<!-- 在build中配置resources,来防止我们资源导出失败的问题 -->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
</project>
3.3 创建一个模块
3.3.1 IDEA连接MySQL数据库步骤
1.添加数据库
2.测试连接
3.选择目标数据库
4.连接完成
5.数据库连接失败解决方案
测试连接过程中遇到了
解决方法:设置MySQL数据库的时区
1.连接mysql
mysql -u root -p
2.查看系统默认的时区
show variables like'%time_zone';
3.设置新的时区
set global time_zone = '+8:00';
4.查看修改后的时区
这里注意要退出命令窗口后重新进入才可以看到修改成功后的时区
show variables like'%time_zone';
3.3.2 编写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?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
<mappers>
<mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
</configuration>
3.3.3 编写mybatis工具类
// sqlSessionFactory --> sqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
// 静态方法体
static {
try {
// 使用mybatis第一步:获取SqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* 既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例
* SqlSession 提供了在数据库执行 SQL 命令所需的所有方法
*/
public static SqlSession getSqlSession() {
// SqlSession sqlSession = sqlSessionFactory.openSession();
// return sqlSession;
// 代码优化,作用与上面两句代码作用相同
return sqlSessionFactory.openSession();
}
}
3.4 编写代码
3.4.1 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;
}
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 + '\'' +
'}';
}
}
3.4.2 Mapper接口
public interface UserMapper {
// 返回一个User,获取所有的用户
List<User> getUserList();
}
3.4.3 Mapper配置文件
1. UserDao实现类
- 之前使用的UserDao实现类
public class UserDaoImpl implements UserDao {
public List<User> getUserList() {
// 执行SQL,连接数据库
String sql = "select * from mybatis.user";
// 结果集ResultSet
return null;
}
}
2. Mapper配置文件
- 由原来的UserDaoImpl转变为一个Mapper配置文件
<?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">
<!-- namespace=绑定一个对应的Dao/Mapper接口 -->
<mapper namespace="com.kuang.dao.UserMapper">
<!--select查询语句:
这里的select标签其实即相当于Dao实现类里面的方法重写,去执行SQL,连接数据库
resultType:相当于结果,返回一个;resultMap:相当于集合,返回多个 -->
<!-- select的id属性,要和接口中定义的方法名相同 -->
<select id="getUserList" resultType="com.kuang.pojo.User">
select * from mybatis.user
</select>
</mapper>
3.5 代码测试
3.5.1 MapperRegistry
1. 遇到问题
Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.
2. 问题分析
MapperRegistry是什么?
核心配置文件里注册mappers
<!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
<mappers>
<mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
3.5.2 junit测试
1.使用getMapper()方法
- 使用getMapper方法来获取接口对象,不用考虑强制转换的问题
public class UserDaoTest {
@Test
public void test(){
// 第一步:获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
/**
* 建议使用try-catch-finally语句来捕获异常,
* 并且把关闭sqlSession写在finally语句块中,保证每次执行关闭
*/
try {
// 通过getMapper来获取UserMapper类(利用了反射机制)
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 执行userDao里的方法,返回List集里的User对象
List<User> userList = userMapper.getUserList();
// 遍历数组:可以使用userList.for快捷键打出for循环
for (User user : userList) {
System.out.println(user);
}
}catch(Exception e){
e.printStackTrace();
}finally {
// 关闭sqlSession
sqlSession.close();
}
}
}
2. 使用selectList()方法
- 使用特定方法的返回值去返回,不推荐使用
public class UserDaoTest {
@Test
public void test(){
// 第一步:获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
try {
List<User> userList= sqlSession.selectList("com.kuang.dao.UserDao.getUserList");
// List<User> userList1= sqlSession.selectOne("com.kuang.dao.UserDao.getUserList"); // 一个返回值
// List<User> userList2= sqlSession.selectMap("com.kuang.dao.UserDao.getUserList"); // 多个返回值
// 使用for循环遍历用户列表集合
for (User user : userList) {
System.out.println(user);
}
}catch(Exception e){
e.printStackTrace();
}finally {
// 关闭sqlSession
sqlSession.close();
}
}
}
3.6 遇到问题
1.配置文件没有注册
<!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
<mappers>
<mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
2.绑定接口错误
<!-- namespace=绑定一个对应的Dao/Mapper接口 -->
<mapper namespace="com.kuang.dao.UserDao">
3.方法名不对
<!--select的id属性,要和接口中定义的方法名相同-->
<select id="getUserList" resultType="com.kuang.pojo.User">
select * from mybatis.user
</select>
4.返回类型不对
<!-- resultType:相当于结果,返回一个;resultMap:相当于集合,返回多个 -->
<select id="getUserList" resultType="com.kuang.pojo.User">
select * from mybatis.user
</select>
5.Maven导出资源资源
<!-- 在build中配置resources,来防止我们资源导出失败的问题 -->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<!-- 需要把filtering改为false -->
<filtering>false</filtering>
</resource>
</resources>
</build>
3.7 知识扩充
1.SqlSessionFactoryBuilder
- SqlSessionFactoryBuilder–>SqlSessionFactory–>SqlSession
2.SqlSession
好了,今天的有关第一个Mybatis程序的学习就到此结束啦,欢迎小伙伴们积极学习和讨论,喜欢的可以给蜗牛君点个关注,顺便来个一键三连,我们下期见,拜拜啦!
参考视频链接:https://www.bilibili.com/video/BV1NE411Q7Nx?spm_id_from=333.999.0.0(【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂)