一、MyBatis简介
1、MyBatis历史
MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁 移到了Google Code。随着开发团队转投Google Code旗下, iBatis3.x正式更名为MyBatis。代码于 2013年11月迁移到Github。
iBatis一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。 iBatis提供的持久层框架 包括SQL Maps和Data Access Objects(DAO)。
2、MyBatis特性
1)MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
2)MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
3)MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java和POJO(Plain Old Java Objects, 普通的Java对象)映射成数据库中的记录
4)MyBatis 是一个半自动的 ORM(Object Relation Mapping) 框架
3、MyBatis下载
4、和其它持久层技术对比
- JDBC
- SQL 夹杂在Java代码中耦合度高,导致硬编码内伤
- 维护不易且实际开发需求中 SQL 有变化,频繁修改的情况多见
- 代码冗长,开发效率低
- Hibernate 和 JPA
- 操作简便,开发效率高
- 程序中的长难复杂 SQL 需要绕过框架
- 内部自动生产的 SQL,不容易做特殊优化 基于全映射的全自动框架,大量字段的 POJO 进行部分映射时比较困难。
- 反射操作太多,导致数据库性能下降
- MyBatis
- 轻量级,性能出色
- SQL和Java编码分开,功能边界清晰。Java代码专注业务、SQL语句专注数据
- 开发效率稍逊于Hlbernate,但是完成能够接受
二、搭建MyBatis
1、开发环境
IDE:idea 2019.2
构建工具:maven 3.5.4
MySQL版本:MySQL 5.7
MyBatis版本:MyBatis 3.5.7
2、创建maven工程
a>打包方式
<packaging>jar</packaging>
b>引入依赖
<dependencies>
<dependency>
<!--Mybatis核心-->
<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>8.0.27</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.22</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
3、创建MyBatis的核心配置文件
习惯上命名为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>
<!--设置连接数据库的环境-->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>
4、创建mapper接口
MyBatis中的Mapper接口相当于以前的dao。但是区别于,mapper仅仅是接口,我们不需要听实现类
public interface UserMapper {
/**
* Mybatis面向接口编程的两个一致
* 1.映射文件的namespace要和mapper接口的全类名接口保持一致
* 2.映射文件的id要和mapper接口中的方法保持一致
*
* 表 -- 实体类 -- mapper接口 -- 映射文件
*/
/**
* 添加用户信息
*/
int insertUser(User user);
/**
* 修改用户信息
*/
void updateUser();
/**
* 删除用户信息
*/
void deleteUser();
/**
* 根据id查询用户信息
*/
User getUserById();
/**
* 查询所有的用户信息
*/
List<User> getAllUser();
}
5、创建MyBatis的映射文件
相关概念:ORM(Object Relationship Mapping**)**对象关系映射。
- 对象:Java的实体类对象
- 关系:关系型数据库
- 映射:二者之间的对应关系
![image.png](https://img-blog.csdnimg.cn/img_convert/427f79d545c9984022cd86cb83f06f14.png#clientId=u7b14e7be-e328-4&crop=0&crop=0&crop=1&crop=1&from=paste&height=150&id=u585072f0&margin=[object Object]&name=image.png&originHeight=300&originWidth=1402&originalType=binary&ratio=1&rotation=0&showTitle=false&size=28347&status=done&style=none&taskId=uc59252d0-4587-4654-8642-a71a7990aa4&title=&width=701)
1、映射文件的命名规则:
表所对应的实体的类名+Mapper.xml
例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
因此一个映射文件用于编写SQL,访问以及操作表中的数据
MyBaits映射文件用于编写SQL,访问以及操作表中的数据
MyBatis映射文件存放的位置编写SQL,访问以及操作表中的数据
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.atguigu.mybatis.mapper.UserMapper">
<!--int insertUser();-->
<insert id="insertUser">
insert into t_user values(null,'张三','123',23,'女')
</insert>
</mapper>
6、通过junit测试功能
@Test
public void testMyBatis() throws IOException {
// 加载核心配置文件
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
// 获取SqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 获取SqlSessionFactory
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
// 获取SqlSession
SqlSession session = sqlSessionFactory.openSession(true);
// 获取mapper接口对象
UserMapper mapper = session.getMapper(UserMapper.class); // 底层会自动为我们创建好mapper接口的实现类
// 测试功能
int result = mapper.insertUser(new User(null, "小胡", "123456", 20, "男", "123@qq.com"));
// 提交事务
// session.commit();
System.out.println("result = " + result);
session.close();
}
- SqlSession:代表java程序和数据库之间的会话。(HttpSession是java程序和浏览器之间的会话)
- SqlSessionFactory:是生产SqlSession的工厂
- 工厂模式:如果创建某个对象,使用的过程基本固定,那么我们就可以把创建这个对象的相关代码封装到一个”工厂类“中,以后都可以使用这个工厂类来”生产”我们需要的对象。
7、加入log4j日志功能
a>加入依赖
<!-- log4j日志 --> <dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
b>加入log4j的配置文件
<?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(调试) 从左到右打印的内容越来越详细
三、核心配置文件详解
核心配置文件中标签必须按照固定的顺序:
properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorF actory?,plugins?,environments?,databaseIdProvider?,mappers?
<?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核心配置文件中,标签的顺序:
properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,
objectWrapperFactory?,reflectorFactory?,plugins?,
environments?,databaseIdProvider?,mappers?
-->
<!--引入properties配置文件-->
<properties resource="jdbc.properties" />
<!--设置类型别名-->
<typeAliases>
<!--
typeAlias:设置某个类型的别名
属性:
type:设置需要设置别名的类型
alas:设置某个类型的别名,若不设置该属性,那么该类型拥有默认的别名,即类型且不区分大小写
-->
<!--<typeAlias type="com.atguigu.mybatis.pojo.User" />-->
<!--以包为单位,将包下所有的类型设置默认的类型别名,即类名且不区分大小写-->
<package name="com.atguigu.mybatis.pojo"/>
</typeAliases>
<!--
environments:配置多个连接数据库的环境
属性:
default:设置默认使用的环境的id
-->
<environments default="development">
<!--
environment:配置某个具体的环境
属性:
id:表示连接数据库的环境的唯一标识,不能重复
-->
<environment id="development">
<!--
transactionManager:设置事务管理方式
属性:
type="JDBC|MANAGER"
JDBC:表示当前环境中,执行SQL中,使用的是JDBC中原生的事务管理方式,事务的提交或回滚需要手动提交
MANAGER:被管理,例如spring
-->
<transactionManager type="JDBC"/>
<!--
dataSource:配置数据源
属性:
type:设置数据源的类型
type="POOLED|UNPOOLED|JNDI"
POOLED: 表示使用数据库连接池缓存数据库连接
UNPOOLED: 表示不适用数据库连接池
JNDI: 表示使用上下文中的数据源
-->
<dataSource type="POOLED">
<!--driver:驱动内容-->
<property name="driver" value="${jdbc.driver}"/>
<!--连接数据库的url-->
<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">
<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>
<!--引入映射文件-->
<mappers>
<!--<mapper resource="mappers/UserMapper.xml" />-->
<!--
以包为单位引入映射文件
要求:
1、mapper接口所在的包要和映射文件所在的包一致
2、mapper接口和映射文件的名字一致
-->
<package name="com.atguigu.mybatis.mapper"/>
</mappers>
</configuration>
注意:mapper接口所在的包要和映射文件所在的包一致。在resource文件夹下要用/代替.创建包
四、MyBatis的增删改查
1、添加
/**
* 添加用户信息
*/
int insertUser(User user);
<!--int insertUser(User user);-->
<insert id="insertUser">
insert into t_user values(null, #{username}, #{password}, #{age}, #{sex}, #{email})
</insert>
2、删除
/**
* 删除用户信息
*/
void deleteUser();
<!--void deleteUser()-->
<delete id="deleteUser">
delete from t_user where id = 3
</delete>
3、修改
/**
* 修改用户信息
*/
void updateUser();
<!--void updateUser();-->
<update id="updateUser">
update t_user set username = '张三' where id = 4
</update>
4、查询一个实体对象
/**
* 根据id查询用户信息
*/
User getUserById();
<!--
查询功能的标签必须设置resultType或者resultMap
resultType:设置默认的映射关系
resultMap:设置上自定义的映射关系 字段名和实体属性不一致的时候
-->
<select id="getUserById" resultType="com.atguigu.mybatis.pojo.User">
select * from t_user where id = 4
</select>
5、查询集合
/**
* 查询所有的用户信息
*/
List<User> getAllUser();
<!--List<User> getAllUser();-->
<select id="getAllUser" resultType="User">
select * from t_user
</select>
注意:
1、查询的标签select必须设置属性resultType或resultMap,用于设置实体类和数据库表的映射关系
resultType:自动映射,用于属性名和表中字段名一致的情况
resultMap:自定义映射,用于一对多或多对一或字段名和属性名不一致的情况
2、当查询的数据我多条时,不能使用实体类作为返回值,只能使用集合,否则会抛出异常
TooManyResultsException;但是若查询的数据只有一条,可以使用实体类或集合作为返回值
五、MyBatis获取参数值的两种方式(重点)
MyBatis获取参数值的两种方式:KaTeX parse error: Expected 'EOF', got '#' at position 6: {} 和 #̲{}<br />**{} 的本质就是字符串拼接**,#{}的本质就是占位符赋值
${}使用字符串拼接的方式拼接sql,若为字符串类型或日期类型的字段进行赋值时,需要手动加单引号;但是#{}使用占位符赋值的方式拼接sql,此时为字符串类型或日期类型的字段进行赋值时,可以自动添加单引号。
重要建议使用#{}
1、单个字面量类型的参数
若mapper接口中的方法参数为单个的字面量类型
此时可以使用KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}以任意的名称获取参数的值,…{}需要手动加单引号
/**
* 根据用户名查询用户信息
*/
User getUserByUsername(String username);
<!--User getUserByUsername(String username);-->
<select id="getUserByUsername" resultType="User">
<!-- select * from t_user where username = #{username} -->
select * from t_user where username = '${username}'
</select>
2、多个字面量类型的参数
若mapper接口中的方法参数为多个时
此时MyBatis会自动将这些参数放在一个map集合中,以arg0,arg1…为键,以参数为值;以 param1,param2…为键,以参数为值;因此只需要通过KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}访问map集合的键就可以获…{}需要手动加单引号
/**
* 验证登录
*/
User checkLogin(String username, String password);
<!--User checkLogin(String username, String password);-->
<!--[arg0,arg1,param1,param2]-->
<select id="checkLogin" resultType="User">
<!-- select * from t_user where us