1.获取
-
英文资料:https://github.com/mybatis/mybatis-3/releases
-
中文资料:https://mybatis.org/mybatis-3/index.html
-
maven仓库:
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.3</version> </dependency>
2.持久层
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存:断点即失
- 完成持久化工作的代码块就说持久层
3.第一个Mybatis程序
3.1 搭建环境
搭建数据库
-
新建一个普通的maven项目
-
删除src目录
-
导入依赖
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.tang</groupId> <artifactId>Mybatis-Study</artifactId> <version>1.0-SNAPSHOT</version> <!--导入依赖--> <dependencies> <!-- mysql驱动--> <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.22</version> </dependency> <!-- mybatis--> <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.7</version> </dependency> <!-- junit--> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13</version> </dependency> </dependencies> </project>
3.2 创建模块
-
编写mybatis的核心配置文件
在resources下面建一个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> <!-- <settings>--> <!-- <setting name="mapUnderscoreToCamelCase" value="true"/>--> <!-- </settings>--> <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/ssm_crud?useSSL=true&useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8"/> <property name="username" value="root"/> <property name="password" value="tanglei"/> </dataSource> </environment> </environments> <!-- <mappers>--> <!-- <mapper resource="com/mybatis/mydemo/config/employee.xml"/>--> <!-- </mappers>--> </configuration>
-
编写mybatis的工具类
package com.tang.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;
/**
* @author tanglei
* @create 2021-05-12 15:08
*/
// SqlSessionFactory转化到sqlsession的方法
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
String resource = "mybatis-config.xml";
InputStream inputStream = null;
try {
// 使用Mybatis第一步:获取sqlSessionFactory对象
inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
// 有 SqlSessionFactory,就可以从中获得sqlsession的实例了
// 需要用SqlSessionFactory来得到sqlsession才能操作数据库
public static SqlSession getSqlSession(){
SqlSession sqlSession = sqlSessionFactory.openSession();
return sqlSession;
}
}
3.3 编写代码
-
实体类
package com.tang.pojo; /** * @author tanglei * @create 2021-05-12 17:23 */ 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; } }
-
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"> <!-- namepace=绑定一个对应的Dao/Mapper接口--> <mapper namespace="com.tang.dao.UserDao"> <select id="getUserlist" resultType="com.tang.pojo.User"> select * from mybatis.user </select> </mapper>
3.4 测试
注意点:
在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>
错误1:org.apache.ibatis.binding.BindingException: Type interface com.tang.dao.UserDao is not known to the MapperRegistry.
解决1:这是因为每一个mapper.xml都需要在mybatis核心配置文件中注册
<mappers>
<mapper resource="com/tang/dao/UserMapper.xml"/>
</mappers>
-
junit测试
@Test public void test(){ //第一步,获得sqlsession对象 SqlSession sqlSession = MybatisUtils.getSqlSession(); //执行sql UserDao userDao = sqlSession.getMapper(UserDao.class); List<User> userlist = userDao.getUserlist(); for (User user:userlist){ System.out.println(user); } sqlSession.close(); }
理清思路:
-
首先要连接数据库,所以在pom配置文件里先导入mybais和mysql的jar包
-
为了得到sqlsessionfactory对象,建造工具类mybatisutils,这时需要数据库的配置文件,因此在resources里面创建配置文件连接数据库
-
写数据库里面的相关实体类和接口,用mapper.xml文件代替以前的实现类:namespace绑定接口,里面的标签ID绑定接口方法,标签体专注于sql语句,返回值类型专注于带有全面的返回对象类型
-
测试的时候,先获取到sqlsession对象,调用反射接口类的getmapper方法,再调用getUserList()方法得到对象数据,遍历输出,再关闭sqlsession
-
4. CRUD
4.1 namespace
namespace中的包名要和Dao/mapper接口中的包名一致!
4.2 参数说明
<mapper namespace="com.tang.dao.UserMapper">
<select id="getUserlist" resultType="com.tang.pojo.User">
select * from mybatis.user
</select>
</mapper>
其中
-
id:对应namespace中的方法名
-
resultType:sql语句执行的返回值
-
parameterType:参数类型
测试里面的增删改需要提交事务!!!!
4.3 步骤
-
1.在pojo包里面编写接口
public interface UserMapper { // 查询全部用户 List<User> getUserlist(); // 根据ID查询用户 User getUserById(int id); // 插入一个用户 int addUser(User user); // 修改用户 int updateUser(User user); // 删除用户 int deleteUser(int id); }
-
2.编写对应的mapper中的sql语句
<mapper namespace="com.tang.dao.UserMapper"> <select id="getUserlist" resultType="com.tang.pojo.User"> select * from mybatis.user </select> <select id="getUserById" parameterType="int" resultType="com.tang.pojo.User"> select * from mybatis.user where id = #{id} </select> <insert id="addUser" parameterType="com.tang.pojo.User"> insert into mybatis.user(id, name, pwd) values (#{id},#{name},#{pwd}); </insert> <update id="updateUser" parameterType="com.tang.pojo.User"> update mybatis.user set name=#{name},pwd=#{pwd} where id = #{id}; </update> <delete id="deleteUser" parameterType="int"> delete from mybatis.user where id=#{id}; </delete> </mapper>
-
3.测试
@Test public void getUserByIdTest(){ SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); User user = mapper.getUserById(1); System.out.println(user); sqlSession.close(); } // 增删改需要提交事务 @Test public void adduserTest() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); mapper.addUser(new User(4,"haha","123123")); //提交事务 sqlSession.commit(); sqlSession.close(); } @Test public void updateTest() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); mapper.updateUser(new User(4,"leilei","456456")); //提交事务 sqlSession.commit(); sqlSession.close(); } @Test public void deleteTest() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); mapper.deleteUser(4); //提交事务 sqlSession.commit(); sqlSession.close(); }
-
5.配置解析
5.1 核心配置文件
- mybatis-config.xml
- Mybatis的配置文件包好了影响Mybatis行为的设置和属性信息
5.2 环境配置
- MyBatis 可以配置成适应多种环境
- 但每个 SqlSessionFactory 实例只能选择一种环境
- 默认事务管理器是JDBC,连接池:POOLED
5.3 属性(properties)
属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置 [db.properties]
1.编写一个配置文件 db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=tanglei
2.在核心配置文件中引入
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="tanglei"/>
</properties>
<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>
5.4 类型别名(typeAliases)
- 类型别名可为 Java 类型设置一个缩写名字
- 仅用于 XML 配置,意在降低冗余的全限定类名书写
- 也可以扫描包名,别名就是这个类名的小写
<typeAliases>
<typeAlias type="com.tang.pojo.User" alias="User"/>
</typeAliases>
<typeAliases>
<package name="com.tang.pojo"/>
</typeAliases>
5.5 设置
MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。
5.6.映射器
要来定义 SQL 映射语句了。 但首先,我们需要告诉 MyBatis 到哪里去找到这些语句
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
<!-- 使用映射器接口实现类的完全限定类名
注意事项:接口和Mapper配置文件必须同名且必须在同一个包下-->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
<!-- 将包内的映射器接口实现全部注册为映射器
注意事项:接口和Mapper配置文件必须同名且必须在同一个包下-->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
6.生命周期
生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题
SqlSessionFactoryBuilder:
- 一旦创建了 SqlSessionFactory,就不再需要它了
- 局部变量
SqlSessionFactory:
- 一旦被创建就应该在应用的运行期间一直存在,相当于数据库连接池
- 全局变量
SqlSession:
- 每个线程都应该有它自己的 SqlSession 实例
- 连接到连接池的一个请求
- 请求结束需要关闭
7.解决属性名和字段名不一致问题
1.问题
数据库中的字段
新建一个项目(拷贝之前的),测试实体类字段不一致的情况
解决方法:
-
起别名
select * from mybatis.user where id = #{id} 改为 select id,name,pwd as password from mybatis.user where id=#{id}
-
resultMap解决
2.resultMap
<resultMap id="UserMap" type="user">
<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>
8.日志
1.日志工厂
- STDOUT_LOGGING是标准日志输出
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
2.Log4j
第一步:在pom.xml里面导入依赖包
<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
第二步:log4j配置
#将等级为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="Log4j"/>
</settings>
第四步:在要使用log4j的类中导入包:import org.apache.log4j.Logger;
定义变量:static Logger logger = Logger.getLogger(UserDaoTest.class);
9.分页
使用limit语法分页
使用Mybatis分页,核心就是SQL
- 接口
- Mapper.xml
- 测试