MyBatis详细教程入门（从0-1这一步你必须迈出去）_mybatis从入门(1)

最新推荐文章于 2024-08-21 23:39:15 发布

2401_84164546

最新推荐文章于 2024-08-21 23:39:15 发布

阅读量535

点赞数 23

分类专栏： 2024年程序员学习文章标签： mybatis

本文链接：https://blog.csdn.net/2401_84164546/article/details/137999259

版权

2024年程序员学习专栏收录该内容

113 篇文章 0 订阅

订阅专栏

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

htt

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

mysql-connector-java
8.0.22

org.mybatis mybatis 3.5.6 junit junit 4.12 test org.projectlombok lombok 1.18.10 log4j log4j 1.2.17

4.创建一个Module

2.2 创建一个模块

编写mybatis的核心配置文件

<?xml version="1.0" encoding="UTF-8" ?>

编写mybatis工具类

package com.liziba.mybatis.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.InputStream;

/**
* @auther LiZiBa
* @date 2021/1/17 17:01
* @description: mybatis工具类
**/
public class MybatisUtil {

/** SqlSessionFactory对象 */
static SqlSessionFactory sqlSessionFactory;

static {
try{
// 第一步：通过SqlSessionFactoryBuilder获取SqlSessionFactory
String resource = “mybatis-config.xml”;
InputStream is = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
}catch (Exception e) {
e.printStackTrace();
}
}

/**
* 获取SqlSession （SqlSession提供执行数据库语句方法）
* @return SqlSession对象
*/
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}

2.3 编写代码

实体类

package com.liziba.mybatis.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.apache.ibatis.type.Alias;

/**
* @auther LiZiBa
* @date 2021/1/17 17:07
* @description:
**/

@Data
@AllArgsConstructor
@NoArgsConstructor
// 别名自定义默认使用实体首字母小写 User–>Alias–>user
@Alias(“user”)
public class User {

private Integer id;
private String name;
private String password;

}

Dao/Mapper接口

public interface UserMapper {
/**
* 查询所有User
* @return
*/
List getUserList();
}

接口实现类（由原来的UserMapperImpl转变为一个Mapper配置文件）

<?xml version="1.0" encoding="UTF-8" ?> select id,name,pwd as password from user

测试

package com.liziba.mybatis.mapper;

import com.liziba.mybatis.pojo.User;
import com.liziba.mybatis.utils.MybatisUtil;
import org.apache.ibatis.session.RowBounds;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.Test;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
* @auther LiZiBa
* @date 2021/1/17 17:28
* @description:
**/
public class UserMapperTest {

/**
* 测试获取全部user
*/
@Test
public void getUserListTest() {
// 开启一个SqlSession
SqlSession sqlSession = MybatisUtil.getSqlSession();
// 通过SqlSession获取UserMapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List userList = userMapper.getUserList();
// 循环输出userList
userList.forEach(user -> {
System.out.println(user.toString());
});
// 关闭SqlSession
sqlSession.close();
}

}

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fgbp0vH1-1622730704315)(C:\Users\Leon Plious\AppData\Roaming\Typora\typora-user-images\1610891512594.png)]

可能会遇到的问题：

配置文件没有注册
绑定接口错误
方法名不对
返回类型不对
Maven导出资源问题

3、CURD

3.1 namespace

namespace中的包名要和Dao/Mapper接口的包名一致

3.2 select

选择，查询语句；

id：就是对应的namespace对于的mapper中的方法名；
resultType : Sql语句执行的返回值；
parameterType : 参数类型；

编写接口

/**
* 通过id获取用户
* @param id
* @return
*/
User getUserById(Integer id);

编写对应的mapper中的sql语句

select * from user where id = #{id}

测试

/**
* 通过id获取用户
*/
@Test
public void getUserByIdTest() {

logger.info(“通过id获取用户”);

SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.getUserById(1);
System.out.println(user.toString());
sqlSession.close();
}

*insert/update/delete 语句需要提交事务sqlSession.commit();

3.3 Insert

编写接口

/**
* 插入User
* @param user
*/
void addUser(User user);

