MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 通过简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。
入门篇:什么是 MyBatis?
MyBatis 允许你采用一种简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。以下是 MyBatis 的一些关键特点:
- 半自动化: MyBatis 允许你手动编写 SQL 语句,同时也提供了强大的自动映射功能。
- 灵活的配置: 通过 XML 或注解,你可以灵活地配置 SQL 语句和参数。
- 易于扩展: MyBatis 提供了丰富的插件系统,可以轻松扩展其功能。
- 支持多种数据库: MyBatis 支持多种数据库,包括 MySQL、Oracle、SQL Server 等。
基础配置:搭建 MyBatis 项目
1. 添加依赖
在 Maven 项目中,添加以下依赖:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-redis</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
</dependencies>
2. 配置文件
在 src/main/resources 目录下创建 mybatis-config.xml 文件,配置数据库连接信息:
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 创建 Mapper 接口
在 com/example/mapper 目录下创建 UserMapper.java 接口:
package com.example.mapper;
public interface UserMapper {
int insert(User user);
User selectById(Integer id);
}
4. 创建 Mapper XML
在 src/main/resources/com/example/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="com.example.mapper.UserMapper">
<insert id="insert" parameterType="User">
INSERT INTO users (name, age) VALUES (#{name}, #{age})
</insert>
<select id="selectById" resultType="User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
实战篇:MyBatis 应用示例
1. 创建实体类
在 com/example/domain 目录下创建 User.java 实体类:
package com.example.domain;
public class User {
private Integer id;
private String name;
private Integer age;
// getter 和 setter 方法
}
2. 测试代码
在 com/example/mapper 目录下创建 UserMapperTest.java 测试类:
package com.example.mapper;
import com.example.domain.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.BeforeClass;
import org.junit.Test;
public class UserMapperTest {
private static SqlSessionFactory sqlSessionFactory;
@BeforeClass
public static void setUp() throws Exception {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml")
);
}
@Test
public void testSelectById() {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user);
}
}
}
3. 运行测试
运行 UserMapperTest 类的 testSelectById 方法,你应该能够看到如下输出:
User(id=1, name=张三, age=20)
这表示 MyBatis 已成功从数据库中查询到用户信息。
总结
通过本文,你了解了 MyBatis 的基本概念、配置方法以及在实际项目中的应用。MyBatis 是一个功能强大且灵活的持久层框架,能够帮助你高效地完成数据库操作。希望本文能帮助你更好地掌握 MyBatis,开启你的 Java 开源框架之旅!
