使用MyBatis实现简单查询

---

一，创建数据库与表

（一）在Navicat里创建MySQL数据库testdb

（二）创建用户表 - t_user

CREATE TABLE `t_user` (`id` int(11) NOT NULL AUTO_INCREMENT,`name` varchar(50) DEFAULT NULL,`age` int(11) DEFAULT NULL,`address` varchar(255) DEFAULT NULL,PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;

执行SQL语句来创建用户表

查看用户表结构

（三）在用户表里插入3条记录

INSERT INTO `t_user` VALUES ('1', '李洪刚', '20', '江阳区嘉裕花园3栋四楼15#');
INSERT INTO `t_user` VALUES ('2', '王云华', '30', '纳溪区大渡镇红鱼村三大队');
INSERT INTO `t_user` VALUES ('3', '郑小翠', '21', '江阳区老窖花园2栋五楼15号');

执行SQL语句插入记录

查看用户表记录

采用Maven构建工具，不用你手动去下载jar包，所有jar包仓库统一管理，只要配置一下pom文件，run-install…依赖的包就会下载下来，省去你管理依赖的时间。（pom: Project Object Model 项目对象模型）

二，案例演示MyBatis基本使用

（一）创建Maven项目 - MyBatisDemo

（二）在pom文件里添加相应的依赖

<?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.0http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>net.army.mybatis</groupId><artifactId>MyBatisDemo</artifactId><version>1.0-SNAPSHOT</version><dependencies><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.13</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.49</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version></dependency><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency></dependencies>
</project>

（三）创建与用户表对应的用户实体类 - User

1.新建bean包

2.在bean包下创建实体类：User

3.添加如下代码

package net.army.mybatis.bean;/*** 作者：梁辰兴* 日期：2023/3/29* 功能：用户实体类*/
public class User {private int id;private String name;private int age;private String address;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 int getAge() {return age;}public void setAge(int age) {this.age = age;}public String getAddress() {return address;}public void setAddress(String address) {this.address = address;}@Overridepublic String toString() {return "User{" +"id=" + id +", name='" + name + '\'' +", age=" + age +", address='" + address + '\'' +'}';}
}

（四）创建用户实体关系映射配置文件

在resources目录里创建mapper子目录，然后在里面创建实体关系映射配置文件 - UserMapper.xml

添加如下代码

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="net.army.mybatis.mapper.UserMapper"><select id="findById" parameterType="int" resultType="User">SELECT * FROM t_user WHERE id = #{id};</select><select id="findAll" resultType="User">SELECT * FROM t_user;</select>
</mapper>

注意：传入参数一般用#，查询属性值一般用$

（五）创建MyBatis配置文件

在resources目录里创建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><!--配置实体类别名--><typeAliases><typeAlias type="net.army.mybatis.bean.User" alias="User"/></typeAliases><!--配置数据库环境--><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/testdb?useSSL=false"/><property name="username" value="root"/><property name="password" value="root"/></dataSource></environment></environments><!--配置实体关系映射器文件--><mappers><mapper resource="mapper/UserMapper.xml"/></mappers>
</configuration>

简要说明

• mybatis-config.xml 是 MyBatis 用来建立 sessionFactory 用的，里面主要包含了数据库连接相关内容，还有 Java 类所对应的别名，比如<typeAlias type = “net.hw.mybatis.bean.User” alias = “User” />，这个别名非常重要，在具体类的映射中，比如UserMapper.xml 中 resultType 就是对应这里的User。要保持一致。
• mybatis-config.xml 里面 的<mapper resource=“mapper/UserMapper.xml”/>是包含要映射的类的实体关系映射配置文件。
• 在UserMapper.xml 文件里面主要是定义各种SQL 语句，以及这些语句的参数，以及要返回的类型等。

（六）创建日志属性文件

在resources目录里创建log4j.properties文件

内容如下：

log4j.rootLogger=WARN, stdout, logfile
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n
log4j.appender.logfile=org.apache.log4j.FileAppender
log4j.appender.logfile.File=target/mybatis.log
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - %m%n

（七）创建测试类测试用户操作

1、创建测试类 - TestUserOperation

在test/java目录里创建net.army.mybatis.bean包，然后在包里创建测试类 - TestUserOperation

添加如下代码：

package net.army.mybatis.bean;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.After;
import org.junit.Before;
import org.junit.Test;import java.io.IOException;
import java.io.Reader;
import java.util.List;/*** 作者：梁辰兴* 日期：2023/4/4* 功能：测试用户操作*/
public class TestUserOperation {private SqlSession sqlSession; // SQL会话@Beforepublic void init() {try {// 读取MyBatis配置文件Reader reader = Resources.getResourceAsReader("mybatis-config.xml");// 基于MyBatis配置文件构建SQL会话工厂SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader);// 利用SQL会话工厂获取SQL会话sqlSession = factory.openSession();// 提示用户SQL会话创建成功System.out.println("SQL会话创建成功~");} catch (IOException e) {e.printStackTrace();}}@Test // 测试按编号查询用户记录public void testFindById() {int id = 10;// 利用SQL会话执行SQL语句进行查询，返回查询结果User user = sqlSession.selectOne("net.army.mybatis.mapper.UserMapper.findById", id);// 判断查询是否成功if (user != null) {System.out.println(user);} else {System.out.println("编号为[" + id + "]的用户未找到~");}}@Test // 测试查询全部用户记录public void testFindAll() {// 利用SQL会话执行SQL语句进行查询，返回查询结果List<User> users = sqlSession.selectList("net.army.mybatis.mapper.UserMapper.findAll");// 输出全部用户信息（采用了列表的遍历算子与Lambda表达式）users.forEach(user -> System.out.println(user));}@Afterpublic void destroy() {// 关闭SQL会话sqlSession.close();// 提示用户SQL会话关闭System.out.println("SQL会话已经关闭~");}
}

2、运行测试方法 - testFindById()

运行测试方法 - testFindById()

查看结果

修改testFindById()代码，再次运行

查看结果

3、运行测试方法 - testFindAll()

运行测试方法 - testFindAll()

查看结果

三，采用接口方式使用MyBatis

上文我们采用 SqlSession 实例来直接执行已映射的SQL语句：sqlSession.selectOne( "net.army.mybatis.mapper.UserMapper.findById", id); 其实还有更好更简洁的方式，使用合理描述参数和SQL语句返回值的接口（比如 UserMapper.class ），这样代码更简单，不容易发生字符串文字和转换的错误。

（一）创建用户映射器接口

创建net.army.mybatis.mapper包，然后在包里创建用户映射器接口 - UserMapper

输入以下代码：

package net.army.mybatis.mapper;import net.army.mybatis.bean.User;import java.util.List;/*** 作者：梁辰兴* 日期：2023/4/4* 功能：用户映射器接口
*/public interface UserMapper {User findById(int id);List<User> findAll();
}

注意：UserMapper接口的完整路路径（包名+接口名）必须是元素的namespace属性值 net.huawei.mybatis.mapper.UserMapper，并且里面定义的方法名必须与UserMapper.xml里定义的SQL语句的id值保持一致，比如 findById、findAll。

（二）创建测试类测试用户映射器接口

1、创建测试类 - TestUserMapper

在test/java里创建net.huawei.mybatis.mapper包，然后在包里创建测试类 - TestUserMapper

输入以下代码：

package net.army.mybatis.mapper;import net.army.mybatis.bean.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.After;
import org.junit.Before;
import org.junit.Test;import java.io.IOException;
import java.io.Reader;
import java.util.List;/*** 作者：梁辰兴* 日期：2023/4/4* 功能：测试用户映射器接口*/public class TestUserMapper {private SqlSession sqlSession; // SQL会话private UserMapper userMapper; // 用户映射器@Beforepublic void init() {try {// 读取MyBatis配置文件作为字符输入流Reader reader = Resources.getResourceAsReader("mybatis-config.xml");// 基于MyBatis配置文件构建SQL会话工厂SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader);// 利用SQL会话工厂获取SQL会话sqlSession = factory.openSession();// 利用SQL会话获取用户映射器对象userMapper = sqlSession.getMapper(UserMapper.class);// 提示用户SQL会话对象创建成功System.out.println("sqlSession对象已创建。");} catch (IOException e) {e.printStackTrace();}}@Testpublic void testFindById() {int id = 1;User user = userMapper.findById(id);if (user != null) {System.out.println(user);} else {System.out.println("编号为[" + id + "]的用户未找到。");}}@Testpublic void testFindAll() {List<User> users = userMapper.findAll();users.forEach(user -> System.out.println(user));}@Afterpublic void destroy() {// 关闭SQL会话sqlSession.close();// 提示用户SQL会话对象关闭System.out.println("sqlSession对象已关闭。");}
}

2、运行测试方法 - testFindById()

运行测试方法 - testFindById()

3、运行测试方法 - testFindAll()

运行测试方法 - testFindAll()

四，采用配置类与注解方式使用MyBatis

（一）查看官网上给出的资料

MyBatis官网 - https://mybatis.org/mybatis-3/getting-started.html

（二）创建MyBatis配置类

在net.army.mybatis包里创建config子包，然后在子包里创建MyBatisConfig类

输入如下代码：

package net.army.mybatis.config;import org.apache.ibatis.datasource.pooled.PooledDataSource;
import org.apache.ibatis.mapping.Environment;
import org.apache.ibatis.session.Configuration;
import org.apache.ibatis.transaction.TransactionFactory;
import org.apache.ibatis.transaction.jdbc.JdbcTransactionFactory;import javax.sql.DataSource;/*** 作者：梁辰兴* 日期：2023/4/4* 功能：MyBatis配置类*/
public class MyBatisConfig {// 获取MyBatis配置对象public static Configuration getConfiguration() {// 声明配置对象Configuration configuration = null;// 创建JDBC事务管理器TransactionFactory transactionFactory = new JdbcTransactionFactory();// 创建数据源DataSource dataSource = new PooledDataSource("com.mysql.jdbc.Driver","jdbc:mysql://localhost.3306/testdb?useSSl=false","root","root");// 创建数据库环境Environment environment = new Environment("development", transactionFactory, dataSource);// 基于数据库环境创建配置对象configuration = new Configuration(environment);// 返回配置对象return configuration;}
}

（三）创建新的用户映射器接口测试类

在test/java的net.huawei.mybatis.mapper包里创建TestUserMapperNew类

输入如下代码：

package net.army.mybatis.mapper;import net.army.mybatis.bean.User;
import net.army.mybatis.config.MyBatisConfig;
import org.apache.ibatis.session.Configuration;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;import java.util.List;/*** 作者：梁辰兴* 日期：2023/4/18* 功能：测试用户映射器接口*/
public class TestUserMapperNew {private SqlSession sqlSession; // SQL会话private UserMapper userMapper; // 用户映射器@Beforepublic void init() {// 获取MyBatis配置对象Configuration configuration = MyBatisConfig.getConfiguration();// 添加用户映射器接口configuration.addMapper(UserMapper.class);// 基于配置对象构建SQL会话工厂SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(configuration);// 利用SQL会话工厂获取SQL会话sqlSession = factory.openSession();// 利用SQL会话获取用户映射器对象userMapper = sqlSession.getMapper(UserMapper.class);// 提示用户SQL会话创建成功System.out.println("SQL会话创建成功~");}@Test // 测试按编号查询用户记录public void testFindById() {int id = 1;// 调用用户映射器的查询方法User user = userMapper.findById(id);// 判断查询是否成功if (user != null) {System.out.println(user);} else {System.out.println("编号为[" + id + "]的用户未找到~");}}@Test // 测试查询全部用户记录public void testFindAll() {// 调用用户映射器的查询方法List<User> users = userMapper.findAll();// 输出全部用户信息（采用了列表的遍历算子与Lambda表达式）users.forEach(user -> System.out.println(user));}@Afterpublic void destroy() {// 关闭SQL会话sqlSession.close();// 提示用户SQL会话关闭System.out.println("SQL会话已经关闭~");}
}

（四）修改用户映射器接口

用户映射器接口 - UserMapper

在用户映射器接口的抽象方法上添加注解，绑定SQL语句

package net.army.mybatis.mapper;import net.army.mybatis.bean.User;
import org.apache.ibatis.annotations.Select;import java.util.List;/*** 作者：梁辰兴* 日期：2023/4/4* 功能：用户映射器接口
*/public interface UserMapper {@Select("select * from t_user where id = #{id}")User findById(int id); // 按编号查询记录 @Select("select * from t_user")List<User> findAll(); // 查询所有记录 
}

（五）运行新的用户映射器接口测试类

运行测试方法testFindById()，查看结果

运行测试方法testFindAll()，查看结果