编写对应的mapper中的sql语句

insert into user (id, name, pwd) values (#{id}, #{name}, #{pwd})

测试

/**
* 测试插入user
*/
@Test
public void addUserTest() {
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = new User(5, “liangqinshi”, “123456”);
userMapper.addUser(user);
// 增加、删除、修改一定要提交事务
sqlSession.commit();
sqlSession.close();
}

3.4 update

编写接口

/**
* 通过id修改User
* @param user
*/
void updateUserById(User user);

编写对应的mapper中的sql语句

update user set name = #{name} ,pwd = #{pwd} where id = #{id}

测试

/**
* 通过id修改用户
*/
@Test
public void updateUserByIdTest() {
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = new User(1, “liziba01”, “654321”);
userMapper.updateUserById(user);

sqlSession.commit();
sqlSession.close();
}

3.5 Delete

编写接口

/**
* 通过id删除用户
* @param id
*/
void deleteUserById(Integer id);

编写对应的mapper中的sql语句

delete from user where id = #{id}

测试

/**
* 通过id删除用户
*/
@Test
public void deleteUserByIdTest() {
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
userMapper.deleteUserById(5);
sqlSession.commit();
sqlSession.close();
}

3.6 万能Map

假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应该考虑使用Map!

UserMapper接口

/**
* 通过Map对象插入User
* @param map
*/
void addUserByMap(Map<String, Object> map);

UserMapper.xml

insert into user (id, name, pwd) values (#{id}, #{name}, #{password})

测试

/**
* 通过map新增User
*/
@Test
public void addUserByMapTest() {
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 构建map，传入参数
Map<String, Object> userMap = new HashMap<>();
userMap.put(“id”, 4);
userMap.put(“name”, “xieli”);
userMap.put(“password”, “123456”);
userMapper.addUserByMap(userMap);

sqlSession.commit();
sqlSession.close();
}

Map传递参数，直接在sql中取出key即可！【parameter=“map”】

对象传递参数，直接在sql中取出对象的属性即可！【parameter=“Object”】

只有一个基本类型参数的情况下，可以直接在sql中取到

多个参数用Map , 或者注解！

3.7 模糊查询

*建议Java代码执行的时候，传递通配符% %

UserMapper接口

/**
* 通过名字模糊查询User
* @param nameLike %nameLike%
* @return
*/
List getUserLikeByName(String nameLike);

UserMapper.xml

select * from user where name like #{nameLike}

测试

/**
* 通过名字模糊查询
*/
@Test
public void getUserLikeByNameTest() {
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

String nameLike = “%li%”;
List users = userMapper.getUserLikeByName(nameLike);
users.forEach(user -> {
System.out.println(user.toString());
});

sqlSession.close();
}

4、配置解析

4.1 核心配置文件

mybatis-config.xml
Mybatis的配置文件包含了会深深影响MyBatis行为的设置和属性信息。

configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）

4.2 环境配置 environments

MyBatis 可以配置成适应多种环境

不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境

学会使用配置多套运行环境！

MyBatis默认的事务管理器就是JDBC ，连接池：POOLED

4.3 属性 properties

我们可以通过properties属性来实现引用配置文件

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。【db.poperties】

编写一个配置文件

db.properties

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?userSSL=true&useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC
username=root
password=123456

在核心配置文件中引入

可以直接引入外部文件
可以在其中增加一些属性配置
如果两个文件有同一个字段，优先使用外部配置文件的

4.4 类型别名 typeAliases

类型别名可为 Java 类型设置一个缩写名字。它仅用于 XML 配置.
意在降低冗余的全限定类名书写。

也可以指定一个包，每一个在包 com.liziba.mybatis.pojo 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。比如 com.liziba.mybatis.pojo.User 的别名为 user,；若有注解，则别名为其注解值。见下面的例子：

在实体类比较少的时候，使用第一种方式。

如果实体类十分多，建议用第二种扫描包的方式。

第一种可以自定义别名，第二种不行，如果非要改，需要在实体上增加注解。

@Alias(“user”)
public class User {
…
}

4.5 设置 Settings

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

https://mybatis.org/mybatis-3/zh/configuration.html#settings

4.6 其他配置

mybatis-generator-core
mybatis-plus
通用mapper

4.7. 映射器 mappers

MapperRegistry：注册绑定我们的Mapper文件；

方式一：【推荐使用】

方式二：使用class文件绑定注册

注意点：

接口和他的Mapper配置文件必须同名
接口和他的Mapper配置文件必须在同一个包下

方式三：使用包扫描进行注入

4.8 作用域和生命周期

作用域（Scope）和生命周期

理解我们之前讨论过的不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题。

提示 对象生命周期和依赖注入框架

依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器，并将它们直接注入到你的 bean 中，因此可以直接忽略它们的生命周期。如果对如何通过依赖注入框架使用 MyBatis 感兴趣，可以研究一下 MyBatis-Spring 或 MyBatis-Guice 两个子项目。

SqlSessionFactoryBuilder

这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例，但最好还是不要一直保留着它，以保证所有的 XML 解析资源可以被释放给更重要的事情。

SqlSessionFactory

SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏习惯”。因此 SqlSessionFactory 的最佳作用域是应用作用域。有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。

SqlSession

每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中，比如 Servlet 框架中的 HttpSession。如果你现在正在使用一种 Web 框架，考虑将 SqlSession 放在一个和 HTTP 请求相似的作用域中。换句话说，每次收到 HTTP 请求，就可以打开一个 SqlSession，返回一个响应后，就关闭它。这个关闭操作很重要，为了确保每次都能执行关闭操作，你应该把这个关闭操作放到 finally 块中。下面的示例就是一个确保 SqlSession 关闭的标准模式：

try (SqlSession session = sqlSessionFactory.openSession()) {
// 你的应用逻辑代码
}

在所有代码中都遵循这种使用模式，可以保证所有数据库资源都能被正确地关闭。

5、解决属性名和数据库字段名不一致的问题

5.1 问题

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-68p7rpJs-1622730704319)(C:\Users\Leon Plious\AppData\Roaming\Typora\typora-user-images\1610893482795.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Pw33fS2L-1622730704323)(C:\Users\Leon Plious\AppData\Roaming\Typora\typora-user-images\1610893508460.png)]

