1、Mybatis的简介和特性
2、环境配置及其注意事项
2.1、注意事项
本文示例,开发环境
IDE:idea 2019.2
构建工具:maven 3.8.6
MySQL版本:MySQL 8
MyBatis版本:MyBatis 3.5.7
MySQL不同版本的注意事项:
1、驱动类driver-class-name
MySQL 5版本使用jdbc5驱动,驱动类使用:com.mysql.jdbc.Driver
MySQL 8版本使用jdbc8驱动,驱动类使用:com.mysql.cj.jdbc.Driver
2 连接地址url
MySQL 5版本的url: jdbc:mysql://localhost:3306/ssm
MySQL 8版本的url:jdbc:mysql://localhost:3306/ssm?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=true
ps 这里有个小插曲:最近在折腾虚拟机的时候,关闭了很多服务(守护进程)的开机自启动,我本地的mysql80服务也被禁用了,
于是我用客户端工具连接的时候,报了一个 2003 连接不上的错误。这里打开windows服务管理,把mysql80服务启动就好了
2.2 Mybaits 环境搭建步骤
1)创建Maven工程
2)引入依赖文件
参考连接: https://mvnrepository.com/
pom中引入mybatis依赖
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
引入mysql 连接驱动 (根据自己的数据库版本,选择合适的驱动版本)
这里注意一下,新的驱动依赖 maven gav坐标内容与旧版本的有所变动,别写错了
<!-- https://mvnrepository.com/artifact/com.mysql/mysql-connector-j -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.0.31</version>
</dependency>
3)创建mybatis 核心配置文件
关于配置文件 ,mapper.xml (映射文件)的书写 具体 我们可以参考官网,还支持中文翻译:
mybatis – MyBatis 3 | 简介
习惯上命名为mybatis-config.xml,这个文件名仅仅只是建议,并非强制要求。将来整合Spring 之后,这个配置文件可以省略,所以大家操作时可以直接复制、粘贴。 核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息 核心配置文件存放的位置是src/main/resources目录下。
<?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>
<!--设置连接数据库的环境-->
<!-- 可以有多个 environment-->
<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://localhost:3306/ssm?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=true"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<package name="mapper/UserMapper.xml"/>
</mappers>
</configuration>
4)创建mapper接口
我们在用原生的JDBC 实现数据库与业务代码交互的时候,用到一个ORM 设计理念,即对象关系映射 。
对象:Java的实体类对象
关系:关系型数据库
映射:二者之间的对应关系
ORM的核心 是为了解决 软件设计是面向对象的,而关系型数据库是一个数学概念,ORM可以将两者原本不匹配的思想进行中继,统一。
简单来说,就是将关系数据库的表,转换成开发过程中,更容易理解、处理的对象,(有时我们也将表中查出的信息,封装成一个对象,或JSON)
mybatis也是ORM框架,它的工作机制也是依赖于此。
MyBatis中的mapper接口相当于以前的dao。但是区别在于,mapper仅仅是接口,我们不需要 提供实现类。
public interface UserMapper {
/**
* 添加用户信息
*/
int insertUser();
}
5)创建映射文件
1、映射文件的命名规则: 表所对应的实体类的类名+Mapper.xml
例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
因此一个映射文件对应一个实体类,对应一张表的操作
MyBatis映射文件用于编写SQL,访问以及操作表中的数据 MyBatis映射文件存放的位置是src/main/resources/mappers目录下
2、 MyBatis中可以面向接口操作数据,要保证两个一致:
a、mapper接口的全类名和映射文件的命名空间(namespace)保持一致
b、mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
具体如下图:
<?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="com.alex.mybatis.mapper.UserMapper">
<insert id="insertUser">
insert into t_user values(null,'admin','123456',23,'男','123456@qq.com')
</insert>
</mapper>
6)通过Junit 进行测试
在官网的入门案例中,我们能看到如下描述:mybatis – MyBatis 3 | 入门
从 XML 中构建 SqlSessionFactory
每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。从 XML 文件中构建 SqlSessionFactory 的实例非常简单,建议使用类路径下的资源文件进行配置。 但也可以使用任意的输入流(InputStream)实例,比如用文件路径字符串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类,它包含一些实用方法,使得从类路径或其它位置加载资源文件更加容易。
我们照葫芦画瓢:
import com.alex.mybatis.mapper.UserMapper;
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.Test;
import java.io.IOException;
import java.io.InputStream;
/**
* @Title:
* @Description: TODO
* @author: Alex
* @Version:
* @date 2023-01-24-22:24
*/
public class MbTest {
@Test
public void test1(){
InputStream is=null;
try {
//读取MyBatis的核心配置文件
is = Resources.getResourceAsStream("mybatis-config.xml"); //mybatis-config.xml
//创建SqlSessionFactoryBuilder对象
//通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory,生产SqlSession对象
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
//创建SqlSession对象,此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
//SqlSession sqlSession = sqlSessionFactory.openSession();
//创建SqlSession对象,此时通过SqlSession对象所操作的sql都会自动提交
SqlSession sqlSession = sessionFactory.openSession(true);
//通过代理模式创建UserMapper接口的代理实现类对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//调用UserMapper接口中的方法,就可以根据UserMapper的全类名匹配元素文件,通过调用的方法名匹配
// 映射文件中的SQL标签,并执行标签中的SQL语句
int result = mapper.insertUser();
//sqlSession.commit();
System.out.println("数据库中 "+result+" 行 改动");
} catch (IOException e) {
throw new RuntimeException(e);
}finally {
//不用执行 sqlsession 关闭,
try {
if(is!=null){
is.close();
}
} catch (IOException e) {
throw new RuntimeException(e);
}
}
}
}
关于sqlSession关闭的情况 请看这篇文章:http://t.csdn.cn/RmWot
SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的 会话) SqlSessionFactory:是“生产”SqlSession的“工厂”。
工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象。
注意事项:
1)pom文件打包方式 不能写成 pom
<packaging>jar</packaging>原因:maven打包方式有三种,pom,jar和war。当选择了打包方式为pom时,意味着该工程是个聚合工程,而这个工程也就是个父工程,只用来做依赖版本管理和模块管理,并不会涉及到源码,所以maven不会将resources下的文件编译到classes路径下。所以将打包方式换成jar,才能编译成功!
2)mybatis-config.xml配置文件 要注意mapper映射的书写,注意引入单个和引入一个包的标签是不一样的。
3)Sql 语法一定要写对
打印结果:
查看数据库变化:
代码地址: GitHub - Chai-Feng/git-demo01