MyBatis快速入门
在回顾JDBC时，我们已经创建有Maven工程，而且在pom.xml中也已经导入 mysql 依赖包，这里就直接在原有工程上搭建MyBatis环境，以及使用MyBatis来实现JDBC查询user的操作流程。
MyBatis环境搭建
首先，在 Maven 项目的 pom.xml 中添加 MyBatis 的依赖 jar 包
<!--导入 mybatis 依赖包-->
<dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.2.8</version>
</dependency>
注：如果对 Maven 搞不清楚的同学，可以看我写的关于 Maven 使用教程的博客文章。
然后，在Maven工程的 resources 目录下创建 MyBatis 环境配置文件 mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!-- 数据库配置 --><environments default="development"><environment id="development"><!-- 事务管理器，JDBC类型的事务管理器 --><transactionManager type="JDBC" /><!-- 数据源，池类型的数据源 --><dataSource type="POOLED"><!--设置数据库驱动 --><property name="driver" value="com.mysql.jdbc.Driver"/><!--设置数据库url地址--><property name="url" value="jdbc:mysql://localhost:3306/mybatis"/><!--设置数据库用户名--><property name="username" value="填写数据库的用户名"/><!--设置数据库密码--><property name="password" value="填写数据库密码"/></dataSource></environment></environments></configuration>
最后，在Maven工程的main/java下创建MyBatisDemo.java文件，用于测试MyBatis环境是否搭建OK
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;
import java.util.List;/*** @desc MyBatis测试* @date 2020/6/18 上午11:34*/
public class MyBatisDemo {public static void main(String[] args) throws Exception {// 指定mybatis环境配置文件String resource = "mybatis-config.xml";// 读取配置文件InputStream inputStream = Resources.getResourceAsStream(resource);// 构建sqlSessionFactorySqlSessionFactory sqlSessionFactory= new SqlSessionFactoryBuilder().build(inputStream);// 获取sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();System.out.println("MyBatis 环境搭建 OK ");}
执行MyBatisDeme后结果如下：
注意：如果运行出现异常错误，那么可能是 jar 包导入有问题，或者 mybatis-config.xml 编写有语法错误，相信认真核查一下就可以解决。
MyBatis查询操作
首先，在 Maven 工程的main/java/mapper下创建 UserMapper.java 文件，该文件是user的映射器接口，如下：
package mapper;
import entity.UserEntity;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Result;
import org.apache.ibatis.annotations.Results;
import org.apache.ibatis.annotations.Select;import java.util.List;/*** @desc User映射器接口* @date 2020/6/19 上午8:59*/
public interface UserMapper {/*** 根据年龄查询用户信息* @param age 年龄* @return user 用户实体集合*/public List<UserEntity> selectUserByAge(int age);
}
接着，在 Maven 工程的 resources/mappers下创建 UserMapper.xml 映射文件，如下：
<?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表示命名空间，填写之前创建的 UserMapp.java 接口包路径 -->
<mapper namespace="mapper.UserMapper"><!--结果集映射--><resultMap id="userResultMap" type="entity.UserEntity"><!-- propery表示UserEntity属性名 column表示tb_user表的字段名--><id property="id" column="id" /><result property="userName" column="userName" /><result property="password" column="password" /><result property="name" column="name" /><result property="age" column="age" /><result property="sex" column="sex" /><result property="birthday" column="birthday" /><result property="created" column="created" /><result property="updated" column="updated" /></resultMap><!--select查询语句--><select id="selectUserByAge" resultMap="userResultMap">select * from tb_user where age > #{age}</select>
</mapper>
然后，在 Maven 工程的 resources/mybatis-config.xml 配置文件中添加 UserMapper.xml 映射文件的路径，如下：
<configuration><!-- 数据库配置 --><environments default="development">...</environments><!--配置映射文件路径--><mappers><mapper resource="mappers/UserMapper.xml" /></mappers>
</configuration>
最后，在 Maven 工程的 main/java/MyBatisDemo.java 文件中添加代码执行查询操作，如下：
import entity.UserEntity;
import mapper.UserMapper;
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;
import java.util.List;/*** @author benjamin.xu* @desc MyBatis测试* @date 2020/6/18 上午11:34*/
public class MyBatisDemo {public static void main(String[] args) throws Exception {// 指定mybatis环境配置文件String resource = "mybatis-config.xml";// 读取配置文件InputStream inputStream = Resources.getResourceAsStream(resource);// 构建sqlSessionFactorySqlSessionFactory sqlSessionFactory= new SqlSessionFactoryBuilder().build(inputStream);// 获取sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 获取UserMapper对象UserMapper userMapper = sqlSession.getMapper(UserMapper.class);// 执行查询操作List<UserEntity> userEntities = userMapper.selectUserByAge(20);System.out.println(userEntities);//关闭sqlSessionsqlSession.close();}
}
执行 MyBatisDemo 结果如下：
[entity.UserEntity{id=1, userName='zs', password='123456', name='张三', age=22, sex=1, birthday=Sun Sep 02 00:00:00 IRKST 1990, created='2020-06-17 09:30:58.0', updated='2020-06-17 09:30:58.0'}, entity.UserEntity{id=2, userName='ls', password='123456', name='李四', age=24, sex=1, birthday=Sun Sep 05 00:00:00 IRKST 1993, created='2020-06-17 09:30:58.0', updated='2020-06-17 09:30:58.0'}]Process finished with exit code 0
MyBatis操作步骤总结
通过上述操作，我们可以总结出 MyBatis 的操作步骤如下：
-
创建 UserMapper.java 映射器接口
-
创建 UserMapper.xml 映射文件
-
在 mybatis-config.xml 环境配置文件中添加 UserMapper.xml 映射文件路径
-
在 MyBatisDemo中编写MyBatis测试代码
- 加载 mybatis-config.xml MyBatis环境配置文件
- 创建 SqlSessionFactory 工厂对象
- 通过 SqlSessionFactory 工厂创建 SqlSession 对象
- 通过 SqlSession 创建 UserMapper接口对象
- 调用 UserMapper 接口方法执行查询操作
- 调用SqlSession.commit()提交事务（查询不需要）
- 关闭 SqlSession 会话