pwd 与 password不一致查询结果password=null

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xiP33sRx-1622730704324)(C:\Users\Leon Plious\AppData\Roaming\Typora\typora-user-images\1610893687340.png)]

解决办法（不推荐）

起别名

select id,name,pwd as password from user

5.2 resultMap

结果集映射

id name pwd

id name password

select * from user where id = #{id}

resultMap 元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来，并在一些情形下允许你进行一些 JDBC 不支持的操作。实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的数千行代码。ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

6、日志

6.1 日志工厂

如果一个数据库操作，出现了异常，我们需要排错，日志就是最好的助手！

曾经：sout、debug

现在：日志工厂

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-o93Thrgo-1622730704325)(C:\Users\Leon Plious\AppData\Roaming\Typora\typora-user-images\1610893988341.png)]

SLF4J
LOG4J 【掌握】
LOG4J2
JDK_LOGGING
COMMONS_LOGGING
STDOUT_LOGGING 【掌握】
NO_LOGGING

在MyBatis中具体使用哪一个日志实现，在设置中设定

STDOUT_LOGGING

6.2 Log4j

什么是Log4j？

Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件；
我们也可以控制每一条日志的输出格式；
通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程；
最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

先导入log4j的包

log4j log4j 1.2.17

log4j.properties

将等级为DEBUG级别的日志输出到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/rzp.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.sq1.PreparedStatement=DEBUG

配置settings为log4j实现
测试运行

Log4j简单使用

在要使用Log4j的类中，导入包 import org.apache.log4j.Logger;
日志对象，参数为当前类的class对象

static Logger logger = Logger.getLogger(UserMapperTest.class);

日志级别

