1、简介
1.1、什么是Mybatis
- MyBatis 是一款优秀的持久层框架
- 它支持自定义 SQL、存储过程以及高级映射。
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
- MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了[google code](https://baike.baidu.com/item/google code/2346604),并且改名为MyBatis 。2013年11月迁移到Github。
通过mavn仓库获取到mybatis
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
1.2、持久化
数据的持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存:断电数据就消失
- 数据库(jdbc),io文件的持久化
为什么需要持久化
- 有一些对象需要进行永久化的存储,需要进行持久化
1.3、持久层
Dao层
- 完成持久化工作的代码块
- 层界十分的明显
1.4、为什么需要Mybatis?
- 方便
- 传统的jdbc代码十分的复杂,需要简化、框架、自动化
- 优点
- 简单易学:本身就很小且简单。没有任何第三方依赖,最简单安装只要两个jar文件+配置几个sql映射文件易于学习,易于使用,通过文档和源代码,可以比较完全的掌握它的设计思路和实现。
- 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- 解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql。
最重要的一点:使用的十分的广泛
2、第一个Mybatis程序
思路: 搭建编写环境–>导入Mybatis–>编写代码–>测试
2.1搭建环境
Create Table
CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8
INSERT INTO `user` (`id`,`name`,`pwd`) VALUES
(1,"zhangsan","123"),
(2,"lisi","123"),
(3,"wangwu","123");
新建一个空的项目
-
创建模块的时候,选择使用maven项目
-
删除原来项目的src,然后将项目当做父工程进行使用
-
导入maven依赖pom文件
<dependencies> <!-- mysql的驱动--> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.20</version> </dependency> <!-- mybatis的驱动--> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.6</version> </dependency> <!-- junit的驱动--> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> <scope>test</scope> </dependency> </dependencies> <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> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>
2.2、创建 maven模块项目
- 编写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">
<!--mybatis的核心配置文件-->
<configuration>
<!-- environments 代表可以配置多个环境,通过 环境的id进行选择-->
<environments default="development">
<!-- 第一个环境-->
<environment id="development2">
<!-- 配置事务的管理-->
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
<!-- 第二个环境-->
<environment id="development2">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
</configuration>
- 编写mybatis的工具类
package com.hema.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;
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//1.通过加载配置文件获取到一个输入流
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
//2.通过输入流,得到工厂对象
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//通过静态代码获取到Sqlsession的实例,因为sqlSession中包含了面向数据库执行sql命令所需要的所有的方法
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}
2.3、编写代码
- 实体类
package com.hema.pojo;
//实体类
public class User {
private int id;
private String name;
private String 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;
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public User() {
}
}
- Dao接口
- 接口实现类由原来的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">
<!--绑定一个Mapper接口/dao接口-->
<mapper namespace="com.hema.dao.UserDao">
<select id="getUserList" resultType="com.hema.pojo.User">
select * from mybatis.user
</select>
</mapper>
2.4测试
出现的问题:
Could not find resource com/hema/resources/mybatis-config.xml
原因:Maven是约定大于配置的,可能会遇到写的配置文件无法生效或者被导出的问题,因此需要加入配置文件的过滤 ,在build中配置resources,防止导出失败
Junit单元测试
import java.util.List;
public class UserTest {
@Test
public void test() {
//1.获取到sqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//执行Sql,通过
UserDao mapper = sqlSession.getMapper(UserDao.class);
List<User> list = mapper.getUserList();
for (User user : list) {
System.out.println(user);
}
//关闭Sqlsession
sqlSession.close();
}
}
3、CURD
1、namespace
namespace中的报名要和Dao/mapper的接口保持一致!
2、select
选择,查询语句:
- id: 对应的是接口中的函数的方法名
- resultType: 对应的是sql语句中执行返回值的类型
- parameterType: 传入参数的数据类型;条件语句中书写的是**#{接口中书写的参数的名字}**进行查询
3、 insert
- 编写接口
// 新增一个用户
int Insert(User user);
- 编写对应mapper中的sql
<!-- 对象中的属性可以直接取出来-->
<insert id="Insert" parameterType="pojo.User">
insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>
- 测试
4、update
<update id="update" parameterType="pojo.User">
update user set pwd =#{pwd},name = #{name} where id = #{id} ;
</update>
5、delete
<delete id="delete" parameterType="int" >
delete from user where id = #{id}
</delete>
要注意的点:
- 增删改需要手动的提交事务,否则不生效的
容易出错的内容:
- 标签不要出错
- mybatis核心配置文件的mapper标签中resource 要使用路径,不能使用.的形式
6、万能Map
假设,我们试题类,或者数据库中的表的字段过多的话,我们要考虑使用Map集合,就是把实体类封装到map集合中,好处是key可以随意的定制,不需要跟实体类保持一致
int addUser(Map<String, Object> map);
<insert id="addUser" parameterType="map">
insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>
@Test
public void insert2() {
//在mysql中,增删改,需要提交事务才能完成
SqlSession sqlsession = MybatisUtil.getSqlsession();
UserMapper mapper = sqlsession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<>();
map.put("id",5);
map.put("name","xiaoxiong");
map.put("pwd","156646");
int i = mapper.addUser(map);
if (i>0) {
System.out.println("插入成功");
}
sqlsession.commit();
sqlsession.close();
}
7、模糊查询
- 在java代码执行的时候,传递通配符"%li%"
List<user> list = mapper.getUserlike("%li%")
- 在sql拼接种使用通配符!
select *from mybatis.user where name like "%"#{value}"%"
4、配置文件解析
1、核心配置文件
- mybatis-config.cml
- MaBatis的配置文件包含了会深深影响Mybatis 行为的设置和属性信息
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
2、环境变量
MyBatis可以配置成适应多种环境
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
Mybatis默认的事务管理器是jdbc,连接池:pooled
3、属性(properties)
我们可以使用properties属性来实现引用配置文件,这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置
- 编写一个db.properties文件
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=GMT%2B8
username=root
password=123456
- 在核心配置文件中引入
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-777vAiYt-1626016719233)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711081006831.png)]
<configuration>
<!-- 引入外部配置文件,优先使用properties文件中配置的属性-->
<properties resource="db.properties"/>
<!-- <properties resource="config.properties">
<property name="username" value="dev_user"/>
<property name="password" value="F2Fa3!33TYyg"/>
</properties> -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="dao/UserMapper.xml"/>
</mappers>
</configuration>
- 可以直接引用外部的文件,
- 可以在xml中增加一些属性配置
- 如果两个文件有同一个字段,优先使用外部的配置文件的
4、别名
- 类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写。
<typeAliases>
//适用于实体类十分少的情况
<typeAlias alias="Author" type="domain.blog.Author"/>
<typeAlias alias="Blog" type="domain.blog.Blog"/>
<typeAlias alias="Comment" type="domain.blog.Comment"/>
<typeAlias alias="Post" type="domain.blog.Post"/>
<typeAlias alias="Section" type="domain.blog.Section"/>
<typeAlias alias="Tag" type="domain.blog.Tag"/>
</typeAliases>
- 也可以指定一个包名,Mybatis会在包名下面搜索需要的javaBean,扫描实体类的包,他的默认的别名就是这个类的类名,首字母小写
<typeAliases>
<package name="domain.blog"/>
</typeAliases>
- 还可以使用的是注解的方式,在实体类的上方使用@Alias(“别名”)为实体类起别名
@Alias("author")
public class Author {
...
}
5、设置
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-17KHReVM-1626016719236)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711102137050.png)]
6、映射器
注册绑定我们的mapper文件,这些配置会告诉 MyBatis 去哪里找映射文件,剩下的细节就应该是每个 SQL 映射文件了
方式一 使用扫描包进行:
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
方式二 通过class文件进行绑定注册
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
注意点:
- 接口和他的Mapper配置文件必须同名
- 接口和他的Mapper配置文件必须要放在同一个包下面
方式三
<mappers>
<package name="dao"/>
</mappers>
注意点:
- 接口和他的Mapper配置文件必须同名
- 接口和他的Mapper配置文件必须要放在同一个包下面
7、生命周期和作用域
不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder
- 一旦创建SqlSessionFactory,就不再需要它了
- SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)
SqlSessionFactory
- 跟数据库连接池的作用差不多
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 因此 SqlSessionFactory 的最佳作用域是应用作用域,最简单的就是使用单例模式或者静态单例模式。
SqlSession
- 连接到连接池的一个请求
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 用完就需要赶紧关闭,否则资源被占用
5、解决实体类属性名和数据库中表的字段名不一致的问题
1、问题
数据库表中的字段
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-lUN7DJJj-1626016719241)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711111541548.png)]
新建一个项目,实体类属性跟数据库中字段的名字不一致
public class User {
private int id;
private String name;
private String password;
}
测试出现问题:password为空
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-zLgnc2ny-1626016719243)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711112020399.png)]
原因:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1LBYzo1C-1626016719244)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711112102101.png)]
2、解决方法:
- 起别名:
<select id="getUser" resultType="user" >
//改sql起别名
select id,name,pwd as password from user;
</select>
- resultMap:ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。
6.日志
如果数据库操作出现了异常,我们需要进行排错,日志是最好的助手
日志工厂:实现日志的输出
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qu51kS9k-1626016719247)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711134900088.png)]
- SLF4J
- LOG4J
- LOG4J2
- JDK_LOGGING
- COMMONS_LOGGING
- STDOUT_LOGGING 标准的日志输出
- NO_LOGGING
在mybatis的核心文件中配置日志
<!-- 引入外部配置文件-->
<properties resource="db.properties"/>
<settings>
//输出标准的日志格式
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
日志输出的内容:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4YTbFBSv-1626016719250)(C:\Users\17451\AppData\Roaming\Typora\typora-user-images\image-20210711140154783.png)]
6.2、log4j
什么是log4j?
- Log4j是Apache的一个开源项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件
- 我们可以控制每一条日志的输出格式
- 我们还可以控制日志输出的目的地
- 我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。
- 先导入log4j的包
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
- log4jproperties
#将等级为DEBUG的日志信息输出到console和file这两个目的地,console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file
#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/yang.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
- 配置log4j为日志的实现
<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>
7、分页
主要是为了减少数据的处理量
1、使用limit进行分页
select *from user limit startIndex,pagesize;
-
接口:
//分页查询 List<User> getUserByLimit(Map<String,Integer> map);
-
Mapper.xml
<select id="getUserByLimit" parameterType="map" resultType="User" resultMap="userMap"> select * from user limit #{startpage},#{num} </select>
-
测试
@Test public void getSqlLimit() { SqlSession sqlsession = MybatisUtil.getSqlsession(); UserMapper mapper = sqlsession.getMapper(UserMapper.class); Map<String,Integer> map = new HashMap<>(); map.put("startpage",0); map.put("num",2); List<User> userByLimit = mapper.getUserByLimit(map); userByLimit.forEach(s-> System.out.println(s)); }
2、RowBounds分页
不在使用sql实现分页
-
接口
List<User> getRowBounds();
-
Mapper.xml
<select id="getRowBounds" resultMap="userMap" resultType="User"> select * from user </select>
-
测试
@Test public void getRowBounds() { SqlSession sqlsession = MybatisUtil.getSqlsession(); RowBounds rowBounds = new RowBounds(1,2); List<User> userList = sqlsession.selectList("dao.UserMapper.getRowBounds",0,rowBounds); userList.forEach(s-> System.out.println(s)); }
3.分页插件
导入maven坐标
<!-- https://mvnrepository.com/artifact/com.github.pagehelper/pagehelper -->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>5.2.1</version>
</dependency>
具体用法见官方文档:如何使用分页插件 (pagehelper.github.io)