SSM | Mybatis
1.环境
- JDK1.8
- Mysql 5.7
- maven 3.6.1
- IDEA
涉及的内容:
- JDBC
- Mysql
- Java基础
- Maven
- Junit
SSM框架中最重要的是配置文件的学习,看官网文档是一种很好的学习方法。
2.简介
2.1 持久化
定义:持久化就是将程序的数据在持久状态和瞬时状态转化的过程。
举例:内存断电即失,而数据库(Jdbc),io文件可以持久化保存。
需要持久化的原因:内存贵、断电即失,而有一些数据十分重要,需要长时间的保存。
2.2 持久层
Dao层就属于持久层。持久层指的是完成持久化工作的代码块。
2.3 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.2</version>
</dependency>
- Github可以下载源码
https://github.com/mybatis/mybatis-3/releases
学习Mybatis的方法:
查看中文文档:- https://mybatis.org/mybatis-3/zh/index.html
2.4 使用Mybatis的原因
- 帮助程序猿将数据存入到数据库中。
- 方便
- 传统的JDBC代码太复杂了。简化。框架。自动化。
- 不用Mybatis也可以。更容易上手。 技术没有高低之分
- 优点:
- 简单易学
- 灵活
- sql和代码的分离,提高了可维护性。
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql。
最重要的一点:使用的人多!
3.第一个Mybatis程序
MyBatis执行的整个流程如下图:
3.1 搭建环境
- 搭建数据库
- 新建项目
新建一个普通的maven项目 —> 删除src目录 —> 导入maven依赖
<!--导入依赖-->
<dependencies>
<!--mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!--mybatis-->
<!-- https://mvnrepository.com/artifact/org.mybatis/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>
3.2 创建一个子模块并进行基本配置
- 在新建的空的项目中,新建一个maven的空项目作为子模块。
- 在子模块的resources文件中,新建一个名称为mybatis-config.xml的核心配置文件,对driver、url、username、password进行修改。
<?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"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
</configuration>
- 编写mybatis工具类,该工具类中的getSqlSession方法可以获得一个SqlSession对象。
//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();
}
}
- 编写实体类
package com.young.pojo;
public class User {
private int id;
private String username;
private String pwd;
public User() {
}
public User(int id, String username, String pwd) {
this.id = id;
this.username = username;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
}
3.3 编写代码,完成查询全部用户的功能
- Dao接口
public interface UserDao {
List<User> getUserList();
}
- 接口实现类由原来的UserDaoImpl转变为一个 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">
<!--namespace=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.young.dao.UserDao">
<!--select查询语句-->
<select id="getUserList" resultType="com.young.pojo.User">
select * from mybatis.user
</select>
</mapper>
3.4 测试(错误与解决办法)
junit测试:
@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();
}
bug1:<mapper resource>
映射的xml文件错误
产生错误的原因:
因为Maven项目约定大于配置,在java源文件下,只能导出Java文件,UserDao.xml文件不能被导出,所以会出现Could not find resource com/young/dao/UserDao.xml
这样的错误。
解决办法1:在pox.xml中,在build中配置resources,来解决资源导出失败的问题。
<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:将UserDao.xml文件放到resources目录下,这样可以导出资源,注意要修改mybatis-config.xml里面对应的mapper resource的地址。
另一种产生错误的原因:<mapper resource>
写的格式不对,这里必须用/隔开,用.隔开无法识别。
<mappers>
<mapper resource="com/young/dao/UserDao.xml"/> <!--正确格式-->
<mapper resource="com.young.dao.UserDao.xml"/> <!--错误格式-->
</mappers>
3.5 作用域和生命周期
理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder
- 这个类可以被实例化、使用和丢弃,一旦创建了 SqlSessionFactory,就不再需要它了。
- 最佳作用域:局部方法变量
SqlSessionFactory
- SqlSessionFactory可以理解为数据库连接池。
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 最佳作用域:应用作用域。
- 最简单的就是使用单例模式或者静态单例模式。
SqlSession
- SqlSession可以理解为连接到连接池的一个请求。
- 每个线程都应该有它自己的 SqlSession 实例。
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 及时关闭SqlSession,节约系统资源。一般情况下,将关闭操作放到 finally 块中以确保每次都能执行关闭。
4.CRUD
重点记住:数据的增删改必须提交事务
预备知识:
-
命名空间(Namespaces)现在越发重要,你必须指定命名空间。Namespace的包名要和Dao/Mapper接口的包名一致
命名空间的作用:- 1.利用更长的完全限定名来将不同的语句隔离开来,
- 2.实现了你上面见到的接口绑定。
-
select
- id 对应namespace中的方法名
- resultType:Sql语句的返回值
- parameterType:参数类型
4.1 增删改查
4.1.1.接口
public interface UserDao {
//查询全部用户
List<User> getUserList();
//根据id查询用户
User getUserId(int id);
//增加用户
int addUser(User user);
//修改用户
int updateUser(User user);
//删除用户
int deleteUser(int id);
}
4.1.2.Mapper中的SQL
<?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.young.dao.UserDao">
<select id="getUserList" resultType="com.young.pojo.User">
select * from mybatis.user
</select>
<select id="getUserId" resultType="com.young.pojo.User">
select * from mybatis.user where id=#{id}
</select>
<insert id="addUser" parameterType="com.young.pojo.User">
insert into mybatis.user(id, username, pwd) values (#{id},#{username},#{pwd})
</insert>
<update id="updateUser" parameterType="com.young.pojo.User">
update mybatis.user set username =#{username},pwd=#{pwd} where id=#{id}
</update>
<delete id="deleteUser">
delete from mybatis.user where id=#{id}
</delete>
</mapper>
4.1.3.测试
public class UserDaoTest {
@Test
public void getUserList(){
//1.获取SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//2.getMapping
UserDao mapper = sqlSession.getMapper(UserDao.class);
List<User> userList = mapper.getUserList();
for (User user : userList) {
System.out.println(user.getId());
System.out.println(user.getUsername());
System.out.println(user.getPwd());
}
//3.关闭SqlSession
sqlSession.close();
}
@Test
public void getUserId(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
User user = mapper.getUserId(1);
System.out.println(user.getId());
System.out.println(user.getUsername());
System.out.println(user.getPwd());
sqlSession.close();
}
@Test
public void addUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
mapper.addUser(new User(5, "young", "12345"));
sqlSession.commit();
sqlSession.close();
}
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
int i = mapper.updateUser(new User(3, "张四", "123456"));
System.out.println(i);
sqlSession.commit();
sqlSession.close();
}
@Test
public void deleteUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
mapper.deleteUser(4);
sqlSession.commit();
sqlSession.close();
}
}
4.2 巧用Map
如果实体类,或者是数据库中的表,字段或参数过多时,可以考虑使用Map。
4.3 模糊查询 (BUG)
模糊查询的两种写法:
-
Java代码执行时,传递通配符
-
在sql中拼接使用通配符【可能产生SQL注入问题】
5.配置文件解析
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
一般我们默认将配置文件命名为:mybatis-config.xml
配置文档的顶层结构如下:
configuration 配置
properties 配置文件 (学习)
settings mybatis设置 (学习)
typeAliases 为Java类起别名 (学习)
typeHandlers 类处理器
objectFactory 对象工厂
plugins 插件
environments 环境 (学习)
transactionManager : 事务管理(学习)
dataSource : 数据源(学习)
mappers 映射器(学习)
5.1 environments
MyBatis 可以配置成适应多种环境,这种机制有助于将 SQL 映射应用于多种数据库之中。
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
环境元素定义了如何配置环境。
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="..." value="..."/>
</transactionManager>
<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>
注意这里的关键点:
- 默认使用的环境 ID(比如:default=“development”)。
- 每个 environment 元素定义的环境 ID(比如:id=“development”)。
- 事务管理器的配置(比如:type=“JDBC”)。
- 数据源的配置(比如:type=“POOLED”)。
默认的环境和环境 ID 是自解释的,因此一目了然。 你可以对环境随意命名,但一定要保证默认的环境 ID 要匹配其中一个环境 ID。
事务管理器(transactionManager)
在 MyBatis 中有两种类型的事务管理器(也就是 type=”[JDBC|MANAGED]”)
数据源(dataSource)
有三种内建的数据源类型(也就是 type=”[UNPOOLED|POOLED|JNDI]”)
- UNPOOLED– 这个数据源的实现只是每次被请求时打开和关闭连接。
- POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来,避免了创建新的连接实例时所必需的初始化和认证时间。 这是一种使得并发 Web 应用快速响应请求的流行处理方式。
- JNDI – 这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。
重点:
Mybatis默认的事务管理器是JDBC,连接池是POOLED。
5.2 properties
简单的来说,properties是用来实现引用配置文件的。
这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置(db.properties),亦可通过 properties 元素的子元素来传递(mybatis-config.xml的标签中)
方法1:在db.properties配置文件中写配置信息
方法2:mybatis-config.xml的标签中写配置信息
说明:这两种方法是有优先级的,外部配置文件的优先级高于mybatis-config.xml中的优先级
5.3 typeAliases
typeAliases是指类型别名,简单来说就是为Java类型设置一个短的名字,减少冗余。
方法1:给实体类起别名
方法2:扫描实体类的包,它的默认名就是这个类的名字(建议首字母小写,当然大写也行)
方法2补充:如果不想使用默认名,可以通过在实体类上加注释的方法起别名。
方法的选择:相对来说,方法1的命名选择性大,方法2则相对规范。
5.4 settings
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。
了解:
5.5 mappers
我们需要告诉 MyBatis 到哪里去找接口的实现语句(相当于接口的实现类)。
Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。 你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:/// 的 URL),或类名和包名等。
方式1: 使用相对于类路径的资源引用 推荐使用
路径用 / 隔开
<!-- 使用相对于类路径的资源引用 --> 【推荐使用】
<mappers>
<mapper resource="com/young/dao/UserMapper.xml"/>
</mappers>
方式2:使用class文件绑定注册
路径用 . 隔开
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="com.young.dao.UserMapper"/>
</mappers>
注意:
1. 接口和它的Mapper配置文件必须同名
如果接口文件命名为:UserMapper
,Mapper配置文件命名为UserDao.xml
,会报如下的错误:
2. 接口和它的Mapper配置文件必须在同一个包下
方式3:使用扫描包进行注入绑定
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="com.young.dao"/>
</mappers>
注意:
1. 接口和它的Mapper配置文件必须同名
2. 接口和它的Mapper配置文件必须在同一个包下
5.6 其他
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
databaseIdProvider(数据库厂商标识)
6.属性名与字段名不一致的解决方案:ResultMap
问题描述:数据库中字段名pwd,与实体类中的属性名password不一致。
由于字段名pwd与属性名password不一致,所以查询的结果中,password为null。
问题分析:
我们在mapper里面写的select * from mybatis.user where id=#{id}
是一种简写,实际表示的是select id,username,pwd from mybatis.user where id=#{id}
,显然实体类中pwd 这一项为空。
解决方案1:起别名
<select id="getUserId" resultType="com.young.pojo.User">
select id,username,pwd as password from mybatis.user where id=#{id}
</select>
tip:Mapper里面不能写注释,不然会报错
解决方案2:ResultMap 结果集映射
- resultMap 元素是 MyBatis 中最重要最强大的元素。
- ResultMap 的设计思想是,对于简单的语句根本不需要配置显式的结果映射,而对于复杂一点的语句只需要描述它们的关系就行了。