# ssm
**Repository Path**: OHUHO/ssm
## Basic Information
- **Project Name**: ssm
- **Description**: Spring + SpringMVC + MyBatis
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-09-03
- **Last Updated**: 2022-12-01
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 一、MyBatis
## 1、Mybatis简介
### 1.1、Mybatis历史
MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下, iBatis3.x正式更名为MyBatis。代码于 2013年11月迁移到Github。 iBatis一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。 iBatis提供的持久层框架 包括SQL Maps和Data Access Objects(DAO)。
### 1.2、MyBatis特性
1) MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
2) MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
3) MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录
4) MyBatis 是一个 半自动的ORM(Object Relation Mapping)框架
### 1.3 MyBatis下载
MyBatis下载地址:https://github.com/mybatis/mybatis-3


### 1.4、和其他持久化层技术对比
- JDBC
- SQL 夹杂在Java代码中耦合度高,导致硬编码内伤
- 维护不易且实际开发需求中 SQL 有变化,频繁修改的情况多见
- 代码冗长,开发效率低
- Hibernate 和 JPA
- 操作简便,开发效率高
- 程序中的长难复杂 SQL 需要绕过框架
- 内部自动生产的 SQL,不容易做特殊优化
- 基于全映射的全自动框架,大量字段的 POJO 进行部分映射时比较困难。
- 反射操作太多,导致数据库性能下降
- MyBatis
- 轻量级,性能出色
- SQL 和 Java 编码分开,功能边界清晰。Java代码专注业务、SQL语句专注数据
- 开发效率稍逊于HIbernate,但是完全能够接受
## 2、搭建MyBatis
### 2.1、开发环境
IDE:idea 2022.2
构建工具:maven 3.8.4
MySQL版本:MySQL 8.0.28
MyBatis版本:MyBatis 3.5.10
> MySQL不同版本的注意事项
>
> 1、驱动类driver-class-name MySQL 5版本使用jdbc5驱动,驱动类使用:com.mysql.jdbc.Driver
>
> MySQL 8版本使用jdbc8驱动,驱动类使用:com.mysql.cj.jdbc.Driver
>
> 2、连接地址url
>
> MySQL 5版本的url: jdbc:mysql://localhost:3306/ssm
>
> MySQL 8版本的url: jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC
>
> 否则运行测试用例报告如下错误: java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more
### 2.2、创建maven工程
#### ① 打包方式:jar
#### ② 引入依赖
```xml
org.mybatis
mybatis
3.5.10
junit
junit
4.13.2
test
mysql
mysql-connector-java
8.0.28
```
### 2.3、创建MyBatis的核心配置文件
> 习惯上命名为mybatis-config.xml,这个文件名仅仅只是建议,并非强制要求。将来整合Spring 之后,这个配置文件可以省略。
>
> 核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息
>
> 核心配置文件存放的位置是src/main/resources目录下
```xml
```
### 2.4、创建mapper接口
> MyBatis中的mapper接口相当于以前的dao。但是区别在于,mapper仅仅是接口,我们不需要 提供实现类。
```java
public interface UserMapper {
/**
* 添加用户信息
* @return
*/
int insertUser();
}
```
### 2.5、创建MyBatis的映射文件
相关概念:ORM(Object Relationship Mapping)对象关系映射。
- 对象:Java的实体类对象
- 关系:关系型数据库
- 映射:二者之间的对应关系
| Java概念 | 数据库概念 |
| -------- | ---------- |
| 类 | 表 |
| 属性 | 字段/列 |
| 对象 | 记录/行 |
> 1、映射文件的命名规则:
>
> 表所对应的实体类的类名+Mapper.xml
>
> 例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
>
> 因此一个映射文件对应一个实体类,对应一张表的操作
>
> MyBatis映射文件用于编写SQL,访问以及操作表中的数据
>
> MyBatis映射文件存放的位置是src/main/resources/mappers目录下
>
> 2、 MyBatis中可以面向接口操作数据,要保证两个一致:
>
> - mapper接口的全类名和映射文件的命名空间(namespace)保持一致
>
> - mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
```xml
insert into t_user values(null,'admin','123456',18,'男','jc.jingchao@qq.com')
```
### 2.6、通过Junit测试功能
```java
@Test
public void testInsert() throws IOException {
// 获取核心配置文件的输入流
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
// 获取SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 获取SqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
// 获取Sql的会话对象SqlSession,是MyBatis提供的操作数据库的对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 获取UserMapper的代理实现类对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
// 调用mapper接口中的方法啊,实现添加用户信息的功能
int result = mapper.insertUser();
System.out.println("result = " + result);
// 提交事务
sqlSession.commit();
// 关闭SqlSession
sqlSession.close();
}
```
> SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的 会话)
>
> SqlSessionFactory:是“生产”SqlSession的“工厂”。
>
> 工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象。
### 2.7、添加log4j日志功能
#### ① 引入依赖
```xml
log4j
log4j
1.2.17
```
#### ② 添加log4j的配置文件
log4j的配置文件命名为logj.xml,存放在src/main/resources目录下
```xml
```
> 日志的级别
>
> FATAL(致命) > ERROR(错误) > WARN(警告) > INFO(信息) > DEBUG(调试)
>
> 从左到右打印的内容越来越详细
## 3、核心配置文件详解
### 3.1、核心配置文件顺序
> MyBatis核心配置文件中标签需要按照指定顺序配置:
> properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?
### 3.2、配置标签详解
下面通过scss的代码样式来说明各个标签的作用和属性等
```scss
.configuration{
.properties{
作用:引入properties文件 ,此后可以在当前文件中通过 ${key} 的方式访问value
}
.typeAliases{
作用:设置别名,即为某个具体的类型设置一个别名,在MyBatis的范围中,就可以使用别名来表示一个具体的类型
.typeAlias{
.属性{
type:设置需要起别名的类型
alias:设置某个类型的别名
}
.其他{
1:如果不设置alias,当前类型的默认别名为类名,且不区分大小写
}
}
.package{
说明:通过包设置类型别名,指定包下所有的类型的默认别名为类名,且不区分大小写
}
}
.environments{
作用:配置多个连接数据库的环境
.属性{
default:设置默认使用的环境的id
}
.environment{
作用:配置某个具体的环境
.属性{
id:表示连接数据库的环境的唯一标识,不能重复
}
.transactionManager{
作用:设置事务管理方式
.属性{
.type{
JDBC:表示使用JDBC中原生的事务管理方式(当前环境执行SQL时,使用的事务提交或回滚需要手动处理)
MANAGED:被管理,例如Spring
}
}
}
.dataSource{
作用:配置数据源
.属性{
.type{
作用:设置数据源类型
POOLED:表示使用数据库连接池缓存数据库连接
UNPOOLED:表示不使用数据库连接池
JNDI:表示使用上下文中的数据源
}
}
}
}
}
.mappers{
作用:引入mybatis的映射文件
.mapper{
}
.package{
说明:以包的形式引入映射文件
.要求:{
1:mapper接口和映射文件所在的包名必须一致
2:mapper接口的名字和映射文件的名字必须一致
}
}
}
}
```
### 3.3、配置文件详情
```xml
```
### 3.4、其他
#### ① SQLSessionUtil工具类的封装
```java
package com.jingchao.mybatis.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 SqlSessionUtil {
public static SqlSession getSqlSession(){
SqlSession sqlSession = null;
try {
// 获取核心配置文件的输入流
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
// 获取SqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 获取SqlSessionFactory
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
// 获取SqlSession对象
sqlSession = sqlSessionFactory.openSession(true);
} catch (IOException e) {
throw new RuntimeException(e);
}
return sqlSession;
}
}
```
#### ② IDEA创建mybatis的模板
##### A、配置mybatis-congfig模板
- idea路径:Settings —> Editor —> File and Code Templates
- 示例

