文章目录
- 一,创建数据库与表
- (一)在Navicat里创建MySQL数据库testdb
- (二)创建用户表 - t_user
- (三)在用户表里插入3条记录
- 二,案例演示MyBatis基本使用
- (一)创建Maven项目 - MyBatisDemo
- (二)在pom文件里添加相应的依赖
- (三)创建与用户表对应的用户实体类 - User
- (四)创建用户实体关系映射配置文件
- (五)创建MyBatis配置文件
- (六)创建日志属性文件
- (七)创建测试类测试用户操作
- 1、创建测试类 - TestUserOperation
- 2、运行测试方法 - testFindById()
- 3、运行测试方法 - testFindAll()
- 三,采用接口方式使用MyBatis
- (一)创建用户映射器接口
- (二)创建测试类测试用户映射器接口
- 1、创建测试类 - TestUserMapper
- 2、运行测试方法 - testFindById()
- 3、运行测试方法 - testFindAll()
- 四,采用配置类与注解方式使用MyBatis
- (一)查看官网上给出的资料
- (二)创建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.0
http://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;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", age=" + age +
", address='" + address + '\'' +
'}';
}
}
(四)创建用户实体关系映射配置文件
在resources目录里创建mapper子目录,然后在里面创建实体关系映射配置文件 - 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">
<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 configuration
PUBLIC "-//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会话
@Before
public 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));
}
@After
public 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; // 用户映射器
@Before
public 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();
}
}
@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();
users.forEach(user -> System.out.println(user));
}
@After
public 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; // 用户映射器
@Before
public 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));
}
@After
public 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(),查看结果