Mybatis
环境:
- JDK1.8
- Mysql5.7
- maven3.6.1
- IDEA
回顾:
- JDBC
- MySQL
- Java基础
- Maven
- Junit
SSM框架:配置文件的
最好的方式:看官网文档
1、简介
1.1、什么是mybatis
- Mybatis是一款优秀的持久层框架
- 它支持定制化SQL,存储过程个以及高级映射
- Mybatis避免了激活所有的JDBC代码和手动设置参数以及获取结果集
- Mybatis可以使用简单的XML或注解来配置和映射原生类型,接口和Java的POJO(Plain Old Java Object,普通老式Java对象)为数据库中的记录
- Mybatis本是apache的一个开源项目iBatis,2010年这个项目有apache software foundation迁移到了Google code,并且改名为Mybatis
- 2013年11月迁移到Github
1.2、持久化
数据持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存:断电即失
- 数据库(JDBC),io文件持久化
- 生活:冷藏,罐头
为什么需要持久化?
- 有一些对象不可以让他丢掉
- 内存价格昂贵
1.3、持久层
Dao层 ,Service层,Controller层…
- 完成持久化工作的代码块
- 层的界限十分明显
1.4、为什么需要Mybatis?
- 帮助程序员将数据存入到数据库中
- 方便
- 传统的JDBC代码太复杂,简化操作,制成框架,自动化
- 不用Mybatis也可以,因为Mybatis是框架更容易上手,小白也可以,技术没有高低之分
优点:
- 简单易学
- 灵活
- SQL和代码的分离,提高了程序的可维护性
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql
- 最重要的一点:使用的人多!
2、第一个Mybatis程序
思路:搭建环境—>导入Mybatis—>编写代码—>测试!
2.1、搭建环境
搭建数据库
create database `mybatis`;
use `mybatis`;
create table `user`(
`id` int(20) not null primary key,
`name` varchar(20) default null,
`pwd` varchar(20) default null
)engine=innodb default charset=utf8;
insert into `user` ('id','name','pwd') values
(1,'阿波','123456'),
(2,'张三','123456'),
(3,'李四','123456')
新建项目
1.新建一个普遍的maven项目
2.删除src目录
3.导入maven依赖
<!--导入依赖-->
<dependencies>
<!-- mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.28</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>
</dependencies>
2.2、创建一个模块
- 编写mybatis的核心配置文件
<?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 核心配置文件-->
<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://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
</configuration>
- 编写mybatis工具类
//SqlSessionFactory--->SqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//使用Mybatis第一步---> 获取SqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。/
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 + '\'' +
'}';
}
}
- Dao接口
public interface UserDao {
List<User> getUserList();
}
- 接口实现类由原来的UserDaolmpl转变为一个Mapper配置文件
<?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.kaung.dao.UserDao">
<!-- select 查询语句-->
<select id="getUserList" resultType="com.kaung.pojo.User">
select * from mybatis.user;
</select>
</mapper>
2.4、测试
注意点:
org.apache.ibatis.binding.BindingException: Type interface com.kaung.dao.UserDao is not known to the MapperRegistry.
MapperRegistry是什么?
核心配置文件中注册Mappers
- junit测试
public class UserDaoTest {
@Test
public void test(){
//第一步:获取SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//方式一:getMapper
UserDao userDao = sqlSession.getMapper(UserDao.class);
List<User> userList = userDao.getUserList();
for (User user : userList) {
System.out.println(user);
}
//关闭SqlSession
sqlSession.close();
}
}
可能会遇到的问题
- 配置文件没有注册
- 接口绑定错误
- 方法名不对
- 返回类型不对
- Meven导出资源问题
3、CRUD
3.1、namespace
namesapce中的包名要和Dao/mapper 接口的包名一致!
3.2、select
选择,查询语句;
- id:就是对应的namespace方法名
- resultType:sql语句执行的返回值!
- paramaterType:参数类型!
1、编写接口
//根据ID查询用户
User getUserById(int id);
2、编写对应的mapper中的sql语句
<select id="getUserById" parameterType="int" resultType="com.kaung.pojo.User">
select * from mybatis.user where id = #{id}
</select>
3、测试
@Test
public void getUserById(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(2);
System.out.println(user);
sqlSession.close();
};
3.3、insert
1、编写接口
//insert
int addUser(User user);
2、编写对应mapper中的sql语句
<insert id="addUser" parameterType="com.kaung.pojo.User">
insert into mybatis.user(id, name, pwd) value (#{id},#{name},#{pwd});
</insert>
3、测试
//增删改需要提交事务
@Test
public void addUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int res = mapper.addUser(new User(4, "哈哈", "123456"));
if(res>0){
System.out.println("插入成功!");
}
//提交事务
sqlSession.commit();
sqlSession.close();
}
3.4、update
1、编写接口
//update
int updateUser(User user);
2、编写对应mapper中的sql语句
<update id="updateUser" parameterType="com.kaung.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id = #{id};
</update>
3、测试
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.updateUser(new User(4,"呵呵","123123"));
sqlSession.commit();
sqlSession.close();
};
3.5、delete
1、编写接口
//delete
int deleteUser(int id);
2、编写对应mapper中的sql语句
<delete id="deleteUser" parameterType="com.kaung.pojo.User">
delete from mybatis.user where id = #{id};
</delete>
3、测试
@Test
public void deleteUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.deleteUser(4);
sqlSession.commit();
sqlSession.close();
}
注意点:
- 增删改需要提交事务!
3.6、分析错误
- 标签不要匹配错误
- resource绑定mapper,需要使用路径!
- 程序配置文件必须符合规范
- NullPointerException,没有注册到资源(空指针异常)
- 输出的xml文件中存在中文乱码问题
- maven资源没有导出问题
3.7、万能Map
假如我们的实体类或者数据库中的表,字段或者参数过多,我们应当考虑使用Map!
//万能的Map
int addUser2(Map<String,Object> map);
<insert id="addUser2" parameterType="map">
insert into mybatis.user(id, name, pwd) value (#{userid},#{userName},#{password});
</insert>
@Test
//Map测试
public void addUser2(){
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","Hello");
map.put("password","111111");
mapper.addUser2(map);
sqlSession.commit();
sqlSession.close();
}
Map传递参数,直接在sql中取出key即可 【parameterType=“map”】
对象传递参数,直接在sql中取对象的属性即可 【parameterType=“Object”】
只有一个基本类型参数的情况下,可以直接在sql中取到
多个参数用Map,或者注解
3.8、思考题
模糊查询怎么写?
1、Java代码执行的时候,传递通配符% %
List<User> userList = mapper.getUserLike("%李%");
2、在sql拼接中使用通配符!(防止sql注入问题)
select * from mybatis.user where name like "%"#{value}"%"
4、配置解析
4.1、核心配置文件
- mybatis-config.xml
- Mybatis的配置文件包含了会深深影响Mybatis行为的设置和属性信息
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
4.2、环境配置
Mybatis可以配置成适应多种环境
不过要记住:尽管可以配置多个环境,但是每个SqlSessionFactory实例只能选择一种环境
学会使用配置多套配置环境
Mybatis默认的事务管理器是JDBC
默认的连接池是:POOLED
4.3、属性
我们可以通过properties属性来实现引用配置文件
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。 【db.properties】
编写一个配置文件:db.properties
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT
username=root
password=123456
在核心配置文件中引入
<!-- 引入外部配置文件-->
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="123456"/>
</properties>
- 可以直接引入外部文件
- 可以在其中增加一些属性配置
- 如果有两个文件有同一个字段,优先使用外部配置文件的
4、类型别名
- 类型别名是为了Java类型设置一个短的名字
- 存在的意义仅在于用来减少类完全限定名的冗余
<!--可以给实体类起别名-->
<typeAliases>
<typeAlias type="com.kaung.pojo.User" alias="User"></typeAlias>
</typeAliases>
也可以指定一个包名,Mybatis会在包名下搜索需要的Java Bean,比如:
扫描实体类的包,它的默认别名就是这个类的 类名,首字母小写
<!-- 可以给实体类起别名-->
<typeAliases>
<package name="com.kaung.pojo"/>
</typeAliases>
在实体类比较少的时候,使用第一种方式,如果实体类十分多,建议使用第二种!
第一种可以DIY别名,第二种则不可以,如果非要改,需要在实体上增加注解
@Alias("user")
public class user{}
5、设置
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为
6、其他配置
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper
7、映射器
MapperRegistry:注册绑定我们的Mapper文件;
方式一:
<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册!-->
<mappers>
<mapper resource="com/kaung/dao/UserMapper.xml"/>
</mappers>
方式二:使用class文件绑定注册
<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册!-->
<mappers>
<mapper class="com.kaung.dao.UserMapper"/>
</mappers>
方式三:使用扫描包进行注入绑定
<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册!-->
<mappers>
<package name="com.kaung.dao"/>
</mappers>
注意点(方式二、三):
- 接口和它的Mapper配置文件必须同名
- 接口和它的Mapper配置文件必须在同一个包下
8、生命周期和作用域
生命周期和作用域是至关重要的,因为错误的使用会导致非常严重的并发问题
SqlSessionFactoryBuilder :
-
一旦创建了SqlSessionFactory,就不再需要它了
-
局部变量
SqlSessionFactory:
- 说白了就是可以想象成为:数据库连接池
- SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或者重新创建另一个实例
- 因此SqlSessionFactory的最佳作用域是应用作用域
- 最简单的就是使用单例模式或者静态单例模式
SqlSession:
- 可以理解成为连接到连接池的一个请求
- SqlSession的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或者方法作用域
- 用完之后需要及时关闭,否则资源会被占用
这里面的每一个Mapper,就代表一个具体的业务!
5、解决属性名和字段名不一致的问题
5.1、问题
数据库中的字段
测试出现问题
// select * from mybatis.user where id = #{id}
//类型处理器
// select id,name,pwd from mybatis.user where id = #{id}
解决方法:
- 起别名
<select id="getUserById" parameterType="int" resultType="User">
select id,name,pwd as password from mybatis.user where id = #{id}
</select>
5.2、resultMap
-
resultMap
元素是 MyBatis 中最重要最强大的元素 -
ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。
-
ResultMap 最优秀的地方在于,虽然你已经对它相当的了解,但是根本就不需要显式的用到他们
-
结果集映射:
id name pwd
id name password
<!-- 结果集映射-->
<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" parameterType="int" resultMap="UserMap">
select * from mybatis.user where id = #{id}
</select>