目录
一、MyBatis简介
MyBatis是一款优秀的持久层框架,用于简化JDBC开发。
MyBatis本是apache的一个开源项目iBatis,2010年这个项目由apache software foundation迁移到了google code,并且改名为MyBatis。2013年11月迁移到Github。
JavaEE三层架构: 表现层(页面展示)、业务层(逻辑处理)、持久层。
持久层指的是负责将数据保存到数据库的那一层代码。
框架: 相当于一个半成品软件,是一套可重用、通用的、软件基础代码模型。在框架的基础之上构建软件编写更加高效、规范、通用、可扩展。
JDBC的缺点:
硬编码:注册驱动,获取连接;SQL语句;----MyBatis使用配置文件
操作繁琐:手动设置参数;手动封装结果集。----MyBatis自动完成
特点: MyBatis几乎免除了所有的JDBC代码以及设置参数和获取结果集的工作。
二、MyBatis快速入门
2.1 查询user表中所有数据
2.1.1 使用Navicat创建user表,添加数据
create database mybatis;
use mybatis;
drop table if exists tb_user;
create table tb_user(
id int primary key auto_increment,
username varchar(20),
password varchar(20),
gender char(1),
addr varchar(30)
);
INSERT INTO tb_user VALUES (1, 'zhangsan', '123', '男', '北京');
INSERT INTO tb_user VALUES (2, '李四', '234', '女', '天津');
INSERT INTO tb_user VALUES (3, '王五', '11', '男', '西安');
2.1.2 创建maven模块,导入坐标
创建maven模块:
导入坐标:
使用 Maven 来构建项目,则需将下面的依赖代码置于 pom.xml 文件中:
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>x.x.x</version>
</dependency>
再添加其他依赖,添加的完整代码:
<dependencies>
<!-- mybatis 依赖-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.10</version>
</dependency>
<!-- mybatis 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.28</version>
</dependency>
<!-- junit单元测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
<!-- 添加slf4j日志api -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.36</version>
</dependency>
<!-- 添加logback-classic依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.11</version>
</dependency>
<!-- 添加logback-core依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>1.2.11</version>
</dependency>
</dependencies>
出现错误是版本原因,鼠标放在错误处,alt+insert添加版本。或者在Maven里面不断的install和download。
2.1.3 编写核心配置文件
从 XML 中构建 SqlSessionFactory:
在resource中新建文件mybatis-config.xml:
<?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="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
注意修改相应内容(第二个框mybatis为之前新建的数据库的名称):
2.1.4 编写SQL映射文件
在resource中新建UserMapper.xml文件,其中User一般为你要操作的表的名字。插入以下代码:
<?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">
<!-- namespace命名空间 -->
<mapper namespace="test">
<select id="selectAll" resultType="Pojo.User">
select * from tb_user;
</select>
</mapper>
2.1.5 编码
- 定义pojo类:
在Java文件夹中新建class类,并创建表中属性的定义和方法:Pojo.User (Pojo为包名,User为类名)
package Pojo;
public class User {
private Integer id;
private String username;
private String password;
private String gender;
private String addr;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getGender() {
return gender;
}
public void setGender(String gender) {
this.gender = gender;
}
public String getAddr() {
return addr;
}
public void setAddr(String addr) {
this.addr = addr;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", password='" + password + '\'' +
", gender='" + gender + '\'' +
", addr='" + addr + '\'' +
'}';
}
}
在UserMapper.xml映射文件中的mapper标签里面填写返回的类的类型,其中id是select标签里面的sql语句的唯一标识符:
<select id="selectAll" resultType="Pojo.User">
select * from tb_user;
</select>
在myBatis-config.xml文件mappers标签中填写路径:
<mappers>
<!-- 加载sql的映射文件-->
<mapper resource="UserMapper.xml"/>
</mappers>
- 在java文件夹创建测试类MyBatisDemo.java文件:
流程:
1.加载MyBatis核心配置文件,获取sqlsessionFactory。resource改为相应核心配置文件名称。
2.获取sqlSessio对象,用它执行sql。
3.执行sql。语句selectList(“test.selectAll”)中test为UserMapper中sql的命名空间,selectAll为sql语句的id。
4.释放资源。
package MyBatis;
import Pojo.User;
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.IOException;
import java.io.InputStream;
import java.util.List;
public class MyBatisDemo {
public static void main(String[] args) throws IOException {
// 1.加载MyBatis核心配置文件,获取sqlsessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 2.获取sqlSessio对象,用他执行sql
SqlSession sqlSession = sqlSessionFactory.openSession();
// 3.执行sql
List<User> users = sqlSession.selectList("test.selectAll");
System.out.println(users);
// 4.释放资源
sqlSession.close();
}
}
2.2 IDEA与数据库的连接
UserMapper文件的sql语句中表名可能出现错误,原因是IDEA与数据库未互相识别。
解决:在IDEA中配置数据库连接。
点击OK之后会弹出提示框填写用户名和密码即可。
可在IDEA中编辑SQL语句:
选中编写的SQL语句右键execute运行。
若有某些方法报错,鼠标点击该方法按alt + enter导入相应的包。
三、Mapper代理开发
UserMapper中还是存在硬编码问题。
目的:解决原生方式中的硬编码问题,简化后期执行SQL。
定义interface类接口:mapper.UserMapper
3.1 定义与SQL映射文件同名的Mapper接口
定义与SQL映射文件同名的Mapper接口,并且将Mapper接口和SQL映射文件放置在同一目录下。
如上图,xml文件与java文件要分开写就在resource文件中新建目录com/itheima/mapper保证编译后的xml与java文件在同一目录下(注意新建时用/代替.),也可以把xml文件拖到与java文件相同的目录下。
3.2 设置SQL映射文件的namespace
设置SQL映射文件的namespace属性为Mapper接口全限定名。
namespace = “com.itheima.mapper.UserMapper”
<?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">
<!-- namespace命名空间 -->
<mapper namespace="com.itheima.mapper.UserMapper">
<select id="selectAll" resultType="com.itheima.mapper.Pojo.User">
select * from tb_user;
</select>
</mapper>
3.3 在Mapper接口中定义方法
在Mapper接口(UserMapper.java文件)中定义方法,方法名为SQL映射文件中的sql语句的id,保持参数类型和返回值类型一致。
返回类型为User,故接口中返回User对象;
由于我们定义的SQL语句是查询全部的属性,故返回类型为List。
package com.itheima.mapper;
import com.itheima.mapper.Pojo.User;
import java.util.List;
public interface UserMapper {
List<User> selectAll();
}
注意:由于映射文件的位置换了,故配置文件mybatis-config中的resource需要修改,在映射文件上右键copyPath -> path from Source Root,然后粘贴到配置文件mybatis-config中的resource处。
<!-- 加载sql的映射文件-->
<mapper resource="com/itheima/mapper/UserMapper.xml"/>
3.4 编码
在java文件夹中新建一个class类的.java文件用于测试运行。
使用sqlSession.getMapper()方法传入UserMapper的类型UserMapper.class,返回得到UserMapper接口的代理对象。然后执行sql语句。
public static void main(String[] args) throws IOException {
// 1.加载MyBatis核心配置文件,获取sqlsessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 2.获取sqlSessio对象,用他执行sql
SqlSession sqlSession = sqlSessionFactory.openSession();
// 3.执行sql ----- 旧方法
// List<User> users = sqlSession.selectList("test.selectAll");
// 3.获取UserMapper接口的代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> users = userMapper.selectAll();
System.out.println(users);
// 4.释放资源
sqlSession.close();
}
测试结果:
改进:
若满足映射文件与接口名称相同且在同一目录下,当映射文件增多,myBatis-config.xml加载映射文件可使用包扫描方式:
< package name=“com.itheima.mapper” />
四、MyBatis核心配置文件
核心配置文件一般命名为mybatis-config.xml:
<?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:///mybatis?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="522731"/>
</dataSource>
</environment>
</environments>
<mappers>
<!-- 加载sql的映射文件-->
<!-- <mapper resource="com/itheima/mapper/UserMapper.xml"/>-->
<!-- mapper代理方式 -->
<package name="com.itheima.mapper"/>
</mappers>
</configuration>
< invironments >中可有多个< invironment >,使用default运行不同的数据库。default的值为< invironment >的id值。