1简介
1.1上面是Mybatis
-
MyBatis 是一款优秀的持久层框架
-
它支持自定义 SQL、存储过程以及高级映射
-
MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取****结果集的工作
-
MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录
-
MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到github
-
Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html
GitHub : https://github.com/mybatis/mybatis-3
https://github.com/mybatis/mybatis-3/releases可以看到源码和不同版本的mybatis
maven仓库https://mvnrepository.com/在里面搜mybatis,找到想用的版本点进去,复制框框里面的话也就是依赖到pom.xml。
1.2持久化
数据持久化
持久化是将程序数据在持久状态和瞬时状态间转换的机制。
内存的特点是:断电即失,而数据库jdbc和io文件是持久化机制。
在生活中 : 将鲜肉冷藏,吃的时候再解冻的方法也是。将水果做成罐头的方法也是这样。
即把数据(如内存中的对象)保存到可永久保存的存储设备中(如磁盘)。持久化的主要应用是将内存中的对象存储在数据库中,或者存储在磁盘文件中、XML数据文件中等等。
*为什么需要持久化?*由于内存本身的缺陷引起的
- 内存断电后数据会丢失,但有一些对象是无论如何都不能丢失的,比如银行账号等,遗憾的是,人们还无法保证内存永不掉电。
- 内存过于昂贵,与硬盘、光盘等外存相比,内存的价格要高2~3个数量级,而且维持成本也高,至少需要一直供电吧。所以即使对象不需要永久保存,也会因为内存的容量限制不能一直呆在内存中,需要持久化来缓存到外存。
1.3持久层
持久化是一个动作,持久层是完成持久化工作的代码块。dao层 【DAO (Data Access Object) 数据访问对象】
Dao层,Service层,Controller层。。。
- 大多数情况下特别是企业级应用,数据持久化往往也就意味着将内存中的数据保存到磁盘上加以固化,而持久化的实现过程则大多通过各种关系数据库来完成。
- 层界限十分明显
- 我们的系统架构中,应该有一个相对独立的逻辑层面,专注于数据持久化逻辑的实现。与系统其他部分相对而言,这个层面应该具有一个较为清晰和严格的逻辑边界。【说白了就是用来**操作数据库**存在的!】
1.4为什么需要mybatis
Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据
传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .
不用mybatis依旧可以做到,只是用了会更加简单。
MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射
优点:
- 简单易学:本身就很小且简单。没有任何第三方依赖,最简单安装只要两个jar文件+配置几个sql映射文件就可以了,易于学习,易于使用,通过文档和源代码,可以比较完全的掌握它的设计思路和实现。
- 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- 解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。
- 提供xml标签,支持编写动态sql。
- 最重要的一点,使用的人多!公司需要!
2Mybatis第一个程序
思路流程:搭建环境–>导入Mybatis—>编写代码—>测试
2.1搭建环境–实验数据库
在猫里面创建数据库mybatis(名字而已),数据库里创建表,表里面插入数据;
2.2导入mybatis
步骤:
-
首先创建一个普通的maven项目
-
删除src文件夹(目录),这样写的就是一个父工程了
-
在这个工程的pom.xml导入依赖
-
数据库的mysql驱动
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.47</version> </dependency>
mybatis的
<dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.2</version> </dependency>
junit的
<dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> </dependency>
-
-
在这个工程下面新建一个module,这样的话这个模块的父就是这个工程,在工程导入的东西不需要再给模块导了。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-T1o02kTV-1620379896903)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\image-20210507105845293.png)]
父工程出现模块
<!---父工程--> <groupId>com.kuang</groupId> <artifactId>Mybatis-Study</artifactId> <packaging>pom</packaging> <version>1.0-SNAPSHOT</version> <modules> <module>mybatis-01</module> </modules>
同时模块的pom.xml,可看到他的父和自己的名字
<parent> <artifactId>Mybatis-Study</artifactId> <groupId>com.kuang</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>mybatis-01</artifactId>
4.1编写mybatis的核心配置文件
-
在模块的src/main/resources下新建一个xml文件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="com/kuang/dao/UserMapper.xml"/> </mappers> </configuration>
修改后的xml,利用到准备工作的东西
<!--核心配置文件--> <configuration> <!--environments配置多个环境--> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/><!--事务管理jdbc--> <dataSource type="POOLED"> <!-- 数据库的驱动--> <property name="driver" value="com.mysql.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3386/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/> <!-- 完整的url后面还要写安全,Unicode编码,字符,其中与&&要换成&;--> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/kuang/dao/UserMapper.xml"/> //mapper.xml的注册 </mappers> </configuration>
准备工作:因为里面涉及到了数据库的东西,所以在idea中连接数据库,右边栏有个database,填好user,password,port,点test;
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-5buv9Bl0-1620379896906)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\image-20210507112208173.png)]
然后去schemas选中数据库,比如选了2.1中自己创建的那个名为mybatis的那个。这里面可以看到很多自己创建的数据库。
这是连好数据库的样子,点击小锤子可以看到设置,看到url的标准格式jdbc:mysql://localhost:3386
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xSX5yR7m-1620379896919)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\image-20210507113023275.png)]
-
每个基于 MyBatis 的应用都是以一个 SqlSessionFactory (工厂模式)的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder (建造者模式)获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。
做这一步为了得到SqlSessionFactory ,官方文档给出的是通过读取配置文件然后一步步得到,现在将他封装成一个工具类。
String resource = "org/mybatis/example/mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
有了SqlSessionFactory,就可以从 SqlSessionFactory 中获取 SqlSession,SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。SqlSession和jdbc里面的preparedstatement差不多的作用,用来操作sql语句的。
注意:SqlSessionFactoryBuilder这个类可以被实例化、使用和丢弃,一旦创建了SqlSessionFactory就不再需要它了。所以它的最佳作用域是方法作用域(局部方法变量),不要让其一直存在,保证所有的xml解析资源可以被释放给更重要的事情。
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在,最佳作用域是应用作用域,比如单例模式或者静态单例模式。
SqlSession用来执行sql,每个线程都应该有自己的SqlSession实例,但这个实例不是线程安全的,因此不能被共享。每次收到http请求就会打开一个SqlSession,返回一个响应,就应该关闭它,关闭操作很重要,手动来个try,,catch,,,finally去关闭。
4.2编写mybatis工具类
在模块的src/main/java文件夹下建立包com.kuang.utils在里面编写工具类
package com.kuang.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.IOException; import java.io.InputStream; public class MybatisUtils { private static SqlSessionFactory sqlSessionFactory; //获取sqlsessionfactory对象,工厂模式,用来生产产品,就是sqlsession //获取的资源是这个模块的resources下的xml,也就是刚刚写好的xml配置文件,连接数据库用的 static{ try {//使用mybatis的第一步,获取sqlsessionfactory对象 String resource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); // SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //写在这里,别的方法不能用,所以要提升作用域 sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); } catch (IOException e) { e.printStackTrace(); } } //利用sqlsessionfactory获取sqlsession public static SqlSession getSqlsession(){ /* SqlSession sqlSession= sqlSessionFactory.openSession(); return sqlSession;*/ return sqlSessionFactory.openSession(); } }
- XML 配置文件中包含了对 MyBatis 系统的核心设置,包括获取数据库连接实例的数据源(DataSource)以及决定事务作用域和控制方式的事务管理器(TransactionManager)
好了至此可以连接上数据库了!!!
-
2.3编写代码
数据库相关,所以要编写实体类
首先在模块下面src/main/com/kuang下将一个pojo包,在里面编写实体类
举例,2.1创建的数据库mybatis的表是user,所以创建的实体类是user
public class User {
private int id;
private String mname;
private String pwd;
构造方法,getset方法,tostring方法
}
操作实体类,编写实现类
JDBC的做法:首先写接口dao(这里开始写的都是dao,后面专业术语叫mapper,后面用mapper),再写接口实现类在里面实现接口的方法。
mybatis:写一个dao/mapper,再写一个mapper的xml配置文件去绑定接口。
2.1在dao包下新建一个UserDao接口
package com.kuang.dao;
import com.kuang.pojo.User;
import java.util.List;
public interface UserDao {
List<User> getUserList();
}
2.2编写UserMapper.xml配置文件,前面的usermapper是自己取的名字(放在了dao包下)
小技巧:在标签里面一打空格就会出选项
xml文件是绑定接口的,实现的就和接口实现类的功能一样,所以接口实现类里面的实现方法就对应xml文件里面写个标签,标签的id,id的值就是接口里面的方法; jdbc的结果集resultset就是标签里面的resulttype返回一个和resultmap返回多个。**返回结果要写泛型的全名称。**命名空间要写完全限定名
<?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">
<!--上面都是头文件-->
<!--这个xml文件要和接口产生交集就是通过namespace去定位的-->
<mapper namespace="com.kuang.dao.UserDao">
<!-- 打一个<就可以看到所有对数据库的操作语句,现在先写一个查询吧-->
<select id="getUserList" resultType="com.kuang.pojo.User" >
select * from mybatis.user
</select>
</mapper>
注意;xml文件现在就相当于是接口的实现类,面向接口编程。
2.4测试
小技巧;shift+tab取消有序列表
注意事项
常见错误1 org.apache.ibatis.binding.BidingException一定要注意在核心配置文件中的mapper注册。每一个mapper.xml都要在mybatis核心配置文件中注册。
常见错误2 target下面没看到mapper.xml文件。原因:maven约定大于配置,自己写的配置文件可能会无法导出或者生效。自己写的mapper.xml文件写在了src/main/java文件下了,而maven的配置文件默认是放在resources文件下,所以需要手动配置。需要在pom.xml中配置。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ugda5bbJ-1620379896933)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\image-20210507153849354.png)]
解决方案:在父工程和子模块的pom.xml文件中都写上,为了保险起见。
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
</build>
结果可以看到被导出了。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-C5DZpJwb-1620379896940)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\image-20210507155036849.png)]
常见错误3:绑定接口错误,方法名不对,返回类型不对
常见错误4:utf-8序列哪个字节无效,好了就是xml中中文注释的原因。常见错误2在target中生成了对应的mybatis-config.xml,将里面的中文注释删掉,可以看到里面中文是乱码。所以xml文件最好不写注释了吧,对小白来说。
写在src/test/Java下new一个对应的包com.kuang.dao,在下面新建一个测试类,UserDaoTest
public class UserDaoTest {
@Test
public void test(){
//原来是获取preparedstatements,现在是获取sqlsession,利用工具类
SqlSession sqlSession= MybatisUtils.getSqlsession();
//拿到sqlsession就要执行sql操作
//方式1面向接口编程,拿到接口getmapper,接口调方法,接口更加安全,类型确定
UserDao mapper=sqlSession.getMapper(UserDao.class);
//获取mapper也就是获取dao,获取到那个接口
//就可以利用它的方法了
List<User> userList = mapper.getUserList();
//方式2直接利用sqlsession的方法,查询一个list,参数为接口的方法;不建议使用,这里的返回值其实是object,这里强转为user
List<User> userList1 = sqlSession.selectList("com.kuang.dao.UserDao.getUserList");
//不管是方式1还是方式2拿到list,遍历输出
for (User user : userList1) {
System.out.println(user);
//返回user,掉方法就可以
}
//关闭sqlsession
sqlSession.close();
}
}
总结;7步。1要写一个工具类,用到了核心配置文件,2核心配置文件要用到环境准备(数据库的一些东西),然后写3实体类,4写接口写5mapper.xml最后6test,还要满足maven的约束大于配置,7要在pom.xml写一段话。