目录
一、JDBC操作回顾
二、什么是MyBatis?
三、MyBatis入门
1、准备工作
(1)创建工程
(2)数据准备
2、配置数据库连接字符串
3、写持久层代码
4、单元测试
(1)使用IDEA自动成成测试类
(2)使用程序运行代码,编写controller类,service类
四、常见问题错误
1、SQL错误
2、配置信息错误(检查账户密码)
3、未配置数据库
4、数据库不存在
5、表不存在
6、方法名重复
一、JDBC操作回顾
新增数据操作代码如下:
public static void main(String[] args) throws SQLException {
Scanner sc = new Scanner(System.in);
System.out.println("请输入id");
int id = sc.nextInt();
System.out.println("请输入name");
String name = sc.next();
//1、建立数据源
DataSource dataSource = new MysqlDataSource();
((MysqlDataSource)dataSource).setUrl("jdbc:mysql://127.0.0.1:3306/java110?characterEncoding=utf8&&useSSL=false");
((MysqlDataSource)dataSource).setUser("root");
((MysqlDataSource)dataSource).setPassword("123456");
//2、和数据库服务器建立连接
Connection connection = dataSource.getConnection();
//3、构造sql
String sql = "insert into student values(?,?)";//?作为占位符
//预处理
PreparedStatement statement = connection.prepareStatement(sql);
statement.setInt(1, id);
statement.setString(2, name);
//4、把构造好的sql发送的数据库服务器里执行
int n = statement.executeUpdate();
System.out.println(n);
//5、回收必要的资源
statement.close();
connection.close();
}
之前博客的详细介绍:Java的JDBC编程-CSDN博客
从上述代码和操作流程可以看出来,对于JDBC来说,整个操作都非常繁琐,我们不但要拼接每一个参数,而且还有按照模板代码的方式,一步步的操作数据库,并且每次操作完,还要手动关闭连接等。所有的这些操作步骤,都需要再每个方法中重复书写,那有没有一种方法,可以更简单、更方便操作数据库呢?肯定有,这也是我们要学习MyBatis的真正原因,它可以帮助我们更方便、更快速的操作数据库。
二、什么是MyBatis?
1、MyBatis是一块优秀的 持久层 框架,用于简化JDBC的开发。
2、MyBatis本是Apache的一个开源项目iBatis,2010年这个项目由Apache迁移到了google code,并且改名为MyBaits。2013年11月迁移到Github。
3、官网:MyBatis中文网 。
4、持久层:指的就是持久化操作的层,通常指数据访问层(dao),是用来操作数据库的。
简单来说,MyBatis是更简单完成程序和数据库交互的框架,也就是更简单的操作和读取数据库工具。
三、MyBatis入门
MyBatis操作数据库的步骤:
1、准备工作(创建Spring Boot工程、数据库表准备、实体类)。
2、引入Mybatis的相关依赖,配置Mybatis(数据库连接信息)。
3、编写SQL语句(注解 / XML)。
4、测试。
1、准备工作
(1)创建工程
创建Spring Boot 工程,并且导入MyBatis的起步依赖、MySQL驱动包。
MyBatis是一个持久层框架,具体的数据存储和数据操作还是在MySQL中操作的,所以需要添加MySQL驱动。
项目工程创建完成后,会自动在pom.xml文件中导入MyBatis依赖和MySQL驱动依赖,如图:
代码:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>
它们的版本会随着SpringBoot版本发生变化,SpringBoot 3.X 对应 MyBatis版本为 3.X,对应关系参考:mybatis-spring-boot-autoconfigure – Introduction ,如图:
(2)数据准备
创建用户表,代码如下:
-- 创建数据库
DROP DATABASE IF EXISTS mybatis_test;
CREATE DATABASE mybatis_test DEFAULT CHARACTER SET utf8mb4;
-- 使用数据数据
USE mybatis_test;
-- 创建表[用户表]
DROP TABLE IF EXISTS userinfo;
CREATE TABLE `userinfo` (
`id` INT ( 11 ) NOT NULL AUTO_INCREMENT,
`username` VARCHAR ( 127 ) NOT NULL,
`password` VARCHAR ( 127 ) NOT NULL,
`age` TINYINT ( 4 ) NOT NULL,
`gender` TINYINT ( 4 ) DEFAULT '0' COMMENT '1-男 2-女 0-默认',
`phone` VARCHAR ( 15 ) DEFAULT NULL,
`delete_flag` TINYINT ( 4 ) DEFAULT 0 COMMENT '0-正常, 1-删除',
`create_time` DATETIME DEFAULT now(),
`update_time` DATETIME DEFAULT now(),
PRIMARY KEY ( `id` )
) ENGINE = INNODB DEFAULT CHARSET = utf8mb4;
-- 添加用户信息
INSERT INTO mybatis_test.userinfo ( username, `password`, age, gender, phone )
VALUES ( 'admin', 'admin', 18, 1, '18612340001' );
INSERT INTO mybatis_test.userinfo ( username, `password`, age, gender, phone )
VALUES ( 'zhangsan', 'zhangsan', 18, 1, '18612340002' );
INSERT INTO mybatis_test.userinfo ( username, `password`, age, gender, phone )
VALUES ( 'lisi', 'lisi', 18, 1, '18612340003' );
INSERT INTO mybatis_test.userinfo ( username, `password`, age, gender, phone )
VALUES ( 'wangwu', 'wangwu', 18, 1, '18612340004' );
创建对应的实体类,代码如下:
@Data
public class UserInfo {
private Integer id;
private String username;
private String password;
private Integer age;
private Integer gender;
private String phone;
private Integer deleteFlag;
private Date createTime;
private Date updateTime;
}
2、配置数据库连接字符串
MyBatis中要连接数据库,需要数据库相关的参数配置:MySQL驱动类、登录名、密码、数据库连接字符串。
application.yml文件,配置内容如下:
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/mybatis_test?characterEncoding=utf8&useSSL=false
username: root
password: 1234
driver-class-name: com.mysql.cj.jdbc.Driver
注意事项:如果MySQL是 5.X 之前的使用的是 “com.mysql.jdbc.Driver”,如果是大于5.X使用的是“com.mysql.cj.jdbc.Driver”。
application.properties文件,配置内容如下:
#驱动类名称
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#数据库连接的url
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/mybatis_test?
characterEncoding=utf8&useSSL=false
#连接数据库的⽤⼾名
spring.datasource.username=root
#连接数据库的密码
spring.datasource.password=1234
3、写持久层代码
在项目中,创建持久层接口UserInfoMapper,如图:
代码如下:
import com.example.mybatisdemo.model.UserInfo;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.util.List;
@Mapper
public interface UserInfoMapper {
@Select("select * from userinfo")
List<UserInfo> getUserInfoAll();
}
MyBatis的持久层接口规范一般都叫XxxMapper。@Mapper注解:表示是MyBatis中的Mapper接口。
程序运行时,MyBatis框架会自动生成接口的实现类对象(代理对象),并交给Spring的IOC容器管理。
@Select注解:代表的就是select查询,也就是注解对应方法的具体实现内容。
4、单元测试
在Spring Boot工程下中,src下的test目录中,已经自动帮我们创建好了测试类,我们可以直接使用这个测试类来进行测试,代码如下:
import com.example.mybatisdemo.mapper.UserInfoMapper;
import com.example.mybatisdemo.model.UserInfo;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.List;
@SpringBootTest
class MybatisDemoApplicationTests {
@Autowired
private UserInfoMapper userInfoMapper;
@Test
void contextLoads() {
List<UserInfo> userInfos = userInfoMapper.getUserInfoAll();
System.out.println(userInfos);
}
}
测试类添加了注解@SpringBootTest,该测试类在运行时,就会自动加载Spring的运行环境。我们通过@Autowired这个注解,注入我们要测试的类,就可以开始进行测试了。
运行结果如下:
返回对应的结果,可以看到,只有SQL语句中查询的列中,只有和对应的列名一样,才会有显示(如果和数据库列名一样,就会有显示对应的信息)。如图:
(1)使用IDEA自动成成测试类
在你要测试的类中,鼠标右键 -> Generate -> Test -> 勾上对应要测试的方法,这里使用UserInfoMapper类做演示,如图:
点击OK,会在test目录下生成对应的测试类,如图:
测试类代码如下:
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
class UserInfoMapperTest {
@Autowired
private UserInfoMapper userInfoMapper;
@Test
void getUserInfoAll() {
System.out.println(userInfoMapper.getUserInfoAll());
}
}
记得加@SpringBootTest注解。
运行结果如下:
(2)使用程序运行代码,编写controller类,service类
controller类代码如下:
@RequestMapping("/user")
@RestController
public class UserController {
@Autowired
private UserService userService;
@RequestMapping("/getUserAll")
public List<UserInfo> getUserAll() {
return userService.getUserAll();
}
}
service类代码如下:
@Service
public class UserService {
@Autowired
private UserInfoMapper userInfoMapper;
public List<UserInfo> getUserAll() {
return userInfoMapper.getUserInfoAll();
}
}
浏览器访问:127.0.0.1:8080/user/getUserAll ,结果如下:
四、常见问题错误
1、SQL错误
如图:下面from和userinfo连在一起,没有空格分开。
双引号中多些一个空格都不行,不然就会报错,如图:
2、配置信息错误(检查账户密码)
3、未配置数据库
把application.yml配置内容注释掉,如图:
测试用例报错如下:创建dataSource失败了,解决方案是检查配置
程序启动代码报错如下:
如果配置内容格式不对,如图:
依然会报错上面这种错误。
4、数据库不存在
修改配置文件内容,其中这个数据库是不存在的,如图:
运行测试类代码,报错如下:
5、表不存在
修改代码如下:
运行测试类,报错如下:
6、方法名重复
UserInfoMapper类的方法名重复,修改代码如下:
运行测试类,报错如下: