文章目录
1.Mybatis框架
1.1 Mybatis框架介绍
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github。
iBATIS一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects(DAOs)。
MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录,利用ORM思想实现了数据库持久化操作。
虽然JDBC是操作数据库性能最好的方式,但因为其操作的复杂性,所以在实际项目开发中并不使用JDBC,MyBatis的性能,便捷性做了很好的均衡,所以大多数项目中都使用MyBatis进行数据库的操作。
1.2 ORM思想
对象关系映射(英语:Object Relational Mapping,简称ORM,或O/RM,或O/R mapping),是一种程序设计技术,用于实现面向对象编程语言里不同类型系统的数据之间的转换。从效果上说,它其实是创建了一个可在编程语言里使用的“虚拟对象数据库”。如今已有很多免费和付费的ORM产品,而有些程序员更倾向于创建自己的ORM工具。
关系映射:
- 对象映射:映射表
- 对象中有属性:表中有字段
总结: 以对象的方式操作数据库.
举例说明:
- JDBC 方式完成入库操作
- insert into xxxx(字段名称) values (字段的值…)
- select * from xxxxx 结果集需要自己手动封装为对象 (繁琐)
- ORM方式实现入库
- userDao.insert(对象)
- ORM方式的查询
- List userList = userDao.selectList(对象);
1.3 数据库数据准备
在项目中找到jt.sql文件:
在SQLyog目录结构空白处单机鼠标右键,选择从外部导入:
选中文件后,点击执行,完成,然后点击刷新看是否成功导入:
2.入门案例
2.1 创建项目
首先,我们在当前工程下,新建一个Module:
在新项目中添加Lombok,MyBatis,JDBC的jar包:
<!--引入插件lombok 自动的set/get/构造方法插件 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
<!--mybatis依赖包-->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
<!--jdbc依赖包-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
2.2 创建相关物料
2.2.1 创建pojo类
package com.study.pojo;
import lombok.Data;
import lombok.experimental.Accessors;
import java.io.Serializable;
@Data
@Accessors(chain = true)
public class User implements Serializable {
private Integer id;
private String name;
private Integer age;
private String sex;
}
2.2.2 编辑mybatis-config.xml文件
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>
<!--环境配置标签-->
<!--MyBatis支持多个数据源的配置,default=“默认链接数据源”-->
<environments default="development">
<!--编辑开发环境-->
<environment id="development">
<!--MyBatis使用JDBC的方式控制数据库事物-->
<transactionManager type="JDBC"/>
<!--type="POOLED" 创建一个数据源吗链接池,每次从池中获取链接-->
<dataSource type="POOLED">
<!--版本信息:
如果数据源采用5.x的版本, value="com.mysql.jdbc.Driver"
如果数据源采用8.x的版本, value="com.mysql.cj.jdbc.Driver"
-->
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<!--数据库链接地址及用户名,密码-->
<property name="url" value="jdbc:mysql://127.0.0.1:3306/jt?serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=utf8&autoReconnect=true&allowMultiQueries=true"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!--Mybatis加载Mapper映射文件-->
<mappers>
<mapper resource="mybatis/mappers/UserMapper.xml"/>
</mappers>
</configuration>
我们可以在idea中查看当前数据库依赖版本:
2.2.3 编辑UserMapper.xml文件
MyBatis根据接口的规范,需要在自己指定的映射文件中添加sql的语句,从而实现数据库的操作,并且一个接口对应一个映射文件,接下来我们编辑此前创建的映射文件:
<?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是mybaits映射文件的唯一标识,与接口对应-->
<mapper namespace="com.study.mapper.UserMapper">
<!--id 表示接口方法
resultType 返回值结果类型
-->
<select id="findAll" resultType="com.study.pojo.User">
select * from demo_user
</select>
</mapper>
2.2.4 编辑测试接口
此时我们开始接触面向接口编程,因为持久层直接调用处理业务类耦合度太高,所以引入接口的概念,持久层调用接口,实现类实现接口,进行耦合度的分离。
2.2.5 编辑Mybatis测试类
package com.study;
import com.study.mapper.UserMapper;
import com.study.pojo.User;
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 org.junit.jupiter.api.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
class SpringbootDemo2ApplicationTests {
/**
* 核心问题: SqlSession 理解为Mybatis操作数据的连接
* 1. 通过 SqlSessionFactoryBuilder 构建SqlSessionFactory
*/
@Test
public void testMyBatis() throws IOException {
//1.定义核心配置文件的路径
String resource = "mybatis/mybatis-config.xml";
//2.通过工具API读取资源文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//3.构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory =
new SqlSessionFactoryBuilder().build(inputStream);
//4.获取SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
//5.获取Mapper的接口对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
//6.调用接口方法 获取返回值数据
List<User> userList = userMapper.findAll();
System.out.println(userList);
//7.连接用完记得关闭
sqlSession.close();
inputStream.close();
}
}
2.2.6 运行查看测试结果
我们当前面向接口进行测试,所以不能借助spring框架,所以要去掉测试类上的@SpringBootTest
注解,单独运行我们的测试方法,查看测试结果:
2.3 常见错误总结
2.3.1 resultType错误
resultType错误,在输入时,一般会自动提示后续路径,建议根据提示输入。
2.3.2 namespace 命名错误
检查UserMapper.xml文件中的namespace 命名空间即可。
2.3.3 mybaits关联mapper映射文件异常
说明: 检查mybatis.config.xml文件中的resource路径
3.简化测试操作
目前我们在测试时,测试类的代码还是十分的繁琐,其获取SqlSession以及关闭连接完全可以封装起来,接下来我们使用AOP的思想,将其封装,我们在测试类中完成下列代码进行简化测试操作:
package com.study;
import com.study.mapper.UserMapper;
import com.study.pojo.User;
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 org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
class SpringbootDemo2ApplicationTests {
/**
* 设计思路:
* 1.要求每次执行测试方法时 都先生成一个SqlSessionFactory
* 2.从sqlSessionFactory中获取sqlSession
* 3.完成业务操作
* 注解说明:
* @BeforeEach 当每次执行@Test注解方法时,都会先执行该方法.
*/
private SqlSessionFactory sqlSessionFactory;
@BeforeEach
public void init() throws IOException {
String resource = "mybatis/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
}
@Test
public void testFind2(){
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = userMapper.findAll();
System.out.println(userList);
sqlSession.close();
}
/**
* 核心问题: SqlSession 理解为Mybatis操作数据的连接
* 1. 通过 SqlSessionFactoryBuilder 构建SqlSessionFactory
*/
@Test
public void testMyBatis() throws IOException {
//1.定义核心配置文件的路径
String resource = "mybatis/mybatis-config.xml";
//2.通过工具API读取资源文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//3.构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory =
new SqlSessionFactoryBuilder().build(inputStream);
//4.获取SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
//5.获取Mapper的接口对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
//6.调用接口方法 获取返回值数据
List<User> userList = userMapper.findAll();
System.out.println(userList);
//7.连接用完记得关闭
sqlSession.close();
inputStream.close();
}
}
我们运行testFind2()方法,查看执行结果: