MyBatis框架学习
文章目录
1、简介
1.1、什么是MyBatis
- MyBatis 是一款优秀的持久层框架
- 它支持自定义 SQL、存储过程以及高级映射。
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
- MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。
- 2013年11月迁移到Github。
如何获得Mybatis？
-
maven仓库
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.9</version> </dependency> -
Github：https://github.com/mybatis/mybatis-3/releases/tag/mybatis-3.5.9
-
中文文档： https://mybatis.org/mybatis-3/zh/index.html
1.2、持久化
数据持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存：断电即失
- 数据库科(jdbc)，io文件持久化
为什么需要持久化？
- 有些对象，不能让它丢掉
- 内存太贵了
1.3、持久层
Dao层，Service层，Controller层……
- 完成持久化工作的代码块
- 层界限十分明显
1.4、为什么需要MyBatis？
- 帮助程序猿将数据存入到数据库中
- 方便
- 传统的JDBC代码太复杂了。简化。框架。自动化。
- 不用MyBatis也可以。更容易上手。技术没有高低之分
- 优点：
- 简单易学
- 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- sql和代码的分离，提高了可维护性。
- 提供映射标签，支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签，支持对象关系组建维护
- 提供xml标签，支持编写动态sql。
2、第一个MyBatis程序
2.1、搭建环境
搭建数据库
创建项目
2.2、创建一个模块
-
编写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://localhost:3306/mybatis?useSSL=false&useUnicode=true&charsetEncoding=utf-8"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/seig/dao/UserMapper.xml"/> </mappers> </configuration>写的Mapper.xml一定要在这里注册
-
<mappers> <mapper resource="com/seig/dao/UserMapper.xml"/> </mappers> -
编写mybatis工具类
//SqlSessionFactory-->sqlSession public class MyBatisUtils { private static SqlSessionFactory sqlSessionFactory; static { try { String resource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); } catch (IOException e) { e.printStackTrace(); } } public static SqlSession getSqlSession(){ return sqlSessionFactory.openSession(); } }
2.3、编写代码
-
实体类
public class User { private int id; private String name; private String pwd; public User() { } public User(int id, String name, String pwd) { this.id = id; this.name = name; this.pwd = pwd; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getPwd() { return pwd; } public void setPwd(String pwd) { this.pwd = pwd; } @Override public String toString() { return "User{" + "id=" + id + ", name='" + name + '\'' + ", pwd='" + pwd + '\'' + '}'; } } -
xxxMapper接口
public interface UserMapper { /** * 获取用户列表 * @return */ List<User> getUserList(); } -
接口实现类由原来的xxxDaoImpl转变为xxxMapper.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.seig.dao.UserMapper"> <select id="getUserList" resultType="com.seig.pojo.User"> select * from user; </select> </mapper>
绑定一个对应的Mapper接口 xxxMapper.xmlxxxMapper.xml 不能有注释 中文注释也不能
maven导出资源过滤问题（狂神Mybatis第二集55:00）
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
2.4、测试
遇到的问题:
就是maven导出资源问题 在子maven项目的pom.xml加上以下代码段
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
- junit
测试代码：
@Test
public void test(){
//第一步：获得sqlSession
SqlSession sqlSession = MyBatisUtils.getSqlSession();
//第二步：执行sql
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = mapper.getUserList();
for (User user : userList) {
System.out.println(user);
}
//第三步：关闭sqlSession
sqlSession.close();
}
3、CRUD – 入门的增删改查
3.1、命名空间 namespace
namespace中的包名要和Dao/Mapper接口的包名一致！
3.2 、select
选择，查询语句；
- id：就是对应的namespace中的方法名
- resultType：sql语句执行的返回值！
- parameterType： 参数类型！
1.编写接口
/**
* 根据id查询用户
* @param i 用户id
* @return
*/
User getUserById(int i);
2.编写对应的mapper中的sql语句
<select id="getUserById" parameterType="int" resultType="com.seig.pojo.User">
select * from mybatis.user where id = #{id}
</select>
3.测试
@Test
public void testgetUserById(){
//第一步：获得sqlSession
SqlSession sqlSession = MyBatisUtils.getSqlSession();
//第二步：执行sql
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
//第三步：关闭sqlSession
sqlSession.close();
3.3、insert
<insert id="addUser" parameterType="com.seig.pojo.User">
insert into mybatis.user(id, name, pwd) values (#{id},#{name},#{pwd})
</insert>
3.4、update
<update id="updateUser" parameterType="com.seig.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id}
</update>
3.5、delete
<delete id="deleteUser" parameterType="int">
delete from mybatis.user where id=#{id}
</delete>
注意点： 增删改需要提交事务
3.6、万能的Map
假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应当考虑使用Map！
Mapper.java 中的接口
int addUser2(Map<String,Object> map);
Mapper.xml
<!--对象中的属性，可以直接取出来 传递map的key-->
<insert id="addUser2" parameterType="map">
insert into mybatis.user(id, name, pwd) values (#{userid},#{username},#{password})
</insert>
测试代码：
@Test
public void testaddUser2(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<String, Object>();
map.put("userid",5);
map.put("username","小莫");
map.put("password","123456");
mapper.addUser2(map);
sqlSession.commit();
sqlSession.close();
Map传递参数，直接在sql中取出key即可！【parameterType=“map”】
对象传递参数，直接在sql中取对象的属性即可！【parameterType=“Object”】
只有一个基本类型参数的情况下，可以直接在sql中取到！
多个参数用Map，或者注解
3.7、模糊查询
- java代码执行的时候，传递通配符% %
- 在sql拼接中使用通配符！
/**
* 根据名字模糊查询
* @param value
* @return
*/
List<User> getUserLike(String value);
<select id="getUserLike" resultType="com.seig.pojo.User">
select * from mybatis.user where name like "%"#{value}"%"
</select>
测试：
@Test
public void testgetUserLike(){
//第一步：获得sqlSession
SqlSession sqlSession = MyBatisUtils.getSqlSession();
//第二步：执行sql
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = mapper.getUserLike("钟");
for (User user : userList) {
System.out.println(user);
}
//第三步：关闭sqlSession
sqlSession.close();
}
4、MyBatis配置解析
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.properties】
在xml中，所有的标签都可以规定其顺序
编写一个配置文件
db.properties
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&charsetEncoding=utf-8
username=root
password=123456
在核心配置文件中映入
<!--映入外部配置文件-->
<properties resource="db.properties"/>
- 可以直接引入外部文件
- 可以在其中增加一些属性配置
- 如果两个文件有同一个字段，优先使用外部配置文件的！
4.4、类型别名（typeAliases）
- 类型别名可为 Java 类型设置一个缩写名字。
- 它仅用于 XML 配置，意在降低冗余的全限定类名书写。
<!--可以给实体类起别名-->
<typeAliases>
<typeAlias type="com.seig.pojo.User" alias="User"/>
</typeAliases>
也可以指定一个包名，MyBatis会在包名下面搜索需要的JavaBean，比如:
扫描实体类的包，它的默认别名就为这个类的 类名，首字母小写！
<typeAliases>
<package name="com.seig.pojo"/>
</typeAliases>
4.5、设置（settings）
这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。
4.6、其他配置
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
- mybatis-generator-core
- mybatis-plus
- 通用mapper
4.7、映射器（mappers）
MapperRegistry：注册绑定我们的Mapper文件！
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="com/seig/mapper/UserMapper.xml"/>
</mappers>
还有两种方式 看文档
4.8、作用域（Scope）和生命周期
不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题
SqlSessionFactoryBuilder：
- 一旦创建了 SqlSessionFactory，就不再需要它了
- 局部变量
SqlSessionFactory：
- 类似于数据库连接池
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。
- 因此 SqlSessionFactory 的最佳作用域是应用作用域
- 最简单的就是使用单例模式或者静态单例模式。
SqlSession：
- 连接到连接池的一个请求
- SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
- 用完之后需要赶紧关闭，否则资源被占用！
这里的每一个Mapper，就代表一个具体的业务！
5、解决属性名与对象名不一致的问题
5.1、问题
数据库中的字段
新建一个项目，拷贝之前的，测试实体类字段不一致的情况
public class User {
private int id;
private String name;
private String password;
}
测试出现问题
//select * from mybatis.user where id = #{id}
//类型处理器
//select id,name,pwd from mybatis.user where id = #{id}
解决方法：
-
起别名
<select id="getUserById" parameterType="int" resultType="com.seig.pojo.User"> select id, `name`,pwd as password from mybatis.user where id = #{id} </select>
5.2、resultMap 结果集映射
<!--结果集映射-->
<resultMap id="UserMap" type="User">
<!--column数据库中的字段，property实体类中的属性-->
<!-- <result column="id" property="id"/>-->
<!-- <result column="name" property="name"/>-->
<result column="pwd" property="password"/>
</resultMap>
<select id="getUserById" resultMap="UserMap">
select * from mybatis.user where id = #{id}
</select>
只需要映射需要映射的对象即可
resultMap元素是 MyBatis 中最重要最强大的元素。- ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。
ResultMap的优秀之处——你完全可以不用显式地配置它们。
6、日志
6.1、日志工厂
如果一个数据库操作，出现了异常，我们需要排错。日志就是最好的助手！
曾经：sout 、debug
现在使用 日志工厂
- SLF4J
- LOG4J(deprecated since 3.5.9)
- LOG4J2
- JDK_LOGGING
- COMMONS_LOGGING
- STDOUT_LOGGING 【掌握】
- NO_LOGGING
在Mbatis中具体使用那个日志实现，在设置中设定！
STDOUT_LOGGING 标准的日志输出
在Mybatis的核心配置文件中，配置我们的日志
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
6.2、Log4j
什么是Log4j？
- Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件
- 我们也可以控制每一条日志的输出格式；
- 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。
- 通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。
-
先导入log4j的包
<!-- https://mvnrepository.com/artifact/log4j/log4j --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> -
log4j.properties
#将等级为DEBUG的日志信息输出到console和file这两个目的地，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/kuang.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.sql.PreparedStatement=DEBUG -
配置log4j为日志的实现
<settings> <setting name="logImpl" value=""/> </settings> -
Log4j的使用！，直接测试运行刚才的查询
简单使用 -
在要使用Log4j 的类中，导入包 import org.apache.log4j.Logger;
-
日志对象，参数为当前类的class
static Logger logger = Logger.getLogger(UserDaoTest.class); -
日志级别
logger.info("info:进入了testLog4j"); logger.debug("debug:进入了testLog4j"); logger.error("error:进入了testLog4j");
7、分页
思考：为什么要分页？
- 减少数据的处理量
7.1、使用Limit分页
语法：SELECT * from user limit startIndex,pageSize;
SELECT * from user limit 3; #[0,n]
使用Mybatis实现分页，核心SQL
接口：
/**
* 分页
* @param map
* @return
*/
List<User> getUserByLimit(Map<String,Integer> map);
Mapper：
<select id="getUserByLimit" parameterType="map" resultMap="UserMap">
select * from user limit #{startIndex},#{pageSize}
</select>
测试：
@Test
public void getUserByLimit(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Integer> map = new HashMap<String, Integer>();
map.put("startIndex",0);
map.put("pageSize",2);
List<User> userList = mapper.getUserByLimit(map);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
7.2、RowBounds分页
不再使用SQL实现分页
-
接口
//分页2 List<User> getUserByRowBounds(); -
mapper.xml
<!--分页2--> <select id="getUserByRowBounds" resultMap="UserMap"> select * from mybatis.user </select> -
测试
@Test public void getUserByRowBounds(){ SqlSession sqlSession = MybatisUtils.getSqlSession(); //RowBounds实现 RowBounds rowBounds = new RowBounds(1, 2); //通过Java代码层面实现分页 List<User> userList = sqlSession.selectList("com.kuang.dao.UserMapper.getUserByRowBounds",null,rowBounds); for (User user : userList) { System.out.println(user); } sqlSession.close(); }
7.3、分页插件
了解即可，万一 以后工作时架构师，说要使用，你需要知道它是什么东西。
8、使用注解开发
8.1、面向接口编程
- 大家之前都学过面向对象编程，也学习过接口，但在真正的开发中，很多时候我们会选择面向接口编程
- 根本原因 : 解耦 , 可拓展 , 提高复用 , 分层开发中 , 上层不用管具体的实现 , 大家都遵守共同的标准 , 使得开发变得容易 , 规范性更好
- 在一个面向对象的系统中，系统的各种功能是由许许多多的不同对象协作完成的。在这种情况下，各个对象内部是如何实现自己的,对系统设计人员来讲就不那么重要了；
- 而各个对象之间的协作关系则成为系统设计的关键。小到不同类之间的通信，大到各模块之间的交互，在系统设计之初都是要着重考虑的，这也是系统设计的主要工作内容。面向接口编程就是指按照这种思想来编程。
关于接口的理解
- 接口从更深层次的理解，应是定义（规范，约束）与实现（名实分离的原则）的分离。
- 接口的本身反映了系统设计人员对系统的抽象理解。
- 接口应有两类：
- 第一类是对一个个体的抽象，它可对应为一个抽象体(abstract class)；
- 第二类是对一个个体某一方面的抽象，即形成一个抽象面（interface）；
- 一个体有可能有多个抽象面。抽象体与抽象面是有区别的。
三个面向区别
- 面向对象是指，我们考虑问题时，以对象为单位，考虑它的属性及方法 .
- 面向过程是指，我们考虑问题时，以一个具体的流程（事务过程）为单位，考虑它的实现 .
- 接口设计与非接口设计是针对复用技术而言的，与面向对象（过程）不是一个问题.更多的体现就是对系统整体的架构
8.2、使用注解开发
-
注解在接口上实现
@Select("select * from user") List<User> getUsers(); -
需要再核心配置文件中绑定接口！
<!--绑定接口--> <mappers> <mapper class="com.seig.mapper.UserMapper"/> </mappers> -
测试
本质：反射机制实现
底层：动态代理！
Mybatis详细的执行流程！
8.3、CRUD
我们可以在工具类创建的时候实现自动提交事务！
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession(true);
}
编写接口，增加注解
public interface UserMapper {
@Select("select * from user")
List<User> getUsers();
// 方法存在多个参数，所有的参数前面必须加上 @Param("id")注解
@Select("select * from user where id = #{id}")
User getUserByID(@Param("id") int id);
@Insert("insert into user(id,name,pwd) values (#{id},#{name},#{password})")
int addUser(User user);
@Update("update user set name=#{name},pwd=#{password} where id = #{id}")
int updateUser(User user);
@Delete("delete from user where id = #{uid}")
int deleteUser(@Param("uid") int id);
}
测试类
【注意：我们必须要讲接口注册绑定到我们的核心配置文件中！】
关于@Param() 注解
- 基本类型的参数或者String类型，需要加上
- 引用类型不需要加
- 如果只有一个基本类型的话，可以忽略，但是建议大家都加上！
- 我们在SQL中引用的就是我们这里的 @Param() 中设定的属性名！
#{} ${} 区别
B站地址：https://space.bilibili.com/95256449