/**
* 通过id获取用户
*/
@Test
public void getUserByIdTest() {

logger.info(“通过id获取用户”);

info
debug
error

7、分页

思考：为什么分页？

减少数据的处理量

7.1 使用Limit分页

SELECT * from user limit startIndex,pageSize

使用MyBatis实现分页，核心SQL

接口

/**
* Limit分页查询用户
* @param map
* @return
*/
List getUserByLimit(Map<String, Integer> map);

Mapper.xml

select * from user limit #{startIndex}, #{pageSize}

测试

/**
* limit分页查询
*/
@Test
public void getUserByLimit() {
SqlSession sqlSession = MybatisUtil.getSqlSession();

UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
Map<String, Integer> paramMap = new HashMap<>();
paramMap.put(“startIndex”, 0);
paramMap.put(“pageSize”, 2);
List users = userMapper.getUserByLimit(paramMap);

users.forEach(user -> {
System.out.println(user.toString());
});

sqlSession.close();
}

7.2 RowBounds分页

不再使用SQL实现分页

接口

/**

RowBounds分页查询
@return
*/
List getUserByRowBounds();

mapper.xml

select * from user

测试

/**
* RowBounds分页查询
*/
@Test
public void getUserByRowBounds() {
SqlSession sqlSession = MybatisUtil.getSqlSession();
RowBounds rowBounds = new RowBounds(0, 2);
List users = sqlSession.selectList(“com.liziba.mybatis.mapper.UserMapper.getUserByRowBounds”, null, rowBounds);
users.forEach(user -> {
System.out.println(user.toString());
});

sqlSession.close();
}

7.3 分页插件

pagehelper

8、使用注解开发

8.1 面向接口开发

面向对象：考虑问题以对象为单位，考虑对象的属性和方法
面向过程：考虑问题以一个具体的流程（事务过程）为单位，考虑他的实现
接口开发：针对复用性而言，体现在系统整体的架构和设计

8.2 使用注解开发

注解在接口上

/**
* 查询所有用户
* @return
*/
@Select(“select * from user”)
List getUsers();

/**
* 通过ID查询用户
* @param id
* @return
*/
@Select(“select * from user where id = #{id}”)
User getUserById(@Param(“id”)Integer id);

/**
* 更新用户信息
* @param user
*/
@Update(“update user set name=#{name}, password=#{password} where id = #{id}”)
void setUserById(User user);

/**
* 新增用户
* @param user
*/
@Insert(“insert into user (id, name, password) values (6, #{name}, #{password})”)
void addUser(User user);

/**
* 通过ID删除用户
* @param id
*/
@Delete(“delete from user where id = #{id}”)
void deleteUserById(@Param(“id”)Integer id);

工具类回顾

/**
* @auther LiZiBa
* @date 2021/1/17 17:01
* @description: mybatis工具类
**/
public class MybatisUtil {

/** SqlSessionFactory对象 */
static SqlSessionFactory sqlSessionFactory;

/**
* 获取SqlSession （SqlSession提供执行数据库语句方法）
* @return SqlSession对象
*/
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}

添加mapper接口文件映射 – 查看最后mappers

<?xml version="1.0" encoding="UTF-8" ?>

测试

/**
* 获取用户集合
*/
@Test
public void getUsersTest() {

SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List users = userMapper.getUsers();
users.forEach(user -> {
System.out.println(user.toString());
});
// 关闭会话
sqlSession.close();
}

/**
* 通过用户ID查询用户信息
*/
@Test
public void getUserByIdTest() {

/**
* 根据ID更新User
*/
@Test
public void setUserByIdTest() {

SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = new User(1, “谢礼加油！”, “123456”);
userMapper.setUserById(user);
// 提交事务
sqlSession.commit();
// 关闭会话
sqlSession.close();
}

/**
* 新增用户
*/
@Test
public void addUserTest() {

SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = new User(6, “tabao”, “350000”);
userMapper.addUser(user);
// 提交事务
sqlSession.commit();
// 关闭会话
sqlSession.close();
}

/**
* 通过ID删除用户
*/
@Test
public void deleteUserByIdTest() {

SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
userMapper.deleteUserById(6);
// 提交事务
sqlSession.commit();
// 关闭会话
sqlSession.close();
}

关于@Param( )注解