一、MyBatis
1、MyBatis简介
1.1、MyBatis特性:
- 1) MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
- 2) MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
- 3) MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录
- 4) MyBatis 是一个 半自动的ORM(Object Relation Mapping)框架
1.2、和其他持久化层技术对比
JDBC
- SQL 夹杂在Java代码中耦合度高,导致硬编码内伤
- 维护不易且实际开发需求中 SQL 有变化,频繁修改的情况多见
- 代码冗长,开发效率低
Hibernate 和 JPA
- 操作简便,开发效率高
- 程序中的长难复杂 SQL 需要绕过框架
- 内部自动生产的 SQL,不容易做特殊优化
- 基于全映射的全自动框架,大量字段的 POJO 进行部分映射时比较困难。
- 反射操作太多,导致数据库性能下降
MyBatis
- 轻量级,性能出色
- SQL 和 Java 编码分开,功能边界清晰。Java代码专注业务、SQL语句专注数据
- 开发效率稍逊于HIbernate,但是完全能够接受
2、搭建MyBatis
2.1、开发环境
IDE:idea 2019.2
构建工具:maven 3.5.4
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?serverTimezone=UTC
- 否则运行测试用例报告如下错误:
- java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more
2.2、创建maven工程
- 添加打包方式:jar
<packaging>jar</packaging>
- 引入依赖
<dependencies>
<!-- Mybatis核心 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- junit测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.49</version>
</dependency>
</dependencies>
- 配置好映射后建立对应数据库和表,再创建实体类和其达成映射关系
2.3、创建MyBatis的核心配置文件
- 核心配置文件主要用于配置连接数据库的环境以及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>
<!--设置连接数据库的环境-->
<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?
serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>
2.4、创建mapper接口
- MyBatis中的mapper接口相当于以前的dao。但是区别在于,mapper仅仅是接口,我们不需要 提供实现类。
public interface UserMapper {
//添加用户信息
int insertUser();
}
2.5、创建MyBatis的映射文件
相关概念:ORM(Object Relationship Mapping)对象关系映射。
- 对象:Java的实体类对象
- 关系:关系型数据库
- 映射:二者之间的对应关系
Java概念 | 数据库概念 |
---|---|
类 | 表 |
属性 | 字段/列 |
对象 | 记录/行 |
- 映射文件的命名规则:
- 表所对应的实体类的类名+Mapper.xml
- 例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
- 因此一个映射文件对应一个实体类,对应一张表的操作
- MyBatis映射文件用于编写SQL,访问以及操作表中的数据
- MyBatis映射文件存放的位置是src/main/resources/mappers目录下
- MyBatis中可以面向接口操作数据,要保证两个一致:
- mapper接口的全类名和映射文件的命名空间(namespace)保持一致
- 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.xujicheng.mybatis.mapper.UserMapper">
<!--int insertUser();-->
<insert id="insertUser">
INSERT INTO t_user VALUES(null,'admin','123456','23','女','123456@qq.com')
</insert>
</mapper>
2.6、通过junit测试功能
public class MyBatisTest {
@Test
public void testInsert() throws IOException {
//获取核心配置文件的输入流
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
//获取sqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//获取sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = sqlSessionFactory.openSession();
//由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//然后就可以调用mapper接口中的方法,实现添加用户信息的功能
int result = mapper.insertUser();
System.out.println("结果:" + result);
//提交事务
sqlSession.commit();
//关闭sqlSession
sqlSession.close();
}
}
- SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的 会话)
- SqlSessionFactory:是“生产”SqlSession的“工厂”。
- 工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象。
2.7、加入log4j日志功能
- 1、加入依赖
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
- 2、加入log4j的配置文件
- log4j的配置文件名为log4j.xml,存放的位置是src/main/resources目录下
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Encoding" value="UTF-8" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS}
%m (%F:%L) \n" />
</layout>
</appender>
<logger name="java.sql">
<level value="debug" />
</logger>
<logger name="org.apache.ibatis">
<level value="info" />
</logger>
<root>
<level value="debug" />
<appender-ref ref="STDOUT" />
</root>
</log4j:configuration>
- 日志的级别
- FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)
- 从左到右打印的内容越来越详细
3、核心配置文件详解
3.1、核心配置文件中的标签必须按照固定的顺序:
properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,refl
ectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?
3.2、properties标签
- 引入properties文件,此后就可以在当前文件中使用${key}的方式来访问value
- properties文件的配置
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssm?useSSL=false
jdbc.username=root
jdbc.password=123456
<!--引入properties文件,此后就可以在当前文件中使用${key}的方式来访问value-->
<properties resource="jdbc.properties"/>
3.3、typeAliases标签
<!--
typeAliases:设置类型别名,为某个具体的类型设置一个别名
在Mybatis的范围中,就可以使用别名表示一个具体的类型
-->
<typeAliases>
<!--
type:设置需要起别名的类型
alias:设置某个类型的别名
-->
<!--<typeAlias type="com.zylai.mybatis.pojo.User" alias="abc"/>-->
<!--如果不设置alias属性,那么默认的别名就是类名且不区分大小写-->
<!--<typeAlias type="com.zylai.mybatis.pojo.User"/>-->
<!--通过包来设置类型别名,指定包下所有的类型将全部拥有默认的别名,即类名且不区分大小写-->
<package name="com.zylai.mybatis.pojo"/>
</typeAliases>
3.4 environment标签
<!-- 配置连接数据库的环境-->
<!--
environments:配置连接数据库的环境
属性:
default:指定默认使用的环境,比如选择开发和测试
-->
<environments default="development">
<!-- environment:设置一个具体的连接数据库的环境
属性:
id:设置环境的唯一标识,不能重复
-->
<environment id="development">
<!--
transactionManager:设置事务管理器
属性:
type:设置事务管理的方式。JDBC或MANAGED
JDBC:表示使用JDBC中原生的事务管理方式
MANAGED: 被管理,例如Spring
-->
<transactionManager type="JDBC"/>
<!--
dataSource:设置数据源
属性:
type:设置数据源的类型;
值:POOLED,UNPOOLED,JNDI
POOLED:表示使用数据库连接池
UNPOOLED:不使用数据库连接池,每一次获取连接时都重新创建连接
JNDI:(了解)表示使用上下文中的数据源
-->
<dataSource type="POOLED">
<!--注意,这里是mysql8.0的配置,如果是mysql5,就是com.mysql.jdbc.Driver-->
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
<environment id="test">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!--注意,这里是mysql8.0的配置,如果是mysql5,就是com.mysql.jdbc.Driver-->
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
3.5、mappers
- 使用package起别名
<!-- 引入mybatis的映射文件,映射文件中是操作数据库的SQL语句,需要通过
当前的核心配置文件引入映射文件-->
<mappers>
<!--<mapper resource="mappers/UserMapper.xml"/>-->
<!--
相当于typeAliases给mapper起别名
以包的方式引入映射文件,但是必须满足两个条件:
1.mapper接口和映射文件所在的包必须一致
2.mapper接口的名字和映射文件的名字必须一致
这样一来mapper映射文件和mapper接口的类加载之后会在同一个目录下
-->
<package name="com.zylai.mybatis.mapper"/>
</mappers>
4、MyBatis的增删改查
- 首先编写一个工具类用来封装增删改查功能
public class SqlSessionUtil {
public static SqlSession getSqlSession(){
//需要将SqlSession返回就要把它的作用域向上提级
SqlSession sqlSession = null;
try {
//获取核心配置文件的输入流,来使用Resources中的getResourceAsStream方法,参数放入核心配置文件
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
//获取SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//获取SessionFactory通过sqlSessionFactoryBuilder.build方法把字节输入流放入即可获取
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//获取SqlSession对象,参数写入true表示它会自动提交事务,无需再手动提交
sqlSession = sqlSessionFactory.openSession(true);
} catch (IOException e) {
e.printStackTrace();
}
return sqlSession;
}
//至此工具类创建完成,创建测试方法去测试一下功能
4.1、新增
- 在UserMapper接口中加入方法
public interface UserMapper {
//添加用户信息
int insertUser();
- 在配置文件UserMapper.xml中加入与实体类相对应的SQL语句实现映射
<!--int insertUser();-->
<insert id="insertUser">
INSERT INTO t_user VALUES(null,'admin','123456','23','女','123456@qq.com')
</insert>
- 通过测试来实现新增功能
@Test
public void testInsert(){
//获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = SqlSessionUtil.getSqlSession();
//由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//然后就可以调用mapper接口中的方法,实现添加用户信息的功能
mapper.insertUser();
//使用完毕后记得关闭
sqlSession.close();
}
4.2、删除
- 在UserMapper接口中新增方法
public interface UserMapper {
//删除用户信息
void DeleteUser();
}
- 在配置文件UserMapper.xml中加入与实体类相对应的SQL语句实现映射
<!-- void DeleteUser();-->
<delete id="DeleteUser">
DELETE FROM t_user WHERE id = 8
</delete>
- 通过测试来实现删除功能
@Test
public void testDeleteUser(){
//获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = SqlSessionUtil.getSqlSession();
//由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//然后就可以调用mapper接口中的方法,实现删除用户信息的功能
mapper.DeleteUser();
//使用完毕后记得关闭
sqlSession.close();
}
4.3、修改
- 在UserMapper接口中新增方法
public interface UserMapper {
//修改用户信息
void UpdateUser();
}
- 在配置文件UserMapper.xml中加入与实体类相对应的SQL语句实现映射
<update id="UpdateUser">
UPDATE t_user SET id='1' where id = 4
</update>
- 通过测试来实现修改功能
@Test
public void testUpdate(){
//获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = SqlSessionUtil.getSqlSession();
//由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//然后就可以调用mapper接口中的方法,实现修改用户信息的功能
mapper.UpdateUser();
//使用完毕后记得关闭
sqlSession.close();
}
4.4、查询一个实体类对象
- 在UserMapper接口中新增方法
public interface UserMapper {
//根据id查询用户信息
User getUserById();
}
- 在配置文件UserMapper.xml中加入映射,并设置相对应的结果集
<!--User getUserById();
resultType:设置结果类型,即查询的数据要转换的Java类型
resultMap:自定义映射,处理多对一或一对多的映射关系
-->
<select id="getUserById" resultType="com.xujicheng.mybatis.pojo.User">
SELECT * FROM t_user WHERE id = 1
</select>
- 同样通过测试实现查询单个用户信息的功能
@Test
public void TestGetUserById(){
//获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = SqlSessionUtil.getSqlSession();
//由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//然后就可以调用mapper接口中的方法,实现查询用户信息的功能
User user = mapper.getUserById();
//使用完毕后记得关闭
sqlSession.close();
}
4.5、查询list集合
- 在UserMapper接口中新增方法
public interface UserMapper {
//查询多个用户信息就要用List作为容器
List <User> getAllUser();
}
- 在配置文件UserMapper.xml中加入映射,并设置相对应的结果集,这块需要注意的是返回的是返回的实体类已经是List类型属于映射中就不使用 resultMap映射了
<!--List <User> getAllUser();-->
<select id="getAllUser" resultType="com.xujicheng.mybatis.pojo.User">
SELECT * FROM t_user
</select>
- 同样通过测试实现查询所有用户信息的功能,与查询单个用户稍微有些不同
@Test
public void TestGetAllUser(){
//获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = SqlSessionUtil.getSqlSession();
//由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//然后就可以调用mapper接口中的方法,实现查询所有用户信息的功能
List<User> list = mapper.getAllUser();
//返回list类型并使用forEach方法去打印即可
list.forEach(System.out::println);
//使用完毕后记得关闭
sqlSession.close();
}
- 注意:
- 1、查询的标签select必须设置属性resultType或resultMap,用于设置实体类和数据库表的映射 关系
- resultType:自动映射,用于属性名和表中字段名一致的情况
- resultMap:自定义映射,用于一对多或多对一或字段名和属性名不一致的情况
- 1、查询的标签select必须设置属性resultType或resultMap,用于设置实体类和数据库表的映射 关系