MyBatis 是一款优秀的持久层框架,用于简化 JDBC 开发
MyBatis 本是 Apache 的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github。
官网:mybatis官网
持久层:
框架:
下面是 JDBC 代码,我们通过该代码分析都存在什么缺点:
我们发现缺点有:
硬代码
1.注册驱动、获取连接
上图标1的代码有很多字符串,而这些是连接数据库的四个基本信息,以后如果要将Mysql数据库换成其他的关系型
数据库的话,这四个地方都需要修改,如果放在此处就意味着要修改我们的源代码。
2.SQL语句
上图标2的代码。如果表结构发生变化,SQL语句就要进行更改。这也不方便后期的维护。
操作繁琐
1.手动设置参数
2.手动封装结果集
上图标4的代码是对查询到的数据进行封装,而这部分代码是没有什么技术含量,而且特别耗费时间的。
因此MyBatis就对JDBC的代码进行了简化。
1.硬编码可以配置到配置文件
2.操作繁琐的地方mybatis都自动完成
需求:查询user表中所有的数据。
1.创建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.创建模块,导入坐标
在创建好的模块中的 pom.xml 配置文件中添加依赖的坐标:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>mybatis-demo</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.5</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.10</version>
<scope>test</scope>
</dependency>
<!-- 添加slf4j日志api -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.20</version>
</dependency>
<!-- 添加logback-classic依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
<!-- 添加logback-core依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>1.2.3</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
</dependencies>
</project>
注意:需要在项目的 resources 目录下创建logback的配置文件。这个直接在网上搜就行。
3.编写 MyBatis 核心配置文件 – > 替换连接信息 解决硬编码问题
在模块下的 resources 目录下创建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.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="111111"/>
</dataSource>
</environment>
</environments>
<mappers>
<!-- 加载sql映射文件-->
</mappers>
</configuration>
注:这里需要根据自己数据库的密码进行更改。
4.编写 SQL 映射文件 --> 统一管理sql语句,解决硬编码问题
在模块的 resources 目录下创建映射配置文件 UserMapper.xml ,内容如下:
<?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="test">
<select id="selectAll" resultType="dao.User">
select * from tb_user;
</select>
</mapper>
resultType是返回的结果的类型。
5.编码
在maven项目下的java文件夹创建一个dao包,再在dao包中创建一个User类。
public class User {
private int id;
private String username;
private String password;
private String gender;
private String addr;
//省略了 setter 和 getter
}
再在java文件夹底下创建一个MybatisDemo类:
public class MyBatisDemo {
public static void main(String[] args) throws IOException {
//加载mybatis的核心配置文件,获取sqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//2.获取sqlSessionFactory,执行sql
SqlSession sqlSession = sqlSessionFactory.openSession();
//3.执行sql语句
List<User> users = sqlSession.selectList("test.selectAll");
//参数是一个字符串,该 字符串必须是映射配置文件的namespace.id
System.out.println(users);
sqlSession.close();
}
}
我们可以见到,在MybatisDemo类中,List<User> users=sqlSession.selectList("test.selectAll");
这句代码,就包含了JDBC中用PrepareStatement来执行并且获取到结果的代码,可见Mybatis对JDBC的简化力度是非常大的。
MybatisDemo类与UserMapper.xml文件中的对应关系:
在上面对Mybatis进行配置时,在UserMapper.xml文件中,会出现黄色的警告信息:
产生的原因:Idea和数据库没有建立连接,不识别表信息。但是大家一定要记住,它并不影响程序的执行。
解决方式:在Idea中配置MySQL数据库连接。
IDEA中配置MySQL数据库连接:
1.点击IDEA右边框的 Database ,在展开的界面点击 + 选择 Data Source ,再选择 MySQL:
2.在弹出的界面进行基本信息的填写
此时对于有部分人,可能会在测试连接的时候连接失败,URL改为jdbc:mysql://localhost:3306/mybatis?useUnicode=true&serverTimezone=UTC
3.点击完成后就能看到如下界面
4.而此界面就和 navicat 工具一样可以进行数据库的操作。也可以编写SQL语句
之前我们写的代码是基本使用方式,它也存在硬编码的问题,如下:
这里调用 selectList() 方法传递的参数是映射配置文件中的 namespace.id值。这样写也不便于后期的维护。如果使用Mapper 代理方式(如下图)则不存在硬编码问题。
当然,要进行上面代码的编写肯定要先创建出UserMapper接口:
对于里面的其中一行代码List<User> selectAll();
,List<User>
是返回值类型,selectAll()
是UserMapper.xml中的sql映射的id。
import java.util.List;
public interface UserMapper {
List<User> selectAll();
}
通过上面的描述可以看出 Mapper 代理方式的目的:
解决原生方式中的硬编码
简化后期执行SQL
使用Mapper代理方式,必须满足以下要求:
定义与SQL映射文件同名的Mapper接口,并且将Mapper接口和SQL映射文件放置在同一目录下。如下图:
注:在resources中,没有创建包,只有创建文件夹的选项。在创建相同的路径的文件夹时,要用/分割。如下图,在resources中创建对应的文件夹方式:com/itheima/mapper
此时,虽然在IDEA中看到的sql映射文件的和Mapper接口的不是在同一个目录底下,但是我们可以打开文件去看它们是否在同一个目录底下。注:要先进行编译再查看。
路径为:C:\java-language\java-language\mybatis-demo\target\classes\com\itheima\mapper
中可以看到:发现它们确实是放在了一起。
注:路径中是包含target文件夹的,需要在target文件夹中去找,若直接在IDEA中show in explorer是看不到的。
在3.1中,我们发现List<User> users = sqlSession.selectList("test.selectAll");
是存在硬编码的问题的,如果sql映射的有很多,难免会对namespace.id会产生冲突,此时就非常麻烦了。
此时我们可以将namespace改为对应接口的全限定名,即对应接口的路径。
如:下图的接口路径为:com.itheima.mapper.UserMapper
在 Mapper 接口中定义方法,方法名就是SQL映射文件中sql语句的id,并保持参数类型和返回值类型一致:
在2.1节中,我们的需求是查询user表中的所有的数据。
在 com.itheima.mapper 包下创建 UserMapper接口,代码如下:
package com.itheima.mapper;
import dao.User;
import java.util.List;
public interface UserMapper {
List<User> selectAll();
}
在 resources 下创建 com/itheima/mapper 目录,并在该目录下创建UserMapper.xml 映射配置文件:
<?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.itheima.mapper.UserMapper">
<select id="selectAll" resultType="dao.User">
select * from tb_user;
</select>
</mapper>
在 java文件夹底下创建MybatisDemo2:
public class MyBatisDemo2 {
public static void main(String[] args) throws IOException {
//加载mybatis的核心配置文件,获取sqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//2.获取sqlSessionFactory,执行sql
SqlSession sqlSession = sqlSessionFactory.openSession();
//3.执行sql语句
//List<User> users = sqlSession.selectList("test.selectAll");
//3.1 获取UserMapper接口的代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> users = userMapper.selectAll();
System.out.println(users);
sqlSession.close();
}
}
注意:
如果Mapper接口名称和SQL映射文件名称相同,并在同一目录下,则可以使用包扫描的方式简化SQL映射文件的加载。也就是将核心配置文件的加载映射配置文件的配置修改为:
<mappers>
<!-- 加载sql映射文件-->
<!--<mapper resource="com\itheima\mapper\UserMapper.xml"/>-->
<!--Mapper代理方式-->
<package name="com.itheima.mapper"/>
</mappers>
在核心配置文件的 environments 标签中其实是可以配置多个 environment ,使用 id 给每段环境起名,在environments 中使用 default=‘环境id’ 来指定使用哪儿段配置。我们一般就配置一个 environment 即可。
在映射配置文件中的 resultType 属性需要配置数据封装的类型(类的全限定名)。而每次这样写是特别麻烦的,Mybatis提供了 类型别名 (typeAliases) 可以简化这部分的书写。
首先需要现在核心配置文件中配置类型别名,也就意味着给dao包下所有的类起了别名(别名就是类名),不区分大小写。内容如下:
注:typeAliases在mybatis-config.xml中配置的顺序应该是在Configuration下的,并且是在最开始就配置,如果放在environment底下配置就会报错了。
<typeAliases>
<!--name属性的值是实体类所在包-->
<package name="dao"/>
</typeAliases>
再将对应的resultType改为对应的类名即可,包下的类名即是别名,resultType中不区分大小写。将下图的dao.User改为user即可。
版权说明 : 本文为转载文章, 版权归原作者所有 版权申明
原文链接 : https://blog.csdn.net/ZJRUIII/article/details/125258033
内容来源于网络,如有侵权,请联系作者删除!