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”的组合,是一个基于ava的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects (DAO)。
1.2 MyBatis的特性
MyBatis是支持定制化SQL、存储过程以及高级映射的优秀的持久化框架
MyBatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集
MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(普通java对象)映射成数据库中的记录
MyBatis是一个半自动的ORM框架
1.3 和其他持久化层的对比
- JDBC
- SQL夹杂在Java代码中,耦合度高,导致硬编码内伤
- 维护不易且实际开发需求中SQL有变化,频繁修改的情况很多
- 代码冗长,开发效率低
- Hibernate 和 JPA
- 操作简单,开发效率高
- 程序中的长难复杂 SQL 需要绕过框架
- 内部自动产生的SQL不容易做特殊优化
- 基于全映射的自动框架,大量字段的POJO进行部分映射时比较困难
- 反射操作太多,导致数据库性能下降
- MyBatis
- 轻量级,性能突出
- SQL和Java分开编码,功能边界清晰,Java代码专注业务,SQL语句专注数据
- 开发效率稍逊于Hibernate,但是完全能接受
2. 搭建MyBatis
2.1 创建maven工程
(1)创建项目
a. 新建一个空项目,项目名为SSM;
b. 在项目SSM中新建一个maven模块,名为MyBatis_Demo;
c. 在该模块中,test文件夹中存放测试用代码,main文件夹中的java文件夹存放开发代码,main文件夹中的recourse文件夹存放配置文件;
d. 在MySQL数据库中创建一个数据库ssm,创建一个表t_user;表结构如下(id自增):
(2)打包方式:jar
在maven项目的pom.xml文件中添加:<packaging>jar</packaging>
(3)引入依赖
在pom.xml文件中添加如下代码:
<dependencies>
<!-- 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.12</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.3</version>
</dependency>
<!--实体化类要用到的@Data,就不用构造函数了-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.16.10</version>
<scope>provided</scope>
</dependency>
</dependencies>
(4)创建实体类
在src/main/java目录下,创建一个java类,命名:com.wsl.mybatis.pojo.User.java(命名可根据自己情况随意起,前面的com.wsl.mybatis.pojo表示文件目录,User.java是文件名)
import lombok.Data;
@Data
public class User {
private Integer id;
private String username;
private String password;
private Integer age;
private String gender;
private String email;
}
(5)创建mapper接口
MyBatis中的mapper接口相当于以前的dao。但是区别在于,mapper仅仅是接口,我们不需要 提供实现类。
在src/main/java目录下,创建一个java类,命名:com.wsl.mybatis.mapper.UserMapper.java文件。
import com.wsl.mybatis.pojo.User;
import java.util.List;
public interface UserMapper {
// 添加用户
int insertUser();
// 更新用户
void updateUser();
// 删除用户
void delUser();
// 根据id查找用户
User getUserById();
// 查找所有用户
List<User> getAllUser();
}
(5)创建MyBatis的映射文件
在src/main/recourse目录下,创建com.wsl.mybatis.mapper.UserMapper.xml
注意:
1. MyBatis中可以面向接口操作数据,要保证两个一致:
mapper接口的全类名和映射文件的命名空间(namespace)保持一致
mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
2.查询的标签select必须设置属性resultType或resultMap,用于设置实体类和数据库表的映射关系:
resultType:自动映射,用于属性名和表中字段名一致的情况
resultMap:自定义映射,用于一对多或多对一或字段名和属性名不一致的情况
3.当查询的数据为多条时,不能使用实体类作为返回值,只能使用集合,否则会抛出异常 TooManyResultsException;但是若查询的数据只有一条,可以使用实体类或集合作为返回值
<?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.wsl.mybatis.mapper.UserMapper">
<!--int insertUser-->
<insert id="insertUser">
insert into t_user values(null,'张三','123',23,'女','2436@qq.com');
</insert>
<!--void updateUser-->
<update id="updateUser">
update t_user set username='李四',password='abc' where id=3;
</update>
<!--void delUser-->
<delete id="delUser">
delete from t_user where id=4;
</delete>
<!--User getUserById-->
<!--resultType:设置结构类型,查询的数据要转换为java类型-->
<select id="getUserById" resultType="com.wsl.mybatis.pojo.User">
select * from t_user where id = 3;
</select>
<!--List<User> getAllUser-->
<select id="getAllUser" resultType="com.wsl.mybatis.pojo.User">
select * from t_user;
</select>
</mapper>
(6)创建MyBatis核心配置文件:application.xml
核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息
核心配置文件存放的位置是src/main/resources目录下
<?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" />
<!--设置连接数据库的用户名-->
<property name="username" value="root" />
<!--设置连接数据库的密码-->
<property name="password" value="password" />
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>
(7)创建测试类
在src/test/java目录下,创建com.wsl.mybatis.MyBatisTest.java文件
SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的 会话)
SqlSessionFactory:是“生产”SqlSession的“工厂”。
工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象。
import com.wsl.mybatis.mapper.UserMapper;
import com.wsl.mybatis.pojo.User;
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 org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class MyBatisTest {
// 增加一列
@Test
public void testInsert() throws IOException {
// 获取配置文件的输入流
InputStream is = Resources.getResourceAsStream("application.xml");
// 获取SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 获取sqlSessionFactoryBuilder对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
// 获取SQL的会话对象,是MyBatis提供的操作数据库的对象,true表示自动提交commit
SqlSession sqlSession = sqlSessionFactory.openSession(true);
// 方法1:
// 获取UserMapper的代理实现类对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 调用userMapper接口中的方法,实现添加操作
int result = userMapper.insertUser();
// // 方法2:提供sql以及唯一标识找到sql并执行,唯一标识是namespace.sqlId
// int result=sqlSession.insert("com.wsl.mybatis.Mapper.UserMapper.insertUser");
System.out.println("结果是:"+result);
// 关闭会话
sqlSession.close();
}
// 修改
@Test
public void TestUpdate(){
InputStream is = Resources.getResourceAsStream("application.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.updateUser();
sqlSession.close();
}
// 删除
@Test
public void TestDel(){
InputStream is = Resources.getResourceAsStream("application.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.delUser();
sqlSession.close();
}
// 根据id查找User
@Test
public void TestFindById(){
InputStream is = Resources.getResourceAsStream("application.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById();
System.out.println(user);
sqlSession.close();
}
// 查询所有的User
@Test
public void TestGetAllUsers(){
InputStream is = Resources.getResourceAsStream("application.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> users = mapper.getAllUser();
// 循环输出List里面的内容
users.forEach(System.out::println);
sqlSession.close();
}
}
接下来就可以通过每个@Test注释来启动每个测试代码,验证是否正确。