基于白嫖:【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂
目录
1 简介
1.1 什么是mybatis
官网:mybatis
- MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
1.2 持久层
数据持久化就是将程序的数据在持久状态和瞬时状态转化的过程;
持久层就是完成持久化的代码块;
2 第一个MyBatis程序
2.1 建立MySQL数据库表
因为mybatis是操作数据库的,所以首先要有一个可以操作的数据库,去建立一个可以访问的数据库表,我以鸢尾花数据集为例子,建立了一个表存储了150条数据;
+-------------+---------------+--------------+---------------+--------------+---------+
| dataIndex | sepalLength | sepalWidth | petalLength | petalWidth | label |
|-------------+---------------+--------------+---------------+--------------+---------|
| 1 | 5.1 | 3.5 | 1.4 | 0.2 | setosa |
| 2 | 4.9 | 3 | 1.4 | 0.2 | setosa |
| 3 | 4.7 | 3.2 | 1.3 | 0.2 | setosa |
| 4 | 4.6 | 3.1 | 1.5 | 0.2 | setosa |
| 5 | 5 | 3.6 | 1.4 | 0.2 | setosa |
+-------------+---------------+--------------+---------------+--------------+---------+
表列的数据类型和相关属性;
+-------------+-----------------------------------------+--------+-------+-----------+----------------+
| Field | Type | Null | Key | Default | Extra |
|-------------+-----------------------------------------+--------+-------+-----------+----------------|
| dataIndex | tinyint(3) unsigned | NO | PRI | <null> | auto_increment |
| sepalLength | float(2,1) | YES | | <null> | |
| sepalWidth | float(2,1) | YES | | <null> | |
| petalLength | float(2,1) | YES | | <null> | |
| petalWidth | float(2,1) | YES | | <null> | |
| label | enum('setosa','versicolor','virginica') | YES | | <null> | |
+-------------+-----------------------------------------+--------+-------+-----------+----------------+
2.2 使用maven构建mybatis父项目
考虑到可能使用多个mybatis项目,建议把一个mybatis初始项目做成父项目,之后直接新建module就可以;
父项目的pom.xml文件
<?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>xyz.cqulwj</groupId>
<artifactId>mybatis</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
<module>demo01</module>
</modules>
<!--导入依赖-->
<dependencies>
<!--mysql-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
<!--mybatis-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</version>
</dependency>
<!--juint-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>
<!--把资源目录和代码目录下的配置文件properties和xml打包时都打包-->
<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>
</project>
这里面导入了mysql、mybatis、junit依赖,还在build属性中加入了打包时把资源目录和源代码目录及其子目录下的.xml
文件和.properties
文件也打包;
2.3 建立子项目
子项目是一个具体工程或者例子,在mybatis文件目录下建立一个Demo01之后的工程目录,下面对各个文件和目录做解析;
mybatis/
├── demo01
│ ├── demo01.iml
│ ├── pom.xml
│ └── src
│ ├── main
│ │ ├── java
│ │ │ ├── dao
│ │ │ │ ├── IrisMapper.java
│ │ │ │ └── IrisMapper.xml
│ │ │ ├── pojo
│ │ │ │ └── Iris.java
│ │ │ └── utils
│ │ │ └── MybatisUtils.java
│ │ └── resources
│ │ └── mybatis-config.xml
│ └── test
│ └── java
│ └── dao
│ └── IrisDaoTest.java
├── mybatis.iml
└── pom.xml
2.4 子项目的pom文件
<?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">
<!--父项目就是mybatis的mysql、mybatis、junit项目-->
<parent>
<artifactId>mybatis</artifactId>
<groupId>xyz.cqulwj</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>demo01</artifactId>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<source>7</source>
<target>7</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
2.5 配置mybatis-config.xml文件
在main/resources目录下配置mybatis-config.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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://127.0.0.1/datasets?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--每一个mapper.xml都需要在mybatis核心配置文件中注册-->
<mappers>
<mapper resource="dao/IrisMapper.xml"/>
</mappers>
</configuration>
上面的事务类型、驱动、url、用户名和密码都是根据自己的mysql数据库来的,不同的需要更改;
2.6 编写一个MybatisUtils类
一般项目会建立一个utils包,用来存放一些工具包,其中MybatisUtils类就是用来获得SqlSession对象的;
package 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 MybatisUtils(){};
// SqlSessionFactory对象
private static SqlSessionFactory sqlSessionFactory;
// 静态代码块(恶汉式)
static {
try {
//获得SqlSessionFactory对象(获得SqlSession工厂)
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
// 获得sqlSession实例
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
通过一个资源配置文件mybatis-config.xml
,获得一个输入流,利用SqlSessionFactoryBuilder根据输入流建立一个sqlSessionFactory
的工厂对象,工厂负责产出SqlSession
实例。建立工厂用到建造者模式,工厂产出用了工厂模式,建造工厂(一个就够)用了单例模式。
2.7 实体类Iris
一般会在pojo(Plain Ordinary Java Object)包下建立一个个的实体,比如我这边就需要建立鸢尾花的实体,实体和数据库表是一一对应的,属性名和数据类型是匹配的;
package pojo;
/*
+-------------+-----------------------------------------+--------+-------+-----------+----------------+
| Field | Type | Null | Key | Default | Extra |
|-------------+-----------------------------------------+--------+-------+-----------+----------------|
| dataIndex | tinyint(3) unsigned | NO | PRI | <null> | auto_increment |
| sepalLength | float(2,1) | YES | | <null> | |
| sepalWidth | float(2,1) | YES | | <null> | |
| petalLength | float(2,1) | YES | | <null> | |
| petalWidth | float(2,1) | YES | | <null> | |
| label | enum('setosa','versicolor','virginica') | YES | | <null> | |
+-------------+-----------------------------------------+--------+-------+-----------+----------------+
*/
public class Iris {
private int dataIndex;
private double sepalLength;
private double sepalWidth;
private double petalLength;
private double petalWidth;
private String label;
public int getDataIndex() {
return dataIndex;
}
public void setDataIndex(int dataIndex) {
this.dataIndex = dataIndex;
}
public double getSepalLength() {
return sepalLength;
}
public void setSepalLength(double sepalLength) {
this.sepalLength = sepalLength;
}
public double getSepalWidth() {
return sepalWidth;
}
public void setSepalWidth(double sepalWidth) {
this.sepalWidth = sepalWidth;
}
public double getPetalLength() {
return petalLength;
}
public void setPetalLength(double petalLength) {
this.petalLength = petalLength;
}
public double getPetalWidth() {
return petalWidth;
}
public void setPetalWidth(double petalWidth) {
this.petalWidth = petalWidth;
}
public String getLabel() {
return label;
}
public void setLabel(String label) {
this.label = label;
}
@Override
public String toString() {
return "Iris{" +
"dataIndex=" + dataIndex +
", sepalLength=" + sepalLength +
", sepalWidth=" + sepalWidth +
", petalLength=" + petalLength +
", petalWidth=" + petalWidth +
", label='" + label + '\'' +
'}';
}
}
2.8 接口和接口配置文件
在dao(Data Access Object)包下面新建访问的映射接口和映射配置文件;
2.8.1 接口
package dao;
import pojo.Iris;
import java.util.List;
public interface IrisMapper {
List<Iris> getIrisList();//获得鸢尾花的实例列表
}
2.8.2 映射配置文件
<?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和接口匹配-->
<mapper namespace="dao.IrisMapper">
<select id="getIrisList" resultType="pojo.Iris">
select * from datasets.iris;
</select>
</mapper>
namespace
是java接口,id
接口里面的接口方法,resultType
是结果返回的类型是一个pojo包下的实体;
2.8.3 配置文件在mybatis-config.xml注册
映射配置文件需要在mybatis-config.xml配置文件中注册,即:
<!--每一个mapper.xml都需要在mybatis核心配置文件中注册-->
<mappers>
<mapper resource="dao/IrisMapper.xml"/>
</mappers>
注意:注册是/
分割路径,不是.
分割路径;
2.9 测试
package dao;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import pojo.Iris;
import utils.MybatisUtils;
import java.util.Iterator;
import java.util.List;
public class IrisDaoTest {
@Test
public void test() {
// 官方建议用try(){}来做sqlSession的操作
try (SqlSession sqlSession = MybatisUtils.getSqlSession()) {
//getmap方法
IrisMapper irisDao = sqlSession.getMapper(IrisMapper.class);
List<Iris> irisList = irisDao.getIrisList();
//迭代器
Iterator<Iris> iterator = irisList.iterator();
while (iterator.hasNext())
System.out.println(iterator.next());
}
}
}
官方建议的是用try(){}
来进行sqlSession的操作,这样能够保证它能够及时的关闭;
Iris{dataIndex=1, sepalLength=5.1, sepalWidth=3.5, petalLength=1.4, petalWidth=0.2, label='setosa'}
Iris{dataIndex=2, sepalLength=4.9, sepalWidth=3.0, petalLength=1.4, petalWidth=0.2, label='setosa'}
Iris{dataIndex=3, sepalLength=4.7, sepalWidth=3.2, petalLength=1.3, petalWidth=0.2, label='setosa'}
Iris{dataIndex=4, sepalLength=4.6, sepalWidth=3.1, petalLength=1.5, petalWidth=0.2, label='setosa'}
Iris{dataIndex=5, sepalLength=5.0, sepalWidth=3.6, petalLength=1.4, petalWidth=0.2, label='setosa'}
Iris{dataIndex=6, sepalLength=5.4, sepalWidth=3.9, petalLength=1.7, petalWidth=0.4, label='setosa'}
Iris{dataIndex=7, sepalLength=4.6, sepalWidth=3.4, petalLength=1.4, petalWidth=0.3, label='setosa'}
……
3 总结
看似比JDBC操作简单一些,但是很大一部分内容都是重复内容,之后的维护仅仅需要改很小的一部分,高内聚,低耦合
的思想一直贯穿于程序设计,把实体类和操作实体进行分离,只需要编写接口可以,能够最大程度的减少耦合,非常方便。