- 模板内容
```xml
```
##### B、配置mybatis-mapper模板
- 配置方法同上
- 模板内容
```xml
```
## 4、MyBatis的增删改查
### 4.1、新增
#### ① 实现流程
备注:实现流程仅以新增为例演示,后续的操作流程相似。
1. mapper接口中定义抽象方法
```java
public interface UserMapper {
/**
* 添加用户信息
* @return
*/
int insertUser();
}
```
2. mapper.xml中写入操作的sql语句
```xml
insert into t_user values(null,'admin','123456',18,'男','jc.jingchao@qq.com')
```
3. 测试方法
```java
public class MyBatisTest{
@Test
public void testInsert(){
// 其中的SqlSessionUtil为自己封装好的工具类
SqlSession sqlSession = SqlSessionUtil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.insertUser();
sqlSession.close();
}
}
```
### 4.2、删除
```xml
delete from t_user where id = 3
```
### 4.3、修改
```xml
update t_user set username='root',password='1234' where id = 3
```
### 4.4、查询一个实体类对象
```xml
```
### 4.5、查询list集合
```xml
```
> 注意:
>
> 1、查询的标签select必须设置属性resultType或resultMap,用于设置 实体类和数据库表 的映射关系
>
> resultType:自动映射,用于属性名和表中字段名一致的情况,即查询的数据转换为Java对象
>
> resultMap:自定义映射,用于处理一对多或多对一或字段名和 属性名不一致的情况
## 5、MyBatis获取参数值的两种方式
> MyBatis获取参数值的两种方式:${} 和 #{}
>
> ${} 的本质就是**字符串拼接**
>
> #{}的本质就是**占位符赋值**
>
> ${} 使用字符串拼接的方式拼接sql,若为字符串类型或日期类型的字段进行赋值时,需要手动加单 引 号;但是#{}使用占位符赋值的方式拼接sql,此时为字符串类型或日期类型的字段进行赋值时, 可以自动添加单引号
### 5.1、单个字面向量类型的参数
- 说明
> 若mapper接口中的方法参数为单个的字面量类型
>
> 此时可以使用 ${} 和 #{} 以任意的名称获取参数的值,注意${}需要手动加单引号
- ${} 示例
```xml
```
- #{} 示例
```xml
```
### 5.2、多个字面量类型的参数
- 说明
> 若mapper接口中的方法参数为多个时
>
> 此时MyBatis会自动将这些参数放在一个map集合中,以arg0,arg1...为键,以参数为值;以 param1,param2...为键,以参数为值;因此只需要通过${}和#{}访问map集合的键就可以获取相对应的值,注意${}需要手动加单引号
- ${} 示例
```xml
```
- #{} 示例
```xml
```
### 5.3、map集合类型的参数
- 说明
> 若mapper接口中的方法需要的参数为多个时
>
> 此时可以手动创建map集合,将这些数据放在 map中,只需要通过${}和#{}访问map集合的键就可以获取相对应的值,注意${}需要手动加单引号
- 手动创建map
```java
HashMap map = new HashMap<>();
map.put("username","admin");
map.put("password","123456");
User user = mapper.checkLoginByMap(map);
```
- ${} 示例
```xml
```
- #{} 示例
```xml
```
### 5.4、实体类类型的参数
- 说明
> 若mapper接口中的方法参数为实体类对象时
>
> 此时可以使用${}和#{},通过访问实体类对象中的属性名获取属性值,注意${}需要手动加单引号
- ${} 示例
```xml
insert into t_user values(null,'${username}','${password}','${age}','${gender}','${email}')
```
- #{} 示例
```xml
insert into t_user values(null,#{username},#{password},#{age},#{gender},#{email})
```
### 5.5、使用@Param标识参数(Im)
- 说明
> 可以通过@Param注解标识mapper接口中的方法参数
>
> 此时,会将这些参数放在map集合中,以@Param注解的value属性值为键,以参数为值;以 param1,param2...为键,以参数为值;只需要通过${}和#{}访问map集合的键就可以获取相对应 的值, 注意${}需要手动加单引号
- ${} 示例
```xml
```
- #{} 示例
```xml
```
## 6、MyBatis的各种查询功能
### 6.1、查询一个实体类对象
```java
/**
* 根据id查询用户信息
* @param id
* @return
*/
User getUserById(@Param("id") Integer id);
```
```xml
```
### 6.2、查询一个list集合
```java
/**
* 查询所有用户信息
* @return
*/
List getAllUser();
```
```xml
```
> 当查询的数据为多条时,不能使用实体类作为返回值,否则会抛出异常
>
> TooManyResultsException;但是若查询的数据只有一条,可以使用实体类或集合作为返回值
### 6.3、查询单个数据
```java
/**
* 查询用户的总数量
* @return
*/
Integer getCount();
```
```xml
```
> 在MyBatis中,对于Java中常用的类型都设置了类型别名
>
> 例如: java.lang.Integer-->int / integer
>
> 例如: int-->_int / _integer
>
> 例如: Map-->map, List-->list
### 6.4、查询一条数据为map集合
```java
/**
* 根据id查询用户信息为map集合
* @param id
* @return
*/
Map getUserByIdToMap(@Param("id") Integer id);
```
```xml
```
### 6.5、查询多条数据为map集合
#### ① 方式一
> 将表中的数据以map集合的方式查询,一条数据对应一个map
>
> 若有多条数据,会产生多个map集合,此时可以将这些map放在一个list集合中获取
```java
/**
* 查询所有用户信息为map集合
* @return
*/
List