1、简介
1.1 什么是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
-
中文文档:https://mybatis.org/mybatis-3/zh/index.html
1.2 持久化
数据持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存:断电即失
- 数据库(JDBC),IO文件持久化
- 生活:冷藏、罐头
为什么需要持久化?
-
有一些对象,不能丢掉
-
内存太贵
1.3 持久层
Dao层,Service层,Controller层……
- 完成持久化工作的代码块
- 层界限十分明显
1.4 为什么需要MyBatis?
- 帮助程序员将数据存入 数据库中。
- 方便
- 传统的JDBC代码太复杂了。简化。框架。自动化。
- 不用MyBatis也可以。更容易上手。技术没有高低之分。
- 优点:
- 简单易学
- 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- sql和代码的分离,提高了可维护性
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql
最重要的一点:使用的人多!
2、第一个MyBatis程序
思路:搭建环境 --> 导入MyBatis --> 编写代码 --> 测试
2.1 搭建环境
搭建数据库
create database `mybatis`;
use `mybatis`;
CREATE TABLE `user`(
`id` INT(20) NOT NULL,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL,
PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8;
insert into `user`(`id`,`name`,`pwd`) values
(1,'旺旺','123321'),
(2,'碎碎冰','456654'),
(3,'黑米饼','789987')
新建项目
-
新建一个普通的maven项目
-
删除src目录
-
导入maven依赖
<?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.won</groupId> <artifactId>Mybatis-Study</artifactId> <version>1.0-SNAPSHOT</version> <!--导入依赖--> <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> </project>
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> <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工具类
// 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 pws; public User() { } public User(int id, String name, String pws) { this.id = id; this.name = name; this.pws = pws; } 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 getPws() { return pws; } public void setPws(String pws) { this.pws = pws; } @Override public String toString() { return "User{" + "id=" + id + ", name='" + name + '\'' + ", pws='" + pws + '\'' + '}'; } }
-
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.won.dao.UserDao"> <!--select查询语句--> <select id="getUserList" resultType="com.won.pojo.User"> select * from mybatis.user </select> </mapper>
后面会将UserDao改为UserMapper
2.4 测试
注意点:
org.apache.ibatis.binding.BindingException: Type interface com.won.dao.UserDao is not known to the MapperRegistry.
主要因为没有将Mapper注册,注册代码如下:
<!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册!!!-->
<mappers>
<mapper resource="com/won/dao/UserMapper.xml"/>
</mappers>
当注册过之后,又存在错误,报错如下:
Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/won/dao/UserMapper.xml
这是因为Maven的约定大于配置,我们在之后可能会遇到写的配置文件无法被导出或者生效的问题,解决方案如下:
<!--在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>
但是随后又出现这个问题:
com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException: 1
解决方法为在pom文件中,添加:
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
Junit测试
public class UserDaoTest {
@Test
public void test() {
// 第一步:获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
// 方式一:getMapper
UserDao uerDao = sqlSession.getMapper(UserDao.class);
List<User> userList = uerDao.getUserList();
for (User user : userList) {
System.out.println(user);
}
// 关闭sqlSession
sqlSession.close();
}
}
3、CRUD
3.1 namespace
namespace中的包名要和Dao/mapper接口的包名一致!
3.2 select
选择,查询语句:
- id:就是对应的namespace中的方法名
- resultType:SQL语句执行的返回值
- parameterType:参数类型
-
编写接口
public interface UserMapper { // 查询全部用户 List<User> getUserList(); // 根据id查询用户 User getUserById(int id); // insert一个用户 int addUser(User user); // 修改用户 int updateUser(User user); // 删除用户 int deleteUser(int id); }
-
编写对应的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"> <!--namespace=绑定一个对应的Dao/Mapper接口--> <mapper namespace="com.won.dao.UserMapper"> <!--select查询语句--> <select id="getUserList" resultType="com.won.pojo.User"> select * from mybatis.user </select> <select id="getUserById" parameterType="int" resultType="com.won.pojo.User"> select * from mybatis.user where id = #{id} </select> </mapper>
-
测试
public class UserMapperTest { @Test public void test() { // 第一步:获得SqlSession对象 SqlSession sqlSession = MybatisUtils.getSqlSession(); // 方式一:getMapper UserMapper uerDao = sqlSession.getMapper(UserMapper.class); List<User> userList = uerDao.getUserList(); for (User user : userList) { System.out.println(user); } // 关闭sqlSession sqlSession.close(); } @Test public void getUserById() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); User user = mapper.getUserById(1); System.out.println(user); sqlSession.close(); } // 增删改需要提交事务 @Test public void addUser() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); int rows = mapper.addUser(new User(4, "阿里嘎多", "6666666")); if (rows > 0) { System.out.println("插入成功"); } // 提交事务 sqlSession.commit(); sqlSession.close(); } @Test public void updateUser() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); int rows = mapper.updateUser(new User(4, "吉利嘎嘎", "888666")); if (rows > 0) { System.out.println("修改成功"); } sqlSession.commit(); sqlSession.close(); } @Test public void deleteUser() { SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); int i = mapper.deleteUser(4); if (i > 0) { System.out.println("删除成功!"); } sqlSession.commit(); sqlSession.close(); } }
3.3 insert
<!--对象中的属性,可以直接取出来-->
<insert id="addUser" parameterType="com.won.pojo.User" >
insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd})
</insert>
3.4 update
<update id="updateUser" parameterType="com.won.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id}
</update>
3.5 delete
<delete id="deleteUser" parameterType="int">
delete from mybatis.user where id = #{id}
</delete>
注意点:
- 增删改需要提交事务
3.6 万能的Map
假设我们的实体类,或者数据库中的表,字段或者参数过多,我们应当考虑使用Map!
// 万能的Map
int addUser2(Map<String,Object> map);
<!--对象中的属性,可以直接取出来 传递map的key-->
<insert id="addUser2" parameterType="map" >
insert into mybatis.user (id, name, pwd) values (#{userId},#{userName},#{password})
</insert>
@Test
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", "jakewon");
map.put("password", "78787878");
int i = mapper.addUser2(map);
if (i > 0) {
System.out.println("增加成功~");
}
sqlSession.commit();
sqlSession.close();
}
Map传递参数,直接在sql中取出key即可!【parameterType=“map”】
对象传递参数,直接在sql中取对象的属性即可!【parameterType=“Object”】
只有一个基本类型参数的情况下,可以直接在sql中取到。
多个参数用Map,或者注解!
3.7 模糊查询
-
Java代码执行的时候,传递通配符 % %
List<User> userList = mapper.getUserLike("%旺%");
-
在sql拼接中使用通配符
select * from mybatis.user where name like "%"#{value}"%"